first cycle lab release

server/README.md

@@ -0,0 +1,30 @@
+# Local server
+
+Этот каталог — source server configuration и прежний Phase 0 Compose.
+Lifecycle полного релиза использует `scripts/server.sh` и Compose из самого
+релиза; настройка описана в [docs/runtime.md](../docs/runtime.md).
+
+`compose.yaml` — проверенный runtime NeoForge через локальный `.mrpack`.
+Image закреплён в `toolchain.lock.env`, который загружает wrapper
+`scripts/spike-server.sh`. Данные находятся в `runtime/`, артефакты
+монтируются read-only из `dist/`. Порт публикуется только на IPv4 loopback.
+Онлайн-проверка аккаунтов отключена согласно требованиям проекта.
+
+`server.properties` создаётся image из Compose environment. Отдельный
+source-файл не используется: иначе параметры получили бы двух владельцев.
+Секреты и локальные настройки — в игнорируемом `.env`; публичные defaults —
+в `.env.example`. Самостоятельное принятие EULA обязательно на новом host.
+
+Для overrides скопировать `compose.override.yaml.example` в
+`compose.override.yaml`, добавить нужные настройки в `server/config/` и
+передать слой явно:
+
+```bash
+scripts/spike-server.sh -f server/compose.override.yaml config --quiet
+scripts/spike-server.sh -f server/compose.override.yaml up -d --wait --wait-timeout 600
+```
+
+Override заменяет соответствующие runtime-конфиги при запуске. Текущий
+`server/config/spike-marker.txt` — тестовый пример; основной Compose его
+не применяет. `compose.spike-override.yaml` сохранён для воспроизведения
+Phase 0. Автоматические backup/deploy/rollback появятся в следующих фазах.