Initial import: ICE-NET research docs and Rust workspace (v0.4)
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)
This commit is contained in:
Loki 2026-11-13 12:28:48 +01:00
commit 2e61688eb3
Signed by: boba
GPG key ID: 6CDE87BC9A778D97
141 changed files with 13993 additions and 0 deletions

94
TODO.md Normal file
View file

@ -0,0 +1,94 @@
# 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).