new ux start

docs/specs/bouwplan-ai-speedrun-marketing-first-v2.1.md

@@ -0,0 +1,495 @@
+# 🚀 Mission Control – Bouwplan AI Speedrun EPD v2.1
+
+**Projectnaam:** AI Speedrun - Mini-EPD Prototype  
+**Versie:** v2.1 (Vereenvoudigde User Journey + Teal Design System)  
+**Datum:** 17-11-2024  
+**Auteur:** Colin Lit  
+**Laatste Update:** 17-11-2024
+
+---
+
+## 1. Doel en context
+
+🎯 **Doel:** Een werkend EPD-prototype bouwen in 4 weken dat demonstreert hoe "Software on Demand" traditionele ontwikkeling disrupts: van €100.000+ en 12-24 maanden naar €200 build cost en 4 weken doorlooptijd.
+
+📘 **Toelichting:** Dit project dient een drievoudig doel:
+1. **Demo voor GGZ-sector:** Tonen van AI-waarde in EPD-workflows (intake → profiel → plan) tijdens inspiratiesessies
+2. **LinkedIn Build in Public:** Wekelijkse transparante updates die viral marketing genereren voor AI consultancy
+3. **Software on Demand Proof:** Bewijs dat enterprise-kwaliteit software nu in weken ipv jaren gebouwd kan worden
+
+**Nieuwe Strategie (v2.1):**
+- **Vereenvoudigde user journey:** Geen separate EPD demo pagina meer
+- **Features in timeline:** Build-in-public transparantie met features showcase per week
+- **Login met features:** Directe showcase van EPD capabilities op login pagina
+- **Teal-first design:** Modern, innovatief brand identity (#0D9488)
+
+Het systeem toont praktische AI-integratie: intake samenvattingen in seconden ipv uren, automatische DSM-classificatie, en behandelplannen die direct bruikbaar zijn. Alles met fictieve demo-data, privacy-first design.
+
+**Referenties:**
+- **FO v2.1:** `docs/specs/fo-marketing-app-flow-v2.md` - Vereenvoudigde user journey
+- **UX Plan v2.0:** `docs/specs/ux-implementation-plan-v2.md` - Teal-first design system
+
+---
+
+## 2. Uitgangspunten
+
+### 2.1 Technische Stack
+
+🎯 **Doel:** Modern, bewezen technologie stack voor snelle development en lage run costs.
+
+**Frontend:**
+- **Framework:** Next.js 15 (App Router) - Single repo voor marketing + EPD
+- **Styling:** Tailwind CSS v3.4 met teal-first design system
+- **UI Components:** shadcn/ui + custom components (Timeline, AIButton)
+- **Rich Text:** TipTap editor (ProseMirror basis) - Week 3
+- **Icons:** Lucide React
+- **Animations:** Framer Motion (voor timeline scroll effects)
+- **State:** Zustand + React Context (simpel maar effectief)
+
+**Backend:**
+- **API:** Next.js Route Handlers (server-side)
+- **Database:** Supabase (PostgreSQL + Auth + Storage) - EU region
+- **AI:** Claude 3.5 Sonnet (Anthropic) - Superieur voor Nederlands
+- **Hosting:** Vercel (EU region Amsterdam)
+
+**Development & Tools:**
+- **Version Control:** GitHub (public repo voor transparantie)
+- **Type Safety:** TypeScript overal
+- **Package Manager:** pnpm (sneller dan npm)
+- **AI Pair Programming:** Cursor IDE
+- **Testing:** Vitest + Playwright (basis coverage)
+
+### 2.2 Projectkaders
+
+🎯 **Doel:** Realistische constraints voor 4-weken sprint.
+
+- **Tijd:** 4 weken part-time (80-120 uur totaal)
+- **Budget:** €200 totaal (€50/maand runtime target)
+- **Team:** 1 developer (Colin) + AI tools als co-pilot
+- **Data:** 100% fictieve demo data
+- **Scope:** MVP voor 10-min demo + marketing site
+- **Launch:** LinkedIn viral series + demo sessies
+
+### 2.3 Programmeer Uitgangspunten
+
+🎯 **Doel:** Code quality zonder over-engineering voor MVP.
+
+**Core Principles:**
+- **DRY:** Herbruikbare componenten, centrale configs
+- **KISS:** Simpele oplossingen boven complexiteit
+- **SOC:** UI/logic/data layers gescheiden
+- **YAGNI:** Alleen bouwen wat nu nodig is
+
+**Development Practices:**
+- **Iteratief:** Ship daily, perfect later
+- **AI-First:** Laat Claude/Cursor heavy lifting doen
+- **Copy-Paste OK:** Voor MVP snelheid > perfectie
+- **Error Handling:** User-friendly messages overal
+- **Security:** API keys server-side, RLS in Supabase
+
+**Design System:**
+- **Primary Color:** Teal (#0D9488 / teal-600) - Innovation signal
+- **AI Color:** Amber (#F59E0B / amber-500) - AI actions
+- **Neutral:** Slate scale voor professional foundation
+- **Typography:** Crimson Text (serif) + Inter (sans) + JetBrains Mono
+
+---
+
+## 3. Epics & Stories Overzicht
+
+🎯 **Doel:** 8 duidelijke epics voor 4-weken development sprint - **Marketing First Strategy met vereenvoudigde user journey**.
+
+| Epic ID | Titel | Doel | Status | Story Count | Week |
+|---------|-------|------|--------|-------------|------|
+| **WEEK 1 - FOUNDATION & MARKETING REFACTOR** |||||
+| E0 | Project Setup | Next.js + Supabase + Vercel running | ✅ Compleet | 5 | 1 |
+| E1 | Marketing Website Refactor | Homepage met timeline + login met features | 🔄 In Progress | 7 | 1 |
+| E2 | Design System Migration | Teal-first colors + component updates | ⏳ To Do | 5 | 1 |
+| **WEEK 2 - EPD CORE** |||||
+| E3 | Database & Auth | Schema + RLS + demo users | ✅ Compleet | 4 | 2 |
+| E4 | Core UI & Client Module | Layout + Client CRUD + Navigation | ⏳ To Do | 5 | 2 |
+| **WEEK 3 - AI MAGIC** |||||
+| E5 | Intake & AI Integration | TipTap + Claude API + Prompts | ⏳ To Do | 6 | 3 |
+| E6 | Profile & Plan | DSM + behandelplan flows | ⏳ To Do | 4 | 3 |
+| **WEEK 4 - POLISH & LAUNCH** |||||
+| E7 | Onboarding System | Walkthrough + tooltips + help | ⏳ To Do | 4 | 4 |
+| E8 | Performance & Launch | Optimization + demo prep | ⏳ To Do | 4 | 4 |
+
+---
+
+## 4. Epics & Stories (Uitwerking)
+
+### Epic 0 — Project Setup
+
+**Epic Doel:** Werkende development omgeving met alle benodigde tools en dependencies.
+
+| Story ID | Beschrijving | Acceptatiecriteria | Status | Afhankelijkheden | Story Points |
+|----------|--------------|---------------------|--------|------------------|--------------|
+| E0.S1 | Repository aanmaken | GitHub repo + lokale clone, `.gitignore` config | ✅ | — | 1 |
+| E0.S2 | Next.js project initialisatie | Next.js 15 App Router draait, dev server start | ✅ | E0.S1 | 2 |
+| E0.S3 | Supabase setup | Project aangemaakt, database connected, Auth enabled | ✅ | E0.S2 | 3 |
+| E0.S4 | Dependencies installeren | Tailwind, shadcn/ui, Framer Motion, Lucide geïnstalleerd | ✅ | E0.S2 | 2 |
+| E0.S5 | Environment variables | `.env.local` + Vercel vars geconfigureerd | ✅ | E0.S3 | 1 |
+
+**Technical Notes:**
+- Gebruik `pnpm` voor snellere installs
+- `.env.example` committen voor team onboarding
+- Supabase project in EU region (Amsterdam)
+
+---
+
+### Epic 1 — Marketing Website Refactor
+
+**Epic Doel:** Vereenvoudigde marketing homepage met timeline (features showcase) en login pagina met features.
+
+| Story ID | Beschrijving | Acceptatiecriteria | Status | Afhankelijkheden | Story Points |
+|----------|--------------|---------------------|--------|------------------|--------------|
+| E1.S1 | Verwijder EPD demo pagina | `/epd` route verwijderd, navigation updated | ⏳ | E0.S5 | 1 |
+| E1.S2 | Homepage vereenvoudigen | Manifesto content verwijderd, statement section toegevoegd | ⏳ | E1.S1 | 3 |
+| E1.S3 | Timeline component integreren | Aceternity timeline met features per week | ⏳ | E1.S2 | 5 |
+| E1.S4 | Timeline content structuur | `content/nl/timeline.json` met features array | ⏳ | E1.S3 | 2 |
+| E1.S5 | Login pagina refactor | Split-screen layout: features links, login rechts | ⏳ | E1.S1 | 4 |
+| E1.S6 | Features showcase component | Herbruikbare feature cards voor timeline + login | ⏳ | E1.S3, E1.S5 | 3 |
+| E1.S7 | CTA updates | Homepage CTA naar `/login`, navigation cleanup | ⏳ | E1.S2, E1.S5 | 1 |
+
+**Technical Notes:**
+- Timeline component: `components/ui/timeline.tsx` (Aceternity UI pattern)
+- Features data: `content/nl/timeline.json` (met features array per week)
+- Login layout: Inspiratie van `components/ui/sign-in.tsx`
+- Mobile: Stack layout voor login pagina (features boven, form onder)
+
+**Content Structure:**
+```json
+// content/nl/timeline.json
+{
+  "weeks": [
+    {
+      "weekNumber": 1,
+      "title": "Week 1 • Nov 11-17",
+      "status": "completed",
+      "description": "...",
+      "features": [
+        {
+          "title": "AI-Gestuurde Intake",
+          "description": "...",
+          "time": "< 5 seconden",
+          "traditional": "15-20 minuten handmatig",
+          "icon": "Brain"
+        }
+      ],
+      "metrics": { ... },
+      "achievements": [ ... ]
+    }
+  ]
+}
+```
+
+---
+
+### Epic 2 — Design System Migration
+
+**Epic Doel:** Teal-first design system implementeren (migratie van blue naar teal).
+
+| Story ID | Beschrijving | Acceptatiecriteria | Status | Afhankelijkheden | Story Points |
+|----------|--------------|---------------------|--------|------------------|--------------|
+| E2.S1 | Tailwind config update | Teal brand colors, amber AI colors | ⏳ | E0.S4 | 2 |
+| E2.S2 | Global CSS variables | `--primary`, `--info` naar teal | ⏳ | E2.S1 | 1 |
+| E2.S3 | Component color updates | Buttons, links, navigation naar teal | ⏳ | E2.S2 | 3 |
+| E2.S4 | AIButton component | Amber gradient button voor AI actions | ⏳ | E2.S1 | 2 |
+| E2.S5 | Contrast testing | WCAG AA compliance voor teal colors | ⏳ | E2.S3 | 1 |
+
+**Technical Notes:**
+- Primary: `teal-600` (#0D9488)
+- AI actions: `amber-500` (#F59E0B)
+- Test contrast: WebAIM Contrast Checker
+- Rollback plan: Git revert indien nodig
+
+**Color Palette:**
+```typescript
+// tailwind.config.ts
+colors: {
+  brand: {
+    600: '#0D9488', // PRIMARY
+    700: '#0F766E', // Hover
+    // ... full scale
+  },
+  ai: colors.amber, // AI features
+}
+```
+
+---
+
+### Epic 3 — Database & Auth
+
+**Epic Doel:** Werkend datamodel met seed data, auth flow en RLS policies.
+
+| Story ID | Beschrijving | Acceptatiecriteria | Status | Afhankelijkheden | Story Points |
+|----------|--------------|---------------------|--------|------------------|--------------|
+| E3.S1 | Database schema | 5 core tables: clients, intake_notes, problem_profiles, treatment_plans, ai_events | ✅ | E0.S3 | 5 |
+| E3.S2 | RLS policies | Row-level security per table (user isolation) | ✅ | E3.S1 | 3 |
+| E3.S3 | Demo users seed | demo@mini-ecd.demo account aangemaakt | ✅ | E3.S2 | 1 |
+| E3.S4 | Auth flow | Magic link + password login werkend | ✅ | E3.S3 | 2 |
+
+**Technical Notes:**
+- Schema: PostgreSQL via Supabase
+- RLS: `auth.uid() = created_by` pattern
+- Demo users: Shared dataset voor demo purposes
+- Auth: Supabase Auth (magic link + password)
+
+---
+
+### Epic 4 — Core UI & Client Module
+
+**Epic Doel:** EPD app foundation: layout, client CRUD, navigation.
+
+| Story ID | Beschrijving | Acceptatiecriteria | Status | Afhankelijkheden | Story Points |
+|----------|--------------|---------------------|--------|------------------|--------------|
+| E4.S1 | Coming Soon dashboard | `/epd/clients` placeholder met roadmap | ⏳ | E3.S4 | 2 |
+| E4.S2 | App layout | Header + sidebar + main content area | ⏳ | E4.S1 | 3 |
+| E4.S3 | Client list page | CRUD operations, table view, filters | ⏳ | E4.S2 | 5 |
+| E4.S4 | Client detail page | Tabs: Intake, Profile, Plan (placeholders) | ⏳ | E4.S3 | 3 |
+| E4.S5 | Navigation & routing | App routes, breadcrumbs, logout flow | ⏳ | E4.S2 | 2 |
+
+**Technical Notes:**
+- Layout: Separate van marketing (app header vs MinimalNav)
+- Client CRUD: Forms met validation (Zod)
+- Routing: `/epd/clients` namespace
+- Mobile: Responsive table → card layout
+
+---
+
+### Epic 5 — Intake & AI Integration
+
+**Epic Doel:** TipTap editor + Claude API voor intake samenvatting en B1 readability.
+
+| Story ID | Beschrijving | Acceptatiecriteria | Status | Afhankelijkheden | Story Points |
+|----------|--------------|---------------------|--------|------------------|--------------|
+| E5.S1 | TipTap editor setup | Rich text editor in client detail | ⏳ | E4.S4 | 4 |
+| E5.S2 | Claude API endpoints | `/api/ai/summarize`, `/api/ai/simplify` | ⏳ | E0.S5 | 5 |
+| E5.S3 | AI-rail component | Right panel voor AI suggestions | ⏳ | E5.S2 | 4 |
+| E5.S4 | Prompt engineering | Nederlands prompts voor samenvatting | ⏳ | E5.S2 | 3 |
+| E5.S5 | AI event logging | Log alle AI calls naar `ai_events` table | ⏳ | E5.S2 | 2 |
+| E5.S6 | Error handling | Retry logic, user-friendly errors | ⏳ | E5.S2 | 2 |
+
+**Technical Notes:**
+- TipTap: ProseMirror-based editor
+- Claude: 3.5 Sonnet voor Nederlands
+- Prompts: Templates in `/lib/prompts/`
+- Cost tracking: Log tokens + estimated costs
+
+---
+
+### Epic 6 — Profile & Plan
+
+**Epic Doel:** DSM-light classificatie + SMART behandelplan generatie.
+
+| Story ID | Beschrijving | Acceptatiecriteria | Status | Afhankelijkheden | Story Points |
+|----------|--------------|---------------------|--------|------------------|--------------|
+| E6.S1 | Profile tab UI | DSM categories + severity selector | ⏳ | E4.S4 | 3 |
+| E6.S2 | AI categorize endpoint | `/api/ai/categorize` met DSM-light output | ⏳ | E5.S2 | 4 |
+| E6.S3 | Plan tab UI | SMART doelen form + interventies | ⏳ | E4.S4 | 3 |
+| E6.S4 | AI plan generator | `/api/ai/plan` met 4 secties output | ⏳ | E6.S2 | 5 |
+
+**Technical Notes:**
+- DSM-light: 6 categorieën (stemming, angst, gedrag, etc.)
+- Plan structuur: JSONB in database (flexibel)
+- AI output: Structured JSON voor consistentie
+
+---
+
+### Epic 7 — Onboarding System
+
+**Epic Doel:** User guidance voor eerste gebruik (tooltips, walkthrough).
+
+| Story ID | Beschrijving | Acceptatiecriteria | Status | Afhankelijkheden | Story Points |
+|----------|--------------|---------------------|--------|------------------|--------------|
+| E7.S1 | First-time user detection | Check `user_metadata.onboarded` flag | ⏳ | E4.S2 | 1 |
+| E7.S2 | Tooltip system | React Joyride of custom tooltips | ⏳ | E7.S1 | 3 |
+| E7.S3 | Help documentation | In-app help modal met shortcuts | ⏳ | E7.S2 | 2 |
+| E7.S4 | Skip onboarding | Option om walkthrough te skippen | ⏳ | E7.S2 | 1 |
+
+**Technical Notes:**
+- Tooltips: Highlight key features (AI buttons, etc.)
+- Help: Keyboard shortcuts, feature overview
+- Optional: Skip voor returning users
+
+---
+
+### Epic 8 — Performance & Launch
+
+**Epic Doel:** Optimization, testing, demo preparation.
+
+| Story ID | Beschrijving | Acceptatiecriteria | Status | Afhankelijkheden | Story Points |
+|----------|--------------|---------------------|--------|------------------|--------------|
+| E8.S1 | Performance optimization | Lighthouse > 90, LCP < 2.5s | ⏳ | E7.S4 | 3 |
+| E8.S2 | Accessibility audit | WCAG AA compliance, keyboard nav | ⏳ | E8.S1 | 2 |
+| E8.S3 | Demo dry-run | 10-min demo scenario werkt | ⏳ | E8.S2 | 2 |
+| E8.S4 | Production deployment | Live op Vercel, monitoring setup | ⏳ | E8.S3 | 2 |
+
+**Technical Notes:**
+- Performance: Image optimization, code splitting
+- Accessibility: Focus states, ARIA labels
+- Demo: Pre-seeded data, backup plan
+- Monitoring: Vercel Analytics + error tracking
+
+---
+
+## 5. Kwaliteit & Testplan
+
+🎯 **Doel:** Vastleggen hoe de kwaliteit van het project wordt geborgd.
+
+### Test Types
+
+| Test Type | Scope | Tools | Verantwoordelijke |
+|-----------|-------|-------|-------------------|
+| Unit Tests | Business logic, utilities | Vitest | Developer |
+| Integration Tests | API endpoints, database | Playwright | Developer |
+| Smoke Tests | Kritieke user flows | Manual checklist | Developer |
+| Performance Tests | Load times, API response | Lighthouse | Developer |
+| Accessibility Tests | WCAG AA compliance | axe DevTools | Developer |
+
+### Test Coverage Targets
+
+- **Unit tests:** 80%+ coverage op `/lib` folder
+- **Integration tests:** Alle API endpoints
+- **Smoke tests:** 5 happy flows + 3 error scenarios
+
+### Manual Test Checklist (voor demo)
+
+**Marketing Site:**
+- [ ] Homepage laadt met hero + statement + timeline
+- [ ] Timeline scrollt en toont features per week
+- [ ] Login pagina toont features showcase + form
+- [ ] Navigation werkt (Home, Contact, Login)
+- [ ] Mobile responsive (timeline, login layout)
+
+**EPD App:**
+- [ ] User kan inloggen (magic link + demo credentials)
+- [ ] Coming Soon dashboard toont roadmap
+- [ ] Client CRUD werkt (Week 2)
+- [ ] Intake editor werkt met TipTap (Week 3)
+- [ ] AI samenvatting genereert binnen 5 sec (Week 3)
+- [ ] Profile + Plan tabs werken (Week 3)
+- [ ] Navigatie werkt zonder errors
+- [ ] Mobile view is responsive
+- [ ] Error states tonen user-friendly messages
+
+**Design System:**
+- [ ] Teal colors consistent overal
+- [ ] Amber AI buttons duidelijk
+- [ ] Contrast ratios WCAG AA compliant
+- [ ] Focus states zichtbaar
+
+---
+
+## 6. Demo & Presentatieplan
+
+🎯 **Doel:** Beschrijven hoe de demo wordt gepresenteerd.
+
+### Demo Scenario
+
+**Duur:** 10 minuten  
+**Doelgroep:** GGZ innovatiemanagers + bestuurders  
+**Locatie:** Live op Vercel (backup: localhost)
+
+**Flow:**
+1. **Intro** (1 min): Homepage - Statement + Timeline overview
+2. **Features showcase** (2 min): Timeline scrollen, features per week zien
+3. **Login** (1 min): Login pagina met features showcase
+4. **EPD demo** (4 min):
+   - Client lijst
+   - Nieuwe intake maken
+   - AI samenvatting genereren
+   - Profile + Plan tabs
+5. **Afsluiting** (2 min): Vragen + LinkedIn build-in-public link
+
+**Backup Plan:**
+- Lokale versie klaar bij internet issues
+- Pre-seeded data als AI API niet reageert
+- Screenshots als complete fallback
+
+---
+
+## 7. Risico's & Mitigatie
+
+🎯 **Doel:** Risico's vroeg signaleren en voorzien van oplossingen.
+
+| Risico | Kans | Impact | Mitigatie | Owner |
+|--------|------|--------|-----------|-------|
+| Teal design niet goed ontvangen | Laag | Middel | Rollback plan (1 uur), hybrid approach mogelijk | Developer |
+| Timeline component complex | Middel | Middel | Aceternity UI pattern gebruiken, simplify indien nodig | Developer |
+| Features data structuur te complex | Middel | Laag | Start simpel, iteratief uitbreiden | Developer |
+| AI-output inconsistent | Hoog | Hoog | Snapshot tests, prompt versioning, fallback responses | Developer |
+| API rate limits tijdens demo | Middel | Hoog | Caching, pre-warmed responses, backup data | Developer |
+| Tijdsdruk deadline | Hoog | Middel | Prioriteer MVP features, cut scope indien nodig | Developer |
+| Login pagina layout niet responsive | Laag | Middel | Test op mobile early, stack layout fallback | Developer |
+
+---
+
+## 8. Evaluatie & Lessons Learned
+
+🎯 **Doel:** Reflecteren op het proces en verbeteringen vastleggen.
+
+**Te documenteren na project:**
+- Wat ging goed? Wat niet?
+- Was teal-first design de juiste keuze?
+- Werkt vereenvoudigde user journey beter?
+- Welke AI-tools waren het meest effectief?
+- Welke prompts werkten het beste?
+- Waar liepen we vertraging op?
+- Wat doen we volgende keer anders?
+- Herbruikbare componenten voor volgende projecten
+
+---
+
+## 9. Referenties
+
+🎯 **Doel:** Koppelen aan de overige Mission Control-documenten.
+
+**Mission Control Documents:**
+- **PRD v1.2** — `docs/specs/prd-mini-ecd-v2.md` - Product Requirements & Business Case
+- **FO v2.1** — `docs/specs/fo-marketing-app-flow-v2.md` - Functioneel Ontwerp (vereenvoudigde user journey)
+- **UX Plan v2.0** — `docs/specs/ux-implementation-plan-v2.md` - Teal-first design system
+- **TO v1.2** — `docs/specs/to-mini-ecd-v1_2.md` - Technische Architectuur & Database Schema
+- **API Specs** — `docs/specs/api-acces-mini-ecd.md` - Endpoint Documentation
+
+**External Resources:**
+- Repository: GitHub (public voor transparantie)
+- Deployment: Vercel (EU region Amsterdam)
+- Design: Tailwind CSS + shadcn/ui
+- Documentation: `/docs` folder in repo
+
+---
+
+## 10. Glossary & Abbreviations
+
+| Term | Betekenis |
+|------|-----------|
+| Epic | Grote feature of fase in development (bevat meerdere stories) |
+| Story | Kleine, uitvoerbare taak binnen een epic |
+| Story Points | Schatting van complexiteit (Fibonacci: 1, 2, 3, 5, 8, 13) |
+| MVP | Minimum Viable Product |
+| DRY | Don't Repeat Yourself |
+| KISS | Keep It Simple, Stupid |
+| SOC | Separation of Concerns |
+| YAGNI | You Aren't Gonna Need It |
+| RLS | Row Level Security (Supabase) |
+| WCAG | Web Content Accessibility Guidelines |
+| LCP | Largest Contentful Paint (performance metric) |
+
+---
+
+## Versiehistorie
+
+| Versie | Datum | Auteur | Wijziging |
+|--------|-------|--------|-----------|
+| v2.1 | 17-11-2024 | Colin | Nieuw bouwplan op basis van FO v2.1 (vereenvoudigde user journey) en UX Plan v2.0 (teal-first design). Verwijderd: EPD demo pagina. Nieuw: Timeline met features, login met features showcase. |
+| v1.6 | 15-11-2024 | Colin | Eerdere versie met separate EPD demo pagina |
+
+---
+
+**Status:** Ready for Week 1 Implementation  
+**Next Action:** Begin Epic 1 (Marketing Website Refactor)  
+**Owner:** Colin Lit  
+**Timeline:** Week 1-4 (4 weken sprint)
+

docs/specs/fo-marketing-app-flow-v2.md

@@ -0,0 +1,699 @@
+# 🧩 Functioneel Ontwerp (FO) – Marketing & App Flow v2.1
+
+**Projectnaam:** AI Speedrun - Mini-EPD Prototype
+**Versie:** v2.1 (Vereenvoudigde User Journey)
+**Datum:** 17-11-2024
+**Auteur:** Colin Lit
+
+---
+
+## 1. Doel en relatie met het PRD
+
+🎯 **Doel van dit document:**
+Dit Functioneel Ontwerp beschrijft de **vereenvoudigde user journey** voor de AI Speedrun marketing website en EPD applicatie. Het lost de huidige UX problemen op (broken links, onduidelijke navigatie) en introduceert een heldere scheiding tussen marketing en applicatie.
+
+📘 **Toelichting aan de lezer:**
+Versie 2.0 is een refactor van de huidige implementatie (v1.2). De belangrijkste wijzigingen:
+- **Marketing vereenvoudigd**: Van lange manifesto naar compacte statement + timeline met features
+- **Geen separate EPD demo pagina**: Features worden getoond in timeline op homepage en op login pagina
+- **Duidelijke app routing**: `/epd/*` namespace voor alle EPD functionaliteit
+- **Werkende flows**: Alle CTA's en login links gaan naar bestaande pagina's
+- **Coming Soon strategie**: Eerlijke communicatie tijdens Week 2 development
+
+Dit document is niet-technisch en beschrijft wat gebruikers zien en kunnen doen.
+
+---
+
+## 2. Overzicht van de belangrijkste onderdelen
+
+🎯 **Doel:** De 4 kernmodules van de applicatie
+
+**Marketing Modules (Publiek):**
+1. **Marketing Homepage** (`/`) - Vereenvoudigde landing met hero, statement en timeline (met features)
+2. **Contact & Leads** (`/contact`) - Lead capture formulier
+
+**Auth & App Modules (Protected/Semi-Protected):**
+3. **Login & Authentication** (`/login`) - Magic link + demo credentials + features showcase
+4. **EPD App Dashboard** (`/epd/clients`) - Coming Soon placeholder (Week 2+)
+
+---
+
+## 3. User Stories
+
+🎯 **Doel:** Wat gebruikers kunnen en willen doen
+
+### Prioriteit: Hoog (MVP Critical)
+
+| ID | Rol | Doel / Actie | Verwachte waarde | Status |
+|----|-----|--------------|------------------|--------|
+| US-01 | Marketing bezoeker | Homepage bekijken met project statement en voortgang | Begrijpen wat AI Speedrun doet en volgen van build progress + features zien | ✅ Te implementeren |
+| US-02 | Marketing bezoeker | EPD features bekijken in timeline | Zien wat het prototype kan (features getoond in timeline op homepage) | ✅ Te implementeren |
+| US-03 | Marketing bezoeker | Contact opnemen voor lead | Interesse tonen in Software on Demand services | ✅ Bestaand |
+| US-04 | Demo gebruiker | Inloggen met demo credentials | Toegang tot EPD app prototype | ✅ Bestaand (fix redirect) |
+| US-05 | Demo gebruiker | Coming Soon dashboard zien | Weten dat app in Week 2 komt + verwachtingen managen | ✅ Te implementeren |
+| US-06 | Terugkerende gebruiker | Direct naar login navigeren | Snel inloggen zonder homepage te moeten bezoeken | ✅ Te implementeren (nav link) |
+
+### Prioriteit: Middel (Nice to Have)
+
+| ID | Rol | Doel / Actie | Verwachte waarde | Status |
+|----|-----|--------------|------------------|--------|
+| US-07 | Ingelogde gebruiker | Uitloggen | Sessie beëindigen en terug naar marketing | 🔄 Toekomstig |
+| US-08 | Marketing bezoeker | Wekelijkse updates volgen via timeline | Build in public transparantie ervaren | ✅ Te implementeren |
+| US-09 | Stakeholder | ROI vergelijking zien | Business case begrijpen (traditioneel vs AI) | ⏸️ On hold |
+
+### Prioriteit: Laag (Future Enhancement)
+
+| ID | Rol | Doel / Actie | Verwachte waarde | Status |
+|----|-----|--------------|------------------|--------|
+| US-10 | Developer | Interactieve ROI calculator gebruiken | Eigen business case berekenen | ⏸️ On hold |
+| US-11 | LinkedIn volger | Build metrics dashboard zien | Real-time tracking van uren en kosten | ⏸️ On hold |
+
+---
+
+## 4. Functionele werking per onderdel
+
+🎯 **Doel:** Per module beschrijven wat gebruikers kunnen doen
+
+### 4.1 Marketing Homepage (`/`)
+
+**Doel:** Compacte, krachtige introductie van Software on Demand concept met build-in-public transparantie.
+
+**Secties (van boven naar beneden):**
+
+1. **Hero Section** (behouden zoals nu)
+   - Full-viewport quote van Jensen Huang: "Software is eating the world"
+   - Dot-shader achtergrond (subtiel, opacity 0.02)
+   - Scroll indicator
+
+2. **Statement Section** (NIEUW - vervangt lange manifesto)
+   - **Heading**: "Software on Demand: Van €100k naar €200"
+   - **3-4 Paragrafen** in problem → solution → proof format:
+     - *Problem*: Enterprise software kost €100.000+ en duurt 12-24 maanden
+     - *Solution*: AI-powered development verkort dit naar 4 weken en €200
+     - *Proof*: Dit EPD is het bewijs - gebouwd in 4 weken, build in public
+     - *CTA*: Volg de voortgang hieronder
+   - **Visueel**: Clean, serif typography (Crimson Text), breathing room
+
+3. **Timeline Section** (NIEUW - build in public met features showcase)
+   - **Component**: Aceternity UI Timeline (21st.dev)
+   - **Content structure** per week:
+     - Week nummer + datum range (bijv. "Week 1 • Nov 11-17")
+     - Status badge: Completed / In Progress / Planned
+     - Korte beschrijving (3-4 zinnen): wat is er gebouwd
+     - **Features showcase** (NIEUW): 
+       - Per week worden relevante EPD features getoond
+       - Feature cards met: Titel, beschrijving, tijdswinst (bijv. "30 min → 5 sec")
+       - Icons per feature type (Brain voor AI, Zap voor snelheid, etc.)
+       - Visuele highlight van wat er die week gebouwd is
+     - Metrics cards: Development hours, Infrastructure cost
+     - Achievements lijst: Bullets met voltooide features
+     - Optioneel: Screenshot of visual van die week
+   - **Interactie**: Scroll-based animation (timeline ontvouwt)
+   - **Data source**: `content/nl/timeline.json` (met features array per week)
+
+4. **CTA Section** (vereenvoudigd)
+   - **Primary CTA**: "Probeer het prototype" → `/login` (direct naar login met features)
+   - **Secondary CTA**: "Volg voortgang" → Scroll to timeline (anchor link `#timeline`)
+   - **Tertiary**: "Contact" → `/contact`
+   - **Visueel**: Button hierarchy duidelijk (primary = green, secondary = outline)
+
+**Verwijderd uit v1.2:**
+- Lange manifesto content (8000+ woorden)
+- Separate EPD demo pagina (`/epd`) - features nu in timeline
+- Comparison table (verwijderd - niet meer nodig)
+- Multiple insight boxes
+- Statement sections met dark backgrounds
+
+**States:**
+- **Normal**: Alle content zichtbaar
+- **Loading**: Skeleton voor timeline items
+- **Empty state**: (niet van toepassing - statische content)
+
+**Navigatie:**
+- Top: MinimalNav (Home, Contact, Login) - EPD Prototype link verwijderd
+- Footer: Copyright + link naar ikbenlit.nl
+
+---
+
+### 4.2 ~~EPD Demo Info Pagina (`/epd`)~~ VERWIJDERD
+
+**Status:** Deze pagina is verwijderd in v2.1. Features worden nu getoond in:
+- Timeline op homepage (`/`)
+- Features showcase op login pagina (`/login`)
+
+**Reden:** Vereenvoudiging van user journey - gebruikers zien features direct in context van build progress en kunnen direct naar login gaan.
+
+---
+
+### 4.3 Contact & Lead Capture (`/contact`)
+
+**Doel:** Lead acquisition voor Software on Demand consultancy.
+
+**Functionaliteit:** (behouden zoals nu - werkt al)
+- Form fields: Naam, Email, Bericht
+- Client-side validation (Zod)
+- Submit → API `/api/leads` → Supabase `leads` table
+- Success state: "Bedankt! We nemen contact op"
+- Error state: "Er ging iets mis. Probeer opnieuw"
+
+**Navigatie:**
+- Terug naar homepage via nav
+
+---
+
+### 4.4 Login & Authentication (`/login`)
+
+**Doel:** Flexibele auth met magic link (productie) en demo credentials (MVP), inclusief features showcase.
+
+**Layout:** Split-screen design (zoals `sign-in.tsx` component)
+- **Links (60%)**: Features showcase met visuals
+- **Rechts (40%)**: Login formulier
+
+**Features Showcase Sectie (Links):**
+- **Grid layout** met feature cards:
+  - AI-Gestuurde Intake (30 min → 5 sec)
+  - Automatische DSM Classificatie (15 min → 3 sec)
+  - Behandelplan Generatie (45 min → 10 sec)
+  - B1 Readability (30 min → 3 sec)
+- **Visuals**: Icons, stat cards, of screenshots per feature
+- **Metrics**: Tijdswinst per feature prominent getoond
+- **Design**: Inspiratie van `components/ui/sign-in.tsx` collage layout
+
+**Login Form Sectie (Rechts):**
+
+**Twee tabs/modes:**
+
+1. **Magic Link Login** (voor productie users)
+   - Email input
+   - "Stuur Magic Link" button
+   - Success: "Check je email voor login link"
+   - Nieuwe users: Account wordt automatisch aangemaakt
+   - Callback: `/auth/callback` → redirect naar `/epd/clients`
+
+2. **Demo Credentials Login** (voor demo)
+   - Email + Password inputs
+   - Toggle show/hide password
+   - "Login" button
+   - Quick demo button: Auto-fill + submit
+   - Success: Redirect naar `/epd/clients`
+   - Error: "Ongeldige credentials"
+
+**Demo credentials info box:**
+- Gele achtergrond
+- Credentials in monospace font
+- Copy-paste friendly
+
+**States:**
+- Loading: "Inloggen..." spinner
+- Error: Red error message
+- Success: Green message + redirect
+- Mobile: Features sectie wordt boven login form getoond (stack layout)
+
+**Navigatie:**
+- Link in MinimalNav: "Login"
+- Logo → terug naar `/`
+
+---
+
+### 4.5 EPD App - Coming Soon Dashboard (`/epd/clients`)
+
+**Doel:** Eerlijke communicatie dat app in Week 2 gebouwd wordt, manage expectations.
+
+**Functionaliteit:** (NIEUW - te bouwen)
+
+**Layout:**
+```
+┌────────────────────────────────────────────┐
+│ Header: Logo | "EPD Dashboard" | Logout    │
+├────────────────────────────────────────────┤
+│                                            │
+│   [Icon] Coming Soon                       │
+│                                            │
+│   EPD Dashboard - In Ontwikkeling          │
+│                                            │
+│   Week 2 (Nov 18-24): Client management    │
+│   Week 3 (Nov 25-Dec 1): AI integrations   │
+│                                            │
+│   [Mockup screenshot placeholder]          │
+│                                            │
+│   [Button: Terug naar Info] [Logout]       │
+│                                            │
+└────────────────────────────────────────────┘
+```
+
+**Content:**
+- **Heading**: "EPD Dashboard - Coming Week 2"
+- **Beschrijving**:
+  - "De EPD applicatie wordt momenteel gebouwd."
+  - "Bekijk de voortgang op de homepage (timeline sectie)"
+- **Timeline preview**:
+  - Week 2: Client management & CRUD
+  - Week 3: AI integrations (intake, profiel, plan)
+  - Week 4: Polish & onboarding
+- **Mockup/Screenshot**: Wireframe of visual preview van wat komt
+- **Actions**:
+  - Button: "Terug naar Prototype Info" → `/epd`
+  - Button: "Logout" → `/auth/logout` → redirect `/`
+
+**States:**
+- **Authenticated**: Normale weergave
+- **Not authenticated**: Redirect naar `/login` (middleware)
+
+**Navigatie:**
+- Logo → `/epd/clients` (blijf in app context)
+- "Terug naar Info" → `/epd` (exit app)
+- Logout → `/` (marketing)
+
+**Future states (Week 2+):**
+- Replace Coming Soon met werkende client lijst
+- Zelfde layout, andere content
+
+---
+
+## 5. UI-overzicht (visuele structuur)
+
+🎯 **Doel:** Globale schermopbouw voor developers en designers
+
+### 5.1 Marketing Layout (alle publieke paginas)
+
+```
+┌─────────────────────────────────────────────────────┐
+│ MinimalNav (fixed top)                              │
+│ [Logo] Home | Contact | Login                      │
+├─────────────────────────────────────────────────────┤
+│ ReadingProgress (scroll-based bar)                  │
+├─────────────────────────────────────────────────────┤
+│                                                     │
+│               Page Content                          │
+│          (hero, statement, timeline,                │
+│           features, forms, etc.)                    │
+│                                                     │
+├─────────────────────────────────────────────────────┤
+│ Footer: © AI Speedrun | ikbenlit.nl                │
+└─────────────────────────────────────────────────────┘
+```
+
+**Features:**
+- Minimal navigation: scroll-based color change
+- Reading progress bar (client component)
+- No sidebar
+- Full-width content
+- Mobile: Hamburger menu
+
+### 5.2 EPD App Layout (protected paginas)
+
+```
+┌─────────────────────────────────────────────────────┐
+│ App Header                                          │
+│ [Logo: EPD] EPD Dashboard          [User] [Logout] │
+├─────────────────────────────────────────────────────┤
+│                                                     │
+│                  Main Content                       │
+│             (coming soon state                      │
+│              of client list future)                 │
+│                                                     │
+├─────────────────────────────────────────────────────┤
+│ Footer: Terug naar Info | ikbenlit.nl              │
+└─────────────────────────────────────────────────────┘
+```
+
+**Features:**
+- Separate header (geen MinimalNav)
+- User state visible
+- Logout prominent
+- Exit to marketing link
+- Future: Sidebar toevoegen voor app nav
+
+---
+
+## 6. Navigatie Flows & User Journeys
+
+🎯 **Doel:** Visualiseren hoe gebruikers door de applicatie bewegen
+
+### Flow 1: Marketing Bezoeker → Lead
+
+```
+Landing (/)
+  ↓
+Lees Statement + Timeline (met features)
+  ↓
+Decision Point:
+  ├─→ "Probeer het prototype" → /login
+  │     ↓
+  │   Zie features showcase + login form
+  │     ↓
+  │   Login met demo credentials
+  │     ↓
+  │   /epd/clients (Coming Soon)
+  │
+  └─→ "Contact" → /contact
+        ↓
+      Vul formulier in
+        ↓
+      Lead opgeslagen ✓
+```
+
+### Flow 2: Demo Gebruiker → EPD App
+
+```
+Direct naar /login (nav link)
+  ↓
+Kies: Magic Link OF Demo Credentials
+  ↓
+[Demo pad]
+Fill demo@mini-ecd.demo + Demo2024!
+  ↓
+Submit
+  ↓
+Auth success → Middleware redirect
+  ↓
+/epd/clients (Coming Soon)
+  ↓
+Options:
+  ├─→ "Terug naar Info" → /epd
+  └─→ "Logout" → /
+```
+
+### Flow 3: Terugkerende Gebruiker (Week 2+)
+
+```
+Homepage / or direct /login
+  ↓
+Login (magic link of credentials)
+  ↓
+/epd/clients (werkende app)
+  ↓
+Client lijst → Client detail
+  ↓
+Intake → AI → Profiel → Plan
+  ↓
+Logout → terug naar marketing
+```
+
+### Flow 4: Build-in-Public Volger
+
+```
+LinkedIn post → Homepage
+  ↓
+Scroll naar Timeline (met features per week)
+  ↓
+Lees weekly updates + zie features
+  ↓
+Decision:
+  ├─→ "Probeer demo" → /login (met features showcase)
+  ├─→ "Contact" → /contact
+  └─→ Exit (volg op LinkedIn)
+```
+
+---
+
+## 7. Interacties met AI (functionele beschrijving)
+
+🎯 **Doel:** Waar AI voorkomt in toekomstige EPD app (Week 3+)
+
+📘 **Toelichting:** Deze sectie beschrijft toekomstige AI features die nog niet in Coming Soon state zitten.
+
+| Locatie | AI-actie | Trigger | Input | Output | Timing |
+|---------|----------|---------|-------|--------|--------|
+| Intake Editor | Samenvatten | Button "AI Samenvatten" | TipTap editor content (max 20k chars) | 5-8 bullets in rechterpaneel | ~3-5 sec |
+| Intake Editor | B1 Leesbaarheid | Button "Vereenvoudig taal" | Selected text of hele intake | Herschreven versie in B1 Nederlands | ~5 sec |
+| Profiel Tab | Extract Problemen | Button "AI Analyse" | Intake content | DSM-light categorie + severity + rationale | ~5-8 sec |
+| Plan Tab | Genereer Plan | Button "Genereer Behandelplan" | Profiel + intake data | 4 secties: Doelen, Interventies, Freq/Duur, Meetmomenten | ~10-15 sec |
+
+**AI-rail (rechterpaneel) gedrag:**
+- Slides in vanaf rechts bij AI actie
+- Loading state: Spinner + "AI analyseert..."
+- Result state: Content + bronverwijzingen
+- Actions: "Invoegen", "Regenereer", "Annuleer"
+- Preview mode: Highlight waar content ingevoegd wordt
+
+**Cost tracking** (toekomstig):
+- Alle AI calls worden gelogd in `ai_events` table
+- Dashboard toont: Aantal calls, tokens gebruikt, geschatte kosten
+- Target: <€5/maand voor MVP demo use
+
+---
+
+## 8. Routes & Toegangsrechten
+
+🎯 **Doel:** Duidelijk overzicht welke routes publiek of protected zijn
+
+### Publieke Routes (geen auth vereist)
+
+| Route | Naam | Functie | Status |
+|-------|------|---------|--------|
+| `/` | Marketing Homepage | Statement + Timeline (met features) | ✅ Refactor |
+| `/contact` | Contact Form | Lead capture | ✅ Bestaand |
+| `/login` | Login Pagina | Auth flow + features showcase | ✅ Refactor |
+| `/auth/callback` | OAuth Callback | Magic link handler | ✅ Bestaand |
+
+**Verwijderd:**
+- `/epd` - EPD Demo Info pagina (features nu in timeline en login)
+
+### Protected Routes (auth vereist)
+
+| Route | Naam | Functie | Status |
+|-------|------|---------|--------|
+| `/epd/clients` | EPD Dashboard | Coming Soon (Week 2: Client lijst) | ⏳ Te bouwen |
+| `/epd/clients/[id]` | Client Detail | Client dossier (Week 2) | 🔄 Toekomstig |
+| `/epd/clients/[id]/intake` | Intake Editor | TipTap + AI (Week 3) | 🔄 Toekomstig |
+| `/epd/clients/[id]/profile` | Probleem Profiel | DSM-light + AI (Week 3) | 🔄 Toekomstig |
+| `/epd/clients/[id]/plan` | Behandelplan | SMART doelen + AI (Week 3) | 🔄 Toekomstig |
+
+### API Routes
+
+| Route | Naam | Functie | Auth | Status |
+|-------|------|---------|------|--------|
+| `/api/leads` | Lead Submission | POST contact form data | No | ✅ Bestaand |
+| `/api/ai/summarize` | AI Summarize | POST intake → bullets | Yes | 🔄 Week 3 |
+| `/api/ai/categorize` | AI Categorize | POST intake → DSM profile | Yes | 🔄 Week 3 |
+| `/api/ai/plan` | AI Plan Generator | POST profile → treatment plan | Yes | 🔄 Week 3 |
+| `/auth/logout` | Logout | Supabase signOut | Yes | ✅ Bestaand |
+
+### Middleware Logic (simplified)
+
+```typescript
+// Public routes (no redirect)
+const publicRoutes = [
+  '/', '/contact', '/login',
+  '/auth/callback', '/auth/logout'
+]
+
+// Logic
+if (!user && !isPublicRoute) {
+  redirect('/login?redirect=' + pathname)
+}
+
+if (user && pathname === '/login') {
+  redirect('/epd/clients')
+}
+```
+
+---
+
+## 9. Content Management Strategie
+
+🎯 **Doel:** Hoe content beheerd en bijgewerkt wordt
+
+### Timeline Content (Build-in-Public updates)
+
+**Locatie**: `content/timeline/` of `content/nl/timeline.json`
+
+**Structuur per week**:
+```json
+{
+  "weekNumber": 1,
+  "title": "Week 1 • Nov 11-17",
+  "status": "completed", // completed | in_progress | planned
+  "description": "Marketing site foundation. Hero, statement setup, database schema aangemaakt.",
+  "features": [
+    {
+      "title": "AI-Gestuurde Intake",
+      "description": "Schrijf een intakeverslag en krijg binnen seconden een gestructureerde samenvatting",
+      "time": "< 5 seconden",
+      "traditional": "15-20 minuten handmatig",
+      "icon": "Brain"
+    },
+    {
+      "title": "Automatische DSM Classificatie",
+      "description": "Het systeem analyseert de intake en stelt DSM-categorieën voor",
+      "time": "< 3 seconden",
+      "traditional": "10-15 minuten analyse",
+      "icon": "Zap"
+    }
+  ],
+  "metrics": {
+    "developmentHours": 30,
+    "infrastructureCost": 50,
+    "totalCost": 50
+  },
+  "achievements": [
+    "Landing page met hero + statement",
+    "Timeline component met features",
+    "Contact form + lead capture API",
+    "Database schema (5 core tables)",
+    "Supabase Auth + RLS policies"
+  ],
+  "visual": "/timeline/week-1-screenshot.png" // optional
+}
+```
+
+**Update frequency**: Einde van elke week (zaterdag/zondag)
+
+**Ownership**: Handmatig door Colin via JSON edit
+
+**Alternative**: MDX files met frontmatter voor meer flexibiliteit
+
+### Static Content (niet-timeline)
+
+| Content Type | Locatie | Format | Update Freq |
+|--------------|---------|--------|-------------|
+| Navigation | `content/nl/navigation.json` | JSON | Ad-hoc |
+| Timeline (met features) | `content/nl/timeline.json` | JSON | Weekly |
+| EPD Features (voor login) | `content/nl/epd.json` | JSON | Rarely |
+| Metadata (SEO) | `content/nl/metadata.json` | JSON | Once |
+
+---
+
+## 10. Gebruikersrollen en rechten
+
+🎯 **Doel:** Wie kan wat binnen de applicatie
+
+| Rol | Toegang tot | Beperkingen | Auth Method |
+|-----|-------------|-------------|-------------|
+| **Anonymous Visitor** | Marketing pages (/, /contact, /login) | Geen EPD app toegang | - |
+| **Demo User** | Alles (marketing + EPD app) | Fictieve data only, geen wijzigingen persistent | Email/password (demo credentials) |
+| **Magic Link User** | Marketing + EPD app (toekomstig) | Eigen dossiers (RLS) | Magic link email |
+| **Admin** (toekomstig) | Alle dossiers + metrics | - | Special credentials |
+
+**RLS (Row Level Security) in Supabase:**
+- Elke gebruiker ziet alleen eigen clients/notes/profiles/plans
+- Policy: `auth.uid() = created_by`
+- Demo users delen fictieve dataset
+- Real users: isolated per user_id
+
+---
+
+## 11. States & Edge Cases
+
+🎯 **Doel:** Hoe systeem omgaat met uitzonderlijke situaties
+
+### Marketing Website
+
+| Scenario | Gedrag |
+|----------|--------|
+| Timeline data niet beschikbaar | Toon skeleton loading + "Updates coming soon" |
+| Image load failure | Fallback naar placeholder met initials |
+| Form submission error | Retry optie + error message + support email |
+| Slow network | Progressive loading, defer non-critical content |
+
+### Login Flow
+
+| Scenario | Gedrag |
+|----------|--------|
+| Ongeldige demo credentials | Error: "Credentials incorrect. Gebruik demo@mini-ecd.demo" |
+| Magic link expired | Error + "Request new link" button |
+| Already logged in | Direct redirect naar `/epd/clients` |
+| Network error tijdens auth | Error message + retry button |
+
+### EPD App (Coming Soon)
+
+| Scenario | Gedrag |
+|----------|--------|
+| User bezoekt direct `/epd/clients` | Middleware check → redirect `/login` als niet ingelogd |
+| Logout tijdens session | Redirect naar `/` + success toast |
+| Session expired | Redirect naar `/login` + "Session verlopen, log opnieuw in" |
+
+### Week 2+ (Toekomstig - Client CRUD)
+
+| Scenario | Gedrag |
+|----------|--------|
+| Lege state (geen clients) | "Voeg je eerste cliënt toe" + CTA button |
+| Delete confirmation | Modal: "Weet je zeker? Alle dossiers worden verwijderd" |
+| Concurrent edit conflict | Toast: "Data is veranderd, herlaad pagina" |
+| AI API failure | Retry 3x, dan error + support contact |
+
+---
+
+## 12. Bijlagen & Referenties
+
+🎯 **Doel:** Linken naar gerelateerde documenten
+
+**Mission Control Documents:**
+- **PRD v1.2** (`docs/specs/prd-mini-ecd-v2.md`) - Product Requirements & Business Case
+- **TO v1.2** (`docs/specs/to-mini-ecd-v1_2.md`) - Technische Architectuur & Database Schema
+- **Bouwplan v1.6** (`docs/specs/bouwplan-ai-speedrun-marketing-first-v1.1.md`) - Epic & Story Planning
+- **UX Stylesheet** (`docs/specs/ux-stylesheet.md`) - Design System & Tailwind Config
+- **API Specs** (`docs/specs/api-acces-mini-ecd.md`) - Endpoint Documentation
+
+**External Resources:**
+- [Aceternity UI Timeline](https://21st.dev/r/timeline) - Timeline component inspiratie
+- [Supabase Auth Docs](https://supabase.com/docs/guides/auth) - Authentication flows
+- [Next.js 15 Routing](https://nextjs.org/docs/app/building-your-application/routing) - App Router patterns
+
+**Design References:**
+- `docs/design/timeline-comp.tsx` - Timeline component voorbeeld
+- Bestaande marketing components in `app/(marketing)/components/`
+
+---
+
+## 13. Implementatie Prioriteiten (voor Developers)
+
+🎯 **Doel:** Volgorde van bouwen voor maximale impact
+
+### 🔴 Critical (Week 1 fixes - nu)
+
+1. **Verwijder EPD demo pagina** (15 min)
+   - Delete `/app/(marketing)/epd/page.tsx`
+   - Update navigation (verwijder "EPD Prototype" link)
+   - Update middleware (verwijder `/epd` uit public routes)
+
+2. **Coming Soon page** (30 min)
+   - Create `/epd/clients/page.tsx`
+   - Simple layout + logout
+   - Middleware redirect update
+
+### 🟡 High Priority (Week 1-2 refactor)
+
+3. **Timeline component met features** (3-4 uur)
+   - Install/copy Aceternity timeline
+   - Create timeline content JSON met features array
+   - Add features showcase per week item
+   - Add to homepage
+
+4. **Homepage vereenvoudiging** (2-3 uur)
+   - Remove manifesto long-form
+   - Add statement section
+   - Integrate timeline (met features)
+   - Update CTA: "Probeer het prototype" → `/login`
+
+5. **Login pagina met features showcase** (2-3 uur)
+   - Split-screen layout (features links, login rechts)
+   - Features grid component (hergebruik van EPD features)
+   - Mobile responsive (stack layout)
+   - Integreer bestaande login functionaliteit
+
+### 🟢 Medium Priority (Week 2 app build)
+
+5. **EPD App foundation** (Week 2)
+   - Client CRUD
+   - App layout met sidebar
+   - Navigation tussen contexts
+
+6. **AI integrations** (Week 3)
+   - API endpoints
+   - TipTap editor
+   - AI-rail components
+
+---
+
+## Changelog
+
+| Versie | Datum | Auteur | Wijzigingen |
+|--------|-------|--------|-------------|
+| v2.0 | 17-11-2024 | Colin | Initiële versie - Refactor van v1.2 implementatie. Nieuwe timeline approach, vereenvoudigde marketing, /epd/* routing, coming soon strategie |
+| v2.1 | 17-11-2024 | Colin | Verwijderd: Separate EPD demo pagina (/epd). Features nu in timeline op homepage en features showcase op login pagina. Vereenvoudigde user journey. |
+
+---
+
+**Einde Functioneel Ontwerp v2.1**