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

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-модель.