docs(plans): M16 fase 1 implementation plan — scaffold scrum4me-workers #33

Merged
janpeter merged 1 commit from docs/M16-fase1-plan into main 2026-05-26 18:19:45 +02:00
Owner

Summary

Docs-only PR. Voegt het implementatieplan voor M16 fase 1 toe (analoog aan PR #32 voor fase 0).

Doel van fase 1: scaffold een nieuwe Next.js 16 admin-only app scrum4me-workers op workers.jp-visser.nl (achter Caddy + Docker op scrum4me-server). Geen feature-functionaliteit — alleen iron-session-login, requireWorkersAdmin-guard, lege /dashboard, en het deploy-mechanisme.

Structure

  • 19 taken met expliciete [MAC] / [SERVER] labels (zelfde patroon als fase 0)
  • TDD voor security-kritisch deel: requireWorkersAdmin, loginAction, proxy.ts, promote-admin.ts
  • Exit-gate + rollback-strategie per task

Belangrijke afwijking van design-spec sectie 5

De spec stelde een nieuwe UserRole { USER, ADMIN }-enum + migratie voor. In de praktijk heeft Scrum4Me al een uitgebreider rol-model:

  • enum Role { PRODUCT_OWNER, SCRUM_MASTER, DEVELOPER, ADMIN } bestaat
  • model UserRole { user_id, role } join-table bestaat
  • loginAction zet session.isAdmin al op basis van een userRole.findFirst({where: {role: 'ADMIN'}})

Fase 1 gebruikt dat bestaande model. Geen schema-migratie nodig — scripts/promote-admin.ts doet alleen een prisma.userRole.upsert({role: 'ADMIN'}).

Andere keuzes verantwoord

  • Eigen iron-session-config in workers (niet als shared factory) — design-spec voorstel uitgesteld naar latere fase
  • MD3 theme.css gekopieerd uit Scrum4Me — drift mogelijk, future move naar shared/styles
  • Anonymous-cloneable Forgejo-repo (private:false), net als scrum4me-shared — geen PAT-injectie in Docker-builds
  • prisma generate-only in workers; designated migrator blijft scrum4me-web
  • Login is bcrypt-only — geen QR-pairing in fase 1 (workers is admin-only, weinig users)

Volgorde-afhankelijkheden

[SERVER] task 1 ──► [MAC] tasks 2-12 (workers-scaffold) ──┐
                                                          ├──► [SERVER] tasks 15-19
[MAC] tasks 13-14 (Scrum4Me promote-admin PR) ────────────┘

Test plan

  • Plan zelfreview: spec-coverage, placeholder-scan, type-consistency
  • Plan ook geplaatst in MCP (scrum4me-doc://product/cmohrysyj0000rd17clnjy4tc/plans/m16-platform-split-fase-1-workers-scaffold) — beschikbaar voor server-Claude

Geen code-change — wordt opgevolgd door PRs per task tijdens uitvoering.

## Summary Docs-only PR. Voegt het implementatieplan voor M16 fase 1 toe (analoog aan PR #32 voor fase 0). **Doel van fase 1:** scaffold een nieuwe Next.js 16 admin-only app `scrum4me-workers` op `workers.jp-visser.nl` (achter Caddy + Docker op scrum4me-server). Geen feature-functionaliteit — alleen iron-session-login, requireWorkersAdmin-guard, lege /dashboard, en het deploy-mechanisme. ## Structure - **19 taken** met expliciete `[MAC]` / `[SERVER]` labels (zelfde patroon als fase 0) - TDD voor security-kritisch deel: `requireWorkersAdmin`, `loginAction`, `proxy.ts`, `promote-admin.ts` - Exit-gate + rollback-strategie per task ## Belangrijke afwijking van design-spec sectie 5 De spec stelde een nieuwe `UserRole { USER, ADMIN }`-enum + migratie voor. In de praktijk heeft Scrum4Me al een uitgebreider rol-model: - `enum Role { PRODUCT_OWNER, SCRUM_MASTER, DEVELOPER, ADMIN }` bestaat - `model UserRole { user_id, role }` join-table bestaat - `loginAction` zet `session.isAdmin` al op basis van een `userRole.findFirst({where: {role: 'ADMIN'}})` Fase 1 gebruikt dat bestaande model. **Geen schema-migratie nodig** — `scripts/promote-admin.ts` doet alleen een `prisma.userRole.upsert({role: 'ADMIN'})`. ## Andere keuzes verantwoord - **Eigen iron-session-config in workers** (niet als shared factory) — design-spec voorstel uitgesteld naar latere fase - **MD3 `theme.css` gekopieerd** uit Scrum4Me — drift mogelijk, future move naar shared/styles - **Anonymous-cloneable Forgejo-repo** (`private:false`), net als scrum4me-shared — geen PAT-injectie in Docker-builds - **`prisma generate`-only** in workers; designated migrator blijft scrum4me-web - **Login is bcrypt-only** — geen QR-pairing in fase 1 (workers is admin-only, weinig users) ## Volgorde-afhankelijkheden ``` [SERVER] task 1 ──► [MAC] tasks 2-12 (workers-scaffold) ──┐ ├──► [SERVER] tasks 15-19 [MAC] tasks 13-14 (Scrum4Me promote-admin PR) ────────────┘ ``` ## Test plan - [x] Plan zelfreview: spec-coverage, placeholder-scan, type-consistency - [x] Plan ook geplaatst in MCP (`scrum4me-doc://product/cmohrysyj0000rd17clnjy4tc/plans/m16-platform-split-fase-1-workers-scaffold`) — beschikbaar voor server-Claude Geen code-change — wordt opgevolgd door PRs per task tijdens uitvoering.
docs(plans): add M16 fase 1 implementation plan — scaffold scrum4me-workers
Some checks failed
CI / Lint, Typecheck, Test & Build (pull_request) Failing after 1m30s
CI / Deploy Manual (workflow_dispatch) (pull_request) Has been skipped
CI / Detect deploy-relevant changes (pull_request) Has been skipped
CI / Deploy Preview (PR) (pull_request) Has been skipped
CI / Deploy Production (main) (pull_request) Has been skipped
8a18bc9863
Bouwt voort op fase 0 (scrum4me-shared submodule). Fase 1 introduceert
de admin-only workers-app op workers.jp-visser.nl met iron-session-login,
lege /dashboard skeleton en docker-compose-deploy op scrum4me-server.

19 taken: 1 [SERVER] (Forgejo repo create) + 11 [MAC] voor de
workers-app-scaffold + 2 [MAC] voor scripts/promote-admin.ts in Scrum4Me
+ 5 [SERVER] voor secrets / docker-compose / Caddyfile / promote / smoke.

Belangrijke afwijking van design-spec sectie 5: geen nieuwe UserRole-enum +
migratie. Scrum4Me heeft al een breder Role-enum (PRODUCT_OWNER/SCRUM_MASTER/
DEVELOPER/ADMIN) + UserRole join-table + session.isAdmin. promote-admin.ts
upsert een UserRole-row; geen schema-change.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
janpeter/Scrum4Me!33
No description provided.