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

84
docs/INDEX.md Normal file
View file

@ -0,0 +1,84 @@
# Индекс ICE-NET
Все Markdown-документы проекта. Цифры и состояние — только в [STATUS.md](STATUS.md).
## Корень
- [README.md](../README.md)
- [RULES.md](../RULES.md)
- [TODO.md](../TODO.md)
## Актуальные документы
- [docs/INDEX.md](../docs/INDEX.md)
- [docs/SOURCES.md](../docs/SOURCES.md)
- [docs/STATUS.md](../docs/STATUS.md)
- [docs/architecture/contracts.md](../docs/architecture/contracts.md)
- [docs/architecture/crates.md](../docs/architecture/crates.md)
- [docs/architecture/decisions.md](../docs/architecture/decisions.md)
- [docs/architecture/overview.md](../docs/architecture/overview.md)
- [docs/build/dependencies.md](../docs/build/dependencies.md)
- [docs/build/slint_license.md](../docs/build/slint_license.md)
- [docs/community/announcement_en.md](../docs/community/announcement_en.md)
- [docs/community/announcement_ru.md](../docs/community/announcement_ru.md)
- [docs/guides/commands.md](../docs/guides/commands.md)
- [docs/guides/contributing.md](../docs/guides/contributing.md)
- [docs/guides/quickstart.md](../docs/guides/quickstart.md)
- [docs/guides/testing.md](../docs/guides/testing.md)
- [docs/research/gaps.md](../docs/research/gaps.md)
- [docs/research/licensing.md](../docs/research/licensing.md)
- [docs/research/meshtastic.md](../docs/research/meshtastic.md)
- [docs/research/reticulum.md](../docs/research/reticulum.md)
- [docs/review/questions.md](../docs/review/questions.md)
- [docs/review/revision.md](../docs/review/revision.md)
- [docs/review/rf_notes.md](../docs/review/rf_notes.md)
- [docs/security/guard.md](../docs/security/guard.md)
- [docs/security/privacy.md](../docs/security/privacy.md)
- [docs/simulator/city_editor.md](../docs/simulator/city_editor.md)
- [docs/simulator/event_model.md](../docs/simulator/event_model.md)
- [docs/simulator/metrics.md](../docs/simulator/metrics.md)
- [docs/simulator/scenarios.md](../docs/simulator/scenarios.md)
## Workspace
- [workspace/README.md](../workspace/README.md)
## Архив исследования 0.1
- [archive/README.md](../archive/README.md)
- [archive/README_0.1.md](../archive/README_0.1.md)
- [archive/START_HERE_0.1.md](../archive/START_HERE_0.1.md)
- [archive/build/migration_egui_to_slint.md](../archive/build/migration_egui_to_slint.md)
- [archive/community/call_for_collaborators.md](../archive/community/call_for_collaborators.md)
- [archive/community/projects_people.md](../archive/community/projects_people.md)
- [archive/community/reddit_strategy.md](../archive/community/reddit_strategy.md)
- [archive/docs/changelog.md](../archive/docs/changelog.md)
- [archive/docs/future_questions.md](../archive/docs/future_questions.md)
- [archive/docs/glossary.md](../archive/docs/glossary.md)
- [archive/implementation/mvp_zero_budget.md](../archive/implementation/mvp_zero_budget.md)
- [archive/implementation/roadmap.md](../archive/implementation/roadmap.md)
- [archive/implementation/simulation.md](../archive/implementation/simulation.md)
- [archive/implementation/tests_metrics.md](../archive/implementation/tests_metrics.md)
- [archive/project/foundation/architecture.md](../archive/project/foundation/architecture.md)
- [archive/project/foundation/requirements.md](../archive/project/foundation/requirements.md)
- [archive/project/foundation/vision.md](../archive/project/foundation/vision.md)
- [archive/project/governance/decisions.md](../archive/project/governance/decisions.md)
- [archive/project/governance/risks.md](../archive/project/governance/risks.md)
- [archive/protocol/control/discovery_control_plane.md](../archive/protocol/control/discovery_control_plane.md)
- [archive/protocol/control/routing.md](../archive/protocol/control/routing.md)
- [archive/protocol/control/transport_qos.md](../archive/protocol/control/transport_qos.md)
- [archive/protocol/foundation/identities_addresses.md](../archive/protocol/foundation/identities_addresses.md)
- [archive/protocol/foundation/overview.md](../archive/protocol/foundation/overview.md)
- [archive/protocol/foundation/packet_wire_format.md](../archive/protocol/foundation/packet_wire_format.md)
- [archive/protocol/store/storage_dtn.md](../archive/protocol/store/storage_dtn.md)
- [archive/radio/backhaul_city_deployment.md](../archive/radio/backhaul_city_deployment.md)
- [archive/radio/legal_spectrum.md](../archive/radio/legal_spectrum.md)
- [archive/radio/physical_links.md](../archive/radio/physical_links.md)
- [archive/research/2025_2026_updates.md](../archive/research/2025_2026_updates.md)
- [archive/research/comparison.md](../archive/research/comparison.md)
- [archive/research/reading_list.md](../archive/research/reading_list.md)
- [archive/security/crypto_privacy.md](../archive/security/crypto_privacy.md)
- [archive/security/ice_engine.md](../archive/security/ice_engine.md)
- [archive/security/threat_model.md](../archive/security/threat_model.md)
- [archive/sources/part1.md](../archive/sources/part1.md)
- [archive/sources/part2.md](../archive/sources/part2.md)

38
docs/SOURCES.md Normal file
View file

