aboutsummaryrefslogtreecommitdiff
path: root/docs/specs/arealmap.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/arealmap.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/arealmap.md')
-rw-r--r--docs/specs/arealmap.md30
1 files changed, 28 insertions, 2 deletions
diff --git a/docs/specs/arealmap.md b/docs/specs/arealmap.md
index cac2743..3b234c9 100644
--- a/docs/specs/arealmap.md
+++ b/docs/specs/arealmap.md
@@ -1,5 +1,31 @@
# ArealMap
-Документ описывает формат и структуру карты мира: зоны/сектора, координаты, размещение объектов и связь с terrain и миссиями.
+`ArealMap` — подсистема топологии мира и логических зон.
-> Статус: в работе. Спецификация будет дополняться по мере реверс-инжиниринга `ArealMap.dll`.
+Подробный бинарный формат `Land.map` и связь с terrain описаны в:
+
+- [Terrain + ArealMap](terrain-map-loading.md)
+
+## 1. Роль в движке
+
+1. Хранит ареалы, связи между ареалами и клеточный индекс.
+2. Используется для навигации, логики объектов и AI-решений.
+3. Связывает геометрию карты с миссионной и поведенческой логикой.
+
+## 2. Минимальный runtime-контракт
+
+1. Валидный граф ареалов и edge-link связей.
+2. Валидная cell-grid индексация (`cellsX/cellsY` + hit lists).
+3. Согласованные идентификаторы ареалов для AI/Behavior/Missions.
+
+## 3. Статус покрытия и что осталось до 100%
+
+Закрыто:
+
+- бинарный контракт `Land.map` и pair-загрузка с `Land.msh`.
+
+Осталось:
+
+1. Полная доменная семантика `class_id`/`logic_flag` по всем игровым сценариям.
+2. Формальная спецификация API-запросов к ArealMap (поиск зон, фильтры, события).
+3. Набор parity-тестов поведения навигационных запросов на одинаковых входах.