Inspannings Monitor

Wellness-first webapp voor volwassen individuele gebruikers die hun energie willen plannen, uitvoeren en evalueren.

Productrichting

Inspannings Monitor wordt bewust gebouwd als wellness/self-management product, niet als medisch hulpmiddel. Release 1 blijft smal:

• alleen individuele gebruikers
• alleen Nederlands
• geen delen met zorgverleners of naasten
• geen AI of medische workflows in de MVP

Huidige scope

• e-mail/wachtwoord-auth via Supabase
• protected dashboard met server-side sessiecontrole
• ochtendcheck-in voor energiescore en slaapkwaliteit van vandaag
• eenvoudig dagbudget en energieniveau op basis van de ochtendscore
• dashboardweergave van check-instatus, energieniveau en dagbudget
• planningsfundering met activiteitenmodel, categorieën en skip-redenen in Supabase
• planningpagina voor vandaag met activiteit toevoegen en directe lijstweergave
• energiemeter met lopend totaal ten opzichte van het dagbudget
• eerste unit tests voor budget- en meterlogica via Vitest
• korte onboardingflow voor eerste voorkeuren
• instellingen voor taal, timezone, reminders en zichtbaarheid van energiepunten
• shadcn/ui foundation voor knoppen, formulieren, kaarten en meldingen

Stack

• Next.js 16 App Router
• React 19
• TypeScript
• Tailwind CSS
• shadcn/ui component foundation
• Vercel als hostingdoel
• Supabase voor database en authenticatie

Snel lokaal starten

1. Kopieer .env.example naar .env.local
2. Vul in:
   • NEXT_PUBLIC_SUPABASE_URL
   • NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY
   • optioneel: NEXT_PUBLIC_ENABLE_TEST_WIZARD=true voor de interne wizard-testpagina
3. Installeer dependencies met npm install
4. Start lokaal met npm run dev

Scripts

• npm run dev
• npm run build
• npm run start
• npm run lint
• npm run test

Supabase Auth configuratie

1. Zet in Supabase Dashboard aan:
   • Email/password auth
   • Self-signup
   • Email confirmation verplicht
2. Voeg redirect URLs toe voor:
   • http://localhost:3000/auth/confirm
   • je Vercel productie-URL
   • eventuele preview-URL's die je wilt testen

Omgevingsbestanden

Gebruik alleen .env.example als template. Lokale bestanden zoals .env en .env.local horen niet in git thuis.

Supabase database migraties

De huidige app gebruikt onder meer deze migraties:

• supabase/migrations/20260418_create_profiles_and_user_settings.sql
• supabase/migrations/20260418_add_onboarding_seen_to_profiles.sql
• supabase/migrations/20260418_create_morning_check_ins.sql
• supabase/migrations/20260418_add_budget_fields_to_morning_check_ins.sql
• supabase/migrations/20260419_create_activities_and_reference_data.sql

Voer deze SQL uit in de Supabase SQL Editor of via de Supabase CLI voordat je de profile-, check-in- en budgetlagen lokaal test.

UI foundation

De app gebruikt shadcn/ui bovenop Tailwind CSS als herbruikbare basis voor knoppen, formulieren, kaarten en meldingen. De theme tokens staan centraal in app/globals.css, zodat kleur, focus-states en componentgedrag consistenter blijven. Voor feedback na redirects of server actions krijgt de app nu standaard de voorkeur voor sonner-toasts boven losse inline statusmeldingen.

Interne wizard-test

Er is een interne testwizard beschikbaar op /wizard-test om een toekomstige generieke wizard-core te valideren. Deze route en de dashboardknop worden alleen zichtbaar als NEXT_PUBLIC_ENABLE_TEST_WIZARD=true staat.

CI/CD

• CI: GitHub Actions draait automatisch lint en build op pull requests en op main
• CD: Vercel deployt automatisch previews voor branches/PR's en productie vanaf main
• Uitwerking: docs/inspannings-monitor-cicd-en-deploy.md

Documentatie

• Hoofdset specificaties en plannen: docs/README.md
• Technische architectuur: inspannings-monitor-05-technische-architectuur-en-implementatie-v01.docx
• Implementatieplan en backlog: inspannings-monitor-06-implementatieplan-en-backlog-v01.docx

Eerstvolgende bouwstappen

1. ST-303 Autocomplete op eerdere activiteiten toevoegen
2. ST-305 Overschrijdingswaarschuwing toevoegen
3. ST-401 Evaluatie- en dagoverzichtslus bouwen
4. ST-105 RLS-policy tests en hardening afronden