fabrilis/docs/NETWORK.md
loki5512344 93075ab1fd
Some checks failed
ci / check (macos-latest) (push) Has been cancelled
ci / check (ubuntu-latest) (push) Has been cancelled
ci / check (windows-latest) (push) Has been cancelled
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.
2026-11-16 23:34:05 +01:00

5.5 KiB
Raw Blame History

Сетевой режим (план)

Цель: физика может считаться не на машине зрителя. Один авторитетный сервер ведёт симуляцию, к нему подключаются клиенты: смотреть с разных углов, управлять, позже — редактировать. Текущая модульность это допускает: 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: C5 — тот же headless-бинарник.

Разрез работ

  1. S1 — headless-сервер. Тот же мир без окна, тикает по часам, пишет метрики.
  2. S2 — снапшоты по сети. Один клиент подключается на localhost и рисует мир, полученный от сервера, без локальной физики.
  3. S3 — несколько клиентов. Два-три наблюдателя с разными камерами, сервер рассылает одно состояние; проверка, что картинки согласованы.
  4. S4 — ввод. Один клиент управляет телом, остальные видят результат; подтверждение ввода и отказ при разрыве.
  5. S5 — интернет и устойчивость. Сжатие, дельты, переподключение, лимиты, аутентификация по токену.

DoD S3: headless-сервер, два клиента на разных машинах/окнах, камеры независимы, состояние совпадает, разрыв одного клиента не роняет остальных.

Открытые вопросы

  • Транспорт: TCP сейчас или сразу QUIC.
  • Частота снапшотов и бюджет полосы на эталонной сцене.
  • Нужен ли предсказанный ввод или достаточно 50–100 мс задержки для наблюдения.
  • Кто владеет управлением: один клиент, очередь, или серверный сценарий.
  • Интерес-менеджмент: весь мир или только область вокруг камеры.
  • Где живёт сервер: отдельный бинарник fabrilis-server или подкоманда app.