golem15/summercms
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(02): resolve parity proxy port split

Browse Source
This commit is contained in:
Jakub Zych
2026-09-16 16:27:50 +02:00
parent 9368a18530
commit a109b52ec6
2 changed files with 4 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
.planning/phases/02-api-parity-harness-bootstrap/02-CONTEXT.md
View File

@@ -21,7 +21,7 @@ Not in this phase: any ported endpoint (Phase 3 ports the first one), the OpenAP
### Recording strategy
- **D-01:** Two capture paths, both producing the same fixture format. A recording reverse proxy (`summer parity:proxy`) sits in front of the PHP backend on `:8422`; the Nuxt dev app (`NUXT_DEV_BACKEND_ORIGIN`) and the MCP server (`FONOTEKA_API_URL`) are pointed at it and real sessions are recorded as ordered flows. A scripted runner (`summer parity:record`) drives a route manifest to guarantee coverage of all 154 routes, including error cases (404, 422, 401, 423, throttled).
- **D-02:** Recordings are made against a local PHP backend (`php artisan serve --port=8422`) on a fresh database holding a small deterministic parity dataset. Never against the developer's ad-hoc dev database and never against production.
- **D-02:** Recordings are made against a local PHP backend (`php artisan serve --host=127.0.0.1 --port=8423`) on a fresh database holding a small deterministic parity dataset. The recording proxy binds `127.0.0.1:8422`, and Nuxt/MCP point to that proxy. Never record against the developer's ad-hoc dev database or production. The user confirmed this port split during planning on 2026-09-16.
- **D-03:** The parity dataset is created through the PHP API itself in a recorded seed flow (onboarding bootstrap, register, login, create collection, albums, artists, genres, styles, invitations, personal tokens, and so on). Only what the API cannot create (backend admin user, OAuth client via the existing `oauth-client` artisan command) uses artisan. No seeder code is added to the PHP repo; the PHP originals stay untouched.
- **D-04:** The recorder and replayer are `summer parity:proxy`, `summer parity:record` and `summer parity:replay` commands implemented on the Phase 1 `bonfire` command interface, not a standalone binary and not `go test` env-var switches. Phase 2 waits for Phase 1's command kernel.