Scrum4Me/docs/plans/M9-active-product-backlog.md

---
title: "M9 — Actief Product Backlog"
status: active
audience: [maintainer, contributor]
language: nl
last_updated: 2026-05-03
applies_to: [M9]
---

# M9 — Actief Product Backlog

Eén "actief Product Backlog" per gebruiker, persistent op `User.active_product_id`. NavBar wordt: Producten | Product Backlog | Sprint | Solo | Todo's. Zonder actief PB zijn Backlog/Sprint/Solo disabled. Sprint is alleen klikbaar als er een sprint met status `ACTIVE` bestaat. Vervangt de bestaande `last_product`-cookieflow.

Backlog-entries: zie [backlog.md § M9](../backlog/index.md#m9-actief-product-backlog).

---

## ST-901 — Database `user.active_product_id`

> Status: voltooid in commit `dad9a80`.

**Bestanden**
- `prisma/schema.prisma` — model `User` uitgebreid + named relation
- `prisma/migrations/20260427165329_add_user_active_product_id/migration.sql` — migratie

**Stappen**
1. Op `User`: `active_product_id String? @db.Uuid` + relatie `active_product Product? @relation("UserActiveProduct", fields: [active_product_id], references: [id], onDelete: SetNull)` + `@@index([active_product_id])`.
2. Op `Product`: tegenrelatie `active_for_users User[] @relation("UserActiveProduct")` (anders conflicteert het met de bestaande `Product.user_id`-relatie).
3. `npx prisma migrate dev --name add_user_active_product_id`.

**Aandachtspunten**
- `vendor/scrum4me`-submodule in repo `mcp` heeft hetzelfde schema. Na merge moet daar `prisma generate && tsc --noEmit` slagen, anders breekt de wekelijkse drift-check (`trig_015FFUnxjz9WMuhhWNGBQKFD`).
- Geen seed-wijziging nodig — `null` is correcte initiële staat.

**Verificatie**
- `npx prisma migrate dev` slaagt
- `npx prisma validate` zonder fouten
- `prisma studio` toont kolom

---

## ST-902 — Server Actions: actief product zetten/wissen + auto-clear

**Bestanden**
- `actions/active-product.ts` — nieuw, twee Server Actions
- `actions/products.ts` — uitbreiden bij `archiveProductAction`
- `actions/product-members.ts` — uitbreiden bij `leaveProductAction` en `removeMemberAction` (locatie verifiëren met grep)
- `__tests__/actions/active-product.test.ts` — nieuw

**Stappen**

1. **`setActiveProductAction({ productId })`** in `actions/active-product.ts`:
   - Volg `docs/patterns/server-action.md`
   - Zod: `z.object({ productId: z.string().uuid() })`
   - `getSession()` → 401 bij geen sessie
   - **Demo-guard**: `if (session.isDemo) return { ok: false, error: 'Niet beschikbaar in demo-modus.' }`
   - Toegangscheck: `prisma.product.findFirst({ where: { id: productId, archived: false, ...productAccessFilter(userId) } })` → `null` levert `{ ok: false, error: 'Product niet gevonden of geen toegang.' }`
   - `prisma.user.update({ where: { id: userId }, data: { active_product_id: productId } })`
   - `revalidatePath('/', 'layout')` — laat NavBar in alle routes opnieuw renderen
   - Return `{ ok: true }`

2. **`clearActiveProductAction()`** in hetzelfde bestand:
   - Geen input
   - `getSession()` + demo-guard
   - `prisma.user.update({ where: { id: userId }, data: { active_product_id: null } })`
   - `revalidatePath('/', 'layout')`

3. **Auto-clear bij toegangsverlies** — drie call-sites uitbreiden ná de hoofdmutatie:
   - `archiveProductAction(productId)`: `prisma.user.updateMany({ where: { active_product_id: productId }, data: { active_product_id: null } })`
   - `leaveProductAction(productId)`: `prisma.user.updateMany({ where: { id: userId, active_product_id: productId }, data: { active_product_id: null } })`
   - `removeMemberAction(productId, removedUserId)`: `prisma.user.updateMany({ where: { id: removedUserId, active_product_id: productId }, data: { active_product_id: null } })`
   - Eigenaarsverwijdering van een product wordt door FK `onDelete: SetNull` automatisch geregeld — geen extra code

4. **Tests** — `__tests__/actions/active-product.test.ts`:
   - setActive met onbekend product → `{ ok: false }`
   - setActive met archived product → `{ ok: false }`
   - setActive met product zonder access → `{ ok: false }`
   - setActive happy path → `users.active_product_id` gezet
   - Demo-user setActive → error + geen DB-mutatie
   - archiveProductAction op actief product → `active_product_id` gecleared voor alle eigenaren/leden

**Aandachtspunten**
- Race-condition: setActive winnen ná auto-clear kan voorkomen. Layout-guard in ST-903 vangt dit op bij volgende request.
- `revalidatePath('/', 'layout')` is correct — niet `revalidatePath('/dashboard')` (NavBar zit in root layout van `(app)`).
- Geen `productAccessFilter` op `clearActiveProductAction` — eigen keuze wissen mag altijd.

**Verificatie**
- `npm run lint && npx tsc --noEmit && npm test && npm run build` groen
- Handmatig: 2 users — A archiveert product, `users.active_product_id` van B wordt `null` in DB

---

## ST-903 — App-layout actief product + redirects

**Bestanden**
- `app/(app)/layout.tsx` — uitbreiden met activeProduct-fetch + guard
- `app/(app)/solo/page.tsx` — cookie-flow vervangen
- `lib/cookies.ts` — `getLastProductCookie` / `setLastProductCookie` verwijderen
- `components/shared/nav-bar.tsx` — nieuwe prop `activeProduct` accepteren (verdere UI-uitwerking in ST-904)
- `components/solo/product-picker.tsx` — checken of nog gebruikt; anders weg

**Stappen**

1. **`app/(app)/layout.tsx`**:
   - User-query uitbreiden:
     ```ts
     prisma.user.findUnique({
       where: { id: session.userId },
       select: {
         username: true,
         email: true,
         active_product_id: true,
         active_product: { select: { id: true, name: true, archived: true } },
       },
     })
     ```
   - **Guard**: als `user.active_product_id` is gezet maar (`active_product === null` of `active_product.archived === true` of geen toegang via `productAccessFilter`):
     - `prisma.user.update(... active_product_id: null)` server-side
     - `redirect('/dashboard?notice=active-cleared')`
   - `<NavBar activeProduct={user.active_product ?? null} ... />` als nieuwe prop

2. **`app/(app)/solo/page.tsx`** — vervang volledig:
   ```ts
   const session = await getSession()
   if (!session.userId) redirect('/login')
   const user = await prisma.user.findUnique({
     where: { id: session.userId },
     select: { active_product_id: true },
   })
   if (!user?.active_product_id) redirect('/dashboard?notice=no-active')
   redirect(`/products/${user.active_product_id}/solo`)
   ```

3. **`lib/cookies.ts`**: verwijder `getLastProductCookie` en `setLastProductCookie`. Grep alle call-sites en pas aan/verwijder.

4. **Toast-handling** (server-redirect → client toast):
   - Klein client-component `<NoticeToast />` dat `useSearchParams` leest, `toast()` aanroept, querystring strippt via `router.replace(pathname)`
   - Plaats in `app/(app)/dashboard/page.tsx` (of layout) — alleen geactiveerde notices afhandelen
   - Twee waarden: `active-cleared` → "Je actieve product is niet meer beschikbaar."; `no-active` → "Selecteer eerst een actief product."

**Aandachtspunten**
- Layout-guard draait per request (extra DB-query). Houd 'm in dezelfde Promise.all met de bestaande user/userRoles-fetch.
- ProductPicker-fallback verdwijnt — switcher gebeurt in ST-904 via NavBar-dropdown.
- `app/(app)/solo/page.tsx` blijft Server Component — alleen `redirect()` van `next/navigation`.
- Een vorm van de cookie-helper kan ook door andere code gebruikt worden — verifieer de grep zorgvuldig vóór je verwijdert.

**Verificatie**
- `npm run lint && npx tsc --noEmit && npm test && npm run build` groen
- Login zonder active → NavBar krijgt `activeProduct={null}`
- Login met active → NavBar krijgt object met id/name
- Bezoek `/solo` met active → redirect naar `/products/[id]/solo` zonder cookie
- Archiveer actief product (script of via andere user) → bij volgende request layout cleart, toast op `/dashboard`

---

## ST-904 — NavBar splits + disabled-states + switcher

> Plan nog te schrijven.

## ST-905 — Producten-scherm Activeer-knop

> Plan nog te schrijven.

## ST-906 — Edge cases — toegangsverlies en archivering

> Plan nog te schrijven.

## ST-907 — Documentatie en tests

> Plan nog te schrijven.