Initial import: ICE-NET research docs and Rust workspace (v0.4)
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)
This commit is contained in:
Loki 2026-11-13 12:28:48 +01:00
commit 2e61688eb3
Signed by: boba
GPG key ID: 6CDE87BC9A778D97
141 changed files with 13993 additions and 0 deletions

View file

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