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

50
docs/build/dependencies.md vendored Normal file
View file

@ -0,0 +1,50 @@
# Аудит зависимостей ICE-NET
Числа (записи `Cargo.lock`, версия Rust, результаты сборки и замеров) — только в
[STATUS.md](../STATUS.md). Здесь — решения и политика.
## Прямые внешние зависимости
| Уровень | Внешняя зависимость | Почему |
| --- | --- | --- |
| `icenet-core`, `wire`, `guard`, `routing`, `transport`, `sdk`, `sim` | нет | Алгоритмы и интерфейсы на `std` |
| `icenetd` | нет | CLI и UDP на `std::net` |
| `icenet-city` | `slint = 1.18.1` | Декларативный GUI |
| сборка `icenet-city` | `slint-build = 1.18.1` | Генерация Rust из `.slint` |
`slint` подключён с `default-features = false` и признаками `std`, `backend-winit`,
`renderer-software`, `compat-1-18`. Не включены Qt, Skia, FemtoVG, OpenGL, Vello, WGPU,
системный трей и интеграции. `renderer-software` не требует GPU, но `winit` зависит от
окружения рабочего стола. `slint-build` имеет собственный большой граф, который нельзя
убрать при заранее компилируемом UI. Меньшие флаги **не гарантируют** меньше транзитивных
зависимостей: число записей lock — не число скомпилированных crates.
## История
До v0.3 GUI был на `eframe`/`egui`. Он заменён на Slint; старый lock-файл не сохранён,
поэтому сравнение размера, RSS и старта с egui **невозможно** и снято с плана.
Инструкция по переходу — в архиве: [migration_egui_to_slint.md](../../archive/build/migration_egui_to_slint.md).
## Проверка
```bash
cd workspace
cargo tree -p icenet-city --depth 1
cargo clippy --workspace --all-targets -- -D warnings
cargo test --workspace
cargo build -p icenet-city --release
```
`Cargo.lock` нужно коммитить: workspace содержит исполняемые программы.
## Политика для новых crates
Перед добавлением библиотеки — отдельный ADR: какую задачу решает, почему нельзя на `std`,
MSRV, лицензия (совместимость с LGPL-3.0-or-later), число транзитивных crates, размер,
поддержка и план отказа. Не импортировать `serde`, `tokio`, `async-std`, `tracing`, `wgpu`,
`iced`, `egui` до замеров.
Источники:
- [Slint feature flags](https://docs.slint.dev/latest/docs/rust/slint/docs/cargo_features/)
- [Slint Winit backend](https://docs.slint.dev/latest/docs/slint/guide/backends-and-renderers/backend_winit/)
- [Slint Rust integration](https://docs.rs/slint/latest/slint/)

25
docs/build/slint_license.md vendored Normal file
View file

@ -0,0 +1,25 @@
# Лицензия Slint: решение до публичного релиза
Slint не MIT/Apache; это **тройное лицензирование**:
GPLv3, royalty-free с условиями и коммерческая лицензия.
- **GPLv3:** можно для открытого проекта, но совместное распространяемое
приложение должно соблюдать GPLv3.
- **Royalty-free:** для desktop/mobile/web, включая проприетарные приложения,
но с надлежащей атрибуцией Slint; не распространяется на embedded.
- **Коммерческая:** вариант для закрытого embedded или специальных требований.
Лицензия собственного кода ICE-NET — **LGPL-3.0-or-later** (ADR-010). Она совместима с GPLv3:
если `icenet-city` распространяется со Slint по GPLv3, бинарник GUI целиком идёт под GPLv3.
Если нужна иная схема (royalty-free с атрибуцией), её надо проверить отдельно. Юридически это
не проверялось.
Для ICE-NET: `icenet-city` — desktop GUI, а будущий роутер/LoRa-узел
не должен содержать Slint. Поэтому выбор лицензии GUI **отделён** от
сетевых библиотек. Условия не переносятся автоматически на независимые
библиотеки, но для связанного и распространяемого приложения обязательства
нужно проверить до публикации бинарников. Режим лицензии Slint для распространяемых бинарников GUI всё ещё **не выбран** (открытый пункт TODO).
Источники:
- [Официальный LICENSE Slint](https://github.com/slint-ui/slint/blob/master/LICENSE.md)
- [FAQ лицензирования](https://slint.dev/faqs)