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