betreuungs-cockpit/src/app/(app)/finanzen/page.tsx

import Link from 'next/link'
import { ArrowRight, Banknote, FileDown, Landmark, Plus, Repeat, Upload } from 'lucide-react'
import { Alert, AlertDescription } from '@/components/ui/alert'
import { Button } from '@/components/ui/button'
import { Card, CardContent, CardDescription, CardHeader, CardTitle } from '@/components/ui/card'
import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from '@/components/ui/table'
import { SeitenKopf, Leerzustand } from '@/components/seiten-kopf'
import { Rechtshinweis } from '@/components/rechtshinweis'
import {
  Belegzeichen,
  Betrag,
  Hinweisliste,
  Kennzahl,
  Vermischungswarnung,
} from '@/components/finanzen/bausteine'
import { centZuZahl } from '@/lib/db'
import { formatCent, formatDatum } from '@/lib/utils'
import { finanzKontext } from '@/lib/finanzen/seite'
import { heute, monatePlus, tagePlus } from '@/lib/finanzen/datum'
import { belegDurchVertrag, betragPruefen, kennzahlen, vermischungsWarnung } from '@/lib/finanzen/kassenbuch'
import { KATEGORIE_BESCHRIFTUNG } from '@/lib/finanzen/kategorien'
import { laufendesBetreuungsjahr } from '@/lib/finanzen/betreuungsjahr'
import { buchungenLaden, kontenLaden, kontostaendeZumStichtag, vermoegenLaden } from '@/lib/berichte/gemeinsam'
import { offeneZahlungsgruppen } from '@/lib/finanzen/wiederkehrend-laden'

export const metadata = { title: 'Vermögen & Kasse' }

/**
 * Übersichtsseite des Finanzmoduls.
 *
 * Sie beantwortet die vier Fragen, die man sich beim Öffnen stellt:
 * Was ist da? Wo liegt es? Was ist zuletzt passiert? Und: Wo fehlt noch
 * ein Beleg?
 */
