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

15
docs/review/questions.md Normal file
View file

@ -0,0 +1,15 @@
# Вопросы к автору ICE-NET (обсудить при следующем созвоне/чате)
1. **Главная функция:** исследуем constrained routing или хочешь полностью свой новый протокол независимо от сравнения?
2. **Городской GUI:** нужен только топологический граф или настоящий вид города с улицами/домами и RF-моделью?
3. **Основная роль устройств:** мобильные клиенты — только leaf или добровольное временное реле при зарядке?
4. **Идентичность:** один пользователь с несколькими устройствами — аккаунт, группа ключей или отдельные адреса?
5. **Радио:** какое разрешённое оборудование/страна первичного пилота? Без этой детали не подбирать частоты.
6. ~~Open-source: какая лицензия?~~ **Решено:** LGPL-3.0-or-later (ADR-010). Чужие источники по-прежнему не копировать.
7. **Сетевые сервисы:** первый полезный сценарий — текст, файл, remote SSH-like сервис или другое?
8. **Мобильная платформа:** Android первым или только Linux/Arch до готового desktop MVP?
9. **GUI:** достаточно 2D на Slint (сильно быстрее) или нужен 3D город (дороже и сложнее)?
10. **Скорость vs ресурсность:** какой предел RAM/CPU у самых слабых устройств?
**Не нужно отвечать сейчас на всё.** Для следующего этапа самый важный выбор:
пункт 1 и вид редактора из пункта 2.

57
docs/review/revision.md Normal file
View file

@ -0,0 +1,57 @@
# Что исправлено по внешней ревизии (18 страниц, 12.11.2026)
**Основание:** загруженный пользователем документ
`ICE-NET_ревизия_досье_и_план_реализации.pdf/docx`.
Документ оценил 35 старых файлов, выборочно проверил 10 свежих утверждений
и предложил дополнительные направления; утверждения ревизора не являются
автоматически окончательной спецификацией.
## Критика → решение v0.2
| Замечание | Ответ |
|---|---|
| Нет уникальной цели | отдельный [gaps.md](../research/gaps.md), H1–H4 |
| Много MD, нет кода | оформлен Cargo workspace, GUI и тесты; результаты проверок — в [STATUS](../STATUS.md) |
| Нет этапа 0 с Reticulum | отдельная P0 фаза в [TODO](../../TODO.md) |
| ICE Learning рискован | убран из MVP, [guard.md](../security/guard.md) |
| Нет mobile identity | открыто как ADR-008 |
| Нет экономической модели ретрансляторов | вынесено в [questions.md](questions.md) |
| Закон ограничен ЕС | по радиопередаче остаётся обязательная региональная проверка |
| Не зафиксированы API и тесты | [contracts.md](../architecture/contracts.md) + `workspace/*/tests/` |
| Нет выбора между своим протоколом/адаптером | ADR-007 открыт до полевых тестов |
## Важные поправки к самому обзору
- Фраза «телефоны не могут быть ретрансляторами» слишком категорична: Android может
участвовать в отдельных режимах, но непригоден как гарантированная магистраль 24/7.
- Цена и сроки железа оценочные; пользователь может стартовать с бюджетом ноль.
- Пример «городской mesh из смартфонов» не считается надёжным backbone.
## Что не делали
Не исполняли весь 30-дневный план; не проверяли по воздуху, не проводили аудит
безопасности. Этот документ — changelog решений, не сертификат готовности.
## v0.3 · Slint и минимальные зависимости
- GUI `eframe/egui` заменён на декларативный Slint; обновлены UI-модели и state-команды.
- Прямые внешние crates ограничены runtime `slint` и build-time `slint-build`.
- Rust domain crates изолированы и не используют сторонние пакеты.
- Проверка 250/4 не считает generated Cargo.lock / .gitignore, но считает `.slint`.
- Тесты добавлены отдельно; результаты `cargo test/fmt/clippy` — в [STATUS](../STATUS.md).
## v0.4 · Внутренний разбор симулятора и документации
Источник: самостоятельный разбор кода и доков 13.11.2026, не внешняя ревизия.
| Находка | Исправление |
| --- | --- |
| Крупный `tick` давал `Delivered` после обрыва маршрута | доставка требует живого маршрута; регрессионные тесты в `tests/city.rs` |
| Метка `Text` на 5 МБ шла по slow radio | класс выводится из размера (ADR-011) |
| Линк пропускал любую нагрузку параллельно | слоты эфира и очередь на ребре (ADR-012) |
| `seed` в доках, но не в коде | убран из доков; TODO снят; случайные отказы — отдельная задача |
| Store-and-forward отмечен готовым | галочка снята, оговорено в TODO и STATUS |
| Устаревшие утверждения, v0.2/egui, дублирование чисел | числа вынесены в [STATUS](../STATUS.md), остатки убраны |
| Нет git и лицензии | `git init`, LGPL-3.0-or-later (ADR-010) |
Не сделано: тела ADR-001…009, этап 0 с Reticulum, служебный трафик для H4.

12
docs/review/rf_notes.md Normal file
View file

@ -0,0 +1,12 @@
# Радиосвязь и физическая реальность
- LoRa дальнобойнее на малой скорости, но радиоканал разделяется соседями и
регулируется полосой/мощностью/duty cycle.
- Направленные Wi-Fi/микроволновые мосты позволяют высокий bitrate при прямой
видимости, правильной установке и соблюдении местных норм.
- Расстояние по RSSI не является надёжным измерением геопозиции.
- Провал маршрута нельзя исправить «умным алгоритмом», если нет физического пути.
- В первом GUI геометрия **иллюстративная**, а линк задаётся пользователем вручную.
Перед передачей в эфир проверить местные частоты, power/EIRP, duty cycle, DFS,
разрешения и условия для шифрованных данных. Пример региона не переносится на все страны.