triqura-ecd/docs/swift/bouwplan-swift-standalone-module.md

Mission Control - Bouwplan

Projectnaam: Swift Standalone Module (MVP)
Versie: v1.0
Datum: 27-12-2025
Auteur: Colin Lit

---

1. Doel en context

Doel: Swift loskoppelen van de klassieke EPD layout zodat de Swift UI full-screen draait zonder sidebar.
Toelichting: Swift is een aparte modus (conversational scribe) die focus en ruimte nodig heeft. In de huidige app router erft /epd/swift de EPD layout, waardoor de sidebar blijft staan. Dit plan brengt Swift onder een eigen route group, behoudt dezelfde URL, en voorkomt regressies in het klassieke EPD.

Belangrijke overwegingen:

• Lead dev: zuivere layout scheiding via route group, minimale impact, geen conditionele layout hacks.
• UX: full-screen focus, duidelijke entry/exit, geen dubbele navigatie, consistente context bar.
• PO: MVP scope, beperkte wijzigingen, geen nieuwe features of dependencies.
• Besluit: route group is akkoord (27-12-2025).

UX flow (MVP):

• Toegang via login: interface-voorkeur bepaalt redirect (Swift -> /epd/swift, klassiek -> /epd/clients).
• Deep link naar /epd/swift zonder sessie: login volgt en redirect gaat alsnog op basis van interface-voorkeur.
• Terug naar EPD: context bar link naar /epd.
• Schakelen vanuit klassiek EPD: Swift staat als item in de EPD sidebar.

---

2. Uitgangspunten

2.1 Technische Stack

• Frontend: Next.js App Router + React + TypeScript
• Styling: Tailwind CSS
• State: Zustand
• Auth: Supabase Auth
• API: Next.js route handlers (SSE voor Swift chat)
• Hosting: Vercel

2.2 Projectkaders

• Scope (MVP): alleen layout/routing scheiding + minimale navigatie checks.
• Out of scope: nieuwe Swift features, redesign van chat/artifacts, nieuwe AI flows.
• Geen nieuwe dependencies zonder akkoord.
• Geen database migraties nodig.
• URL /epd/swift blijft gelijk voor deep links.
• Klassiek EPD moet onveranderd blijven.

2.3 Programmeer Uitgangspunten

Code quality principles:

• DRY: shared layout helpers en routes hergebruiken waar logisch.
• KISS: route group boven conditionele rendering.
• SOC: Swift layout los van EPD layout, geen cross-coupling.
• YAGNI: geen extra features buiten layout scheiding.

Development practices:

• Geen nieuwe dependencies of migrations zonder akkoord.
• Keep server components default; alleen client waar nodig.
• Duidelijke error handling bij auth redirect.
• UI blijft Tailwind-only, geen styling drift.

---

3. Epics & Stories Overzicht

Epic ID	Titel	Doel	Status	Stories	Opmerkingen
E0	Product/UX alignment	Scope en UX flows vastleggen	Done	2	Route group akkoord
E1	Routing & layout scheiding	Swift los van EPD layout	Done	4	/epd/swift blijft
E2	Navigatie & toegang	Entry/exit flows borgen	Done	3	MVP only
E3	Swift shell polish	Full-screen gedrag + responsive	To Do	3	Geen redesign
E4	QA & docs	Validatie en documentatie	To Do	3	Manual checks

---

4. Epics & Stories (Uitwerking)

Epic 0 - Product/UX alignment

Epic doel: beslissen over aanpak en de MVP scope vastleggen.

Story ID	Beschrijving	Acceptatiecriteria	Status	Afhankelijkheden	Story Points
E0.S1	Besluit en scope vastleggen	Keuze voor route group vastgelegd + out of scope lijst	Done	-	2
E0.S2	UX entry/exit flow vastleggen	Flow voor toegang en terug naar EPD gedocumenteerd	Done	E0.S1	2

Technical notes:

• Geen code changes voor E0; alleen documentatie en alignment.

Epic 1 - Routing & layout scheiding

Epic doel: Swift UI draait full-screen buiten EPD layout.

Story ID	Beschrijving	Acceptatiecriteria	Status	Afhankelijkheden	Story Points
E1.S1	Route group toevoegen	app/(swift) bestaat en /epd/swift blijft werken	Done	E0.S1	3
E1.S2	Swift layout isoleren	Swift layout rendert full-screen zonder sidebar	Done	E1.S1	3
E1.S3	Auth guard borgen	Ongeauth users redirect naar /login zoals nu	Done	E1.S2	2
E1.S4	EPD layout regressie check	Klassiek EPD layout ongewijzigd	Done	E1.S2	2

Technical notes:

