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

40 lines
4 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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