export default async function FinanzenSeite() {
  const { betreute, darfSchreiben } = await finanzKontext()
  const schreiben = darfSchreiben('FINANZEN')
  const stichtag = heute()

  const [konten, buchungen, vermoegen] = await Promise.all([
    kontenLaden(betreute.id),
    buchungenLaden(betreute.id),
    vermoegenLaden(betreute.id, stichtag),
  ])

  const eigeneKonten = konten.filter((k) => !k.istBetreuerkonto)
  const staende = kontostaendeZumStichtag(eigeneKonten, stichtag)
  const summeKontenCent = staende.reduce((s, z) => s + (z.betragCent ?? 0n), 0n)

  const zwoelfMonate = tagePlus(monatePlus(stichtag, -12), 1)
  const letzteZwoelf = buchungen.filter((b) => b.datum >= zwoelfMonate)
  const zahlen = kennzahlen(letzteZwoelf)
  const offeneGruppen = await offeneZahlungsgruppen(betreute.id)

  const letzte = [...buchungen].sort((a, b) => b.datum.getTime() - a.datum.getTime()).slice(0, 8)

  const jahr = betreute.bestellungAm ? laufendesBetreuungsjahr(betreute.bestellungAm) : null

  const hinweise: string[] = []
  for (const stand of staende) {
    if (stand.betragCent === null) {
      hinweise.push(`Für „${stand.bezeichnung}“ ist noch kein Kontostand erfasst.`)
    } else if (stand.stichtag && stand.stichtag < monatePlus(stichtag, -3)) {
      hinweise.push(
        `Der Stand von „${stand.bezeichnung}“ ist vom ${formatDatum(stand.stichtag)} und damit ` +
          'älter als drei Monate.',
      )
    }
  }
  if (!betreute.bestellungAm) {
    hinweise.push(
      'In den Stammdaten fehlt das Datum der Bestellung. Ohne dieses Datum lässt sich das ' +
        'Betreuungsjahr nicht bestimmen – und damit auch keine Rechnungslegung erzeugen.',
    )
  }

  return (
    <div className="space-y-8">
      <SeitenKopf
        titel="Vermögen & Kasse"
        beschreibung={
          jahr
            ? `Aktuell läuft das ${jahr.bezeichnung}. Alles hier fließt in das Vermögensverzeichnis und die Rechnungslegung.`
            : 'Konten, Kassenbuch und Vermögensposten. Von hier aus entstehen beide Berichte ans Betreuungsgericht.'
        }
        pfad={[{ titel: 'Vermögen & Kasse' }]}
        aktionen={
          schreiben ? (
            <>
              <Button asChild variant="secondary">
                <Link href="/finanzen/buchungen/neu">
                  <Plus aria-hidden="true" />
                  Buchung erfassen
                </Link>
              </Button>
              <Button asChild>
                <Link href="/finanzen/berichte">
                  <FileDown aria-hidden="true" />
                  Berichte
                </Link>
              </Button>
            </>
          ) : undefined
        }
      />

      <div className="grid gap-4 sm:grid-cols-2 lg:grid-cols-4">
        <Kennzahl
          titel="Guthaben auf Konten"
          wert={formatCent(centZuZahl(summeKontenCent))}
          hinweis={`${staende.length} Konto/Konten der betreuten Person`}
          href="/finanzen/konten"
        />
        <Kennzahl
          titel="Reinvermögen"
          wert={formatCent(centZuZahl(summeKontenCent + vermoegen.summeAktivaCent - vermoegen.summePassivaCent))}
          hinweis="Konten und Vermögensposten, abzüglich Verbindlichkeiten"
          href="/finanzen/vermoegen"
        />
        <Kennzahl
          titel="Belegquote (12 Monate)"
          wert={`${zahlen.beleg.quoteProzent} %`}
          hinweis={
            zahlen.beleg.zuPruefen > 0
              ? `${zahlen.beleg.zuPruefen} Zahlung(en) weichen vom hinterlegten Beitrag ab`
              : zahlen.beleg.ohneNachweis > 0
                ? `${zahlen.beleg.ohneNachweis} Buchung(en) ohne Beleg und ohne Begründung`
                : zahlen.beleg.durchVertrag > 0
                  ? `Belegt, begründet oder durch Vertrag gedeckt (${zahlen.beleg.durchVertrag} Dauerzahlungen)`
                  : 'Alle Buchungen sind belegt oder begründet'
          }
          ton={zahlen.beleg.ohneNachweis > 0 ? 'achtung' : 'gut'}
          href="/finanzen/buchungen?nurOhneBeleg=on"
        />
        <Kennzahl
          titel="Saldo der letzten 12 Monate"
          wert={formatCent(centZuZahl(zahlen.saldoCent))}
          hinweis={`${formatCent(centZuZahl(zahlen.einnahmenCent))} ein, ${formatCent(centZuZahl(zahlen.ausgabenCent))} aus`}
          ton={zahlen.saldoCent < 0n ? 'achtung' : 'neutral'}
          href="/finanzen/buchungen"
        />
      </div>

      {offeneGruppen > 0 && (
        <Alert variant="hinweis">
          <Repeat aria-hidden="true" />
          <AlertDescription className="flex flex-wrap items-center justify-between gap-3">
            <span>
              <strong>{offeneGruppen}</strong> regelmäßige Abbuchung
              {offeneGruppen === 1 ? '' : 'en'} ohne hinterlegten Vertrag. Wer regelmäßig
              abbucht, hat einen — und der fehlt dann im Vermögensverzeichnis.
            </span>
            <Button asChild size="sm" variant="outline">
              <Link href="/finanzen/wiederkehrend">Ansehen</Link>
            </Button>
          </AlertDescription>
        </Alert>
      )}

      {zahlen.vermischungen > 0 && <Vermischungswarnung />}

      <Hinweisliste hinweise={hinweise} titel="Das solltest du nachtragen" />

      {/* ------------------------------------------------------------- */}
      <Card>
        <CardHeader>
          <CardTitle>Konten</CardTitle>
          <CardDescription>
            Stand zum {formatDatum(stichtag)} – jeweils der jüngste erfasste Saldostand.
          </CardDescription>
        </CardHeader>
        <CardContent>
          {konten.length === 0 ? (
            <Leerzustand
              icon={Landmark}
              titel="Noch kein Konto erfasst"
              beschreibung="Fang mit dem Girokonto an, über das Rente und Heimkosten laufen. Das Verwahrgeldkonto im Heim gehört ebenfalls dazu."
              aktion={
                schreiben ? (
                  <Button asChild>
                    <Link href="/finanzen/konten/neu">
                      <Plus aria-hidden="true" />
                      Konto anlegen
                    </Link>
                  </Button>
                ) : undefined
              }
            />
          ) : (
            <Table>
              <TableHeader>
                <TableRow>
                  <TableHead>Konto</TableHead>
                  <TableHead>Art</TableHead>
                  <TableHead>Stand vom</TableHead>
                  <TableHead className="text-right">Betrag</TableHead>
                </TableRow>
              </TableHeader>
              <TableBody>
                {kontostaendeZumStichtag(konten, stichtag).map((stand) => (
                  <TableRow key={stand.kontoId}>
                    <TableCell>
                      <Link
                        href={`/finanzen/konten/${stand.kontoId}`}
                        className="font-medium hover:underline"
                      >
                        {stand.bezeichnung}
                      </Link>
                      {stand.istBetreuerkonto && (
                        <span className="block text-sm text-muted-foreground">
                          Konto des Betreuers – zählt nicht zum Vermögen der Betreuten
                        </span>
                      )}
                      {stand.ibanMaskiert && (
                        <span className="block text-sm text-muted-foreground">
                          {stand.ibanMaskiert}
                        </span>
                      )}
                    </TableCell>
                    <TableCell className="text-sm text-muted-foreground">
                      {stand.artBeschriftung}
                    </TableCell>
                    <TableCell className="whitespace-nowrap text-sm text-muted-foreground">
                      {stand.stichtag ? formatDatum(stand.stichtag) : 'nie erfasst'}
                    </TableCell>
                    <TableCell className="text-right">
                      <Betrag cent={centZuZahl(stand.betragCent)} />
                    </TableCell>
                  </TableRow>
                ))}
              </TableBody>
            </Table>
          )}
        </CardContent>
      </Card>

      {/* ------------------------------------------------------------- */}
      <Card>
        <CardHeader className="flex-row items-start justify-between gap-3">
          <div>
            <CardTitle>Zuletzt gebucht</CardTitle>
            <CardDescription>Die acht jüngsten Einträge im Kassenbuch.</CardDescription>
          </div>
          <div className="flex shrink-0 flex-wrap gap-2">
            {schreiben && (
              <Button asChild variant="ghost" size="sm">
                <Link href="/finanzen/buchungen/import">
                  <Upload aria-hidden="true" />
                  Importieren
                </Link>
              </Button>
            )}
            <Button asChild variant="ghost" size="sm">
              <Link href="/finanzen/buchungen">
                Alle ansehen
                <ArrowRight aria-hidden="true" />
              </Link>
            </Button>
          </div>
        </CardHeader>
        <CardContent>
          {letzte.length === 0 ? (
            <Leerzustand
              icon={Banknote}
              titel="Das Kassenbuch ist noch leer"
              beschreibung="Erfasse die erste Buchung von Hand oder lies einen Kontoauszug als CSV ein."
              aktion={
                schreiben ? (
                  <div className="flex flex-wrap justify-center gap-2">
                    <Button asChild>
                      <Link href="/finanzen/buchungen/neu">
                        <Plus aria-hidden="true" />
                        Buchung erfassen
                      </Link>
                    </Button>
                    <Button asChild variant="secondary">
                      <Link href="/finanzen/buchungen/import">
                        <Upload aria-hidden="true" />
                        CSV einlesen
                      </Link>
                    </Button>
                  </div>
                ) : undefined
              }
            />
          ) : (
            <Table>
              <TableHeader>
                <TableRow>
                  <TableHead>Datum</TableHead>
                  <TableHead>Vorgang</TableHead>
                  <TableHead>Beleg</TableHead>
                  <TableHead className="text-right">Betrag</TableHead>
                </TableRow>
              </TableHeader>
              <TableBody>
                {letzte.map((buchung) => (
                  <TableRow key={buchung.id}>
                    <TableCell className="whitespace-nowrap">
                      {formatDatum(buchung.datum)}
                    </TableCell>
                    <TableCell>
                      <Link
                        href={`/finanzen/buchungen/${buchung.id}`}
                        className="font-medium hover:underline"
                      >
                        {buchung.gegenstelle ?? KATEGORIE_BESCHRIFTUNG[buchung.kategorie]}
                      </Link>
                      <span className="block text-sm text-muted-foreground">
                        {KATEGORIE_BESCHRIFTUNG[buchung.kategorie]}
                        {!buchung.betrifftBetreute && ' · eigene Auslage'}
                        {buchung.vermoegenswirksam && ' · vermögenswirksam'}
                      </span>
                      {vermischungsWarnung(buchung) && (
                        <span className="mt-1 block">
                          <Vermischungswarnung kurz />
                        </span>
                      )}
                    </TableCell>
                    <TableCell>
                      <Belegzeichen
                        belegId={buchung.belegId}
                        belegTitel={buchung.belegTitel ?? null}
                        begruendung={buchung.belegFehltBegruendung}
                        vertragBezeichnung={
                        belegDurchVertrag(buchung) ? (buchung.vertragBezeichnung ?? null) : null
                        }
                        vertragAutomatisch={buchung.vertragAutomatisch ?? false}
                        betragZuPruefen={betragPruefen(buchung)}
                      />
                    </TableCell>
                    <TableCell className="text-right">
                      <Betrag cent={centZuZahl(buchung.betragCent)} richtung={buchung.richtung} />
                    </TableCell>
                  </TableRow>
                ))}
              </TableBody>
            </Table>
          )}
        </CardContent>
      </Card>

      <Rechtshinweis rechtsgrundlage="§ 1835 BGB, §§ 1859, 1865 BGB" />
    </div>
  )
}