Spring naar hoofdinhoud
Voltooidv1.0.0

Verpleegkundige Rapportage & Overdracht

Centrale module voor verpleegkundige notities, overdracht en AI-gestuurde samenvattingen

Overzicht

De Verpleegkundige Rapportage & Overdracht module biedt een complete workflow voor het vastleggen van verpleegkundige notities en het voorbereiden van overdrachten aan de volgende dienst. De module bestaat uit twee hoofdschermen: Rapportage voor het invoeren van notities en Overdracht voor het overzicht met AI-samenvatting.

Via het menu Verpleegrapportage met submenu:
  • Rapportage - Invoerscherm voor verpleegkundige notities (standaard landing page)
  • Overdracht - Overzicht van alle patiënten met rapportages en AI-samenvatting
Routes:
  • /epd/verpleegrapportage → Rapportage (invoer)
  • /epd/verpleegrapportage/overdracht → Overdracht (overzicht + AI)

Rapportage Module

Doel

Centrale werkplek voor het vastleggen van korte verpleegkundige notities tijdens de ronde.

Layout

Master-detail layout met:
  • Links: Ronde overzicht met alle patiënten
  • Rechts: Invoerformulier en tijdlijn voor geselecteerde patiënt

Patiëntenlijst (Ronde Overzicht)

Per patiënt wordt getoond:
  • Naam
  • Alert badge (rood) - Aantal hoge risico's met tooltip "X hoog risico's"
  • Overdracht badge (groen vinkje) - Aantal notities voor overdracht met tooltip "X voor overdracht"
Bij selectie krijgt de patiënt een teal achtergrond.

Invoerformulier

Risico Alert: Bij patiënten met hoge risico's verschijnt een rode waarschuwingsbanner bovenaan.
Categorie Selectie: Gekleurde pills voor 5 categorieën: | Categorie | Kleur | Icoon | |-----------|-------|-------| | Medicatie | Blauw | Pill | | ADL/verzorging | Groen | Utensils | | Gedragsobservatie | Paars | User | | Incident | Rood | AlertTriangle | | Algemene observatie | Grijs | FileText |
Tekstveld:
  • Auto-resize: groeit mee met de tekst (min 56px, max 200px)
  • Maximum 500 karakters met teller
  • Placeholder past zich aan per categorie
Overdracht Toggle: Groen "Overdracht" label om notitie te markeren voor overdracht.
Verzendknop: Teal knop met pijl-icoon, disabled wanneer leeg.

Notities Tijdlijn

Toont alle notities van vandaag, gegroepeerd per dagdeel:
| Dagdeel | Tijden | Icoon | Kleur | |---------|--------|-------|-------| | Nacht | 00:00-07:00 | Moon | Paars | | Ochtend | 07:00-12:00 | Sunrise | Amber | | Middag | 12:00-17:00 | Sun | Geel | | Avond | 17:00-24:00 | Sunset | Oranje |
Per notitie:
  • Tijdstip
  • Categorie badge (gekleurd)
  • Overdracht toggle (groen vinkje, klikbaar)
  • Inhoud
  • Bewerken (potlood-icoon, verschijnt bij hover)
  • Verwijderen (prullenbak-icoon, met bevestiging)
Statistieken: Boven de tijdlijn: totaal aantal notities en aantal voor overdracht.
Nachtdienst logica: Notities vóór 07:00 worden toegewezen aan de vorige dag.

Overdracht Module

Doel

Overzicht van alle patiënten met hun rapportages en AI-gestuurde samenvatting voor overdracht.

Layout

Master-detail layout met:
  • Links: Patiëntenlijst met filters en periode selector
  • Rechts: Patiënt detail met rapportages tijdlijn en AI-samenvatting

Patiëntenlijst

Header:
  • Titel "Patiënten" met totaal aantal
  • Periode selector: 24 uur (default), 3 dagen, 1 week, 2 weken
  • Filter tabs: "Alle" / "Met alerts"
