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)
8.9 KiB
8.9 KiB
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, без объявления собственного сетевого протокола «стандартом» и без беспроводного железа. См. вопросы для автора.