ICE-NET/docs/architecture/overview.md
loki5512344 2e61688eb3
Some checks failed
rust-ci / checks (push) Has been cancelled
Initial import: ICE-NET research docs and Rust workspace (v0.4)
- 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)
2026-11-13 12:28:48 +01:00

44 lines
3.7 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Актуальная архитектура 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-модель.