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

8.9 KiB
Raw Blame History

TODO · план ICE-NET (v0.4)

Отмечай только после измеренного результата. Этап не считается готовым по факту написания документа. Приоритет: P0 — обязательно, P1 — после первого прототипа, P2 — позже. Числа и результаты проверок — только в docs/STATUS.md.

P0 · подготовка и изучение (Этап 0)

  • Прочитать Reticulum 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)

  • Удалить прямой egui/eframe и вынести декларативную UI в .slint.
  • Выключить default-features Slint; включить только Winit + software renderer.
  • Оставить все базовые библиотеки без внешних crates.io-зависимостей.
  • Добавить отдельные state-тесты без графического backend.
  • Исправить конфликт 4 файла vs Cargo.lock в check_layout.py.
  • На Arch собрать Slint 1.18.1 (результаты проверок — в STATUS).
  • Замерить RSS и холодный старт Slint GUI в release (сравнение с egui снято: старого проекта нет).
  • Сгенерировать новый Cargo.lock; старый Cargo.lock с egui не использовать.
  • cargo fmt, cargo clippy, cargo test на Slint-сборке.
  • Вручную проверить перетаскивание точек, линии и элементы боковой панели (X11/Xvfb + XTest).
  • Уточнить режим распространения ПО и выполнить обязательства лицензии Slint.

P0 · Rust workspace и правила

  • Установить rustup, Rust toolchain, rustfmt, clippy и python3 на Arch.
  • python3 workspace/tools/check_layout.py проходит без исключений.
  • cargo fmt --all -- --check, cargo clippy --workspace --all-targets -- -D warnings.
  • cargo test --workspace, включая отдельные файлы в tests/.
  • Все публичные API документированы в rustdoc на английском, без JavaDoc-синтаксиса /** */.
  • Зафиксировать новый Cargo.lock после разрешения Slint-графа для GUI/daemon.

P0 · интерактивный город (M0)

  • Запустить cargo run -p icenet-city и проверить создание/отключение линков.
  • Визуально выбрать отправителя и получателя, послать Text и Photo.
  • Проверить: Photo никогда не выбирает slow-only маршрут.
  • Проверить: Text может пройти через slow radio, если другого пути нет.
  • Отключить транзитный узел, убедиться в QUEUED/NO_ROUTE и повторной попытке.
  • Одинаковый сценарий и действия → байт-в-байт одинаковые CSV/JSON.
  • Seeded случайные отказы линков/узлов. seed не реализован; детерминизм сейчас обеспечен отсутствием случайности.
  • Добавить экспорт JSON сценария/CSV метрик.

P0 · CLI без GUI (headless)

  • icenetd route — путь/NO_ROUTE по demo-топологии и отключённым линкам.
  • icenetd send — статусы Delivered/Queued/Expired с TTL и виртуальным временем.
  • icenetd sim — детерминированный сценарий + экспорт CSV/JSON.
  • icenetd policy — Permit/Deny с причиной (ACL, размер, authenticated).
  • icenetd wire-encode/wire-decode — roundtrip чернового кадра.
  • CLI integration tests запускают реальный бинарник.
  • icenetd serve/send-udp поверх UDP adapter (сеть, без GUI).

P1 · инженерные измерения и безопасность

  • 100/1000 узлов, p50/p95 поиска маршрута, delivery ratio, control airtime, RAM. Частично, цифры — в STATUS. RAM на 1000 узлов и release-замеры — позже.
  • Исправить ложный DELIVERED при обрыве маршрута до крупного шага времени (регрессионные тесты).
  • Класс трафика выводится из размера (Control ≤ 256 Б, Text ≤ 4096 Б, иначе Bulk).
  • Ёмкость линка: слоты эфира, очередь на ребре, slow_radio_airtime_ms.
  • Генератор служебного (announce/discovery) трафика — без него H4 не проверить.
  • Метрика задержки от создания сообщения (first_route_ms сейчас — абсолютная метка).
  • Выбор пути с учётом бэклога линков и перепланирование с текущего узла, не с источника.
  • Сравнить результаты с базовыми алгоритмами, не делать заявлений о превосходстве без данных.
  • Выбрать криптосхему в ADR + тест-векторы; до этого не заявлять E2E-защиту.
  • Реализовать replay window, ACL, rate limit, лимиты очередей.
  • Детерминированный fuzz-smoke парсера (10 000 входов, без паник).
  • Полноценный fuzz-прогон (cargo-fuzz/OSS-Fuzz) и очередь с квотами/TTL.
  • 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 — кандидат).
  • Опубликовать один воспроизводимый сценарий + метрики; затем искать коллег.
  • Выбрать лицензию кода (LGPL-3.0-or-later) и git init; первый коммит — по решению автора.
  • Опубликовать репозиторий (https://git.wihuk.pro/boba/ICE-NET.git) после первого коммита.

Решение, которое нужно принять первым

Что делаем на старте? Рекомендация: отдельная симуляция и независимый Rust API, без объявления собственного сетевого протокола «стандартом» и без беспроводного железа. См. вопросы для автора.