docs: every change goes live right away

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Fabian @ Blax Software 2026-10-28 20:30:52 +01:00
parent 65cd7cd333
commit 4fa6b46f62
1 changed files with 11 additions and 0 deletions

View File

@ -43,6 +43,17 @@ Local: `https://server-village.localhost.at` (HTTP), `wss://ws-server-village.lo
On Windows without Docker, the tests run on a user-local PHP 8.4 (the image's version) and Composer in `%LOCALAPPDATA%\Programs\php84`: `vendor/bin/pest` and `vendor/bin/pint` (SQLite in memory, per phpunit.xml). The WS server needs `pcntl`, so it only runs on Linux. On Windows without Docker, the tests run on a user-local PHP 8.4 (the image's version) and Composer in `%LOCALAPPDATA%\Programs\php84`: `vendor/bin/pest` and `vendor/bin/pint` (SQLite in memory, per phpunit.xml). The WS server needs `pcntl`, so it only runs on Linux.
## Finishing a change
Every change ends live, right away: the user wants each change on the URL as soon as it is done, not batched. The user has authorized this for this project: deploying the game's containers on edgerealm needs no further go-ahead.
1. `vendor/bin/pest` and `vendor/bin/pint --test` pass.
2. Commit (small, one concern each) and push to `origin master`.
3. Run `scripts/deploy-edgerealm.sh`. Done when it prints `Live: https://server-village.blax.at at <commit>`.
4. Name the live commit in the reply. If the frontend needs the change too, deploy it right after (see its CLAUDE.md).
The authorization covers only `/mnt/HC_Volume_102040804/srv/game-village-politics-backend`, `/mnt/HC_Volume_102040804/srv/game-village-politics-frontend` and their containers. Everything else on edgerealm (a host shared with customer sites) still needs the user's go-ahead.
## Deploy ## Deploy
The backend runs on edgerealm at `https://server-village.blax.at` (HTTP) and `wss://ws-server-village.blax.at/app/village-politics` (WS), from `/mnt/HC_Volume_102040804/srv/game-village-politics-backend` with containers `app`, `mysql` and `redis` on the shared `web` network. `deploy.sh` runs there: pull, composer install, migrate, seed the worlds, optimize, restart the WS server and worker. The first run creates `.env` from `.env.example` with generated secrets. The backend runs on edgerealm at `https://server-village.blax.at` (HTTP) and `wss://ws-server-village.blax.at/app/village-politics` (WS), from `/mnt/HC_Volume_102040804/srv/game-village-politics-backend` with containers `app`, `mysql` and `redis` on the shared `web` network. `deploy.sh` runs there: pull, composer install, migrate, seed the worlds, optimize, restart the WS server and worker. The first run creates `.env` from `.env.example` with generated secrets.