570 lines
41 KiB
Markdown
570 lines
41 KiB
Markdown
# CRR Apps Monorepo Migration Plan
|
|
|
|
## Fixed decisions
|
|
|
|
- One monorepo, two independently deployable applications.
|
|
- Python 3.13 for both backends.
|
|
- FastAPI + SQLAlchemy 2 + Alembic + Pydantic.
|
|
- `uv` + `pyproject.toml` with one root `uv.lock`.
|
|
- Tournament keeps its Vue 3 frontend and its existing `/api/...` contract.
|
|
- Shifts remains server-rendered with Jinja.
|
|
- Auth models remain app-specific; only proven low-level helpers may be shared later.
|
|
- Separate SQLite databases and separate Alembic histories.
|
|
- Separate Docker images and independent app versions/releases.
|
|
- Shared CRR branding, not shared domain models.
|
|
- CI builds/tests only affected apps and packages that can affect them.
|
|
|
|
## Original source baseline
|
|
|
|
All migration work is sourced from the untouched legacy code under `originals/`:
|
|
|
|
```text
|
|
originals/
|
|
├── tournment-manager-web/
|
|
└── crr-shifts/
|
|
```
|
|
|
|
The file map and later sections retain the original proposal's source labels.
|
|
Resolve `original/tournament-manager/` to `originals/tournment-manager-web/` and
|
|
`original/crr-shifts/` to `originals/crr-shifts/` in this workspace. These are path
|
|
aliases only; do not rename the snapshots. Verified progress is recorded in
|
|
`migration/README.md`.
|
|
|
|
Rules for `originals/`:
|
|
|
|
- Treat it as read-only reference source throughout the migration.
|
|
- Never move, rename, delete, reformat or update files in `originals/` as part of the migration.
|
|
- New monorepo code is created by copying, porting or rewriting from `originals/...` into `apps/...` and `packages/...`.
|
|
- Behaviour/compatibility checks compare the migrated app against the corresponding code in `originals/`.
|
|
- Runtime code must never import from `originals/`.
|
|
- Add `originals/` to the root `.dockerignore` so legacy sources are not sent into Docker build contexts.
|
|
- CI path filters do not build/deploy from `originals/`; it exists only as the migration baseline.
|
|
|
|
## Target repository
|
|
|
|
```text
|
|
crr-apps/
|
|
├── .dockerignore
|
|
├── .gitignore
|
|
├── .python-version # 3.13
|
|
├── AGENTS.md # repository-wide rules only
|
|
├── README.md
|
|
├── Makefile
|
|
├── compose.yaml
|
|
├── pyproject.toml # uv workspace only
|
|
├── pyrightconfig.json
|
|
├── uv.lock
|
|
│
|
|
├── original/ # read-only legacy baseline
|
|
│ ├── tournament-manager/
|
|
│ └── crr-shifts/
|
|
│
|
|
├── apps/
|
|
│ ├── tournament/
|
|
│ │ ├── .env.example
|
|
│ │ ├── AGENTS.md
|
|
│ │ ├── Dockerfile
|
|
│ │ ├── README.md
|
|
│ │ ├── backend/
|
|
│ │ │ ├── alembic.ini
|
|
│ │ │ ├── pyproject.toml
|
|
│ │ │ ├── app/
|
|
│ │ │ │ ├── __init__.py
|
|
│ │ │ │ ├── config.py
|
|
│ │ │ │ ├── database.py
|
|
│ │ │ │ ├── errors.py
|
|
│ │ │ │ ├── events.py
|
|
│ │ │ │ ├── main.py
|
|
│ │ │ │ ├── models/
|
|
│ │ │ │ ├── routers/
|
|
│ │ │ │ │ ├── auth.py
|
|
│ │ │ │ │ ├── public.py
|
|
│ │ │ │ │ └── admin/
|
|
│ │ │ │ │ ├── settings.py
|
|
│ │ │ │ │ ├── display.py
|
|
│ │ │ │ │ ├── groups.py
|
|
│ │ │ │ │ ├── teams.py
|
|
│ │ │ │ │ ├── calendar.py
|
|
│ │ │ │ │ ├── matches.py
|
|
│ │ │ │ │ └── final_stage.py
|
|
│ │ │ │ ├── schemas/
|
|
│ │ │ │ ├── security/
|
|
│ │ │ │ │ ├── session.py
|
|
│ │ │ │ │ └── rate_limit.py
|
|
│ │ │ │ └── services/
|
|
│ │ │ │ ├── bracket.py
|
|
│ │ │ │ ├── calendar.py
|
|
│ │ │ │ ├── classification.py
|
|
│ │ │ │ └── state.py
|
|
│ │ │ ├── migrations/
|
|
│ │ │ │ └── versions/
|
|
│ │ │ │ └── 0001_baseline.py
|
|
│ │ │ └── tests/
|
|
│ │ └── frontend/
|
|
│ │ ├── index.html
|
|
│ │ ├── package.json
|
|
│ │ ├── package-lock.json
|
|
│ │ ├── tsconfig.json
|
|
│ │ ├── vite.config.ts
|
|
│ │ └── src/
|
|
│ │
|
|
│ └── shifts/
|
|
│ ├── .env.example
|
|
│ ├── AGENTS.md
|
|
│ ├── Dockerfile
|
|
│ ├── README.md
|
|
│ ├── docs/
|
|
│ └── backend/
|
|
│ ├── alembic.ini
|
|
│ ├── pyproject.toml
|
|
│ ├── app/
|
|
│ │ ├── __init__.py
|
|
│ │ ├── cli.py
|
|
│ │ ├── config.py
|
|
│ │ ├── database.py
|
|
│ │ ├── i18n.py
|
|
│ │ ├── main.py
|
|
│ │ ├── models/
|
|
│ │ ├── routers/
|
|
│ │ │ ├── auth.py
|
|
│ │ │ ├── account.py
|
|
│ │ │ ├── calendar.py
|
|
│ │ │ ├── dashboard.py
|
|
│ │ │ ├── exports.py
|
|
│ │ │ ├── swaps.py
|
|
│ │ │ └── admin/
|
|
│ │ │ ├── teams.py
|
|
│ │ │ ├── users.py
|
|
│ │ │ ├── schedules.py
|
|
│ │ │ ├── assignments.py
|
|
│ │ │ └── notifications.py
|
|
│ │ ├── security/
|
|
│ │ ├── services/
|
|
│ │ ├── static/
|
|
│ │ └── templates/
|
|
│ ├── migrations/
|
|
│ └── tests/
|
|
│
|
|
└── packages/
|
|
├── crr-brand/
|
|
│ ├── README.md
|
|
│ ├── assets/
|
|
│ │ ├── logo.png
|
|
│ │ └── favicon.png
|
|
│ └── styles/
|
|
│ ├── tokens.css
|
|
│ ├── base.css
|
|
│ └── components.css
|
|
│
|
|
└── crr-python/
|
|
├── README.md
|
|
├── pyproject.toml
|
|
└── src/crr_common/
|
|
└── __init__.py
|
|
```
|
|
|
|
`crr-python` starts intentionally small. Do not extract helpers just because two apps use Python. Extract code only after both apps have the same concrete need.
|
|
|
|
## Common backend conventions
|
|
|
|
Both backends should use the same structural rules even where code is not shared:
|
|
|
|
- `config.py`: Pydantic Settings only.
|
|
- `database.py`: engine/session wiring and app-specific migration startup.
|
|
- `models/`: persistence only; no HTTP concerns.
|
|
- `schemas/`: request/response models where JSON APIs exist.
|
|
- `routers/`: HTTP orchestration and dependency checks, kept thin.
|
|
- `services/`: deterministic/domain operations.
|
|
- `security/`: app-specific authentication primitives.
|
|
- `tests/`: mirrors services/routers and tests observable behaviour.
|
|
- SQLAlchemy 2-style `select()` and typed `Mapped[...]` models.
|
|
- Alembic owns schema creation/evolution; no schema DDL embedded in application startup code.
|
|
|
|
### Tournament JSON compatibility
|
|
|
|
The Python rewrite must preserve the existing Vue contract exactly:
|
|
|
|
- Same route paths and HTTP methods.
|
|
- Same status codes.
|
|
- Same `{ "error": "..." }` error shape and, where tests depend on them, the same Portuguese error messages.
|
|
- Same camelCase JSON field names. Python uses snake_case internally and Pydantic aliases at the API boundary.
|
|
- Same `tournament_admin_session` cookie name, path semantics, `HttpOnly`, `SameSite=Strict`, secure behaviour and seven-day lifetime.
|
|
- Reproduce the current HMAC-SHA256/base64url session token format so sessions survive the backend cut-over when `SESSION_SECRET` is unchanged.
|
|
- Keep the 5-failures/15-minute in-memory login limiter semantics.
|
|
- Keep `/api/public/events` as notification-only SSE: initial `retry: 3000`, 25-second heartbeat, and `state-changed` event with `{"type":"state-changed"}`.
|
|
- Preserve `APP_BASE_PATH`/`VITE_BASE_PATH` sub-path deployment behaviour.
|
|
|
|
## Tournament database migration
|
|
|
|
The existing SQLite file must be usable without export/import.
|
|
|
|
1. Model the existing tables exactly in SQLAlchemy first: `tournament_settings`, `display_settings`, `league_groups`, `teams`, `players`, `league_matches`, `final_seeds`, `final_match_results`, `league_rounds`, including current checks/indexes/FKs.
|
|
2. `0001_baseline.py` creates that exact schema for a new empty database.
|
|
3. Startup checks for an existing pre-Alembic database. If tables exist but `alembic_version` does not, validate the expected table/column set and **stamp** `0001_baseline` instead of running the create migration.
|
|
4. Empty databases run `alembic upgrade head` normally.
|
|
5. Keep SQLite `foreign_keys=ON`, WAL mode and `busy_timeout=5000` via SQLAlchemy connection events.
|
|
6. Add a test that copies a database produced by the current Node application, starts the Python application, and verifies all data/state is unchanged.
|
|
|
|
This permits rollback to the Node version during the migration window because the baseline schema itself does not change.
|
|
|
|
## Tournament backend port mapping by responsibility
|
|
|
|
`app.ts` should not become another monolith. Its endpoints split as follows:
|
|
|
|
| Router | Existing endpoints |
|
|
|---|---|
|
|
| `routers/auth.py` | `/api/auth/login`, `/logout`, `/session` |
|
|
| `routers/admin/settings.py` | `/api/admin/settings` |
|
|
| `routers/admin/display.py` | `/api/admin/display` |
|
|
| `routers/admin/groups.py` | `/api/admin/groups...` |
|
|
| `routers/admin/teams.py` | `/api/admin/teams...`, player CRUD |
|
|
| `routers/admin/calendar.py` | calendar get/generate/preview/delete |
|
|
| `routers/admin/matches.py` | league result + round standings endpoints |
|
|
| `routers/admin/final_stage.py` | all final-stage config/seeds/results endpoints |
|
|
| `routers/public.py` | `/api/public/state`, `/api/public/events` |
|
|
|
|
Pydantic schemas should be grouped by the same domain, not placed in one large schema file.
|
|
|
|
## Shifts `web.py` split
|
|
|
|
Do this **after** the monorepo move, with no route or template behaviour changes:
|
|
|
|
| Target router | Current responsibility |
|
|
|---|---|
|
|
| `routers/auth.py` | `/login`, `/logout`, auth dependencies |
|
|
| `routers/account.py` | `/account` |
|
|
| `routers/calendar.py` | ICS feed and calendar page |
|
|
| `routers/exports.py` | schedule export HTML/PDF |
|
|
| `routers/dashboard.py` | `/`, `/health` |
|
|
| `routers/swaps.py` | all member/admin swap transitions outside schedule assignment |
|
|
| `routers/admin/teams.py` | admin team CRUD |
|
|
| `routers/admin/users.py` | admin user CRUD |
|
|
| `routers/admin/schedules.py` | schedule configuration, patterns, rotation membership |
|
|
| `routers/admin/assignments.py` | assignments, regeneration, assign-day, swap assignment |
|
|
| `routers/admin/notifications.py` | notification log page |
|
|
|
|
Shared request helpers (`current_user`, `require_user`, `require_admin`, CSRF validation, flash/context helpers) go into a small router dependency/helper module, not into `security/` unless they are genuinely security primitives.
|
|
|
|
## Shared branding
|
|
|
|
Use one canonical CRR asset set. The Tournament logo is the higher-resolution current source and becomes `packages/crr-brand/assets/logo.png`; the Shifts copy is removed after visual verification.
|
|
|
|
### `tokens.css`
|
|
|
|
Normalize the already-overlapping palette around the existing CRR red `#ed1c24`:
|
|
|
|
- primary / primary-hover / primary-dark
|
|
- background / surface
|
|
- text / muted text
|
|
- border
|
|
- danger / warning
|
|
- soft brand background
|
|
- shared radii, shadows, spacing and font stack
|
|
|
|
App-specific tokens such as Tournament match-card dimensions stay in the app stylesheet.
|
|
|
|
### `base.css`
|
|
|
|
Only cross-app primitives: box sizing, body typography/background, links, form controls, focus state, basic tables.
|
|
|
|
### `components.css`
|
|
|
|
Shared visual patterns only where both apps actually use them: CRR button variants, cards/panels, alerts/status badges and common table treatment. Do not attempt to share Vue components with Jinja.
|
|
|
|
Tournament imports shared CSS before its app stylesheet. Shifts mounts `packages/crr-brand` as a second FastAPI static directory (for example `/brand`) and loads shared CSS before `app.css`.
|
|
|
|
## Python packaging
|
|
|
|
Root `pyproject.toml` is a uv workspace:
|
|
|
|
```toml
|
|
[tool.uv.workspace]
|
|
members = [
|
|
"apps/tournament/backend",
|
|
"apps/shifts/backend",
|
|
"packages/crr-python",
|
|
]
|
|
```
|
|
|
|
Each backend has its own project metadata and dependencies but resolves into one root `uv.lock`. Use `requires-python = ">=3.13,<3.14"` initially so both applications are tested against the same interpreter generation.
|
|
|
|
Shifts dependencies currently in `requirements*.txt` move into `apps/shifts/backend/pyproject.toml`; the requirements files are deleted only after the uv lockfile is generated and CI passes.
|
|
|
|
Tournament backend dependencies start with FastAPI, Uvicorn, SQLAlchemy, Alembic, Pydantic Settings and the testing stack (`pytest`, `httpx`).
|
|
|
|
## Docker/deployment
|
|
|
|
Keep two images:
|
|
|
|
- `crr-tournament`
|
|
- `crr-shifts`
|
|
|
|
Both Dockerfiles use repository root as build context so they can consume `packages/`. The root `.dockerignore` must exclude `original/` entirely.
|
|
|
|
Tournament uses a Node 22 build stage for Vue and a Python 3.13 runtime stage. The built SPA is copied into the Python image and served by FastAPI, preserving the current single-container deployment.
|
|
|
|
Shifts becomes Python 3.13 + uv and copies the shared brand package into the image. Its database remains independent from Tournament.
|
|
|
|
The root `compose.yaml` defines two independent services and storage locations. `docker compose up tournament` and `docker compose up shifts` must both work independently; `docker compose up` may run both.
|
|
|
|
## Root developer commands
|
|
|
|
The root Makefile should expose namespaced commands rather than hiding which app is running:
|
|
|
|
```text
|
|
make tournament-backend-dev
|
|
make tournament-frontend-dev
|
|
make tournament-test
|
|
make tournament-build
|
|
make shifts-dev
|
|
make shifts-test
|
|
make shifts-build
|
|
make test
|
|
```
|
|
|
|
`make test` runs both backends plus Tournament frontend tests/typechecking.
|
|
|
|
## CI
|
|
|
|
Use path-aware jobs:
|
|
|
|
- Tournament frontend job: `apps/tournament/frontend/**` or `packages/crr-brand/**`.
|
|
- Tournament backend job: `apps/tournament/backend/**` or `packages/crr-python/**`.
|
|
- Shifts job: `apps/shifts/**`, `packages/crr-brand/**` or `packages/crr-python/**`.
|
|
- Root tooling changes (`pyproject.toml`, `uv.lock`, Compose, CI itself) run both backend jobs as appropriate.
|
|
|
|
A branding-only change must test both applications because it can break either rendered UI.
|
|
|
|
## Independent releases
|
|
|
|
Do not use one monorepo version. Tag releases independently, for example:
|
|
|
|
```text
|
|
tournament-v1.1.0
|
|
shifts-v1.0.3
|
|
```
|
|
|
|
A release workflow builds only the relevant image from that tag. Shared package changes are released only through whichever app consumes the change; the shared packages do not need separate public versions initially.
|
|
|
|
## Migration sequence
|
|
|
|
### Phase 0 — freeze behaviour
|
|
|
|
- Run and preserve both current test suites in isolated copies of
|
|
`originals/tournment-manager-web/` and `originals/crr-shifts/`. Dependency
|
|
installation, bytecode, test caches and build outputs must stay outside snapshots.
|
|
- Add any migration-only compatibility fixtures/tests outside `original/`; do not modify the source snapshots.
|
|
- Capture the existing Tournament API contract before replacing Fastify.
|
|
- Save a representative Tournament SQLite database fixture produced by `original/tournament-manager/` for migration tests.
|
|
- Save screenshots of key pages from both original apps for branding regression comparison.
|
|
|
|
**Exit:** both existing repositories are green and baseline artefacts exist.
|
|
|
|
### Phase 1 — create monorepo without architecture changes
|
|
|
|
- Keep `original/` unchanged as the migration baseline.
|
|
- Create root structure/configuration.
|
|
- Copy Tournament frontend/server sources and Shifts sources from `original/` according to the file map below.
|
|
- At this point Tournament may temporarily still run a copied Node backend from its app directory; the goal is only to prove the new monorepo paths.
|
|
- Update build/test paths so all migrated builds/tests run from `apps/`, never from `original/`.
|
|
|
|
**Exit:** both apps run from the monorepo with no functional change.
|
|
|
|
### Phase 2 — shared CRR brand
|
|
|
|
- Create `crr-brand` tokens/assets/base components.
|
|
- Replace both logo copies with the canonical shared asset.
|
|
- Extract only visibly common CSS; leave app-specific layout CSS local.
|
|
- Verify mobile/desktop and Tournament print cards.
|
|
|
|
**Exit:** both apps have the same brand primitives without layout regressions.
|
|
|
|
### Phase 3 — Tournament FastAPI replacement
|
|
|
|
- Create SQLAlchemy models and Alembic baseline/adoption logic.
|
|
- Port deterministic services and their tests first.
|
|
- Port state assembly.
|
|
- Port auth/session/rate limiting.
|
|
- Port routers one domain at a time.
|
|
- Port SSE.
|
|
- Serve the existing Vue build from FastAPI.
|
|
- Remove Node backend dependencies only after the complete Python API compatibility suite passes.
|
|
|
|
**Exit:** existing Vue build works unchanged against Python; existing tournament DB opens in place; API/status/error/SSE contract tests pass.
|
|
|
|
### Phase 4 — Shifts structural refactor
|
|
|
|
- Move service modules into `services/`.
|
|
- Split models without schema changes.
|
|
- Split `web.py` router by router.
|
|
- Move security primitives into `security/`.
|
|
- Do not alter routes, form fields, templates or database schema in this phase.
|
|
|
|
**Exit:** Shifts tests pass and rendered behaviour is unchanged.
|
|
|
|
### Phase 5 — extract proven Python common code
|
|
|
|
Compare the final two Python backends. Only now extract byte-for-byte-equivalent or clearly generic infrastructure into `crr-python`, likely starting with SQLite engine pragmas/Alembic setup helpers if doing so removes real duplication without app-specific switches.
|
|
|
|
**Exit:** neither app imports the other's code; shared package contains no domain concepts.
|
|
|
|
### Phase 6 — cleanup
|
|
|
|
- Remove Tournament TypeScript server files/config/dependencies from `apps/tournament/` only; keep the copy under `original/tournament-manager/` untouched.
|
|
- Remove migrated Shifts requirements files and duplicate logo from `apps/shifts/` only; keep `original/crr-shifts/` untouched.
|
|
- Remove temporary compatibility scaffolding outside `original/`.
|
|
- Update documentation and release workflows.
|
|
- Retain `original/` as the historical migration baseline unless a separate, explicit post-migration decision removes it.
|
|
|
|
## Non-goals
|
|
|
|
- No combined database.
|
|
- No shared `Team` model.
|
|
- No common login/user schema.
|
|
- No migration of Shifts to Vue.
|
|
- No migration of Tournament away from Vue.
|
|
- No microservices or separate API container/frontend container unless a real deployment need appears later.
|
|
- No generic repository/service framework merely to make the directory trees look identical.
|
|
|
|
## Acceptance criteria
|
|
|
|
The migration is complete when:
|
|
|
|
1. Each app can be built/run/tested independently from the monorepo.
|
|
2. Tournament's existing Vue frontend works without API changes against FastAPI.
|
|
3. Existing Tournament and Shifts SQLite data opens without manual conversion or loss.
|
|
4. Each app retains a separate migration history/database/auth model/image/version.
|
|
5. Both apps use the same canonical CRR logo and design tokens.
|
|
6. Shared Python code contains infrastructure only, no Tournament/Shifts domain entities.
|
|
7. A change limited to one app does not require deploying the other.
|
|
8. The old Tournament Node backend can be removed with no remaining runtime dependency on Fastify, `better-sqlite3` or Zod.
|
|
9. `original/` remains unchanged and no production/runtime code imports or executes from it.
|
|
|
|
## Exact existing-file migration map
|
|
|
|
The following table accounts for every non-directory file in the two original codebases. Every source path is rooted under `original/`; source files remain untouched. Actions such as `copy`, `port`, `rewrite` and `merge` create or update files outside `original/`.
|
|
|
|
| Repository | Source | Action | Destination | Notes |
|
|
|---|---|---|---|---|
|
|
| Tournament Manager | `original/tournament-manager/.dockerignore` | merge | `/.dockerignore` | Merge Docker ignore rules for root build context |
|
|
| Tournament Manager | `original/tournament-manager/.env.example` | copy | `apps/tournament/.env.example` | Keep app-specific environment contract |
|
|
| Tournament Manager | `original/tournament-manager/.gitignore` | merge | `/.gitignore` | Merge repository ignore rules |
|
|
| Tournament Manager | `original/tournament-manager/AGENTS.md` | copy+edit | `apps/tournament/AGENTS.md` | Keep tournament-specific contributor guidance |
|
|
| Tournament Manager | `original/tournament-manager/AGENTS.md.bak` | leave-in-original | `—` | Redundant backup after AGENTS.md is migrated; no migrated copy is needed |
|
|
| Tournament Manager | `original/tournament-manager/Dockerfile` | rewrite | `apps/tournament/Dockerfile` | Replace Node backend runtime with Node frontend build + Python 3.13 FastAPI runtime |
|
|
| Tournament Manager | `original/tournament-manager/README.md` | copy+edit | `apps/tournament/README.md` | Update monorepo/dev/deploy commands |
|
|
| Tournament Manager | `original/tournament-manager/compose.yaml` | merge | `/compose.yaml` | Tournament service becomes one root Compose service |
|
|
| Tournament Manager | `original/tournament-manager/index.html` | copy | `apps/tournament/frontend/index.html` | Vite frontend root |
|
|
| Tournament Manager | `original/tournament-manager/logo.png` | copy+canonicalize | `packages/crr-brand/assets/logo.png` | Use as canonical high-resolution CRR logo |
|
|
| Tournament Manager | `original/tournament-manager/package-lock.json` | copy | `apps/tournament/frontend/package-lock.json` | Regenerate after package.json cleanup |
|
|
| Tournament Manager | `original/tournament-manager/package.json` | copy+edit | `apps/tournament/frontend/package.json` | Remove backend Node dependencies/scripts |
|
|
| Tournament Manager | `original/tournament-manager/public/favicon.png` | copy+canonicalize | `packages/crr-brand/assets/favicon.png` | Shared favicon |
|
|
| Tournament Manager | `original/tournament-manager/src/client/App.vue` | copy+edit | `apps/tournament/frontend/src/App.vue` | Adjust imports/base paths/brand imports as needed |
|
|
| Tournament Manager | `original/tournament-manager/src/client/components/AdminShell.vue` | copy+edit | `apps/tournament/frontend/src/components/AdminShell.vue` | Adjust imports/base paths/brand imports as needed |
|
|
| Tournament Manager | `original/tournament-manager/src/client/components/AppLogo.vue` | copy+edit | `apps/tournament/frontend/src/components/AppLogo.vue` | Adjust imports/base paths/brand imports as needed |
|
|
| Tournament Manager | `original/tournament-manager/src/client/components/AppModal.vue` | copy+edit | `apps/tournament/frontend/src/components/AppModal.vue` | Adjust imports/base paths/brand imports as needed |
|
|
| Tournament Manager | `original/tournament-manager/src/client/components/ClassificationTable.vue` | copy+edit | `apps/tournament/frontend/src/components/ClassificationTable.vue` | Adjust imports/base paths/brand imports as needed |
|
|
| Tournament Manager | `original/tournament-manager/src/client/components/DisplayClassificationPanel.vue` | copy+edit | `apps/tournament/frontend/src/components/DisplayClassificationPanel.vue` | Adjust imports/base paths/brand imports as needed |
|
|
| Tournament Manager | `original/tournament-manager/src/client/components/DisplayFit.vue` | copy+edit | `apps/tournament/frontend/src/components/DisplayFit.vue` | Adjust imports/base paths/brand imports as needed |
|
|
| Tournament Manager | `original/tournament-manager/src/client/components/DisplayLatestResultsPanel.vue` | copy+edit | `apps/tournament/frontend/src/components/DisplayLatestResultsPanel.vue` | Adjust imports/base paths/brand imports as needed |
|
|
| Tournament Manager | `original/tournament-manager/src/client/components/FinalBracket.vue` | copy+edit | `apps/tournament/frontend/src/components/FinalBracket.vue` | Adjust imports/base paths/brand imports as needed |
|
|
| Tournament Manager | `original/tournament-manager/src/client/components/MatchResultCard.vue` | copy+edit | `apps/tournament/frontend/src/components/MatchResultCard.vue` | Adjust imports/base paths/brand imports as needed |
|
|
| Tournament Manager | `original/tournament-manager/src/client/components/match-cards/FourScores.vue` | copy+edit | `apps/tournament/frontend/src/components/match-cards/FourScores.vue` | Adjust imports/base paths/brand imports as needed |
|
|
| Tournament Manager | `original/tournament-manager/src/client/components/match-cards/SingleScore.vue` | copy+edit | `apps/tournament/frontend/src/components/match-cards/SingleScore.vue` | Adjust imports/base paths/brand imports as needed |
|
|
| Tournament Manager | `original/tournament-manager/src/client/components/match-cards/SixScores.vue` | copy+edit | `apps/tournament/frontend/src/components/match-cards/SixScores.vue` | Adjust imports/base paths/brand imports as needed |
|
|
| Tournament Manager | `original/tournament-manager/src/client/components/matchCards.ts` | copy+edit | `apps/tournament/frontend/src/components/matchCards.ts` | Adjust imports/base paths/brand imports as needed |
|
|
| Tournament Manager | `original/tournament-manager/src/client/displayPanels.ts` | copy+edit | `apps/tournament/frontend/src/displayPanels.ts` | Adjust imports/base paths/brand imports as needed |
|
|
| Tournament Manager | `original/tournament-manager/src/client/lib/api.ts` | copy+edit | `apps/tournament/frontend/src/lib/api.ts` | Adjust imports/base paths/brand imports as needed |
|
|
| Tournament Manager | `original/tournament-manager/src/client/lib/format.test.ts` | copy+edit | `apps/tournament/frontend/src/lib/format.test.ts` | Adjust imports/base paths/brand imports as needed |
|
|
| Tournament Manager | `original/tournament-manager/src/client/lib/format.ts` | copy+edit | `apps/tournament/frontend/src/lib/format.ts` | Adjust imports/base paths/brand imports as needed |
|
|
| Tournament Manager | `original/tournament-manager/src/client/lib/score.test.ts` | copy+edit | `apps/tournament/frontend/src/lib/score.test.ts` | Adjust imports/base paths/brand imports as needed |
|
|
| Tournament Manager | `original/tournament-manager/src/client/lib/score.ts` | copy+edit | `apps/tournament/frontend/src/lib/score.ts` | Adjust imports/base paths/brand imports as needed |
|
|
| Tournament Manager | `original/tournament-manager/src/client/lib/usePublicTournamentState.ts` | copy+edit | `apps/tournament/frontend/src/lib/usePublicTournamentState.ts` | Adjust imports/base paths/brand imports as needed |
|
|
| Tournament Manager | `original/tournament-manager/src/client/main.ts` | copy+edit | `apps/tournament/frontend/src/main.ts` | Adjust imports/base paths/brand imports as needed |
|
|
| Tournament Manager | `original/tournament-manager/src/client/router.ts` | copy+edit | `apps/tournament/frontend/src/router.ts` | Adjust imports/base paths/brand imports as needed |
|
|
| Tournament Manager | `original/tournament-manager/src/client/styles.css` | copy+edit | `apps/tournament/frontend/src/styles.css` | Adjust imports/base paths/brand imports as needed |
|
|
| Tournament Manager | `original/tournament-manager/src/client/types.ts` | copy+edit | `apps/tournament/frontend/src/types.ts` | Adjust imports/base paths/brand imports as needed |
|
|
| Tournament Manager | `original/tournament-manager/src/client/views/CalendarView.vue` | copy+edit | `apps/tournament/frontend/src/views/CalendarView.vue` | Adjust imports/base paths/brand imports as needed |
|
|
| Tournament Manager | `original/tournament-manager/src/client/views/DisplaySettingsView.vue` | copy+edit | `apps/tournament/frontend/src/views/DisplaySettingsView.vue` | Adjust imports/base paths/brand imports as needed |
|
|
| Tournament Manager | `original/tournament-manager/src/client/views/DisplayView.vue` | copy+edit | `apps/tournament/frontend/src/views/DisplayView.vue` | Adjust imports/base paths/brand imports as needed |
|
|
| Tournament Manager | `original/tournament-manager/src/client/views/FinalStageView.vue` | copy+edit | `apps/tournament/frontend/src/views/FinalStageView.vue` | Adjust imports/base paths/brand imports as needed |
|
|
| Tournament Manager | `original/tournament-manager/src/client/views/LoginView.vue` | copy+edit | `apps/tournament/frontend/src/views/LoginView.vue` | Adjust imports/base paths/brand imports as needed |
|
|
| Tournament Manager | `original/tournament-manager/src/client/views/MatchCardsView.vue` | copy+edit | `apps/tournament/frontend/src/views/MatchCardsView.vue` | Adjust imports/base paths/brand imports as needed |
|
|
| Tournament Manager | `original/tournament-manager/src/client/views/PublicResultsView.vue` | copy+edit | `apps/tournament/frontend/src/views/PublicResultsView.vue` | Adjust imports/base paths/brand imports as needed |
|
|
| Tournament Manager | `original/tournament-manager/src/client/views/ResultsView.vue` | copy+edit | `apps/tournament/frontend/src/views/ResultsView.vue` | Adjust imports/base paths/brand imports as needed |
|
|
| Tournament Manager | `original/tournament-manager/src/client/views/TeamsView.vue` | copy+edit | `apps/tournament/frontend/src/views/TeamsView.vue` | Adjust imports/base paths/brand imports as needed |
|
|
| Tournament Manager | `original/tournament-manager/src/server/app.integration.test.ts` | port | `apps/tournament/backend/tests/test_api_compatibility.py` | Port all observable route/status/error contract tests |
|
|
| Tournament Manager | `original/tournament-manager/src/server/app.ts` | port+split | `apps/tournament/backend/app/{routers,schemas,services}/` | Split Fastify monolith into FastAPI routers and Pydantic schemas; preserve API contract |
|
|
| Tournament Manager | `original/tournament-manager/src/server/auth.ts` | port+split | `apps/tournament/backend/app/security/{session.py,rate_limit.py}` | Preserve cookie name/token format/rate-limit semantics |
|
|
| Tournament Manager | `original/tournament-manager/src/server/db/database.test.ts` | port | `apps/tournament/backend/tests/test_database.py` | Port schema/default/constraint tests |
|
|
| Tournament Manager | `original/tournament-manager/src/server/db/database.ts` | port+split | `apps/tournament/backend/app/database.py + app/models/ + migrations/versions/0001_baseline.py` | SQLAlchemy model + Alembic baseline with legacy DB adoption |
|
|
| Tournament Manager | `original/tournament-manager/src/server/errors.ts` | port | `apps/tournament/backend/app/errors.py` | Preserve JSON error shape |
|
|
| Tournament Manager | `original/tournament-manager/src/server/events.ts` | port | `apps/tournament/backend/app/events.py` | SSE state-change broker |
|
|
| Tournament Manager | `original/tournament-manager/src/server/main.ts` | port | `apps/tournament/backend/app/main.py` | FastAPI application entry point |
|
|
| Tournament Manager | `original/tournament-manager/src/server/services/bracket.test.ts` | port | `apps/tournament/backend/tests/services/test_bracket.py` | |
|
|
| Tournament Manager | `original/tournament-manager/src/server/services/bracket.ts` | port | `apps/tournament/backend/app/services/bracket.py` | |
|
|
| Tournament Manager | `original/tournament-manager/src/server/services/calendar.test.ts` | port | `apps/tournament/backend/tests/services/test_calendar.py` | |
|
|
| Tournament Manager | `original/tournament-manager/src/server/services/calendar.ts` | port | `apps/tournament/backend/app/services/calendar.py` | |
|
|
| Tournament Manager | `original/tournament-manager/src/server/services/classification.test.ts` | port | `apps/tournament/backend/tests/services/test_classification.py` | |
|
|
| Tournament Manager | `original/tournament-manager/src/server/services/classification.ts` | port | `apps/tournament/backend/app/services/classification.py` | |
|
|
| Tournament Manager | `original/tournament-manager/src/server/services/state.ts` | port | `apps/tournament/backend/app/services/state.py` | Translate SQL-backed state assembly to SQLAlchemy while preserving response shape |
|
|
| Tournament Manager | `original/tournament-manager/src/shared/types/tournament.ts` | copy+edit | `apps/tournament/frontend/src/types/tournament.ts` | Frontend API types remain TypeScript; FastAPI Pydantic schemas mirror this contract |
|
|
| Tournament Manager | `original/tournament-manager/src/vite-env.d.ts` | copy | `apps/tournament/frontend/src/vite-env.d.ts` | |
|
|
| Tournament Manager | `original/tournament-manager/tsconfig.client.json` | copy+rename | `apps/tournament/frontend/tsconfig.json` | Update include paths |
|
|
| Tournament Manager | `original/tournament-manager/tsconfig.server.json` | leave-in-original | `—` | Node/TypeScript backend removed; no migrated copy is needed |
|
|
| Tournament Manager | `original/tournament-manager/vite.config.ts` | copy+edit | `apps/tournament/frontend/vite.config.ts` | Proxy to FastAPI and read shared brand assets |
|
|
| CRR Shifts | `original/crr-shifts/.dockerignore` | merge | `/.dockerignore` | Merge Docker ignore rules for root build context |
|
|
| CRR Shifts | `original/crr-shifts/.env.example` | copy+edit | `apps/shifts/.env.example` | Keep app-specific environment contract; Python 3.13 runtime |
|
|
| CRR Shifts | `original/crr-shifts/.gitignore` | merge | `/.gitignore` | Merge repository ignore rules |
|
|
| CRR Shifts | `original/crr-shifts/AGENTS.md` | copy+edit | `apps/shifts/AGENTS.md` | Keep shifts-specific contributor guidance |
|
|
| CRR Shifts | `original/crr-shifts/Dockerfile` | rewrite | `apps/shifts/Dockerfile` | Python 3.13 + uv; root build context |
|
|
| CRR Shifts | `original/crr-shifts/Makefile` | merge | `/Makefile` | Convert to root namespaced targets such as shifts-dev/shifts-test |
|
|
| CRR Shifts | `original/crr-shifts/README.md` | copy+edit | `apps/shifts/README.md` | Update monorepo/dev/deploy commands |
|
|
| CRR Shifts | `original/crr-shifts/alembic.ini` | copy+edit | `apps/shifts/backend/alembic.ini` | Update script paths for backend subdirectory |
|
|
| CRR Shifts | `original/crr-shifts/app/__init__.py` | copy | `apps/shifts/backend/app/__init__.py` | |
|
|
| CRR Shifts | `original/crr-shifts/app/bootstrap.py` | copy+refactor | `apps/shifts/backend/app/services/bootstrap.py` | No behavior change |
|
|
| CRR Shifts | `original/crr-shifts/app/calendar.py` | copy+refactor | `apps/shifts/backend/app/services/calendar_feed.py` | Avoid name collision with router |
|
|
| CRR Shifts | `original/crr-shifts/app/cli.py` | copy+edit | `apps/shifts/backend/app/cli.py` | Update imports/paths |
|
|
| CRR Shifts | `original/crr-shifts/app/config.py` | copy+edit | `apps/shifts/backend/app/config.py` | Keep settings contract |
|
|
| CRR Shifts | `original/crr-shifts/app/database.py` | copy+edit | `apps/shifts/backend/app/database.py` | Update migration paths; later share proven generic helpers |
|
|
| CRR Shifts | `original/crr-shifts/app/i18n.py` | copy | `apps/shifts/backend/app/i18n.py` | |
|
|
| CRR Shifts | `original/crr-shifts/app/main.py` | copy+edit | `apps/shifts/backend/app/main.py` | Include split routers and shared brand StaticFiles mount |
|
|
| CRR Shifts | `original/crr-shifts/app/models.py` | split | `apps/shifts/backend/app/models/{user.py,team.py,schedule.py,assignment.py,swap.py,notification.py,__init__.py}` | Pure structural split; retain SQLAlchemy schema |
|
|
| CRR Shifts | `original/crr-shifts/app/notifications.py` | copy+refactor | `apps/shifts/backend/app/services/notifications.py` | |
|
|
| CRR Shifts | `original/crr-shifts/app/pdf.py` | copy+refactor | `apps/shifts/backend/app/services/pdf.py` | |
|
|
| CRR Shifts | `original/crr-shifts/app/scheduling.py` | copy+refactor | `apps/shifts/backend/app/services/scheduling.py` | |
|
|
| CRR Shifts | `original/crr-shifts/app/security.py` | split | `apps/shifts/backend/app/security/{passwords.py,csrf.py,__init__.py}` | Keep auth model independent from Tournament |
|
|
| CRR Shifts | `original/crr-shifts/app/static/app.css` | copy+edit | `apps/shifts/backend/app/static/app.css` | Remove extracted shared brand tokens/components |
|
|
| CRR Shifts | `original/crr-shifts/app/static/logo-crr.png` | reference-shared-copy | `packages/crr-brand/assets/logo.png` | Use shared canonical logo; do not keep duplicate |
|
|
| CRR Shifts | `original/crr-shifts/app/templates/_schedule_export_form.html` | copy+edit | `apps/shifts/backend/app/templates/_schedule_export_form.html` | Only update shared-brand/static references as needed |
|
|
| CRR Shifts | `original/crr-shifts/app/templates/account.html` | copy+edit | `apps/shifts/backend/app/templates/account.html` | Only update shared-brand/static references as needed |
|
|
| CRR Shifts | `original/crr-shifts/app/templates/admin_assign.html` | copy+edit | `apps/shifts/backend/app/templates/admin_assign.html` | Only update shared-brand/static references as needed |
|
|
| CRR Shifts | `original/crr-shifts/app/templates/admin_notifications.html` | copy+edit | `apps/shifts/backend/app/templates/admin_notifications.html` | Only update shared-brand/static references as needed |
|
|
| CRR Shifts | `original/crr-shifts/app/templates/admin_schedule.html` | copy+edit | `apps/shifts/backend/app/templates/admin_schedule.html` | Only update shared-brand/static references as needed |
|
|
| CRR Shifts | `original/crr-shifts/app/templates/admin_schedules.html` | copy+edit | `apps/shifts/backend/app/templates/admin_schedules.html` | Only update shared-brand/static references as needed |
|
|
| CRR Shifts | `original/crr-shifts/app/templates/admin_team_delete.html` | copy+edit | `apps/shifts/backend/app/templates/admin_team_delete.html` | Only update shared-brand/static references as needed |
|
|
| CRR Shifts | `original/crr-shifts/app/templates/admin_teams.html` | copy+edit | `apps/shifts/backend/app/templates/admin_teams.html` | Only update shared-brand/static references as needed |
|
|
| CRR Shifts | `original/crr-shifts/app/templates/admin_users.html` | copy+edit | `apps/shifts/backend/app/templates/admin_users.html` | Only update shared-brand/static references as needed |
|
|
| CRR Shifts | `original/crr-shifts/app/templates/base.html` | copy+edit | `apps/shifts/backend/app/templates/base.html` | Only update shared-brand/static references as needed |
|
|
| CRR Shifts | `original/crr-shifts/app/templates/calendar.html` | copy+edit | `apps/shifts/backend/app/templates/calendar.html` | Only update shared-brand/static references as needed |
|
|
| CRR Shifts | `original/crr-shifts/app/templates/dashboard.html` | copy+edit | `apps/shifts/backend/app/templates/dashboard.html` | Only update shared-brand/static references as needed |
|
|
| CRR Shifts | `original/crr-shifts/app/templates/export_schedule.html` | copy+edit | `apps/shifts/backend/app/templates/export_schedule.html` | Only update shared-brand/static references as needed |
|
|
| CRR Shifts | `original/crr-shifts/app/templates/login.html` | copy+edit | `apps/shifts/backend/app/templates/login.html` | Only update shared-brand/static references as needed |
|
|
| CRR Shifts | `original/crr-shifts/app/templates/swap_new.html` | copy+edit | `apps/shifts/backend/app/templates/swap_new.html` | Only update shared-brand/static references as needed |
|
|
| CRR Shifts | `original/crr-shifts/app/templates/swaps.html` | copy+edit | `apps/shifts/backend/app/templates/swaps.html` | Only update shared-brand/static references as needed |
|
|
| CRR Shifts | `original/crr-shifts/app/web.py` | split | `apps/shifts/backend/app/routers/` | Split by auth/account/calendar/swaps/admin while preserving routes/templates |
|
|
| CRR Shifts | `original/crr-shifts/compose.yaml` | merge | `/compose.yaml` | Shifts service becomes one root Compose service |
|
|
| CRR Shifts | `original/crr-shifts/docs/ARCHITECTURE.md` | copy+edit | `apps/shifts/docs/ARCHITECTURE.md` | Update paths/architecture notes |
|
|
| CRR Shifts | `original/crr-shifts/docs/DOMAIN.md` | copy+edit | `apps/shifts/docs/DOMAIN.md` | Update paths/architecture notes |
|
|
| CRR Shifts | `original/crr-shifts/migrations/README` | copy+edit | `apps/shifts/backend/migrations/README` | |
|
|
| CRR Shifts | `original/crr-shifts/migrations/env.py` | copy+edit | `apps/shifts/backend/migrations/env.py` | Update imports/path |
|
|
| CRR Shifts | `original/crr-shifts/migrations/script.py.mako` | copy | `apps/shifts/backend/migrations/script.py.mako` | |
|
|
| CRR Shifts | `original/crr-shifts/migrations/versions/0001_initial.py` | copy | `apps/shifts/backend/migrations/versions/0001_initial.py` | Preserve migration history unchanged |
|
|
| CRR Shifts | `original/crr-shifts/pyproject.toml` | rewrite | `apps/shifts/backend/pyproject.toml` | Full uv project metadata + runtime/dev dependencies |
|
|
| CRR Shifts | `original/crr-shifts/pyrightconfig.json` | merge | `/pyrightconfig.json` | One root Python type-check config for both backends |
|
|
| CRR Shifts | `original/crr-shifts/requirements-dev.txt` | leave-in-original | `—` | Dependencies move to pyproject.toml/uv.lock; no migrated copy is needed |
|
|
| CRR Shifts | `original/crr-shifts/requirements.txt` | leave-in-original | `—` | Dependencies move to pyproject.toml/uv.lock; no migrated copy is needed |
|
|
| CRR Shifts | `original/crr-shifts/tests/.gitkeep` | copy+edit | `apps/shifts/backend/tests/.gitkeep` | Update imports/paths only |
|
|
| CRR Shifts | `original/crr-shifts/tests/conftest.py` | copy+edit | `apps/shifts/backend/tests/conftest.py` | Update imports/paths only |
|
|
| CRR Shifts | `original/crr-shifts/tests/test_export_schedule.py` | copy+edit | `apps/shifts/backend/tests/test_export_schedule.py` | Update imports/paths only |
|