- 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)
4 KiB
ADR: журнал архитектурных решений
Правило: изменение большого решения оформляем как новый ADR с мотивацией, альтернативами и критериями пересмотра.
ADR-001: транспорт-независимые адреса (предложено)
Решение: Node ID = стабильный криптографический идентификатор, физический адрес = временный маршрут.
Причина: адрес должен работать при переходе с UDP на локальное радио.
Риск: метаданные и ротация ключей; см. privacy.
ADR-002: управление ≠ передача больших файлов (предложено)
Решение: discovery имеет минимальный общий интерфейс и строгие эфирные лимиты, а крупные payload допускаются только при наличии подходящего канала.
Причина: не забивать LoRa фотографиями.
Исключение: добровольная отложенная пересылка малых chunks при отсутствии альтернативы и явных квотах.
ADR-003: CPU-only ICE Guard (предложено)
Решение: детерминированное ядро правил, FSM, счётчики, token bucket и маленькая классификация без обязательной нейросети.
Причина: работает на слабых процессорах и поддаётся аудиту.
Риск: ложные блокировки, data poisoning; см. security.
ADR-004: без форка ядра на MVP (принято для прототипа)
Решение: пользовательский процесс на Linux + сменные adapters.
Причина: меньшая цена эксперимента, легче тестировать и переносить.
ADR-005: заимствуем принципы, а не копируем чужой протокол (принято для исследований)
Решение: сравнительный анализ Reticulum, DTN, Babel, libp2p и других; юридический аудит лицензий перед использованием кода.
Причина: безопасность и лицензионная чистота.
ADR-006: нет активных атак «в ответ» (принято для модели безопасности)
Решение: ICE может локально прекратить обмен, уменьшить rate, потребовать повторную аутентификацию, изолировать ключ и сообщить владельцу, но не взламывает чужой узел.
ADR-007: глобальное радио — цель, а не свойство MVP
Решение: первая версия гибридная, но каждый компонент может работать без центральной инфраструктуры там, где есть физическая связность.
Открытые ADR
- Выбор длины Node ID: полный 256-битный ключевой hash vs сокращённые идентификаторы и риск коллизий.
- Дискавери: proactive annonces vs on-demand поиск, различная политика для LoRa/backhaul.
- Домашние relay по opt-in, лимиты энергии и доверия.
- Приватная адресная книга vs глобальный каталог сервисов.
- Фрагментация, окна подтверждений и разные TTL для разных типов данных.