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

68 lines
5.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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