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

48 lines
4.3 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 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 может истечь из-за бэклога. Выбор пути пока не
учитывает бэклог, перепланирование начинает с источника — это записано как ограничение.