This repository has been archived on 2026-11-18. You can view files and clone it. You cannot open issues or pull requests or push a commit.
Files
Dashboard/features/dashboard/components/dashboard/WidgetKachel.tsx
T
dejanandClaude Opus 5 ab79c711ad Karten einer Zeile gleich hoch, Ueberschuss mittig verteilen
Aus dem Sparring: Bei duenner Datenlage riss die oben buendige Ausrichtung
Loecher in die Seite. Nachgemessen auf /analytics mit Zeitraum "heute" und
Gewerk "Heizung": "Umsatz nach Gewerk" 112 px neben "Zahlungseingang im
Zeitverlauf" 427 px — 315 px Seitenhintergrund dazwischen. Das liest sich
nicht als "wenig Daten", sondern als "etwas ist kaputt".

Zwei Aenderungen, beide klein:

- Der Kartenkoerper zentriert seinen Inhalt senkrecht. Der Ueberschuss geht
  je zur Haelfte nach oben und unten, statt unten abgeladen zu werden. Eine
  Stelle in ChartCard und eine in WidgetKachel — nicht in fuenf Diagrammen.

- items-start faellt auf den Zeilen, die ausschliesslich Diagrammkarten
  tragen. Die Zeile mit den beiden Tabellen auf der Kundenseite bleibt oben
  buendig: Eine Tabelle hat ein natuerliches Ende und eine eigene
  Blaetterleiste, Strecken schiebt die nur nach unten.

Die Karten bleiben dynamisch — keine feste Hoehe, mehr Inhalt laesst die
Karte und mit ihr die Zeile weiter wachsen.

Die Leere verschwindet nicht, sie zieht aus dem Seitenhintergrund in die
Karte. Das ist der Unterschied zwischen einem Raster mit Luecken und einer
Karte, in der gerade wenig steht.

Nachgemessen nach der Aenderung: 427/427, 389/389 auf /analytics,
372/372 und 423/423 auf /dashboard. Dabei ist nebenbei die Leerflaeche unter
dem Vertriebstrichter verschwunden, die vorher auffiel.

In DESIGN-SYSTEM.md als Regel festgehalten.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QPeZNwSeU7qG3RRCwaxEZX
2026-08-31 17:38:57 +02:00

133 lines
5.3 KiB
TypeScript

