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