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,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).