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

3.7 KiB
Raw Blame History

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, а не бездумно делить ещё мельче. См. аудит.