Add design persistence, world rendering, metrics overlay and logs

M3: STL/OBJ import with mesh validation, mass/COM/inertia, material database, RON scene with content-addressed blobs and v0->v1 migration. M4: deterministic heightmap terrain, trimesh colliders, wgpu renderer with instancing and depth, winit app with 1 kHz physics, fly camera, on-screen metrics overlay and per-frame CSV/dev logs. Docs: UI, logging, network and headless CLI plans.
This commit is contained in:
Loki 2026-11-16 23:34:05 +01:00
parent 878d144b77
commit 190ef9cc4b
111 changed files with 14801 additions and 63 deletions

68
docs/NETWORK.md Normal file
View file

@ -0,0 +1,68 @@
# Сетевой режим (план)
Цель: физика может считаться не на машине зрителя. Один авторитетный сервер ведёт
симуляцию, к нему подключаются клиенты: смотреть с разных углов, управлять, позже —
редактировать. Текущая модульность это допускает: `core` уже даёт снимки и
планировщик, `render` рисует по состоянию, `app` — точка сборки.
## Роли
| Роль | Что делает |
|---|---|
| **Server** | headless, авторитетная симуляция 1 кГц, снапшоты, приём ввода |
| **Client** | окно, рендер, камера, отправка ввода, интерполяция между снапшотами |
| **Observer** | клиент только на чтение: смотрит, не управляет |
| **Editor** | позже: правки конструкции как команды серверу, не прямой доступ к состоянию |
## Модель
1. Сервер тикает фиксированным шагом и остаётся единственным источником истины.
2. Клиенты **не симулируют авторитетное состояние**. Они получают снапшоты и
интерполируют между двумя последними; рендер не влияет на сервер.
3. Ввод идёт с номером последовательности; сервер применяет его на ближайшем шаге
и подтверждает. Один клиент — владелец управления, остальные наблюдатели.
4. Снапшот — уже существующий набор подснимков (COUPLING.md), сжатый и, позже,
дельтами от базового. Частота снапшотов 20–60 Гц; шаг физики от неё не зависит.
5. Для своего управления позже возможны предсказание и откат: только если
детерминизм D1/D2 подтверждён, иначе клиент показывает подтверждённое состояние.
## Транспорт
Начинаем с TCP + собственный фрейминг (длина, версия, тип сообщения) на localhost и
в LAN. QUIC/WebTransport — отдельное решение, когда понадобится интернет и
мобильные клиенты. Формат сообщений версионируется как файлы (STORAGE.md);
несовпадение версий — понятная ошибка, а не тихое расхождение.
## Что уже есть и чего не хватает
Есть: `Snapshot`/подснимки, `SimTime`, `Fidelity`, детерминированный планировщик,
`render` по состоянию, слои crate'ов.
Не хватает: сериализация снапшотов в сетевой формат, серверный бинарник без окна,
клиентский цикл интерполяции, канал ввода, интерес-менеджмент по камере,
аутентификация и права.
Серверная часть пересекается с [CLI.md](CLI.md): C5 — тот же headless-бинарник.
## Разрез работ
1. **S1 — headless-сервер.** Тот же мир без окна, тикает по часам, пишет метрики.
2. **S2 — снапшоты по сети.** Один клиент подключается на localhost и рисует мир,
полученный от сервера, без локальной физики.
3. **S3 — несколько клиентов.** Два-три наблюдателя с разными камерами, сервер
рассылает одно состояние; проверка, что картинки согласованы.
4. **S4 — ввод.** Один клиент управляет телом, остальные видят результат;
подтверждение ввода и отказ при разрыве.
5. **S5 — интернет и устойчивость.** Сжатие, дельты, переподключение, лимиты,
аутентификация по токену.
**DoD S3:** headless-сервер, два клиента на разных машинах/окнах, камеры независимы,
состояние совпадает, разрыв одного клиента не роняет остальных.
## Открытые вопросы
- Транспорт: TCP сейчас или сразу QUIC.
- Частота снапшотов и бюджет полосы на эталонной сцене.
- Нужен ли предсказанный ввод или достаточно 50–100 мс задержки для наблюдения.
- Кто владеет управлением: один клиент, очередь, или серверный сценарий.
- Интерес-менеджмент: весь мир или только область вокруг камеры.
- Где живёт сервер: отдельный бинарник `fabrilis-server` или подкоманда `app`.