• Geen nieuwe dependencies.
• Route group moet alleen Swift raken, niet EPD.
• EPDHeader wordt niet gebruikt in Swift; ContextBar is de top bar.

Epic 2 - Navigatie & toegang

Epic doel: gebruikers kunnen Swift starten en verlaten zonder verwarring.

Story ID	Beschrijving	Acceptatiecriteria	Status	Afhankelijkheden	Story Points
E2.S1	Entry points controleren	Links naar /epd/swift werken (EPD menu/login)	Done	E1.S2	2
E2.S2	Exit back-link verifiëren	Context bar link naar /epd blijft consistent	Done	E1.S2	1
E2.S3	Deep link gedrag	Directe URL naar /epd/swift werkt met auth	Done	E1.S3	2

Technical notes:

• Geen nieuwe navigatie items tenzij nodig voor MVP.

Epic 3 - Swift shell polish

Epic doel: full-screen ervaring is clean en consistent.

Story ID	Beschrijving	Acceptatiecriteria	Status	Afhankelijkheden	Story Points
E3.S1	Full-screen layout check	Geen sidebar spacing of EPD padding zichtbaar	To Do	E1.S2	2
E3.S2	Responsive gedrag check	Chat/artifacts stacken op mobiel zoals nu	To Do	E1.S2	2
E3.S3	Visuele consistentie	Context bar en offline banner correct gepositioneerd	To Do	E1.S2	1

Technical notes:

• Geen redesign of nieuwe UI componenten.

Epic 4 - QA & docs

Epic doel: MVP kwaliteit borgen en documentatie bijwerken.

Story ID	Beschrijving	Acceptatiecriteria	Status	Afhankelijkheden	Story Points
E4.S1	Manual QA checklist	Alle kritieke flows handmatig getest	To Do	E3.S2	2
E4.S2	Bouwplan en docs bijwerken	Bouwplan + korte notitie in docs/swift	To Do	E4.S1	1
E4.S3	Release note (kort)	Interne note met UX impact	To Do	E4.S1	1

Technical notes:

• Gebruik pnpm lint voor basis check (geen extra tests).

---

5. Kwaliteit & Testplan

Test types:

Test Type	Scope	Tools	Verantwoordelijke
Lint	App code	pnpm lint	Developer
Smoke tests	Routing + auth + UX flows	Manual checklist	Developer/PO
Responsive check	Layout op mobile/desktop	Browser devtools	UX

Manual test checklist:

• /epd/swift laadt zonder sidebar
• EPDHeader en DocsChatWidget zijn niet zichtbaar in Swift
• Ongeauth redirect naar /login
• Entry vanuit EPD werkt
• Back-link naar /epd werkt
• Chat input werkt, artifacts openen
• Mobile: chat en artifacts stacken correct
• Deep link naar /epd/swift volgt interface-voorkeur na login

---

6. Demo & Presentatieplan

Doel: korte interne demo van de standalone Swift ervaring.

Flow:

1. Open /epd/swift (full-screen, no sidebar)
2. Start een chat en open artifact
3. Ga terug naar /epd via context bar

Backup:

• Gebruik screenshots als live demo faalt.

---

7. Risico's & Mitigatie

Risico	Kans	Impact	Mitigatie	Owner
Route group breekt /epd routing	Laag	Hoog	Isoleren in app/(swift) en regression check	Lead dev
Auth redirect mismatch	Middel	Middel	E1.S3 + manual QA	Lead dev
UX verwarring over modus	Middel	Middel	Duidelijke back-link + docs	UX
Scope creep (extra features)	Hoog	Middel	MVP guardrails in E0	PO
Mobile layout regressie	Laag	Middel	E3.S2 + devtools check	UX

---

8. Evaluatie & Lessons Learned

Na oplevering documenteren:

• Was de mode-scheiding duidelijk voor users?
• Zijn entry/exit flows logisch?
• Zijn er regressies in klassiek EPD?

---

9. Referenties

• Docs: docs/swift/fo-swift-medical-scribe-v3.md
• Docs: docs/swift/v3-redesign-met-huidige-styling.md
• Docs: docs/swift/e0-design-tokens-and-components.md
• Code: app/epd/layout.tsx
• Code: app/(swift)/epd/swift/layout.tsx
• Code: components/swift/command-center/command-center.tsx

---

10. Glossary & Abbreviations

Term	Betekenis
Epic	Grote feature of fase in development
Story	Kleine uitvoerbare taak binnen een epic
MVP	Minimum Viable Product
EPD	Elektronisch Patient Dossier
SSE	Server-Sent Events

---

Versiehistorie:

Versie	Datum	Auteur	Wijziging
v1.0	27-12-2025	Colin Lit	Initiele versie