ICE-NET/docs/architecture/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.3 KiB
Raw Permalink Blame History

ADR register

ADR Решение Статус
ADR-001 Userland Rust вместо Linux kernel fork Принято для MVP
ADR-002 Slow control / fast bulk policy Принято как гипотеза
ADR-003 Rust workspace + отдельные integration tests Принято
ADR-004 Город — графовая DES-модель, не RF-доказательство Принято
ADR-005 Slint 1.18.1 + software renderer для native GUI (egui удалён) Принято в v0.3
ADR-006 Реальная криптография, wire-format, физические драйверы Открыто
ADR-007 Свой полноценный протокол или адаптер к Reticulum Открыто до экспериментов
ADR-008 Общая идентичность человека на нескольких устройствах Открыто
ADR-009 TTL и явное состояние EXPIRED для недоставленных сообщений Принято в v0.3
ADR-010 Лицензия собственного кода: LGPL-3.0-or-later Принято (автор проекта)
ADR-011 Класс трафика выводится из размера, метка не доверена Принято в v0.4
ADR-012 Ёмкость линка: слоты эфира с владельцем, очередь на ребре Принято в v0.4

Для каждого нового ADR

Описание контекста → альтернативы → причины выбора → проверяемые последствия → риски → срок ревизии.

Запрещено объявлять открытые ADR реализованными в README.

ADR-010 · Лицензия: LGPL-3.0-or-later

  • Контекст: автор выбрал LGPL; репозиторий не имел лицензии.
  • Решение: LGPL-3.0-or-later; тексты в LICENSE и LICENSES/GPL-3.0.txt (LGPL v3 опирается на GPL v3).
  • Альтернативы: LGPL-2.1 (несовместима с GPLv3-only), MIT/Apache (не выбраны автором).
  • Последствия: Rust линкует crates статически; при распространении бинарника с LGPL-кодом нужно дать получателю возможность пересобрать его с изменённой библиотекой (исходники или объектные файлы). Комбинация с Slint по GPLv3 даёт GPLv3 для бинарника GUI. Юристом не проверялось.
  • Ревизия: до первой публикации бинарников.

ADR-011 · Класс по размеру

  • Контекст: метка Text на 5 МБ проходила по slow radio: класс заявлял отправитель.
  • Решение: TrafficClass::effective_for(bytes): Control > 256 Б → Text, Text > 4096 Б → Bulk; Bulk не уменьшается. Применяется внутри choose_path, поэтому защищает всех вызывающих.
  • Последствия: лимит Text совпадает с лимитом payload wire-кадра; пороги условные, их надо подтвердить airtime-расчётом для реального радио (ADR-006).

ADR-012 · Ёмкость линка

  • Контекст: линк пропускал любое число сообщений параллельно, поэтому S4/H2/H4 были пустыми.
  • Решение: на каждом линке календарь слотов; слот принадлежит сообщению; перепланирование освобождает ещё не начатые слоты. Время передачи — transfer_ms + HOP_OVERHEAD_MS на hop.
  • Последствия: задержка растёт с очередью, TTL может истечь из-за бэклога. Выбор пути пока не учитывает бэклог, перепланирование начинает с источника — это записано как ограничение.