aboutsummaryrefslogtreecommitdiff
path: root/docs/specs/network.md
diff options
context:
space:
mode:
authorValentin Popov <valentin@popov.link>2026-02-19 10:07:04 +0300
committerValentin Popov <valentin@popov.link>2026-02-19 10:07:04 +0300
commit0d7ae6a017b8b2bf26c5c14c39cb62b599e8262d (patch)
tree6398ba4a13d22656af75395db6de2e4f84d6c875 /docs/specs/network.md
parenta281ffa32ea615670d369503692f057b2dc60e6f (diff)
downloadfparkan-0d7ae6a017b8b2bf26c5c14c39cb62b599e8262d.tar.xz
fparkan-0d7ae6a017b8b2bf26c5c14c39cb62b599e8262d.zip
Документирование и обновление спецификаций
- Обновлены спецификации `runtime-pipeline`, `sound`, `terrain-map-loading`, `texture`, `ui` и `wear`. - Добавлены разделы о статусе покрытия и оставшихся задачах для достижения 100% завершенности. - Внесены уточнения по архитектурным ролям, минимальным контрактам и требованиям к toolchain для каждой подсистемы. - Уточнены форматы данных и правила взаимодействия между компонентами системы.
Diffstat (limited to 'docs/specs/network.md')
-rw-r--r--docs/specs/network.md27
1 files changed, 25 insertions, 2 deletions
diff --git a/docs/specs/network.md b/docs/specs/network.md
index 1950e8a..9411c34 100644
--- a/docs/specs/network.md
+++ b/docs/specs/network.md
@@ -1,5 +1,28 @@
# Network system
-Документ описывает сетевую подсистему: протокол обмена, синхронизацию состояния и сетевую архитектуру (client-server/P2P).
+`Network` — подсистема синхронизации состояния игры между узлами (мультиплеер/обмен состоянием).
-> Статус: в работе. Спецификация будет дополняться по мере реверс-инжиниринга `Net.dll`.
+## 1. Роль
+
+1. Транспортирует игровые события и state-delta.
+2. Синхронизирует критичные объекты мира и таймеры.
+3. Обеспечивает согласованность simulation между участниками.
+
+## 2. Минимальный контракт для 1:1
+
+1. Детеминированная сериализация сетевых сообщений.
+2. Согласованная обработка порядка/потерь/повторов пакетов.
+3. Единая политика authority и коррекции расхождений.
+
+## 3. Статус покрытия и что осталось до 100%
+
+Закрыто:
+
+- определено место сетевого слоя в общей архитектуре движка.
+
+Осталось:
+
+1. Полная спецификация wire-протокола (header, message types, payload layout).
+2. Полный контракт handshake/session lifecycle.
+3. Формальные правила resync/rollback/correction.
+4. Набор сетевых parity-тестов на контролируемой потере/задержке.