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

3.3 KiB
Raw Blame History

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