Skip to content

M1: Plattform/Accounts — Auth, Tournament-CRUD, Generator, Import/Export - #2

Merged
TimGoldbach merged 1 commit into
chore/scaffold-m0from
feat/m1-platform
Jun 14, 2026
Merged

M1: Plattform/Accounts — Auth, Tournament-CRUD, Generator, Import/Export#2
TimGoldbach merged 1 commit into
chore/scaffold-m0from
feat/m1-platform

Conversation

@TimGoldbach

Copy link
Copy Markdown
Owner

Setzt Meilenstein M1 aus docs/PLAN.md um. Entstanden durch einen orchestrierten Multi-Agent-Build (6 Slices gegen einen fixen Contract) + ein adversariales 5-Perspektiven-Review; dessen Blocker + alle Majors sind hier eingearbeitet.

ℹ️ Gestapelt auf #1 (Scaffold). Base ist chore/scaffold-m0, damit der Diff M1-only bleibt. Nach Merge von #1 retargetet GitHub automatisch auf main.

Was drin ist

Shared (packages/shared)

  • API-DTO-Contracts (Create/Import-Inputs, Summary/Detail-Read-Models, User, Capability-Link) — eine Quelle der Wahrheit für Nest + den typisierten BFF-Client.
  • participants.min(2) am Schema-Rand (keine degenerierten Brackets).

Backend (apps/api)

  • common: ZodValidationPipe, globaler ServiceTokenGuard (mit @Public()-Bypass für /health), CurrentActor-Decorator, globales PrismaModule.
  • bracket: eigener deterministischer Generator — Single-Elimination (Mirror-Seeding + Byes) und Round-Robin (Circle-Method) korrekt; Double-Elim/Swiss werfen 501 (brackets-manager + Swiss kommen im M2/M3-Spike).
  • users: Provider-Sync + /users/me.
  • tournaments: Create (generieren + normalisiert persistieren), List/Get/Delete, Setup-only JSON Export/Import, Gast→User-Claim, Capability-Links.
  • main.ts: bootet nicht ohne BFF_SERVICE_TOKEN.

Frontend (apps/web)

  • Auth.js v5 (Google + Dev-Credentials), JWT→Nest-User-Sync.
  • BFF-Proxy gehärtet: überschreibt/löscht Trust-Header, trägt x-anon-token nur für Gäste, strippt content-encoding/length + hop-by-hop auf der Antwort (sonst doppeltes Gunzip / kaputtes SSE).
  • /api/claim bridged das Gast-Cookie server-seitig zum User.
  • Dashboard/History, Create-Form, read-only Detail (Export/Delete), TanStack Query + SessionProvider über einen App-Provider, DE/EN.

Security-Fixes aus dem Review

  • 🔴 Blocker (Claim-IDOR / Account-Takeover): Claim leitet den anon-Token jetzt aus dem vertrauenswürdigen x-anon-token-Header ab (aus dem eigenen httpOnly-Cookie), nicht mehr aus dem Request-Body.
  • 🟠 pino redacted Service-Token, Actor-Header & Cookies.
  • 🟠 BFF trägt Gast-Identität nicht mehr für eingeloggte User mit.
  • 🟠 Response-Encoding-Header gestrippt (Body-Korruption verhindert).

Bewusst auf M2+ verschoben (im Plan dokumentiert)

Capability-Link-Expiry/Typ-Gating, Link-Client-Funktionen, Response-Zod-Parse, Redirect-Location-Strip.

Für Reviewer / ⚠️ vor dem ersten Start

Offline gebaut → nicht installiert/kompiliert. Vor dem Start nötig:

pnpm install
pnpm --filter @tournamentify/api prisma:migrate   # erste Migration (offline nicht erzeugbar)
pnpm build && pnpm typecheck

Besonders zur Laufzeit prüfen: Generator-Ausgabe, Auth.js-v5-Flow, BFF-SSE-Stream.

🤖 Generated with Claude Code

…t/export

Implements milestone M1 from docs/PLAN.md across backend, frontend and the
shared contract package. Built via an orchestrated multi-agent pass against a
fixed contract, followed by a 5-lens adversarial review whose blocker + major
findings are folded into this commit.

Shared (packages/shared):
- API DTO contracts (create/import inputs, summary/detail read-models, user,
  capability link) — single source of truth for Nest + the typed BFF client.
- Enforce >= 2 participants at the schema boundary (no degenerate brackets).

Backend (apps/api):
- common: ZodValidationPipe, global ServiceTokenGuard (with @public bypass for
  health), CurrentActor decorator. Global PrismaModule.
- bracket: own deterministic generator — single-elimination (mirror seeding +
  byes) and round-robin (circle method) correct; double-elim/swiss throw 501
  (brackets-manager + Swiss land in M2/M3 per the plan's spike).
- users: provider sync + /users/me.
- tournaments: create (generate + persist normalized), list/get/delete,
  setup-only JSON export/import, guest->user claim, capability links.
- main.ts: refuse to boot without BFF_SERVICE_TOKEN.

Frontend (apps/web):
- Auth.js v5 (Google + dev credentials) with JWT->Nest user sync.
- BFF proxy hardened: strips/overwrites trust headers, only carries x-anon-token
  for guests, drops content-encoding/length + hop-by-hop on the response so
  decompressed bodies and SSE are not corrupted.
- /api/claim bridges the guest cookie to the user server-side.
- Dashboard/history, create form, read-only detail (export/delete), TanStack
  Query + SessionProvider via a single app-level provider, DE/EN messages.

Security fixes from review: claim now derives the anon token from the trusted
x-anon-token header (not the request body) — closes an account-takeover IDOR;
pino redacts the service token, actor headers and cookies.

Offline scaffold: not installed/compiled here. Run pnpm install + prisma migrate
before first start; see docs/PLAN.md "M1 — Bekannte Follow-ups".

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant