ICE-NET/TODO.md
loki5512344 2e61688eb3
Some checks failed
rust-ci / checks (push) Has been cancelled
Initial import: ICE-NET research docs and Rust workspace (v0.4)
- 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)
2026-11-13 12:28:48 +01:00

94 lines
8.9 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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).