Files
crr-tools/apps/tournament/README.md
T
jfmcarreira 561b6a2da9
App checks / changes (push) Canceled after 0s
App checks / tournament (push) Canceled after 0s
App checks / shifts (push) Canceled after 0s
feat: monorepo migration phase 3
2026-10-07 11:38:43 +01:00

62 lines
3.0 KiB
Markdown

# Tournament
The FastAPI backend lives in `backend/app`, with app-specific SQLAlchemy models,
Alembic history, Pydantic schemas, domain services and routers. Vue continues to
use `src/client` and `src/shared` with its existing `/api/...` contract. The final
frontend directory move and removal of retired TypeScript server sources are
tracked as cleanup work in the migration plan.
Shared CRR assets and CSS come from `packages/crr-brand` through Vite's
`@crr-brand` alias. Tokens/base/components load before `src/client/styles.css`;
the app owns its responsive layout and print-card dimensions. Vite's public
asset directory uses the canonical package, including the favicon.
From the repository root:
```sh
make tournament-install
make tournament-test
make tournament-build
make tournament-backend-dev
# In another terminal:
make tournament-frontend-dev
```
Copy `apps/tournament/.env.example` to `apps/tournament/.env` and configure
`ADMIN_PASSWORD` and `SESSION_SECRET`. Uvicorn listens on port 8080 and Vite
on 5173. Development data is stored in `apps/tournament/tournament.sqlite`.
Use consistent `APP_BASE_PATH` and `VITE_BASE_PATH`; `/jogo/` remains the example
deployment prefix, while both support `/`.
```sh
docker compose up --build tournament
```
Compose loads `apps/tournament/.env`; `TOURNAMENT_BASE_PATH` in the root shell
controls both the frontend build path and backend path (default `/jogo/`). The
`tournament-data` volume contains `/data/tournament.sqlite`. The image is
`crr-tournament`; app version `1.0.0` is recorded in the frontend package and
backend project metadata. The image builds Vue with Node 22 and runs Python 3.13
as UID/GID 1000, matching the old container's database ownership.
Tests require Node 22+ and uv. `make tournament-test` runs backend pytest,
frontend/shared tests, Vue typechecking and the preserved legacy compatibility
assertions against actual Python services and HTTP/SSE servers. Those assertions
live in `migration/contracts`; their transports are generated only in ignored
`.migration/` staging. CI uses Node 22/Python 3.13 and does not execute snapshots.
Node backend dependencies (Fastify, better-sqlite3 and Zod) have been removed.
## Existing SQLite data
Startup upgrades empty databases with Alembic. Pre-Alembic databases are validated
against all nine legacy tables, columns, defaults, checks, unique/index definitions
and foreign keys before being stamped at `0001_baseline`. Adoption preserves
their schema and rows; there is no export/import. An incompatible schema stops
startup before stamping. SQLite foreign keys, WAL and a 5000 ms busy timeout are
configured on every connection. Migration/stamp operations are transactional.
Keep `SESSION_SECRET` unchanged during cut-over so existing HMAC/base64url admin
sessions remain valid. Cookie name/path, HttpOnly, Strict SameSite, HTTPS behavior
and seven-day lifetime are preserved. `TRUST_PROXY` controls forwarded headers.
Deployments under `/jogo/` retain the legacy proxy-prefix stripping behavior.