Initial import: ICE-NET research docs and Rust workspace (v0.4)
Some checks failed
rust-ci / checks (push) Has been cancelled
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:
commit
2e61688eb3
141 changed files with 13993 additions and 0 deletions
50
docs/build/dependencies.md
vendored
Normal file
50
docs/build/dependencies.md
vendored
Normal 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
25
docs/build/slint_license.md
vendored
Normal 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)
|
||||
Loading…
Add table
Add a link
Reference in a new issue