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

32
docs/simulator/metrics.md Normal file
View file

@ -0,0 +1,32 @@
# Метрики и честность моделирования
Цифры измерений — только в [STATUS](../STATUS.md).
## Минимальный набор
| Метрика | Смысл | Метод |
| --- | --- | --- |
| Delivery ratio | доставлено / создано | считать только `Delivered` |
| `first_route_ms` p50/p95 | **абсолютная** метка симулированного времени первого пути | не задержка: вычитания `created_ms` пока нет |
| Control airtime | эфир, занятый сообщениями класса Control по их маршрутам | сумма `transfer_ms + HOP_OVERHEAD_MS` по hop |
| `slow_radio_airtime_ms` | эфир, зарезервированный на slow radio всеми сообщениями | календарь слотов линков |
| Задержка поиска пути | реальное время CPU Dijkstra | `Instant` в `tests/scale.rs`, **debug**, не симуляция |
| RAM | реальная память процесса | procfs/OS вне симуляции; на 1000 узлов не измерено |
`icenet_sim::metrics` считает состояния, delivery ratio, перцентили и airtime.
`messages_csv` и `scenario_json` дают детерминированный экспорт.
## Условия воспроизводимости
- Источник кода/commit, дата, топология, link profile, последовательность действий.
- Отдельно записать версию Rust и OS. `seed` не нужен, пока в модели нет случайности.
- Минимум 3 сценария: пустой эфир, заполненный эфир, отключение backbone.
- Изменённые параметры должны сохраняться в сценарии, не в GUI state.
## Ограничения
Время доставки учитывает последовательность hop и очередь на линке, но **не** включает
коллизии, hidden terminals, duty cycle, retransmission, FEC, TCP congestion control, радиолокацию,
OS scheduling и стоимость crypto. Выбор пути не знает о бэклоге.
Нельзя из такого графа делать заявления «реальная сеть быстрее Reticulum».