Per patiënt:
  • Avatar met initialen (rood bij hoog risico)
  • Naam, leeftijd, geslacht
  • Alert badges:
    • Rood (AlertTriangle) - Hoge risico's
    • Oranje (Activity) - Afwijkende vitale waarden
    • Groen (CheckCircle2) - Voor overdracht
Alle badges hebben tooltips met beschrijvende tekst.

Patiënt Detail

Header:
  • Naam, leeftijd, geslacht
  • Quick badges (hoog risico, overdracht)
  • Link naar volledig dossier
Risico Block: Prominent rood blok bij hoge risico's met:
  • Risico type (Valrisico, Decubitus, etc.)
  • Risico niveau (Zeer hoog, Hoog, Matig, Laag)
  • Rationale/toelichting
Incident Waarschuwing: Oranje banner bij incidenten in de periode.
Rapportages Tijdlijn:
  • Gegroepeerd per dag (Vandaag, Gisteren, datum)
  • Per dag gegroepeerd per dagdeel
  • Visuele tijdlijn met gekleurde nodes
  • Type badges (Voortgang, Observatie, etc.)
  • Categorie badges voor verpleegkundige notities
  • Overdracht indicator (groen vinkje)
  • Auteur en tijdstip

AI Samenvatting

Locatie: Rechter kolom, sticky bij scrollen.
Header:
  • Sparkles icoon (paars)
  • Titel "AI Samenvatting"
  • Geselecteerde periode label
Genereren:
  • Knop "Genereer samenvatting"
  • Loading state met spinner
  • Typische duur: 3-5 seconden
Resultaat:
  • Samenvatting: 1-2 zinnen met kernpunten
  • Aandachtspunten: Max 5 items met:
    • Urgentie indicator (rode rand)
    • Klikbare bronverwijzing
    • Type bron en datum
  • Actiepunten: Max 3 items voor volgende dienst
Bronverwijzingen:
  • Klikbaar: scrollt naar originele rapportage
  • Highlight effect: paarse ring rond bron (2 seconden)
  • Types: Verpleegkundig, Rapportage, Risicobeoordeling
Footer:
  • Generatie tijdstip en duur
  • "Vernieuwen" knop

Technische Details

Data Model

Reports tabel met type verpleegkundig:
  • content - Notitie tekst (max 500 karakters)
  • structured_data.category - Categorie (medicatie, adl, gedrag, incident, observatie)
  • include_in_handover - Boolean voor overdracht
  • shift_date - Berekende datum (nachtdienst logica)

API Endpoints

| Endpoint | Methode | Beschrijving | |----------|---------|--------------| | /api/reports | GET | Ophalen rapportages met filters | | /api/reports | POST | Nieuwe notitie aanmaken | | /api/reports/[id] | PATCH | Notitie bewerken | | /api/reports/[id] | DELETE | Notitie verwijderen (soft delete) | | /api/verpleegrapportage/[patientId] | GET | Patiënt detail met rapportages en risico's | | /api/overdracht/patients | GET | Patiënten overzicht met alerts | | /api/overdracht/generate | POST | AI samenvatting genereren |

Componenten

Rapportage:
  • RapportageWorkspace - Hoofd container
  • QuickEntryForm - Invoerformulier met auto-resize
  • TimelineItem - Notitie in tijdlijn met edit/delete
Overdracht:
  • VerpleegrapportageClient - Client wrapper met state
  • PatientList - Patiëntenlijst met filters
  • PatientListRow - Patiënt rij met badges
  • PatientDetail - Detail view
  • ReportsBlock - Rapportages tijdlijn
  • AISummaryBlock - AI samenvatting met bronverwijzingen

Gebruikerstips

  1. Markeer direct voor overdracht - Scheelt tijd bij voorbereiding
  2. Gebruik "Met alerts" filter - Snel patiënten vinden die aandacht nodig hebben
  3. Klik op bronverwijzingen - Verifieer AI-informatie bij de bron
  4. Pas periode aan - 3 dagen of 1 week voor meer context bij complexe patiënten
  5. Kies juiste categorie - Helpt bij filteren en overzicht

Gerelateerde Documentatie