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)
47 lines
3.7 KiB
Markdown
47 lines
3.7 KiB
Markdown
# 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).
|