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:
parent
79928b645b
commit
93075ab1fd
107 changed files with 14785 additions and 46 deletions
68
docs/NETWORK.md
Normal file
68
docs/NETWORK.md
Normal 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`.
|
||||
Loading…
Add table
Add a link
Reference in a new issue