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.
68 lines
5.5 KiB
Markdown
68 lines
5.5 KiB
Markdown
# Сетевой режим (план)
|
||
|
||
Цель: физика может считаться не на машине зрителя. Один авторитетный сервер ведёт
|
||
симуляцию, к нему подключаются клиенты: смотреть с разных углов, управлять, позже —
|
||
редактировать. Текущая модульность это допускает: `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`.
|