@ -0,0 +1,38 @@
# Источники ICE-NET (срез 12.11.2026, дополнено 13.11.2026)
Список ссылок на **первичные** документы и каталоги. Это источники фактов,
не разрешение на копирование исходников. Архивные 60 источников —
[часть 1](../archive/sources/part1.md) и [часть 2](../archive/sources/part2.md).
| ID | Назначение | Первоисточник |
|---|---|---|
| N01 | Reticulum: полная текущая документация (1.6.0) | https://reticulum.network/manual/ |
| N02 | Reticulum: интерфейсы, обнаружение, rate limits | https://reticulum.network/manual/interfaces.html |
| N03 | Reticulum: transport nodes и разнородные среды | https://reticulum.network/manual/networks.html |
| N04 | Reticulum: FIFO для обычного трафика | https://reticulum.network/manual/understanding.html |
| N05 | Reticulum: лицензия и ограничения | https://github.com/markqvist/Reticulum/blob/master/LICENSE |
| N06 | Reticulum: код и происхождение, предупреждения | https://github.com/markqvist/Reticulum |
| N07 | Meshtastic: broadcast & next-hop | https://meshtastic.org/docs/overview/mesh-algo/ |
| N08 | Meshtastic: firmware и версии, включая prerelease | https://github.com/meshtastic/firmware/releases |
| N09 | Meshtastic: лицензии и компоненты | https://github.com/meshtastic |
| N10 | Cargo workspaces | https://doc.rust-lang.org/cargo/reference/workspaces.html |
| N11 | Rust 2024 resolver v3 | https://doc.rust-lang.org/stable/edition-guide/rust-2024/cargo-resolver.html |
| N12 | Отдельные integration tests | https://doc.rust-lang.org/stable/cargo/reference/cargo-targets.html |
| N13 | _снято_: eframe/egui (GUI заменён на Slint в v0.3) | — |
| N14 | _снято_: egui MSRV | — |
| N15 | Симуляция и отличие от реального RF (ns-3) | https://www.nsnam.org/ |
| N16 | Wi-Fi Aware (Apple) | https://developer.apple.com/documentation/wifiaware |
**Ограничения:** страницы с latest могут изменяться после даты среза;
нужен `Cargo.lock` и регулярная повторная проверка лицензий. Выписанные факты
из [внешней ревизии](review/revision.md) отмечены отдельно от нового поиска.
## Дополнение: Slint и экосистема
- [Slint 1.18.1 Rust API](https://docs.slint.dev/latest/docs/rust/slint/) — интеграция Rust с компилируемым `.slint`.
- [Флаги Slint](https://docs.slint.dev/latest/docs/rust/slint/docs/cargo_features/) — управление backend/renderer.
- [Slint Winit backend](https://docs.slint.dev/latest/docs/slint/guide/backends-and-renderers/backend_winit/) — desktop Linux/X11/Wayland.
- [Slint TouchArea](https://docs.slint.dev/latest/docs/slint/reference/gestures/toucharea/) — drag без сторонней библиотеки.
- [Slint license](https://github.com/slint-ui/slint/blob/master/LICENSE.md) — GPLv3 / royalty-free / commercial.
- [Slint crate v1.18.1](https://docs.rs/crate/slint/1.18.1/source/Cargo.toml) — MSRV 1.92.
- [GNU LGPL v3](https://www.gnu.org/licenses/lgpl-3.0.html) и [GPL v3](https://www.gnu.org/licenses/gpl-3.0.html) — лицензия кода ICE-NET.

67
docs/STATUS.md Normal file
View file

@ -0,0 +1,67 @@
# Статус ICE-NET (единственный источник цифр)
Все остальные документы **ссылаются сюда** и не повторяют числа. Меняешь код —
обнови только этот файл. Дата последней сверки: **13 ноября 2026**.
## Окружение и лицензия
| Параметр | Значение |
| --- | --- |
| Toolchain | Rust 1.95.0 (`workspace/rust-toolchain.toml`), Edition 2024, resolver 3 |
| Crates workspace | 7 библиотек + 2 приложения (`icenetd`, `icenet-city`) |
| Лицензия кода | **LGPL-3.0-or-later** (`LICENSE`, `LICENSES/GPL-3.0.txt`), см. ADR-010 |
| GUI-зависимость | Slint 1.18.1 (отдельная лицензионная проверка, [slint_license.md](build/slint_license.md)) |
| Git | репозиторий инициализирован; коммитов пока нет |
## Что проверено (в этой сессии)
| Проверка | Результат |
| --- | --- |
| `python3 tools/check_layout.py` | PASS (≤250 строк, ≤4 файла на каталог) |
| `cargo fmt --all -- --check` | чисто |
| `cargo clippy --workspace --all-targets -- -D warnings` | чисто |
| `cargo test --workspace` | **91 тест, 0 падений** (в v0.3 было 77) |
| Записей в `Cargo.lock` | 523 (не равно числу скомпилированных crates) |
| Поиск маршрута, сетка 1000 узлов, 200 запросов, **debug** | p50 ≈ 6.3 мс, p95 ≈ 8.4 мс (**реальное** время CPU, не симулированное) |
Не перепроверялось в этой сессии и взято из записей 12.11.2026: ручной прогон GUI под
X11/Xvfb (клики, drag, экспорт), RSS GUI ≈ 55 МБ (debug), `cargo build --release`
`icenet-city` ≈ 2m27s и 18 МБ без strip. Wayland не проверялся. Сравнение с egui
невозможно: старого проекта и lock-файла нет.
## Что реализовано, а что нет
| Область | Состояние |
| --- | --- |
| Классы трафика, запрет Bulk на slow radio | Есть. Класс **выводится из размера** (`effective_for`): Control ≤ 256 Б, Text ≤ 4096 Б, иначе Bulk |
| Выбор пути | Dijkstra с детерминированным tie-break; возвращает индексы линков |
| Ёмкость линка | Есть: один линк — одна передача, слоты эфира, очередь на ребре, бэклог и airtime |
| Статусы | `Queued`, `InFlight`, `Delivered`, `Expired`; ложный `Delivered` при обрыве маршрута исправлен |
| TTL / EXPIRED | Есть |
| Store-and-forward | **Нет**: сообщение лежит в общем списке, не на узле; нет квот и store-carry |
| Случайность / `seed` | **Нет**: детерминизм обеспечен отсутствием случайности |
| Служебный (control) трафик | **Не генерируется**: announce/discovery не моделируются |
| Wire-формат | Черновик без криптографии, без fragmentation |
| ICE Guard | ACL, размер, очередь, replay window, token bucket; `authenticated` — тестовый флаг |
| Транспорт | `MemoryTransport` и неблокирующий `UdpTransport` (loopback) |
| Криптография, handshake, ключи | Нет |
| Реальное радио, RF-модель | Нет |
## Статус гипотез
| Гипотеза | Статус |
| --- | --- |
| H1: bulk не занимает airtime slow radio | Обеспечена фильтром маршрутизации и размером; тесты проходят, но это **инвариант кода**, а не научный результат. Измеряется `slow_radio_airtime_ms` |
| H2: короткий текст доходит по единственному slow-пути | Теперь проверяема (есть ёмкость, задержка растёт с очередью). Нагрузочных экспериментов ещё не было |
| H3: нет ложного `DELIVERED` | Исправлено и покрыто регрессионными тестами (`tests/city.rs`) |
| H4: контрольный airtime при 100→1000 узлов | **Не проверяема**: нет генератора служебного трафика |
## Известные ограничения симулятора
- Маршрутизация — оракул: видит весь граф бесплатно; стоимость пути не учитывает бэклог.
- Перепланирование начинает передачу заново с источника; уже потраченный airtime не возвращается.
- `first_route_ms` — **абсолютная** метка симулированного времени, не задержка от создания.
- Нет потерь, коллизий, скрытых терминалов, duty cycle и MAC; очередь — по порядку резервирования.
- Число в `demo_bps` — иллюстрация, не измерение железа.
Планы и чек-листы: [TODO.md](../TODO.md).

View file

@ -0,0 +1,44 @@
# Первые контракты и определения
## Какие ID какие
- `NodeId` **реальной сети** в `icenet-core` пока представлен `u64` исключительно для каркаса. Это НЕ криптографическая идентичность!
- `SimNodeId` по сути тот же тестовый ID. В будущем: стабильный fingerprint публичного ключа и отдельный DeviceID.
- `ServiceId(u64)` — логический номер сервиса, не ОС-порт и не гарантия уникальности без схемы namespace.
- `LinkKind::{SlowRadio, FastWireless, Wired, Internet}` — профили симуляции, не протоколы передачи по воздуху.
## Классы
- `Control`: объявления/короткие служебные данные, минимальный payload.
- `Text`: малый payload (≤ 4096 Б), в исключительных случаях допустима передача по slow radio.
- `Bulk`: файлы/фото, `SlowRadio` запрещён независимо от скорости маршрута.
- Класс **выводится из размера**: `effective_for(bytes)` повышает Control > 256 Б до Text, Text > 4096 Б до
Bulk; `Bulk` не уменьшается. Метка отправителя не даёт доступа к slow radio.
## Маршрут
- `choose_path` возвращает последовательность NodeId, индексы использованных линков и приблизительную
задержку сериализации **без очереди**.
- Каждый переход проверяется на `enabled`, разрешённый класс, throughput > 0.
- Для сравнимости первые измерения: dijkstra с deterministic tie-break, затем baseline shortest hops.
- Нельзя автоматически считать `route_found` равным `delivered`.
- Линк несёт одну передачу за раз: время прибытия включает ожидание слота. `Delivered` ставится
только если маршрут (узлы, линки, класс) ещё пригоден на момент `tick`.
- У сообщения есть `created_ms`/`expires_ms`; истёкшее сообщение переходит в `Expired`
и не оживает. Прибытие не позже `expires_ms` считается доставкой.
- CSV/JSON экспорт детерминирован и не использует системные часы.
## Сетевой пакет (черновик)
`magic | version | class | service_id | payload_len | bytes`.
- Пример без криптографии, без anti-replay, без fragmentation.
- Отдельный парсер ограничивает длину входящих байтов и возвращает `Result`.
- В продакшене формат нужно будет изменить после threat modeling и test vectors.
## Результат безопасности
- `Permit`, `Deny(reason)`; без "strike back".
- `Deny` не расходует replay/rate state; `sequence` фиксируется только после `Permit`.
- Входной `authenticated: bool` в scaffold — только тестовый флаг,
**не криптографическая проверка**.

View file

@ -0,0 +1,47 @@
# Cargo workspace: границы крейтов
| Crate | Ответственность | Кому может зависеть |
|---|---|---|
| `icenet-core` | типы идентификаторов, класс сообщения, среда | стандартная библиотека |
| `icenet-wire` | framing + парсер *чернового* пакета | core |
| `icenet-guard` | детерминированные ACL, размер, очередь, replay, rate (без crypto) | core |
| `icenet-routing` | выбор допустимого пути на графе, индексы линков | core |
| `icenet-transport` | интерфейс отправки байтов, memory + UDP адаптеры | core |
| `icenet-sim` | виртуальное время, узлы, ёмкость линков, сценарии, метрики | core, routing |
| `icenet-sdk` | будущий публичный фасад API | core, wire, guard, transport |
| `icenetd` | CLI и UDP `serve`/`send-udp`; позже daemon | sdk, sim |
| `icenet-city` | GUI-карта и контроллер сценариев | sim, core, Slint |
## Принципы границ
- Ни один core crate не зависит от `Slint`, Tokio, Linux, Wi-Fi или LoRa.
- Sim **не** использует `icenetd`; GUI **не** содержит алгоритма маршрутизации.
- SDK является библиотекой встраивания, а daemon и GUI — клиентами публичных интерфейсов.
- Адаптеры настоящего радио добавятся **после** тестов в симуляторе и решения ADR.
- Защиту и типы не дублировать в GUI: дополнять tests на границе библиотеки.
## Почему не 20 crates
SOLID — не повод усложнять сборку. Переносим модуль в crate, если есть отдельная
ответственность, тестируемый контракт или платформенная граница. Сейчас есть
7 библиотек и 2 приложения, почти все минимальные.
## Программируемые интерфейсы
- `Transport::send(bytes)`, `Transport::recv()` — реальные bytes, не UI-события.
- `choose_path(nodes, links, source, destination, class, size)` — чистая функция.
- `City::send(...)`, `City::tick(delta_ms)`, `City::set_link_enabled(...)`, `City::link_airtime_ms(kind)` — контролируемая модель.
- `Guard::check(context)` — решение доступа, не ответная атака.
- `icenetd route|send|sim|policy|wire-*` — headless-проверка этих контрактов.
Детали: [API-контракты](contracts.md) и [симулятор](../simulator/city_editor.md).
## Зависимости и границы UI
`icenet-city` — только адаптер интерфейса. Slint UI в `ui/main.slint`;
`src/state.rs` изменяет `City`; `src/view.rs` конвертирует данные в модели;
`src/main.rs` подключает callbacks. В остальные crates не импортируется Slint.
Все 7 библиотек намеренно разделены по обязанностям, **все без внешних crates** (числа — в [STATUS](../STATUS.md)).
Если эти границы перестанут приносить пользу, нужно объединить crates по ADR,
а не бездумно делить ещё мельче. См. [аудит](../build/dependencies.md).

View file

@ -0,0 +1,48 @@
# ADR register
| ADR | Решение | Статус |
|---|---|---|
| ADR-001 | Userland Rust вместо Linux kernel fork | Принято для MVP |
| ADR-002 | Slow control / fast bulk policy | Принято как **гипотеза** |
| ADR-003 | Rust workspace + отдельные integration tests | Принято |
| ADR-004 | Город — графовая DES-модель, не RF-доказательство | Принято |
| ADR-005 | Slint 1.18.1 + software renderer для native GUI (egui удалён) | Принято в v0.3 |
| ADR-006 | Реальная криптография, wire-format, физические драйверы | Открыто |
| ADR-007 | Свой полноценный протокол или адаптер к Reticulum | Открыто до экспериментов |
| ADR-008 | Общая идентичность человека на нескольких устройствах | Открыто |
| ADR-009 | TTL и явное состояние `EXPIRED` для недоставленных сообщений | Принято в v0.3 |
| ADR-010 | Лицензия собственного кода: LGPL-3.0-or-later | Принято (автор проекта) |
| ADR-011 | Класс трафика выводится из размера, метка не доверена | Принято в v0.4 |
| ADR-012 | Ёмкость линка: слоты эфира с владельцем, очередь на ребре | Принято в v0.4 |
## Для каждого нового ADR
Описание контекста → альтернативы → причины выбора → проверяемые последствия → риски → срок ревизии.
Запрещено объявлять открытые ADR реализованными в README.
## ADR-010 · Лицензия: LGPL-3.0-or-later
- **Контекст:** автор выбрал LGPL; репозиторий не имел лицензии.
- **Решение:** LGPL-3.0-or-later; тексты в `LICENSE` и `LICENSES/GPL-3.0.txt` (LGPL v3 опирается на GPL v3).
- **Альтернативы:** LGPL-2.1 (несовместима с GPLv3-only), MIT/Apache (не выбраны автором).
- **Последствия:** Rust линкует crates статически; при распространении бинарника с LGPL-кодом нужно
дать получателю возможность пересобрать его с изменённой библиотекой (исходники или объектные файлы).
Комбинация с Slint по GPLv3 даёт GPLv3 для бинарника GUI. Юристом не проверялось.
- **Ревизия:** до первой публикации бинарников.
## ADR-011 · Класс по размеру
- **Контекст:** метка `Text` на 5 МБ проходила по slow radio: класс заявлял отправитель.
- **Решение:** `TrafficClass::effective_for(bytes)`: Control > 256 Б → Text, Text > 4096 Б → Bulk;
`Bulk` не уменьшается. Применяется внутри `choose_path`, поэтому защищает всех вызывающих.
- **Последствия:** лимит Text совпадает с лимитом payload wire-кадра; пороги условные, их надо
подтвердить airtime-расчётом для реального радио (ADR-006).
## ADR-012 · Ёмкость линка
- **Контекст:** линк пропускал любое число сообщений параллельно, поэтому S4/H2/H4 были пустыми.
- **Решение:** на каждом линке календарь слотов; слот принадлежит сообщению; перепланирование
освобождает ещё не начатые слоты. Время передачи — `transfer_ms + HOP_OVERHEAD_MS` на hop.
- **Последствия:** задержка растёт с очередью, TTL может истечь из-за бэклога. Выбор пути пока не
учитывает бэклог, перепланирование начинает с источника — это записано как ограничение.

View file

@ -0,0 +1,44 @@
# Актуальная архитектура ICE-NET
## Инварианты
1. `NodeID` — стабильная криптографическая идентичность (будущая), не IP и не физическая координата.
2. `ServiceID` адресует сервис на узле; 64-битные значения — концепция, **не TCP-порты**.
3. Медленный канал (`SlowRadio`) допускает beacon, route-discovery и маленький текст, но не bulk.
Класс определяется **размером**, а не только меткой отправителя (Control ≤ 256 Б, Text ≤ 4096 Б).
4. Фото и файлы отправляются только если найден **разрешённый по политике** путь.
5. Отсутствие пути ≠ успешная доставка; статусы `Queued`, `InFlight`, `Delivered`, `Expired` различаются; `Delivered` только если маршрут жив.
6. End-to-end криптография обязательна для реальной сети, **в симуляторе пока не реализована**.
7. Сетевой слой существует независимо от транспорта (UDP/радиомодем/ethernet) и UI.
## Границы
```text
apps/icenet-city ───> icenet-sim ──> icenet-routing ──> icenet-core
apps/icenetd ───────> icenet-sim (offline-команды)
apps/icenetd ───────> icenet-sdk ───> icenet-wire / icenet-transport / icenet-guard
└──────────────> icenet-core
```
Актуальный список и точные зависимости: [crates.md](crates.md).
## Control plane / data plane
- **Control**: маленькие объявления, отметки доступности, поиск маршрутов, ACK; отдельный лимит airtime и TTL.
- **Data**: текст, файлы, сервисные потоки; расписание маршрутов с учётом профиля физического канала.
- В будущем LoRa может передавать экстренный текст, если это допускают местные правила.
- В сети неизвестных узлов объявления не должны бесконтрольно распространяться; нужны квоты, дедупликация, expire.
## Какую проблему изучаем
Не «мы изобрели mesh/IPv6/крипто-адреса», а:
**может ли строгая политика передачи по гетерогенным каналам избежать перегрузки узкой полосы,
сохранив доставку коротких сообщений и стабильную идентичность?**
Это гипотеза. Сравнивать надо с [Reticulum](../research/reticulum.md) и baselines.
## Важная разница между симуляцией и продакшеном
- Редактор города — модель графа со скоростью ребра, не радиотехнический расчёт покрытия.
- В нём нет настоящей криптографии, реального Wi-Fi, скрытых терминалов, интерференции, MAC.
- Числа в демо условны. Линк несёт одну передачу за раз, но потерь, коллизий и MAC нет. Для реального RF потребуется измерение или ns-3/другая PHY-модель.

50
docs/build/dependencies.md vendored Normal file
View file

@ -0,0 +1,50 @@
# Аудит зависимостей ICE-NET
Числа (записи `Cargo.lock`, версия Rust, результаты сборки и замеров) — только в
[STATUS.md](../STATUS.md). Здесь — решения и политика.
## Прямые внешние зависимости
| Уровень | Внешняя зависимость | Почему |
| --- | --- | --- |
| `icenet-core`, `wire`, `guard`, `routing`, `transport`, `sdk`, `sim` | нет | Алгоритмы и интерфейсы на `std` |
| `icenetd` | нет | CLI и UDP на `std::net` |
| `icenet-city` | `slint = 1.18.1` | Декларативный GUI |
| сборка `icenet-city` | `slint-build = 1.18.1` | Генерация Rust из `.slint` |
`slint` подключён с `default-features = false` и признаками `std`, `backend-winit`,
`renderer-software`, `compat-1-18`. Не включены Qt, Skia, FemtoVG, OpenGL, Vello, WGPU,
системный трей и интеграции. `renderer-software` не требует GPU, но `winit` зависит от
окружения рабочего стола. `slint-build` имеет собственный большой граф, который нельзя
убрать при заранее компилируемом UI. Меньшие флаги **не гарантируют** меньше транзитивных
зависимостей: число записей lock — не число скомпилированных crates.
## История
До v0.3 GUI был на `eframe`/`egui`. Он заменён на Slint; старый lock-файл не сохранён,
поэтому сравнение размера, RSS и старта с egui **невозможно** и снято с плана.
Инструкция по переходу — в архиве: [migration_egui_to_slint.md](../../archive/build/migration_egui_to_slint.md).
## Проверка
```bash
cd workspace
cargo tree -p icenet-city --depth 1
cargo clippy --workspace --all-targets -- -D warnings
cargo test --workspace
cargo build -p icenet-city --release
```
`Cargo.lock` нужно коммитить: workspace содержит исполняемые программы.
## Политика для новых crates
Перед добавлением библиотеки — отдельный ADR: какую задачу решает, почему нельзя на `std`,
MSRV, лицензия (совместимость с LGPL-3.0-or-later), число транзитивных crates, размер,
поддержка и план отказа. Не импортировать `serde`, `tokio`, `async-std`, `tracing`, `wgpu`,
`iced`, `egui` до замеров.
Источники:
- [Slint feature flags](https://docs.slint.dev/latest/docs/rust/slint/docs/cargo_features/)
- [Slint Winit backend](https://docs.slint.dev/latest/docs/slint/guide/backends-and-renderers/backend_winit/)
- [Slint Rust integration](https://docs.rs/slint/latest/slint/)

25
docs/build/slint_license.md vendored Normal file
View file

@ -0,0 +1,25 @@
# Лицензия Slint: решение до публичного релиза
Slint не MIT/Apache; это **тройное лицензирование**:
GPLv3, royalty-free с условиями и коммерческая лицензия.
- **GPLv3:** можно для открытого проекта, но совместное распространяемое
приложение должно соблюдать GPLv3.
- **Royalty-free:** для desktop/mobile/web, включая проприетарные приложения,
но с надлежащей атрибуцией Slint; не распространяется на embedded.
- **Коммерческая:** вариант для закрытого embedded или специальных требований.
Лицензия собственного кода ICE-NET — **LGPL-3.0-or-later** (ADR-010). Она совместима с GPLv3:
если `icenet-city` распространяется со Slint по GPLv3, бинарник GUI целиком идёт под GPLv3.
Если нужна иная схема (royalty-free с атрибуцией), её надо проверить отдельно. Юридически это
не проверялось.
Для ICE-NET: `icenet-city` — desktop GUI, а будущий роутер/LoRa-узел
не должен содержать Slint. Поэтому выбор лицензии GUI **отделён** от
сетевых библиотек. Условия не переносятся автоматически на независимые
библиотеки, но для связанного и распространяемого приложения обязательства
нужно проверить до публикации бинарников. Режим лицензии Slint для распространяемых бинарников GUI всё ещё **не выбран** (открытый пункт TODO).
Источники:
- [Официальный LICENSE Slint](https://github.com/slint-ui/slint/blob/master/LICENSE.md)
- [FAQ лицензирования](https://slint.dev/faqs)

View file

@ -0,0 +1,16 @@
# Community post draft (EN)
Hi! I'm experimenting with ICE-NET, a research-oriented Rust project inspired by
the Net of cyberpunk fiction: an identity-centric network that can span multiple underlying links, including
wired, IP, Wi-Fi, and low-bandwidth radio.
Our first falsifiable hypothesis is that a strict, measurable scheduling
policy can keep slow radio available for discovery and tiny messages while
sending bulk data only through appropriate higher-capacity paths.
This is currently a graph-based simulator and a set of protocol design notes,
not an operating wireless network. I'd love critical feedback on routing,
control-plane airtime, failure handling, and comparisons to Reticulum and
Meshtastic. Please suggest reproducible scenarios rather than feature lists.
Repository: https://git.wihuk.pro/boba/ICE-NET.git (LGPL-3.0-or-later).

View file

@ -0,0 +1,15 @@
# Черновик поста о проекте (RU)
Привет! Мы экспериментируем с ICE-NET — идеей сети, вдохновлённой «Сетью» из киберпанка, которая может работать через
разные виды связи, включая интернет, кабель, Wi-Fi и малоскоростное радио.
Цель первого опыта — проверить, можно ли гарантированно сохранять медленный
радиоканал для коротких сообщений и обнаружения узлов, направляя файлы только
через подходящие быстрые маршруты. Проект ещё на стадии симулятора на Rust,
а не развёрнутой радиосети.
Ищу обратную связь по routing/QoS, ограничению служебного трафика и тестам.
Особенно полезны критические сравнения с Reticulum, Meshtastic и существующими
планировщиками. Желателен конкретный сценарий или воспроизводимый тест.
Репозиторий: https://git.wihuk.pro/boba/ICE-NET.git (лицензия LGPL-3.0-or-later).

22
docs/guides/commands.md Normal file
View file

@ -0,0 +1,22 @@
# Шпаргалка команд
```bash
cd workspace
python3 tools/check_layout.py # file <=250 lines, dir <=4 files
cargo metadata --no-deps
cargo fmt --all -- --check
cargo clippy --workspace --all-targets -- -D warnings
cargo test --workspace
cargo run -p icenet-city
cargo run -p icenetd -- help
cargo run -p icenetd -- route --from 1 --to 3 --class bulk --size 5000000
cargo run -p icenetd -- send --from 1 --to 3 --class text --ticks 1000
cargo run -p icenetd -- sim --csv metrics.csv --json scenario.json
cargo run -p icenetd -- policy --service 77777 --size 5 --allow 1
cargo run -p icenetd -- wire-encode --service 7 --class text --text hello
cargo run -p icenetd -- serve --bind 127.0.0.1:9000 --count 1 --timeout 5000
cargo run -p icenetd -- send-udp --to 127.0.0.1:9000 --service 7 --class text --text hello
```
Пакеты в `crates/*` — библиотеки, `apps/*` — исполняемые приложения.
Cargo workspace использует общий `Cargo.lock` (коммитится) и закреплённый toolchain.

View file

@ -0,0 +1,18 @@
# Contributing conventions
- Feature branch: `feat/<short-name>`; fix: `fix/<short-name>`.
- PR начинается с проблемы и одного конкретного сценария, а не общих обещаний.
- Прежде чем добавлять crate, проверь зависимость и альтернативу module.
- Контракты в `docs/architecture/contracts.md`; тесты снаружи `src`.
- Публичные Rust элементы используют `///` doc comments на **английском**.
- Область изменения: краткая, отлаживаемая, 250 строк на файл максимум.
- До реального радио — legal review и тесты аппаратуры.
## Suggested PR template
- **What / Why:** одна конкретная проблема.
- **How:** какие crates и интерфейсы изменены.
- **Tests:** команды и результаты.
- **Metrics:** новые расходы CPU/RAM/airtime (если затронуты).
- **Security:** новые доверенные данные/границы.
- **Alternatives:** почему проще нельзя.

57
docs/guides/quickstart.md Normal file
View file

@ -0,0 +1,57 @@
# Arch Linux: быстрый запуск разработчика
## Установить инструменты
```bash
sudo pacman -S --needed rustup python git pkgconf clang
rustup default stable
rustup component add rustfmt clippy
```
Для GUI могут потребоваться системные библиотеки графического backend (X11/Wayland,
mesa, fontconfig и т.п.); точные пакеты зависят от Arch, X11/Wayland и версии Slint.
## Запуск
```bash
cd workspace
python3 tools/check_layout.py
cargo test -p icenet-routing -p icenet-sim
cargo run -p icenet-city
```
В окне: выбрать From/To, отправить `Text`/`Photo`, менять состояние линков,
шагать по времени. Это моделирование, не сетевое соединение.
## Отдельная библиотека
```bash
cargo test -p icenet-routing --test routing
cargo test -p icenet-sim --test city
cargo doc --workspace --no-deps
```
`icenetd` — headless CLI для проверки ядра без GUI и без сети:
```bash
cargo run -p icenetd -- route --from 1 --to 3 --class bulk --size 5000000
cargo run -p icenetd -- send --from 1 --to 3 --class text --ticks 1000
cargo run -p icenetd -- sim --csv /tmp/metrics.csv --json /tmp/scenario.json
```
Реальная UDP-передача между двумя процессами (локальный loopback, без crypto):
```bash
# терминал 1
cargo run -p icenetd -- serve --bind 127.0.0.1:9000 --count 1 --timeout 5000
# терминал 2
cargo run -p icenetd -- send-udp --to 127.0.0.1:9000 --service 7 --class text --text hello
```
Это незащищённый черновой кадр: без криптографии, аутентификации и защиты от replay на уровне сети.
## Примечание по версиям
`Slint 1.18.1` требует Rust >=1.92; toolchain закреплён в `rust-toolchain.toml` (версия — в [STATUS](../STATUS.md)).
Для ускоренной сборки не запускай `--workspace`, если сейчас тестируешь только
алгоритмы. Для релиза нужны полноценные CI-проверки всех crates и GUI.

42
docs/guides/testing.md Normal file
View file

@ -0,0 +1,42 @@
# Tests / CI
В Rust тесты лежат **только** в отдельной папке каждого крейта:
`crates/<name>/tests/*.rs` и `apps/<name>/tests/*.rs`. Inline `#[cfg(test)]` в `src` запрещён.
```bash
cd workspace
python3 tools/check_layout.py
cargo fmt --all -- --check
cargo clippy --workspace --all-targets -- -D warnings
cargo test --workspace
cargo doc --workspace --no-deps
```
## Пирамида
1. `core`: классы и логические ID.
2. `wire`: roundtrip + отказ на malformed frame / oversize.
3. `routing`: slow-only route for Text / forbidden for Bulk / oversized Text treated as Bulk / link-down.
4. `guard`: deny unknown service, cap payload, no fake authentication.
5. `sim`: node failure, in-flight state, queued retry, no false `Delivered` after a cut, link capacity (`tests/capacity/`).
6. `city`: GUI smoke test вручную (позднее snapshot/interaction integration tests).
## Приёмка
- Все новые тесты воспроизводимы без сети/радио.
- Каждый алгоритм не нуждается в реальном `sleep`; используется sim clock.
- При дефекте добавить regression test отдельно от production module.
- Маркеры `TODO`/`unimplemented!()` не прятать в ветки реальных пакетов.
Что проверено и сколько тестов проходит — в [STATUS](../STATUS.md).
## Быстрые и полные проверки
```bash
cd workspace
sh tools/check_all.sh # core routing/simulator, без Slint-сборки
sh tools/check_all.sh --full # также Slint GUI и все integration tests
```
`cargo fmt --all` форматирует в том числе GUI crate; `.slint` не проверяется
`rustfmt` и проверяется компилятором Slint в `build.rs`.

36
docs/research/gaps.md Normal file
View file

@ -0,0 +1,36 @@
# ICE-NET vs существующие стеки — гипотеза уникальной ценности
## Что НЕ уникально
- Не-IP идентификаторы, криптография, announce routing, transport-agnostic mesh;
всё это уже реализовано в Reticulum и смежных проектах.
- Узкополосная LoRa discovery и next-hop маршрутизация представлены в Meshtastic.
- Статические радио-мосты, Wi-Fi mesh, store-and-forward и DTN не новые технологии.
## Предлагаемая *исследовательская* функция
**Constrained Path Policy Engine (CPPE)** — единая проверяемая политика,
которая запрещает большой полезный трафик на slow-control интерфейсах,
сопоставляет классы сообщений с возможностями канала, допускает очереди при
partition и измеряет цену служебного discovery в airtime.
Это **не заявка на новизну**: ближайшие системы уже обладают частью этих функций;
эффект или удобство реализации должны быть доказаны экспериментами.
## Проверяемые гипотезы
- H1: bulk traffic не занимает slow-radio airtime при любом графе.
- H2: короткий текст достигает адресата, когда slow radio — единственный маршрут,
при условии допустимой загрузки канала.
- H3: смена link профилей/падение узла не создаёт ложного `DELIVERED`.
- H4: контрольный airtime и время поиска не растут неприемлемо при 100→1000 узлах.
## Baselines
1. Наивный shortest-hop.
2. Dijkstra по длине передачи/требуемому bitrate.
3. Reticulum с включёнными встроенными ограничениями/настройкой интерфейсов.
4. Meshtastic (узкая полоса, отдельный кейс, без попытки bulk).
Если не обнаружено измеримого преимущества или недостающего рабочего сценария:
не писать весь свой протокол, а сделать policy adapter / contribution.

View file

@ -0,0 +1,20 @@
# Правила лицензий и заимствований
- Нельзя копировать исходники Reticulum, считая их MIT или Apache: его лицензия
содержит специфические ограничения. См. [полный текст](https://github.com/markqvist/Reticulum/blob/master/LICENSE).
- Reticulum является полезным независимым проектом; это исследование **не** заявляет его несовместимым с любой иной лицензией без юридической проверки.
- Meshtastic firmware официально GPL-3.0: проверять условия распространения производных работ.
- Slint и другие Rust зависимости сверять по версиям, NOTICE и SPDX;
нельзя механически приписывать всем crates одну лицензию.
- Наша документация написана заново, исходники сторонних проектов в ZIP **не вложены**.
- Лицензия собственного кода: **LGPL-3.0-or-later** (решение автора, ADR-010). Код с несовместимой
лицензией (в том числе нестандартной лицензии Reticulum) в ICE-NET не копировать.
- LGPL и статическая линковка Rust: получатель бинарника должен иметь возможность пересобрать его с
изменённой библиотекой. Юридически не проверялось.
- Не использовать чужие эмблемы/названия так, будто проект официально поддержан.
## Рекомендация
На старте: изучение документации, самостоятельная реализация демонстрационного
графового алгоритма, инструментальные сравнительные тесты. Кодовые зависимости
выбирать после review лицензий и security advisories.

View file

@ -0,0 +1,29 @@
# Meshtastic: как устроена дальняя текстовая mesh-сеть
**Источник:** [официальный mesh algorithm](https://meshtastic.org/docs/overview/mesh-algo/).
- Фокус: LoRa, текст, телеметрия и локальные сообщения без сотовой инфраструктуры.
- В `2.6+` broadcast использует управляемое flooding; direct-message после
обнаружения направления может использовать next-hop, затем откатиться к flooding.
- Используется Protocol Buffers (`MeshPacket`).
- У Meshtastic есть реальные ограничения bandwidth, airtime и батареи.
- **Он не является транспортом больших фото и не совместим с Reticulum по пакету.**
## Что перенять
1. Безусловный лимит на размер/частоту широковещательных объявлений.
2. Разделение broadcast и directed routing.
3. Корректный ACK/дедуп и hop limit.
4. Реальные правила эфира региона до включения радиоплаты.
## Статус релизов
GitHub Releases в ноябре 2026 показывает **2.7.x Beta и 2.8.x Alpha**, часть
alpha помечена `Revoked`. Не устанавливать «latest» вслепую; выбирать
стабильный релиз, проверять совместимость и регион. [Список релизов](https://github.com/meshtastic/firmware/releases).
## Лицензии
Meshtastic — группа репозиториев с разными лицензиями; официальный firmware
указан как **GPL-3.0**. Перед переносом кода проверять конкретный репозиторий,
а не название экосистемы целиком: https://github.com/meshtastic

View file

@ -0,0 +1,31 @@
# Reticulum: что уже готово и чему учиться
**Источник:** [официальный manual](https://reticulum.network/manual/) (на 12.11.2026 отображается 1.6.0).
| Функция | Состояние у Reticulum | Вывод для ICE-NET |
|---|---|---|
| Не-IP идентичности | Есть, cryptographic addressing | не заявлять новизну |
| Multi-hop через разные среды | Есть | копировать идею, НЕ исходный код |
| Announce/path discovery | Есть | проверить baseline и стоимость пакетов |
| Interface discovery | Есть, включая private/encrypted announcements | большой пробел прежнего досье |
| QoS обычного трафика | В manual: обычные данные FIFO, без классов приоритета | возможная область исследований, не доказанное преимущество |
| Announce throttling / queue tuning | Есть | нельзя утверждать «нет контроля радиоэфира» |
| Передача файлов | Есть (`rncp`, Resources) | не изобретать ради галочки |
## Что тестировать руками
1. Две изолированные инстанции на localhost/UDP и transport node.
2. Смена интерфейса во время доступного маршрута.
3. Нагрузка на slow link: объявление + большой файл; измерить фактическое поведение.
4. Сверить с ограничениями Reticulum на rate, announce priority и interface modes.
5. Зафиксировать объективный пробел, а не предполагать его по обзору.
## Осторожно с лицензией!
[Reticulum License](https://github.com/markqvist/Reticulum/blob/master/LICENSE) — **нестандартная**;
включает дополнительные ограничения, включая запрет некоторых вредоносных
применений и использования кода для AI/ML training dataset. Её нельзя
автоматически считать MIT/Apache-2.0 или стандартной OSI-лицензией.
Изучать по документации можно; переносить код в ICE-NET без юридического
анализа нельзя. Официальный GitHub предупреждает о сторонних недостоверных
«совместимых» реализациях. Не объявлять wire-совместимость без тестов.

15
docs/review/questions.md Normal file
View file

@ -0,0 +1,15 @@
# Вопросы к автору ICE-NET (обсудить при следующем созвоне/чате)
1. **Главная функция:** исследуем constrained routing или хочешь полностью свой новый протокол независимо от сравнения?
2. **Городской GUI:** нужен только топологический граф или настоящий вид города с улицами/домами и RF-моделью?
3. **Основная роль устройств:** мобильные клиенты — только leaf или добровольное временное реле при зарядке?
4. **Идентичность:** один пользователь с несколькими устройствами — аккаунт, группа ключей или отдельные адреса?
5. **Радио:** какое разрешённое оборудование/страна первичного пилота? Без этой детали не подбирать частоты.
6. ~~Open-source: какая лицензия?~~ **Решено:** LGPL-3.0-or-later (ADR-010). Чужие источники по-прежнему не копировать.
7. **Сетевые сервисы:** первый полезный сценарий — текст, файл, remote SSH-like сервис или другое?
8. **Мобильная платформа:** Android первым или только Linux/Arch до готового desktop MVP?
9. **GUI:** достаточно 2D на Slint (сильно быстрее) или нужен 3D город (дороже и сложнее)?
10. **Скорость vs ресурсность:** какой предел RAM/CPU у самых слабых устройств?
**Не нужно отвечать сейчас на всё.** Для следующего этапа самый важный выбор:
пункт 1 и вид редактора из пункта 2.

57
docs/review/revision.md Normal file
View file

@ -0,0 +1,57 @@
# Что исправлено по внешней ревизии (18 страниц, 12.11.2026)
**Основание:** загруженный пользователем документ
`ICE-NET_ревизия_досье_и_план_реализации.pdf/docx`.
Документ оценил 35 старых файлов, выборочно проверил 10 свежих утверждений
и предложил дополнительные направления; утверждения ревизора не являются
автоматически окончательной спецификацией.
## Критика → решение v0.2
| Замечание | Ответ |
|---|---|
| Нет уникальной цели | отдельный [gaps.md](../research/gaps.md), H1–H4 |
| Много MD, нет кода | оформлен Cargo workspace, GUI и тесты; результаты проверок — в [STATUS](../STATUS.md) |
| Нет этапа 0 с Reticulum | отдельная P0 фаза в [TODO](../../TODO.md) |
| ICE Learning рискован | убран из MVP, [guard.md](../security/guard.md) |
| Нет mobile identity | открыто как ADR-008 |
| Нет экономической модели ретрансляторов | вынесено в [questions.md](questions.md) |
| Закон ограничен ЕС | по радиопередаче остаётся обязательная региональная проверка |
| Не зафиксированы API и тесты | [contracts.md](../architecture/contracts.md) + `workspace/*/tests/` |
| Нет выбора между своим протоколом/адаптером | ADR-007 открыт до полевых тестов |
## Важные поправки к самому обзору
- Фраза «телефоны не могут быть ретрансляторами» слишком категорична: Android может
участвовать в отдельных режимах, но непригоден как гарантированная магистраль 24/7.
- Цена и сроки железа оценочные; пользователь может стартовать с бюджетом ноль.
- Пример «городской mesh из смартфонов» не считается надёжным backbone.
## Что не делали
Не исполняли весь 30-дневный план; не проверяли по воздуху, не проводили аудит
безопасности. Этот документ — changelog решений, не сертификат готовности.
## v0.3 · Slint и минимальные зависимости
- GUI `eframe/egui` заменён на декларативный Slint; обновлены UI-модели и state-команды.
- Прямые внешние crates ограничены runtime `slint` и build-time `slint-build`.
- Rust domain crates изолированы и не используют сторонние пакеты.
- Проверка 250/4 не считает generated Cargo.lock / .gitignore, но считает `.slint`.
- Тесты добавлены отдельно; результаты `cargo test/fmt/clippy` — в [STATUS](../STATUS.md).
## v0.4 · Внутренний разбор симулятора и документации
Источник: самостоятельный разбор кода и доков 13.11.2026, не внешняя ревизия.
| Находка | Исправление |
| --- | --- |
| Крупный `tick` давал `Delivered` после обрыва маршрута | доставка требует живого маршрута; регрессионные тесты в `tests/city.rs` |
| Метка `Text` на 5 МБ шла по slow radio | класс выводится из размера (ADR-011) |
| Линк пропускал любую нагрузку параллельно | слоты эфира и очередь на ребре (ADR-012) |
| `seed` в доках, но не в коде | убран из доков; TODO снят; случайные отказы — отдельная задача |
| Store-and-forward отмечен готовым | галочка снята, оговорено в TODO и STATUS |
| Устаревшие утверждения, v0.2/egui, дублирование чисел | числа вынесены в [STATUS](../STATUS.md), остатки убраны |
| Нет git и лицензии | `git init`, LGPL-3.0-or-later (ADR-010) |
Не сделано: тела ADR-001…009, этап 0 с Reticulum, служебный трафик для H4.

12
docs/review/rf_notes.md Normal file
View file

@ -0,0 +1,12 @@
# Радиосвязь и физическая реальность
- LoRa дальнобойнее на малой скорости, но радиоканал разделяется соседями и
регулируется полосой/мощностью/duty cycle.
- Направленные Wi-Fi/микроволновые мосты позволяют высокий bitrate при прямой
видимости, правильной установке и соблюдении местных норм.
- Расстояние по RSSI не является надёжным измерением геопозиции.
- Провал маршрута нельзя исправить «умным алгоритмом», если нет физического пути.
- В первом GUI геометрия **иллюстративная**, а линк задаётся пользователем вручную.
Перед передачей в эфир проверить местные частоты, power/EIRP, duty cycle, DFS,
разрешения и условия для шифрованных данных. Пример региона не переносится на все страны.

35
docs/security/guard.md Normal file
View file

@ -0,0 +1,35 @@
# ICE Guard: маленькая предсказуемая защита
## До криптографии
В `icenet-guard` реализованы детерминированные локальные проверки:
1. Разрешён ли сервис (ACL).
2. Не превышен ли лимит размера payload.
3. Есть ли место в очереди (`queue_full`).
4. Replay window per peer по монотонному `sequence`.
5. Token bucket per peer (`rate_limited`, `0` отключает лимит).
6. Передан ли тестовый `authenticated` flag **(не реальное доказательство)**.
Проверка возвращает `Permit | Deny(reason)`. Отказ не расходует replay/rate state;
`sequence` фиксируется только после успешного `Permit`. Время передаёт вызывающий
код (`now_ms`), системные часы не читаются.
**Нельзя** считать `authenticated` защитой от подмены на реальной сети.
## После фиксации криптосхемы
- Проверка подписи/handshake + binding NodeID -> key.
- Replay window per sender/peer, ограничение памяти на окна и очереди.
- Rate limits per interface/per service/per peer.
- Неизвестные пути, ложные announce, Sybil, DoS, packet bombs.
- Автоматическое действие только: log, local drop, local rate-limit, local revoke.
## ICE Learning
Из MVP исключён. Возможно вернётся **после** накопления реальных логов и
оценки ложноположительных блокировок, как отдельное необязательное решение.
## Название
Не путать «ICE Guard» со стандартизированным IETF ICE (Interactive Connectivity Establishment).
Перед публичным релизом обсудить переименование внутреннего security crate.

18
docs/security/privacy.md Normal file
View file

@ -0,0 +1,18 @@
# Идентичность и приватность
Криптографический NodeID подтверждает владение ключом, **не личность человека**.
Список соседей и объявления о маршрутах могут раскрывать паттерны движения.
## Для дизайна
- Device identity отдельно от user identity (телефон + ПК — независимые ключи).
- Нужно заранее решить, разрешён ли общий «профиль» на нескольких устройствах.
- Защитить метаданные TTL, discovery frequency и route request patterns.
- У relay должен быть минимальный доступ к содержимому сообщений.
- Не хранить GPS/историю маршрутов по умолчанию без согласия владельца.
- Перед повторной отправкой с нарушенной связью не объявлять доставку.
## Не решено
Public-key derivation, key rotation, group membership, encrypted store-and-forward
и TTL-политика ещё не специфицированы. См. [вопросы](../review/questions.md).

View file

@ -0,0 +1,45 @@
# ICE-NET City Lab — интерактивный эмулятор города
## Назначение
Нативное окно Rust/Slint, где видны устройства и каналы связи.
Первый GUI не зависит от реальных IP-адресов и может работать **офлайн**.
## Возможности стартового каркаса
- Нарисовать карту/граф, добавлять устройства и связи, видеть названия и типы.
- Выбрать отправителя/получателя; отправить Text (малый) или Photo (Bulk).
- Выбрать роль нового узла (Client/Relay/Backbone) и тип линка; подсветить последний маршрут.
- Отключить/включить узел или ребро через боковую панель.
- Продвинуть симуляционное время вручную (Step), посмотреть Queued/Delivered/Expired.
- Изменить расположение устройств кликом/drag (проверено под X11/Xvfb).
- Посмотреть выбранный маршрут и базовый журнал доставки.
- Экспортировать `icenet-metrics.csv` и `icenet-scenario.json` кнопками в боковой панели.
## Не реализовано на старте
- Сценарии на 1000 узлов в GUI, загрузка сохранённого JSON обратно.
- Настоящее позиционирование по GPS/радиосигналу, физика Fresnel, beamforming.
- Моделирование interference, duty cycle, hidden terminals и настоящая передача файлов.
- Релеи через смартфоны и реальный интернет.
## Как использовать при разработке алгоритмов
1. Реализовать новый `choose_path` в `icenet-routing`.
2. Добавить тест в `crates/icenet-routing/tests/routing.rs`.
3. Запустить city lab; сравнить Text vs Bulk на одном графе.
4. Отключить быстрейшую связь; проверить корректный NO_ROUTE/QUEUED.
5. Зафиксировать seed/топологию в scenario и сравнить метрики.
**Критично:** рисовалка не должна выполнять маршрутизацию внутри `ui.update()`;
она передаёт запрос в `icenet-sim`, а рисует результат.
## Граница GUI (v0.3)
`ui/main.slint` показывает объекты из `VecModel`, фиксирует нажатия и drag.
`src/main.rs` регистрирует callback-обработчики, `src/state.rs` изменяет
`icenet-sim::City`, `src/view.rs` строит только визуальные модели.
Обработчик **не** рассчитывает маршруты сам; алгоритм остался в `icenet-routing`.
GUI на Slint собран и проверен под X11/Xvfb: узлы, линии, drag, переключение
устройств/линий и экспорт CSV/JSON. Полная проверка на Wayland-сессии — отдельный шаг.

View file

@ -0,0 +1,45 @@
# Simulation engine: contract
## Состояния сообщения
`Queued -> InFlight -> Delivered`; `InFlight -> Queued` при потере пригодного маршрута;
`Queued | InFlight -> Expired` по TTL. `Delivered` и `Expired` конечные.
- Есть `created_ms`, `expires_ms`, `first_route_ms`; `tick()` переводит просроченное сообщение в
`Expired` и больше не доставляет его.
- Прибытие в момент `due_ms <= expires_ms` — доставка, даже если один крупный шаг времени
перескочил оба дедлайна (`tests/ttl.rs`).
- **Ложный `Delivered` исключён.** Изменения топологии происходят между тиками, поэтому топология
в `tick` держалась весь интервал. Доставка требует, чтобы все узлы маршрута были online, каждый
линк включён, соединял нужные узлы и допускал класс. Иначе сообщение перепланируется или встаёт
в `Queued` (`tests/city.rs`).
## Ёмкость линка
- На каждом линке календарь слотов эфира. Hop занимает `transfer_ms(bytes) + HOP_OVERHEAD_MS`.
- Резервирование идёт по порядку отправки; следующий слот начинается не раньше конца предыдущего,
а освободившиеся промежутки могут быть заняты. `due_ms` включает ожидание в очереди.
- Перепланирование освобождает ещё не начатые слоты сообщения; уже начатый airtime считается
потраченным. Истёкшее или потерявшее путь сообщение тоже освобождает будущие слоты.
- Выбор пути **не** учитывает бэклог, а перепланирование начинает с источника — ограничения.
- Метрики: `City::link_airtime_ms(kind)`, `City::link_backlog_ms(index)`, `slow_radio_airtime_ms`.
## События будущей DES
Сейчас время идёт шагами `tick`; полноценной очереди событий нет. План:
| Event | Поля |
| --- | --- |
| `Announce` | node_id, iface, ttl |
| `LinkUp/LinkDown` | link_id, now_ms |
| `Send` | source, dest, bytes, traffic_class |
| `HopFinished` | message_id, hop_index |
| `Ack` | message_id, kind |
| `QueueExpire` | message_id, ttl |
## Детерминизм
- Одинаковые сценарий и последовательность действий дают одинаковый результат бит-в-бит
(случайности нет; **`seed` не реализован**).
- Ни один core алгоритм не вызывает `SystemTime` напрямую.
- GUI не ускоряет модель при изменении частоты кадров.

32
docs/simulator/metrics.md Normal file
View file

@ -0,0 +1,32 @@
# Метрики и честность моделирования
Цифры измерений — только в [STATUS](../STATUS.md).
## Минимальный набор
| Метрика | Смысл | Метод |
| --- | --- | --- |
| Delivery ratio | доставлено / создано | считать только `Delivered` |
| `first_route_ms` p50/p95 | **абсолютная** метка симулированного времени первого пути | не задержка: вычитания `created_ms` пока нет |
| Control airtime | эфир, занятый сообщениями класса Control по их маршрутам | сумма `transfer_ms + HOP_OVERHEAD_MS` по hop |
| `slow_radio_airtime_ms` | эфир, зарезервированный на slow radio всеми сообщениями | календарь слотов линков |
| Задержка поиска пути | реальное время CPU Dijkstra | `Instant` в `tests/scale.rs`, **debug**, не симуляция |
| RAM | реальная память процесса | procfs/OS вне симуляции; на 1000 узлов не измерено |
`icenet_sim::metrics` считает состояния, delivery ratio, перцентили и airtime.
`messages_csv` и `scenario_json` дают детерминированный экспорт.
## Условия воспроизводимости
- Источник кода/commit, дата, топология, link profile, последовательность действий.
- Отдельно записать версию Rust и OS. `seed` не нужен, пока в модели нет случайности.
- Минимум 3 сценария: пустой эфир, заполненный эфир, отключение backbone.
- Изменённые параметры должны сохраняться в сценарии, не в GUI state.
## Ограничения
Время доставки учитывает последовательность hop и очередь на линке, но **не** включает
коллизии, hidden terminals, duty cycle, retransmission, FEC, TCP congestion control, радиолокацию,
OS scheduling и стоимость crypto. Выбор пути не знает о бэклоге.
Нельзя из такого графа делать заявления «реальная сеть быстрее Reticulum».

View file

@ -0,0 +1,34 @@
# Сценарии для City Lab и регрессионных тестов
## S1 · LoRa discovery, Wi-Fi photo
- A — клиент, B — реле, C — друг.
- A–B: SlowRadio, A–C: FastWireless, B–C: SlowRadio.
- Text A→C может идти напрямую или через B по метрике.
- Photo A→C **только** fast link; при отключении A–C фото QUEUED.
## S2 · Городские две магистрали
- 12 узлов: 8 клиентов, 2 relay, 2 backbone.
- У каждой магистрали резервное беспроводное ребро.
- Bulk идёт по fast сегментам, контрольные объявления лимитируются на slow.
## S3 · Partition/merge
- Граф из двух районов, между ними 1 bridge.
- После отключения bridge новые сообщения `Queued`, не `Delivered`.
- При восстановлении моста очередь переходит к доставке.
## S4 · Злая нагрузка
- 100 текстовых сообщений + 1 фото 5 MiB при медленном LoRa.
- Проверить, что фото не блокирует канал discovery: `slow_radio_airtime_ms` не содержит фото.
- Очередь на slow-линке растёт, часть текстов может истечь по TTL (`tests/capacity/`).
- Метрики: control airtime, бэклог линка, p95 поиска. Квоты control пока не реализованы.
## S5 · Повторяемость
- Одинаковый начальный граф и последовательность действий → одинаковые результаты и CSV.
- Случайных отказов и `seed` пока нет; когда появятся, seed обязан входить в сценарий.
Не смешивать с реальными RF-измерениями. [Подробнее о метриках](metrics.md).