Initial import: ICE-NET research docs and Rust workspace (v0.4)
Some checks failed
rust-ci / checks (push) Has been cancelled
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:
commit
2e61688eb3
141 changed files with 13993 additions and 0 deletions
84
docs/INDEX.md
Normal file
84
docs/INDEX.md
Normal 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
38
docs/SOURCES.md
Normal 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
67
docs/STATUS.md
Normal 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).
|
||||
44
docs/architecture/contracts.md
Normal file
44
docs/architecture/contracts.md
Normal 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 — только тестовый флаг,
|
||||
**не криптографическая проверка**.
|
||||
47
docs/architecture/crates.md
Normal file
47
docs/architecture/crates.md
Normal 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).
|
||||
48
docs/architecture/decisions.md
Normal file
48
docs/architecture/decisions.md
Normal 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 может истечь из-за бэклога. Выбор пути пока не
|
||||
учитывает бэклог, перепланирование начинает с источника — это записано как ограничение.
|
||||
44
docs/architecture/overview.md
Normal file
44
docs/architecture/overview.md
Normal 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
50
docs/build/dependencies.md
vendored
Normal 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
25
docs/build/slint_license.md
vendored
Normal 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)
|
||||
16
docs/community/announcement_en.md
Normal file
16
docs/community/announcement_en.md
Normal 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).
|
||||
15
docs/community/announcement_ru.md
Normal file
15
docs/community/announcement_ru.md
Normal 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
22
docs/guides/commands.md
Normal 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.
|
||||
18
docs/guides/contributing.md
Normal file
18
docs/guides/contributing.md
Normal 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
57
docs/guides/quickstart.md
Normal 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
42
docs/guides/testing.md
Normal 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
36
docs/research/gaps.md
Normal 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.
|
||||
20
docs/research/licensing.md
Normal file
20
docs/research/licensing.md
Normal 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.
|
||||
29
docs/research/meshtastic.md
Normal file
29
docs/research/meshtastic.md
Normal 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
|
||||
31
docs/research/reticulum.md
Normal file
31
docs/research/reticulum.md
Normal 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
15
docs/review/questions.md
Normal 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
57
docs/review/revision.md
Normal 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
12
docs/review/rf_notes.md
Normal 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
35
docs/security/guard.md
Normal 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
18
docs/security/privacy.md
Normal 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).
|
||||
45
docs/simulator/city_editor.md
Normal file
45
docs/simulator/city_editor.md
Normal 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-сессии — отдельный шаг.
|
||||
45
docs/simulator/event_model.md
Normal file
45
docs/simulator/event_model.md
Normal 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
32
docs/simulator/metrics.md
Normal 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».
|
||||
34
docs/simulator/scenarios.md
Normal file
34
docs/simulator/scenarios.md
Normal 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).
|
||||
Loading…
Add table
Add a link
Reference in a new issue