Some checks failed
rust-ci / checks (push) Has been cancelled
- Rust workspace: 7 library crates, icenetd CLI, icenet-city (Slint GUI) - Sim: fix false Delivered after a route cut, derive traffic class from payload size, per-link airtime slots (link capacity, queueing) - Docs: single docs/STATUS.md for all figures, remove v0.2/egui leftovers, drop unimplemented seed claims, uncheck store-and-forward - License: LGPL-3.0-or-later (LICENSE, LICENSES/GPL-3.0.txt)
94 lines
8.9 KiB
Markdown
94 lines
8.9 KiB
Markdown
# TODO · план ICE-NET (v0.4)
|
||
|
||
> Отмечай только после **измеренного результата**. Этап не считается готовым по факту написания документа.
|
||
> Приоритет: P0 — обязательно, P1 — после первого прототипа, P2 — позже.
|
||
> Числа и результаты проверок — только в [docs/STATUS.md](docs/STATUS.md).
|
||
|
||
## P0 · подготовка и изучение (Этап 0)
|
||
|
||
- [ ] Прочитать [Reticulum manual](https://reticulum.network/manual/) и проверить его текущие QoS, discoverable interfaces, blackhole и transport modes.
|
||
- [ ] На Arch поднять 2 локальных Reticulum-инстанса, провести обмен текстом и файлом; записать команды, задержки и неожиданности.
|
||
- [ ] Проверить Meshtastic **без покупки радио** по документации и доступным симуляторам/эмуляторам; позже протестировать 2 платы.
|
||
- [ ] Сформулировать **один измеримый разрыв** относительно Reticulum/Meshtastic; пока гипотеза: политика data/control path selection.
|
||
- [ ] Оформить ADR: строим свой wire-протокол или слой политики/плагин поверх готового стека.
|
||
- [ ] Не копировать исходники Reticulum до правового анализа его **нестандартной лицензии**.
|
||
|
||
## P0 · Slint и контроль зависимостей (v0.3)
|
||
|
||
- [x] Удалить прямой `egui/eframe` и вынести декларативную UI в `.slint`.
|
||
- [x] Выключить default-features Slint; включить только Winit + software renderer.
|
||
- [x] Оставить все базовые библиотеки без внешних crates.io-зависимостей.
|
||
- [x] Добавить отдельные state-тесты без графического backend.
|
||
- [x] Исправить конфликт 4 файла vs `Cargo.lock` в `check_layout.py`.
|
||
- [x] **На Arch собрать Slint 1.18.1** (результаты проверок — в STATUS).
|
||
- [ ] Замерить RSS и холодный старт Slint GUI в release (сравнение с egui снято: старого проекта нет).
|
||
- [x] Сгенерировать новый `Cargo.lock`; старый `Cargo.lock` с egui **не использовать**.
|
||
- [x] `cargo fmt`, `cargo clippy`, `cargo test` на Slint-сборке.
|
||
- [x] Вручную проверить перетаскивание точек, линии и элементы боковой панели (X11/Xvfb + XTest).
|
||
- [ ] Уточнить режим распространения ПО и выполнить обязательства лицензии Slint.
|
||
|
||
## P0 · Rust workspace и правила
|
||
|
||
- [x] Установить `rustup`, Rust toolchain, `rustfmt`, `clippy` и `python3` на Arch.
|
||
- [x] `python3 workspace/tools/check_layout.py` проходит без исключений.
|
||
- [x] `cargo fmt --all -- --check`, `cargo clippy --workspace --all-targets -- -D warnings`.
|
||
- [x] `cargo test --workspace`, включая отдельные файлы в `tests/`.
|
||
- [x] Все публичные API документированы в rustdoc на английском, без JavaDoc-синтаксиса `/** */`.
|
||
- [x] Зафиксировать **новый** Cargo.lock после разрешения Slint-графа для GUI/daemon.
|
||
|
||
## P0 · интерактивный город (M0)
|
||
|
||
- [x] Запустить `cargo run -p icenet-city` и проверить создание/отключение линков.
|
||
- [x] Визуально выбрать отправителя и получателя, послать Text и Photo.
|
||
- [x] Проверить: Photo **никогда** не выбирает slow-only маршрут.
|
||
- [x] Проверить: Text может пройти через slow radio, если другого пути нет.
|
||
- [x] Отключить транзитный узел, убедиться в QUEUED/NO_ROUTE и повторной попытке.
|
||
- [x] Одинаковый сценарий и действия → байт-в-байт одинаковые CSV/JSON.
|
||
- [ ] Seeded случайные отказы линков/узлов. **`seed` не реализован**; детерминизм сейчас обеспечен отсутствием случайности.
|
||
- [x] Добавить экспорт JSON сценария/CSV метрик.
|
||
|
||
## P0 · CLI без GUI (headless)
|
||
|
||
- [x] `icenetd route` — путь/NO_ROUTE по demo-топологии и отключённым линкам.
|
||
- [x] `icenetd send` — статусы Delivered/Queued/Expired с TTL и виртуальным временем.
|
||
- [x] `icenetd sim` — детерминированный сценарий + экспорт CSV/JSON.
|
||
- [x] `icenetd policy` — Permit/Deny с причиной (ACL, размер, authenticated).
|
||
- [x] `icenetd wire-encode/wire-decode` — roundtrip чернового кадра.
|
||
- [x] CLI integration tests запускают реальный бинарник.
|
||
- [x] `icenetd serve`/`send-udp` поверх UDP adapter (сеть, без GUI).
|
||
|
||
## P1 · инженерные измерения и безопасность
|
||
|
||
- [ ] 100/1000 узлов, p50/p95 поиска маршрута, delivery ratio, control airtime, RAM.
|
||
Частично, цифры — в STATUS. RAM на 1000 узлов и release-замеры — позже.
|
||
- [x] Исправить ложный `DELIVERED` при обрыве маршрута до крупного шага времени (регрессионные тесты).
|
||
- [x] Класс трафика выводится из размера (Control ≤ 256 Б, Text ≤ 4096 Б, иначе Bulk).
|
||
- [x] Ёмкость линка: слоты эфира, очередь на ребре, `slow_radio_airtime_ms`.
|
||
- [ ] Генератор служебного (announce/discovery) трафика — без него H4 не проверить.
|
||
- [ ] Метрика задержки от создания сообщения (`first_route_ms` сейчас — абсолютная метка).
|
||
- [ ] Выбор пути с учётом бэклога линков и перепланирование с текущего узла, не с источника.
|
||
- [ ] Сравнить результаты с базовыми алгоритмами, не делать заявлений о превосходстве без данных.
|
||
- [ ] Выбрать криптосхему в ADR + тест-векторы; до этого не заявлять E2E-защиту.
|
||
- [x] Реализовать replay window, ACL, rate limit, лимиты очередей.
|
||
- [x] Детерминированный fuzz-smoke парсера (10 000 входов, без паник).
|
||
- [ ] Полноценный fuzz-прогон (cargo-fuzz/OSS-Fuzz) и очередь с квотами/TTL.
|
||
- [x] UDP adapter (std::net) + loopback integration test.
|
||
- [ ] A-B-C в трёх network namespaces с `tc netem`.
|
||
- [ ] Store-and-Forward: TTL и явные QUEUED/DELIVERED/EXPIRED есть, но сообщение хранится
|
||
в общем списке, а не на узле. Нет хранения на промежуточных узлах, квот и store-carry.
|
||
- [ ] Обсудить телефон+ПК: модель пользователя и несколько DeviceID.
|
||
|
||
## P2 · реальное радио и экосистема
|
||
|
||
- [ ] Подключить готовый RNode/LoRa адаптер и измерить фактический airtime.
|
||
- [ ] Изучить законодательство конкретной страны до передачи в эфир.
|
||
- [ ] Wi-Fi mesh / направленный backhaul, затем мобильные SDK (UniFFI — кандидат).
|
||
- [ ] Опубликовать один воспроизводимый сценарий + метрики; затем искать коллег.
|
||
- [x] Выбрать лицензию кода (LGPL-3.0-or-later) и `git init`; первый коммит — по решению автора.
|
||
- [ ] Опубликовать репозиторий (<https://git.wihuk.pro/boba/ICE-NET.git>) после первого коммита.
|
||
|
||
## Решение, которое нужно принять первым
|
||
|
||
**Что делаем на старте?** Рекомендация: отдельная симуляция и независимый Rust API,
|
||
без объявления собственного сетевого протокола «стандартом» и без беспроводного железа.
|
||
См. [вопросы для автора](docs/review/questions.md).
|