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)
40 lines
4 KiB
Markdown
40 lines
4 KiB
Markdown
# ADR: журнал архитектурных решений
|
||
|
||
Правило: изменение большого решения оформляем как новый ADR с мотивацией, альтернативами и критериями пересмотра.
|
||
|
||
## ADR-001: транспорт-независимые адреса (предложено)
|
||
**Решение:** Node ID = стабильный криптографический идентификатор, физический адрес = временный маршрут.
|
||
**Причина:** адрес должен работать при переходе с UDP на локальное радио.
|
||
**Риск:** метаданные и ротация ключей; см. [privacy](../../security/crypto_privacy.md).
|
||
|
||
## ADR-002: управление ≠ передача больших файлов (предложено)
|
||
**Решение:** discovery имеет минимальный общий интерфейс и строгие эфирные лимиты, а крупные payload допускаются только при наличии подходящего канала.
|
||
**Причина:** не забивать LoRa фотографиями.
|
||
**Исключение:** добровольная отложенная пересылка малых chunks при отсутствии альтернативы и явных квотах.
|
||
|
||
## ADR-003: CPU-only ICE Guard (предложено)
|
||
**Решение:** детерминированное ядро правил, FSM, счётчики, token bucket и маленькая классификация без обязательной нейросети.
|
||
**Причина:** работает на слабых процессорах и поддаётся аудиту.
|
||
**Риск:** ложные блокировки, data poisoning; см. [security](../../security/ice_engine.md).
|
||
|
||
## 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 для разных типов данных.
|