ICE-NET/docs/architecture/crates.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

47 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.

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