"use client";
import React from "react";
import Link from "next/link";
import { FeatherArrowRight, FeatherInfo } from "@subframe/core";
import { FeatherIcon } from "../layout/FeatherIcon";
import { ZEITRAUM_LABEL, type WidgetDomaene, type WidgetZeitraum } from "../../view-models/dashboard.vm";
/**
* Rahmen einer Dashboard-Kachel.
*
* Sieht aus wie `ChartCard` aus Analytics — gleiche Kante, gleiche Abstände,
* gleiche Schriftgrößen — trägt aber nicht deren Logik. Das ⋯-Menü und das
* Ausblenden gehören zu Analytics; im Dashboard macht das die Widget-Registry
* der Software (`docs/SCOPE-ANALYTICS-DASHBOARD.md`, Abschnitt 3.3).
*
* Zwei Dinge hat die Kachel dafür, die eine Analytics-Karte nicht braucht:
*
* 1. **Ein Domänen-Icon oben rechts.** Die Software führt dafür eine feste
* Zuordnung (`domainIcons` in `DashboardPage.tsx`); sie ist unten
* übernommen. Auf einer Fläche, die Zahlen aus vier Bereichen mischt, sagt
* das Icon in einem Blick, woher eine Kachel kommt.
*
* 2. **Einen eigenen Zeitraum.** In Analytics gilt ein Filter für alle Karten.
* Im Dashboard trägt jede Kachel ihren eigenen (P11: „Edit = nur
* Widget-Filter/Zeitraum"). Deshalb steht er auf der Kachel — ohne das
* zeigt eine Kachel stillschweigend einen anderen Zeitraum als ihre
* Nachbarin, und niemand merkt es.
*/
/** Zeichengleich zu `domainIcons` in `DashboardPage.tsx` der Software. */
const DOMAENEN_ICON: Record<WidgetDomaene, string> = {
general: "Home",
sales: "TrendingUp",
finance: "CreditCard",
projects: "Folder",
tasks: "CheckSquare",
hr: "Users",
activity: "Activity",
comms: "PhoneCall",
schedule: "Calendar",
};
export function WidgetKachel({
titel,
untertitel,
hinweis,
domaene,
zeitraum,
absprung,
absprungText = "Details ansehen",
children,
className = "",
}: {
titel: string;
untertitel?: string;
/** Erklärt die Kennzahl; erscheint als Tooltip am (i) — wie in Analytics. */
hinweis?: string;
domaene: WidgetDomaene;
zeitraum: WidgetZeitraum;
/** Ziel des Absprungs in die Analyse — `widget.drilldownHref` in der Software. */
absprung?: string;
absprungText?: string;
children: React.ReactNode;
className?: string;
}) {
return (
<section
/* @container: Die Kachelbreite hängt am Raster, nicht am Fenster. Eine
Vier-Zwölftel-Kachel ist bei 1024 px rund 235 px breit — dieselbe
Kachel bei 1920 px doppelt so viel. Was sich im Kopf einblendet, muss
deshalb die Kachel messen und nicht den Viewport. */
className={`@container flex h-full flex-col overflow-hidden rounded-lg border border-solid border-border-default bg-white shadow-sm ${className}`}
>
<header className="flex flex-none items-start justify-between gap-3 px-4 pb-3 pt-4">
<div className="flex min-w-0 flex-col">
<div className="flex items-center gap-1.5">
<h2 className="min-w-0 break-words text-[14px] font-semibold leading-tight text-text-neutral-primary">
{titel}
</h2>
{hinweis ? (
<span
title={hinweis}
className="flex h-4 w-4 flex-none cursor-help items-center justify-center text-text-neutral-subtle hover:text-text-neutral-secondary"
>
<FeatherInfo className="text-[13px]" />
</span>
) : null}
</div>
{untertitel ? (
<p className="line-clamp-2 break-words text-[12px] leading-snug text-text-neutral-tertiary">
{untertitel}
</p>
) : null}
</div>
<span className="flex flex-none items-center gap-2">
{/* Der Zeitraum steht nur dort, wo Platz für Wörter ist: ab 24rem
Kachelbreite. Darunter nimmt er dem Untertitel so viel Raum, dass
der auf 77 px Breite zerfällt und in das Diagramm darunter läuft.
Er ist dann über den Untertitel weiterhin erschließbar, der die
Periode ausschreibt. */}
<span className="hidden whitespace-nowrap rounded-full bg-neutral-50 px-2 py-0.5 text-[11px] font-medium text-text-neutral-tertiary @[24rem]:inline">
{ZEITRAUM_LABEL[zeitraum]}
</span>
<span className="text-text-neutral-subtle">
<FeatherIcon name={DOMAENEN_ICON[domaene]} className="text-[16px]" />
</span>
</span>
</header>
{/* justify-center: Karten einer Zeile sind gleich hoch, aber nicht gleich
voll. Eine Karte mit einem Balken neben einer mit einem Diagramm über
400 px bekommt den Überschuss oben und unten je zur Hälfte, statt ihn
unten abzuladen. Der Inhalt behält seine natürliche Höhe — die Karte
wächst weiter mit, wenn mehr hineinkommt. */}
<div className="flex min-h-0 grow flex-col justify-center px-4 pb-4">{children}</div>
{absprung ? (
<footer className="dv-no-print flex flex-none items-center px-4 pb-4">
<Link
href={absprung}
className="flex items-center gap-1 text-[12px] font-medium text-text-feedback-link-default no-underline hover:underline"
>
{absprungText}
<FeatherArrowRight className="text-[13px]" />
</Link>
</footer>
) : null}
</section>
);
}