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)
45 lines
3.3 KiB
Markdown
45 lines
3.3 KiB
Markdown
# ICE-NET City Lab — интерактивный эмулятор города
|
||
|
||
## Назначение
|
||
|
||
Нативное окно Rust/Slint, где видны устройства и каналы связи.
|
||
Первый GUI не зависит от реальных IP-адресов и может работать **офлайн**.
|
||
|
||
## Возможности стартового каркаса
|
||
|
||
- Нарисовать карту/граф, добавлять устройства и связи, видеть названия и типы.
|
||
- Выбрать отправителя/получателя; отправить Text (малый) или Photo (Bulk).
|
||
- Выбрать роль нового узла (Client/Relay/Backbone) и тип линка; подсветить последний маршрут.
|
||
- Отключить/включить узел или ребро через боковую панель.
|
||
- Продвинуть симуляционное время вручную (Step), посмотреть Queued/Delivered/Expired.
|
||
- Изменить расположение устройств кликом/drag (проверено под X11/Xvfb).
|
||
- Посмотреть выбранный маршрут и базовый журнал доставки.
|
||
- Экспортировать `icenet-metrics.csv` и `icenet-scenario.json` кнопками в боковой панели.
|
||
|
||
## Не реализовано на старте
|
||
|
||
- Сценарии на 1000 узлов в GUI, загрузка сохранённого JSON обратно.
|
||
- Настоящее позиционирование по GPS/радиосигналу, физика Fresnel, beamforming.
|
||
- Моделирование interference, duty cycle, hidden terminals и настоящая передача файлов.
|
||
- Релеи через смартфоны и реальный интернет.
|
||
|
||
## Как использовать при разработке алгоритмов
|
||
|
||
1. Реализовать новый `choose_path` в `icenet-routing`.
|
||
2. Добавить тест в `crates/icenet-routing/tests/routing.rs`.
|
||
3. Запустить city lab; сравнить Text vs Bulk на одном графе.
|
||
4. Отключить быстрейшую связь; проверить корректный NO_ROUTE/QUEUED.
|
||
5. Зафиксировать seed/топологию в scenario и сравнить метрики.
|
||
|
||
**Критично:** рисовалка не должна выполнять маршрутизацию внутри `ui.update()`;
|
||
она передаёт запрос в `icenet-sim`, а рисует результат.
|
||
|
||
## Граница GUI (v0.3)
|
||
|
||
`ui/main.slint` показывает объекты из `VecModel`, фиксирует нажатия и drag.
|
||
`src/main.rs` регистрирует callback-обработчики, `src/state.rs` изменяет
|
||
`icenet-sim::City`, `src/view.rs` строит только визуальные модели.
|
||
Обработчик **не** рассчитывает маршруты сам; алгоритм остался в `icenet-routing`.
|
||
|
||
GUI на Slint собран и проверен под X11/Xvfb: узлы, линии, drag, переключение
|
||
устройств/линий и экспорт CSV/JSON. Полная проверка на Wayland-сессии — отдельный шаг.
|