feat: add tooltips and explanatory text for DAK-Mitarbeiter pages

Add contextual tooltips on table headers, KPI cards, status badges,
and action buttons across Dashboard, Cases, Wochenübersicht, Reports,
and My Disclosures pages. Wrap global TooltipProvider in App.tsx.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

frontend/src/App.tsx

@@ -1,5 +1,6 @@
 import { QueryClient, QueryClientProvider } from '@tanstack/react-query'
 import { BrowserRouter, Routes, Route, Navigate } from 'react-router-dom'
+import { TooltipProvider } from '@/components/ui/tooltip'
 import { AuthProvider } from '@/context/AuthContext'
 import { ProtectedRoute } from '@/components/layout/ProtectedRoute'
 import { AppLayout } from '@/components/layout/AppLayout'
@@ -33,6 +34,7 @@ const queryClient = new QueryClient({
 function App() {
   return (
     <QueryClientProvider client={queryClient}>
+      <TooltipProvider>
       <BrowserRouter>
         <AuthProvider>
           <Routes>
@@ -58,6 +60,7 @@ function App() {
           </Routes>
         </AuthProvider>
       </BrowserRouter>
+      </TooltipProvider>
     </QueryClientProvider>
   )
 }

frontend/src/pages/AdminInvitationsPage.tsx

@@ -18,7 +18,7 @@ import {
 import { Skeleton } from '@/components/ui/skeleton'
 import { Alert, AlertDescription } from '@/components/ui/alert'
 import {
-  Tooltip, TooltipContent, TooltipProvider, TooltipTrigger,
+  Tooltip, TooltipContent, TooltipTrigger,
 } from '@/components/ui/tooltip'
 
 export function AdminInvitationsPage() {
@@ -120,7 +120,6 @@ export function AdminInvitationsPage() {
           ))}
         </div>
       ) : invitations.length > 0 ? (
-        <TooltipProvider>
           <Table>
             <TableHeader>
               <TableRow>
@@ -177,7 +176,6 @@ export function AdminInvitationsPage() {
               })}
             </TableBody>
           </Table>
-        </TooltipProvider>
       ) : (
         <p className="py-8 text-center text-muted-foreground">
           Keine Einladungen vorhanden.

frontend/src/pages/CasesPage.tsx

@@ -1,6 +1,6 @@
 import { useState, useEffect, useCallback, useRef } from 'react'
 import {
-  Search, ChevronLeft, ChevronRight, Save, CheckCircle, XCircle, Pencil, X,
+  Search, ChevronLeft, ChevronRight, Save, CheckCircle, XCircle, Pencil, X, Info,
 } from 'lucide-react'
 import type { Case } from '@/types'
 import { useAuth } from '@/context/AuthContext'
@@ -19,6 +19,9 @@ import {
 } from '@/components/ui/sheet'
 import { Skeleton } from '@/components/ui/skeleton'
 import { Alert, AlertDescription } from '@/components/ui/alert'
+import {
+  Tooltip, TooltipContent, TooltipTrigger,
+} from '@/components/ui/tooltip'
 import { CASE_SECTIONS } from './cases/fieldConfig'
 import { useInlineEdit } from './cases/useInlineEdit'
 import { EditableField } from './cases/EditableField'
@@ -107,9 +110,16 @@ export function CasesPage({ pendingIcdOnly = false }: CasesPageProps) {
 
   return (
     <div className="p-6 space-y-4">
-      <h1 className="text-2xl font-bold">
-        {pendingIcdOnly ? 'ICD-Eingabe' : 'Fälle'}
-      </h1>
+      <div>
+        <h1 className="text-2xl font-bold">
+          {pendingIcdOnly ? 'ICD-Eingabe' : 'Fälle'}
+        </h1>
+        {pendingIcdOnly && (
+          <p className="text-sm text-muted-foreground mt-1">
+            Fälle, die noch einen ICD-10-Diagnosecode benötigen. Klicken Sie auf einen Fall, um den Code einzugeben.
+          </p>
+        )}
+      </div>
 
       {/* Filter bar */}
       {!pendingIcdOnly && (
@@ -169,15 +179,65 @@ export function CasesPage({ pendingIcdOnly = false }: CasesPageProps) {
           <Table>
             <TableHeader>
               <TableRow>
-                <TableHead>Fall-ID</TableHead>
+                <TableHead>
+                  <Tooltip>
+                    <TooltipTrigger asChild>
+                      <span className="inline-flex items-center gap-1 cursor-help border-b border-dashed border-muted-foreground/40">
+                        Fall-ID
+                        <Info className="size-3 text-muted-foreground" />
+                      </span>
+                    </TooltipTrigger>
+                    <TooltipContent>Eindeutige Kennung: Jahr-KW-Fallgruppe-KVNR</TooltipContent>
+                  </Tooltip>
+                </TableHead>
                 <TableHead>Datum</TableHead>
                 {isAdmin && <TableHead>Nachname</TableHead>}
                 {isAdmin && <TableHead>Vorname</TableHead>}
-                <TableHead>KVNR</TableHead>
+                <TableHead>
+                  <Tooltip>
+                    <TooltipTrigger asChild>
+                      <span className="inline-flex items-center gap-1 cursor-help border-b border-dashed border-muted-foreground/40">
+                        KVNR
+                        <Info className="size-3 text-muted-foreground" />
+                      </span>
+                    </TooltipTrigger>
+                    <TooltipContent>Krankenversichertennummer des Versicherten</TooltipContent>
+                  </Tooltip>
+                </TableHead>
                 <TableHead>Fallgruppe</TableHead>
-                <TableHead>ICD</TableHead>
-                <TableHead>Gutachten</TableHead>
-                <TableHead>Status</TableHead>
+                <TableHead>
+                  <Tooltip>
+                    <TooltipTrigger asChild>
+                      <span className="inline-flex items-center gap-1 cursor-help border-b border-dashed border-muted-foreground/40">
+                        ICD
+                        <Info className="size-3 text-muted-foreground" />
+                      </span>
+                    </TooltipTrigger>
+                    <TooltipContent>Internationale Klassifikation der Krankheiten (Diagnosecode)</TooltipContent>
+                  </Tooltip>
+                </TableHead>
+                <TableHead>
+                  <Tooltip>
+                    <TooltipTrigger asChild>
+                      <span className="inline-flex items-center gap-1 cursor-help border-b border-dashed border-muted-foreground/40">
+                        Gutachten
+                        <Info className="size-3 text-muted-foreground" />
+                      </span>
+                    </TooltipTrigger>
+                    <TooltipContent>Schriftliche medizinische Stellungnahme vorhanden</TooltipContent>
+                  </Tooltip>
+                </TableHead>
+                <TableHead>
+                  <Tooltip>
+                    <TooltipTrigger asChild>
+                      <span className="inline-flex items-center gap-1 cursor-help border-b border-dashed border-muted-foreground/40">
+                        Status
+                        <Info className="size-3 text-muted-foreground" />
+                      </span>
+                    </TooltipTrigger>
+                    <TooltipContent>Aktueller Bearbeitungsstatus des Falls</TooltipContent>
+                  </Tooltip>
+                </TableHead>
               </TableRow>
             </TableHeader>
             <TableBody>
@@ -272,11 +332,46 @@ export function CasesPage({ pendingIcdOnly = false }: CasesPageProps) {
 function StatusBadges({ c }: { c: Case }) {
   return (
     <div className="flex gap-1">
-      {c.unterlagen && <Badge variant="secondary" className="text-xs">Unterlagen</Badge>}
-      {c.gutachten && <Badge variant="secondary" className="text-xs">Gutachten</Badge>}
-      {c.abgerechnet && <Badge className="text-xs">Abgerechnet</Badge>}
-      {c.ablehnung && <Badge variant="destructive" className="text-xs">Abgelehnt</Badge>}
-      {c.abbruch && <Badge variant="destructive" className="text-xs">Abbruch</Badge>}
+      {c.unterlagen && (
+        <Tooltip>
+          <TooltipTrigger asChild>
+            <Badge variant="secondary" className="text-xs cursor-help">Unterlagen</Badge>
+          </TooltipTrigger>
+          <TooltipContent>Patientenunterlagen wurden eingereicht</TooltipContent>
+        </Tooltip>
+      )}
+      {c.gutachten && (
+        <Tooltip>
+          <TooltipTrigger asChild>
+            <Badge variant="secondary" className="text-xs cursor-help">Gutachten</Badge>
+          </TooltipTrigger>
+          <TooltipContent>Medizinisches Gutachten wurde erstellt</TooltipContent>
+        </Tooltip>
+      )}
+      {c.abgerechnet && (
+        <Tooltip>
+          <TooltipTrigger asChild>
+            <Badge className="text-xs cursor-help">Abgerechnet</Badge>
+          </TooltipTrigger>
+          <TooltipContent>Fall wurde abgerechnet</TooltipContent>
+        </Tooltip>
+      )}
+      {c.ablehnung && (
+        <Tooltip>
+          <TooltipTrigger asChild>
+            <Badge variant="destructive" className="text-xs cursor-help">Abgelehnt</Badge>
+          </TooltipTrigger>
+          <TooltipContent>Leistung wurde abgelehnt</TooltipContent>
+        </Tooltip>
+      )}
+      {c.abbruch && (
+        <Tooltip>
+          <TooltipTrigger asChild>
+            <Badge variant="destructive" className="text-xs cursor-help">Abbruch</Badge>
+          </TooltipTrigger>
+          <TooltipContent>Verfahren wurde abgebrochen</TooltipContent>
+        </Tooltip>
+      )}
     </div>
   )
 }
@@ -410,7 +505,15 @@ function CaseDetail({ caseData }: { caseData: Case }) {
 
         {/* ICD section — own endpoint with validation */}
         <div className="border-t pt-3 space-y-2">
-          <label className="text-sm font-semibold">ICD-Code</label>
+          <Tooltip>
+            <TooltipTrigger asChild>
+              <label className="text-sm font-semibold inline-flex items-center gap-1 cursor-help">
+                ICD-Code
+                <Info className="size-3 text-muted-foreground" />
+              </label>
+            </TooltipTrigger>
+            <TooltipContent>ICD-10-GM Diagnoseschlüssel, z.B. C50.9 für bösartige Neubildung der Brustdrüse</TooltipContent>
+          </Tooltip>
           <div className="flex gap-2">
             <Input
               value={icdValue}
@@ -488,9 +591,14 @@ function DisclosureRequestButton({ caseId }: { caseId: number }) {
 
   return (
     <>
-      <Button size="sm" variant="outline" onClick={() => setOpen(true)}>
-        Personendaten anfordern
-      </Button>
+      <Tooltip>
+        <TooltipTrigger asChild>
+          <Button size="sm" variant="outline" onClick={() => setOpen(true)}>
+            Personendaten anfordern
+          </Button>
+        </TooltipTrigger>
+        <TooltipContent>Zeitlich begrenzte Freigabe (24h) der Personendaten beantragen</TooltipContent>
+      </Tooltip>
       {open && (
         <div className="space-y-2 border rounded-lg p-3">
           <p className="text-sm text-muted-foreground">

frontend/src/pages/DashboardPage.tsx

@@ -4,7 +4,7 @@ import {
   BarChart, Bar, XAxis, YAxis, CartesianGrid, Tooltip, Legend,
   PieChart, Pie, Cell, ResponsiveContainer,
 } from 'recharts'
-import { FileText, Clock, Code, Stethoscope } from 'lucide-react'
+import { FileText, Clock, Code, Stethoscope, Info } from 'lucide-react'
 import { useAuth } from '@/context/AuthContext'
 import { useDashboard } from '@/hooks/useDashboard'
 import { Card, CardContent, CardHeader, CardTitle } from '@/components/ui/card'
@@ -12,6 +12,9 @@ import {
   Select, SelectContent, SelectItem, SelectTrigger, SelectValue,
 } from '@/components/ui/select'
 import { Skeleton } from '@/components/ui/skeleton'
+import {
+  Tooltip as UiTooltip, TooltipContent, TooltipTrigger,
+} from '@/components/ui/tooltip'
 
 const FALLGRUPPEN_LABELS: Record<string, string> = {
   onko: 'Onkologie',
@@ -81,24 +84,28 @@ export function DashboardPage() {
         <div className="grid grid-cols-1 gap-4 sm:grid-cols-2 lg:grid-cols-4">
           <KpiCard
             title="Fälle gesamt"
+            tooltip="Gesamtzahl aller erfassten Fälle im gewählten Jahr"
             value={data.kpis.total_cases}
             icon={<FileText className="size-5 text-muted-foreground" />}
             href="/cases"
           />
           <KpiCard
             title="Offene ICD"
+            tooltip="Fälle, denen noch ein ICD-10-Diagnosecode zugewiesen werden muss"
             value={data.kpis.pending_icd}
             icon={<Clock className="size-5 text-muted-foreground" />}
             href="/icd"
           />
           <KpiCard
             title="Offene Codierung"
+            tooltip="Fälle, die noch nicht abschließend klassifiziert wurden"
             value={data.kpis.pending_coding}
             icon={<Code className="size-5 text-muted-foreground" />}
             href={isAdmin ? '/coding' : undefined}
           />
           <KpiCard
             title="Gutachten gesamt"
+            tooltip="Anzahl der Fälle mit erstelltem Gutachten"
             value={data.kpis.total_gutachten}
             icon={<Stethoscope className="size-5 text-muted-foreground" />}
             href="/gutachten-statistik"
@@ -115,6 +122,7 @@ export function DashboardPage() {
           <Card className="lg:col-span-2">
             <CardHeader>
               <CardTitle>Wöchentliche Übersicht</CardTitle>
+              <p className="text-xs text-muted-foreground">Ablehnungen, fehlende Rückmeldungen und Gutachten pro Kalenderwoche</p>
             </CardHeader>
             <CardContent>
               <ResponsiveContainer width="100%" height={350}>
@@ -165,6 +173,7 @@ export function DashboardPage() {
           <Card>
             <CardHeader>
               <CardTitle>Fallgruppen</CardTitle>
+              <p className="text-xs text-muted-foreground">Verteilung der Fälle nach medizinischer Fachgruppe</p>
             </CardHeader>
             <CardContent>
               <ResponsiveContainer width="100%" height={350}>
@@ -212,11 +221,23 @@ export function DashboardPage() {
   )
 }
 
-function KpiCard({ title, value, icon, href }: { title: string; value: number; icon: React.ReactNode; href?: string }) {
+function KpiCard({ title, tooltip, value, icon, href }: { title: string; tooltip?: string; value: number; icon: React.ReactNode; href?: string }) {
   const card = (
     <Card className={href ? 'transition-colors hover:border-primary/50 hover:shadow-md' : undefined}>
       <CardHeader className="flex flex-row items-center justify-between pb-2">
-        <CardTitle className="text-sm font-medium">{title}</CardTitle>
+        <CardTitle className="text-sm font-medium">
+          {tooltip ? (
+            <UiTooltip>
+              <TooltipTrigger asChild>
+                <span className="inline-flex items-center gap-1 cursor-help">
+                  {title}
+                  <Info className="size-3 text-muted-foreground" />
+                </span>
+              </TooltipTrigger>
+              <TooltipContent>{tooltip}</TooltipContent>
+            </UiTooltip>
+          ) : title}
+        </CardTitle>
         {icon}
       </CardHeader>
       <CardContent>

frontend/src/pages/MyDisclosuresPage.tsx

@@ -14,21 +14,52 @@ import {
   useMyDisclosures, useRevokeDisclosure,
   useDeleteDisclosure, useRequestDisclosure,
 } from '@/hooks/useDisclosures'
+import {
+  Tooltip, TooltipContent, TooltipTrigger,
+} from '@/components/ui/tooltip'
 import type { DisclosureRequest } from '@/types'
 
 function statusBadge(dr: DisclosureRequest) {
   const now = new Date()
   if (dr.status === 'pending') {
-    return <Badge variant="outline" className="bg-yellow-50 text-yellow-700 border-yellow-300">Ausstehend</Badge>
+    return (
+      <Tooltip>
+        <TooltipTrigger asChild>
+          <Badge variant="outline" className="bg-yellow-50 text-yellow-700 border-yellow-300 cursor-help">Ausstehend</Badge>
+        </TooltipTrigger>
+        <TooltipContent>Ihre Anfrage wird vom Administrator geprüft</TooltipContent>
+      </Tooltip>
+    )
   }
   if (dr.status === 'rejected') {
-    return <Badge variant="outline" className="bg-red-50 text-red-700 border-red-300">Abgelehnt</Badge>
+    return (
+      <Tooltip>
+        <TooltipTrigger asChild>
+          <Badge variant="outline" className="bg-red-50 text-red-700 border-red-300 cursor-help">Abgelehnt</Badge>
+        </TooltipTrigger>
+        <TooltipContent>Der Administrator hat Ihre Anfrage abgelehnt</TooltipContent>
+      </Tooltip>
+    )
   }
   // approved
   if (dr.expires_at && new Date(dr.expires_at) <= now) {
-    return <Badge variant="outline" className="bg-gray-50 text-gray-500 border-gray-300">Abgelaufen</Badge>
+    return (
+      <Tooltip>
+        <TooltipTrigger asChild>
+          <Badge variant="outline" className="bg-gray-50 text-gray-500 border-gray-300 cursor-help">Abgelaufen</Badge>
+        </TooltipTrigger>
+        <TooltipContent>Die Freigabe ist nicht mehr gültig</TooltipContent>
+      </Tooltip>
+    )
   }
-  return <Badge variant="outline" className="bg-green-50 text-green-700 border-green-300">Genehmigt</Badge>
+  return (
+    <Tooltip>
+      <TooltipTrigger asChild>
+        <Badge variant="outline" className="bg-green-50 text-green-700 border-green-300 cursor-help">Genehmigt</Badge>
+      </TooltipTrigger>
+      <TooltipContent>Personendaten sind bis zum Ablaufdatum sichtbar</TooltipContent>
+    </Tooltip>
+  )
 }
 
 function isActive(dr: DisclosureRequest): boolean {
@@ -67,7 +98,12 @@ export function MyDisclosuresPage() {
 
   return (
     <div className="p-6 space-y-4">
-      <h1 className="text-2xl font-bold">Meine Freigaben</h1>
+      <div>
+        <h1 className="text-2xl font-bold">Meine Freigaben</h1>
+        <p className="text-sm text-muted-foreground mt-1">
+          Übersicht Ihrer Freigabe-Anfragen für Personendaten. Genehmigte Freigaben sind 24 Stunden gültig.
+        </p>
+      </div>
 
       {isLoading ? (
         <div className="space-y-2">
@@ -105,36 +141,51 @@ export function MyDisclosuresPage() {
                   <TableCell className="text-right">
                     <div className="flex justify-end gap-1">
                       {isActive(dr) && (
-                        <Button
-                          size="sm"
-                          variant="outline"
-                          disabled={revokeMutation.isPending}
-                          onClick={() => revokeMutation.mutate(dr.id)}
-                        >
-                          <ShieldOff className="size-4 mr-1" />
-                          Als erledigt markieren
-                        </Button>
+                        <Tooltip>
+                          <TooltipTrigger asChild>
+                            <Button
+                              size="sm"
+                              variant="outline"
+                              disabled={revokeMutation.isPending}
+                              onClick={() => revokeMutation.mutate(dr.id)}
+                            >
+                              <ShieldOff className="size-4 mr-1" />
+                              Als erledigt markieren
+                            </Button>
+                          </TooltipTrigger>
+                          <TooltipContent>Freigabe vorzeitig beenden — Personendaten werden wieder ausgeblendet</TooltipContent>
+                        </Tooltip>
                       )}
                       {isInactive(dr) && (
                         <>
-                          <Button
-                            size="sm"
-                            variant="outline"
-                            disabled={requestMutation.isPending}
-                            onClick={() => openReRequestDialog(dr)}
-                          >
-                            <RefreshCw className="size-4 mr-1" />
-                            Erneute Anfrage
-                          </Button>
-                          <Button
-                            size="sm"
-                            variant="ghost"
-                            disabled={deleteMutation.isPending}
-                            onClick={() => deleteMutation.mutate(dr.id)}
-                          >
-                            <Trash2 className="size-4 mr-1" />
-                            Verwerfen
-                          </Button>
+                          <Tooltip>
+                            <TooltipTrigger asChild>
+                              <Button
+                                size="sm"
+                                variant="outline"
+                                disabled={requestMutation.isPending}
+                                onClick={() => openReRequestDialog(dr)}
+                              >
+                                <RefreshCw className="size-4 mr-1" />
+                                Erneute Anfrage
+                              </Button>
+                            </TooltipTrigger>
+                            <TooltipContent>Neue Freigabe mit gleicher oder geänderter Begründung beantragen</TooltipContent>
+                          </Tooltip>
+                          <Tooltip>
+                            <TooltipTrigger asChild>
+                              <Button
+                                size="sm"
+                                variant="ghost"
+                                disabled={deleteMutation.isPending}
+                                onClick={() => deleteMutation.mutate(dr.id)}
+                              >
+                                <Trash2 className="size-4 mr-1" />
+                                Verwerfen
+                              </Button>
+                            </TooltipTrigger>
+                            <TooltipContent>Diese Freigabe-Anfrage aus Ihrer Liste entfernen</TooltipContent>
+                          </Tooltip>
                         </>
                       )}
                     </div>

frontend/src/pages/ReportsPage.tsx

@@ -1,5 +1,5 @@
 import { Fragment, useState } from 'react'
-import { ChevronDown, ChevronRight, Download, FileSpreadsheet, Loader2, Plus, Trash2 } from 'lucide-react'
+import { ChevronDown, ChevronRight, Download, FileSpreadsheet, Info, Loader2, Plus, Trash2 } from 'lucide-react'
 import api from '@/services/api'
 import { useAuth } from '@/context/AuthContext'
 import { useReports, useGenerateReport, useDeleteReports, useReportData } from '@/hooks/useReports'
@@ -17,6 +17,9 @@ import {
 } from '@/components/ui/select'
 import { Skeleton } from '@/components/ui/skeleton'
 import { Alert, AlertDescription } from '@/components/ui/alert'
+import {
+  Tooltip, TooltipContent, TooltipTrigger,
+} from '@/components/ui/tooltip'
 
 const REPORT_TYPES = [
   { value: 'gesamt', label: 'Gesamt' },
@@ -253,10 +256,40 @@ export function ReportsPage() {
                       />
                     </TableHead>
                   )}
-                  <TableHead>Berichtsdatum</TableHead>
+                  <TableHead>
+                    <Tooltip>
+                      <TooltipTrigger asChild>
+                        <span className="inline-flex items-center gap-1 cursor-help border-b border-dashed border-muted-foreground/40">
+                          Berichtsdatum
+                          <Info className="size-3 text-muted-foreground" />
+                        </span>
+                      </TooltipTrigger>
+                      <TooltipContent>Stichtag des Berichts</TooltipContent>
+                    </Tooltip>
+                  </TableHead>
                   <TableHead>Jahr</TableHead>
-                  <TableHead>KW</TableHead>
-                  <TableHead>Typ</TableHead>
+                  <TableHead>
+                    <Tooltip>
+                      <TooltipTrigger asChild>
+                        <span className="inline-flex items-center gap-1 cursor-help border-b border-dashed border-muted-foreground/40">
+                          KW
+                          <Info className="size-3 text-muted-foreground" />
+                        </span>
+                      </TooltipTrigger>
+                      <TooltipContent>Kalenderwoche des Berichtszeitraums</TooltipContent>
+                    </Tooltip>
+                  </TableHead>
+                  <TableHead>
+                    <Tooltip>
+                      <TooltipTrigger asChild>
+                        <span className="inline-flex items-center gap-1 cursor-help border-b border-dashed border-muted-foreground/40">
+                          Typ
+                          <Info className="size-3 text-muted-foreground" />
+                        </span>
+                      </TooltipTrigger>
+                      <TooltipContent>Berichtstyp: Gesamt, Onko-Intensiv oder Galle-Schild</TooltipContent>
+                    </Tooltip>
+                  </TableHead>
                   <TableHead>Erstellt am</TableHead>
                   <TableHead className="text-right">Aktion</TableHead>
                 </TableRow>

frontend/src/pages/WochenuebersichtPage.tsx

@@ -1,5 +1,5 @@
 import { Fragment, useCallback, useState } from 'react'
-import { ChevronDown, ChevronRight, Download, FileSpreadsheet, Loader2, Plus, Upload } from 'lucide-react'
+import { ChevronDown, ChevronRight, Download, FileSpreadsheet, Info, Loader2, Plus, Upload } from 'lucide-react'
 import api from '@/services/api'
 import { useAuth } from '@/context/AuthContext'
 import {
@@ -21,6 +21,9 @@ import {
 } from '@/components/ui/table'
 import { Skeleton } from '@/components/ui/skeleton'
 import { Alert, AlertDescription } from '@/components/ui/alert'
+import {
+  Tooltip, TooltipContent, TooltipTrigger,
+} from '@/components/ui/tooltip'
 
 const EXPORT_TYPES = [
   { value: 'c2s', label: 'Onko-Intensiv (c2s)' },
@@ -390,6 +393,9 @@ export function WochenuebersichtPage() {
             Laden Sie die ausgefüllte Wochenübersicht mit den ergänzten ICD-Codes hoch.
             Die ICD-Codes werden automatisch den Fällen anhand der KVNR zugeordnet.
           </p>
+          <p className="text-xs text-muted-foreground">
+            Unterstützte Formate: .xlsx, .xls — Die KVNR wird zum Abgleich der Fälle verwendet.
+          </p>
 
           <div
             className={`border-2 border-dashed rounded-lg p-8 text-center transition-colors ${
@@ -541,15 +547,75 @@ function WochenuebersichtViewer({ data }: { data: Record<string, any> }) {
             <Table>
               <TableHeader>
                 <TableRow>
-                  <TableHead>KVNR</TableHead>
+                  <TableHead>
+                    <Tooltip>
+                      <TooltipTrigger asChild>
+                        <span className="inline-flex items-center gap-1 cursor-help border-b border-dashed border-muted-foreground/40">
+                          KVNR
+                          <Info className="size-3 text-muted-foreground" />
+                        </span>
+                      </TooltipTrigger>
+                      <TooltipContent>Krankenversichertennummer</TooltipContent>
+                    </Tooltip>
+                  </TableHead>
                   <TableHead>Datum</TableHead>
-                  <TableHead className="text-center">Erstgespräch</TableHead>
-                  <TableHead className="text-center">Abbruch</TableHead>
-                  <TableHead className="text-center">Unterlagen</TableHead>
-                  <TableHead className="text-center">Gutachten</TableHead>
+                  <TableHead className="text-center">
+                    <Tooltip>
+                      <TooltipTrigger asChild>
+                        <span className="inline-flex items-center gap-1 cursor-help border-b border-dashed border-muted-foreground/40">
+                          Erstgespräch
+                          <Info className="size-3 text-muted-foreground" />
+                        </span>
+                      </TooltipTrigger>
+                      <TooltipContent>Initialkontakt mit dem Versicherten erfolgt</TooltipContent>
+                    </Tooltip>
+                  </TableHead>
+                  <TableHead className="text-center">
+                    <Tooltip>
+                      <TooltipTrigger asChild>
+                        <span className="inline-flex items-center gap-1 cursor-help border-b border-dashed border-muted-foreground/40">
+                          Abbruch
+                          <Info className="size-3 text-muted-foreground" />
+                        </span>
+                      </TooltipTrigger>
+                      <TooltipContent>Zweitmeinung/Vorbereitung bei Ablehnung oder Abbruch</TooltipContent>
+                    </Tooltip>
+                  </TableHead>
+                  <TableHead className="text-center">
+                    <Tooltip>
+                      <TooltipTrigger asChild>
+                        <span className="inline-flex items-center gap-1 cursor-help border-b border-dashed border-muted-foreground/40">
+                          Unterlagen
+                          <Info className="size-3 text-muted-foreground" />
+                        </span>
+                      </TooltipTrigger>
+                      <TooltipContent>Zweitmeinung/Vorbereitung mit Erteilung</TooltipContent>
+                    </Tooltip>
+                  </TableHead>
+                  <TableHead className="text-center">
+                    <Tooltip>
+                      <TooltipTrigger asChild>
+                        <span className="inline-flex items-center gap-1 cursor-help border-b border-dashed border-muted-foreground/40">
+                          Gutachten
+                          <Info className="size-3 text-muted-foreground" />
+                        </span>
+                      </TooltipTrigger>
+                      <TooltipContent>Schriftliche Dokumentation (Gutachten) erstellt</TooltipContent>
+                    </Tooltip>
+                  </TableHead>
                   <TableHead className="text-center">{fg1Label}</TableHead>
                   <TableHead className="text-center">{fg2Label}</TableHead>
-                  <TableHead>ICD-10</TableHead>
+                  <TableHead>
+                    <Tooltip>
+                      <TooltipTrigger asChild>
+                        <span className="inline-flex items-center gap-1 cursor-help border-b border-dashed border-muted-foreground/40">
+                          ICD-10
+                          <Info className="size-3 text-muted-foreground" />
+                        </span>
+                      </TooltipTrigger>
+                      <TooltipContent>Internationale Klassifikation der Krankheiten</TooltipContent>
+                    </Tooltip>
+                  </TableHead>
                 </TableRow>
               </TableHeader>
               <TableBody>