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