ICE-NET/docs/simulator/city_editor.md
loki5512344 2e61688eb3
Some checks failed
rust-ci / checks (push) Has been cancelled
Initial import: ICE-NET research docs and Rust workspace (v0.4)
- 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)
2026-11-13 12:28:48 +01:00

45 lines
3.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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-сессии — отдельный шаг.