ICE-NET/archive/project/governance/decisions.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

4 KiB
Raw Permalink Blame History

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 для разных типов данных.