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)
3.7 KiB
3.7 KiB
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-контракты и симулятор.
Зависимости и границы UI
icenet-city — только адаптер интерфейса. Slint UI в ui/main.slint;
src/state.rs изменяет City; src/view.rs конвертирует данные в модели;
src/main.rs подключает callbacks. В остальные crates не импортируется Slint.
Все 7 библиотек намеренно разделены по обязанностям, все без внешних crates (числа — в STATUS). Если эти границы перестанут приносить пользу, нужно объединить crates по ADR, а не бездумно делить ещё мельче. См. аудит.