Statistikseite und CSV-Export im Admin

Medusa bringt keine Auswertung mit, die Daten liegen aber alle vor. Die
neue Seite zeigt Umsatz und Bestellungen im Zeitraum, den Verlauf nach
Tagen, die meistverkauften Produkte, die Aufteilung nach Zahlart und
wohin geliefert wurde.

Gerechnet wird in der Datenbank, nicht im Speicher: je Kennzahl eine
Abfrage mit Gruppierung. Die Summen einer Bestellung liegen als JSON in
order_summary, und zwar je Fassung einmal — gezählt wird nur die
neueste, sonst zählten Änderungen doppelt.

Dazu der Export als CSV für die Buchhaltung: Semikolon als Trenner,
Komma als Dezimalzeichen und eine Byte-Order-Mark, sonst zerlegt Excel
in deutscher Einstellung die Spalten und zeigt Umlaute falsch an.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
torbinus
2026-09-28 13:55:09 +02:00
parent 36011a225c
commit 324535db39
3 changed files with 412 additions and 0 deletions
@@ -0,0 +1,206 @@
import { defineRouteConfig } from "@medusajs/admin-sdk";
import { Button, Container, Heading, Select, Table, Text, toast } from "@medusajs/ui";
import { useEffect, useState } from "react";
type Daten = {
zeitraum: { tage: number };
gesamt: {
bestellungen: number;
umsatz: number;
bezahlt: number;
storniert: number;
durchschnitt: number;
};
verlauf: { tag: string; bestellungen: number; umsatz: number }[];
produkte: { titel: string; menge: number; umsatz: number }[];
zahlarten: { zahlart: string; bestellungen: number; summe: number }[];
orte: { ort: string; land: string; bestellungen: number }[];
};
const euro = (wert: number) =>
wert.toLocaleString("de-DE", { style: "currency", currency: "EUR" });
/** Balken aus einem div: für den Verlauf reicht das, und es lädt nichts nach. */
const Balken = ({ anteil }: { anteil: number }) => (
<div className="bg-ui-bg-subtle h-2 w-full rounded-full">
<div
className="bg-ui-fg-interactive h-2 rounded-full"
style={{ width: `${Math.max(anteil * 100, anteil > 0 ? 2 : 0)}%` }}
/>
</div>
);
const Kennzahl = ({ titel, wert, zusatz }: { titel: string; wert: string; zusatz?: string }) => (
<div className="border-ui-border-base rounded-lg border p-4">
<Text size="small" className="text-ui-fg-subtle">{titel}</Text>
<Heading level="h2" className="mt-1">{wert}</Heading>
{zusatz && <Text size="small" className="text-ui-fg-subtle mt-1">{zusatz}</Text>}
</div>
);
const StatistikPage = () => {
const [daten, setDaten] = useState<Daten | null>(null);
const [tage, setTage] = useState("30");
const [laedt, setLaedt] = useState(true);
const laden = async (zeitraum: string) => {
setLaedt(true);
try {
const res = await fetch(`/admin/statistik?tage=${zeitraum}`, { credentials: "include" });
if (!res.ok) throw new Error(String(res.status));
setDaten(await res.json());
} catch (fehler: any) {
toast.error("Fehler", { description: `Zahlen nicht ladbar (${fehler.message}).` });
} finally {
setLaedt(false);
}
};
useEffect(() => {
laden(tage);
}, [tage]);
const hoechsterUmsatz = Math.max(1, ...(daten?.verlauf ?? []).map((t) => t.umsatz));
const bestellungenGesamt = daten?.gesamt.bestellungen ?? 0;
return (
<Container className="divide-y p-0">
<div className="flex flex-wrap items-center justify-between gap-3 px-6 py-4">
<Heading level="h1">Statistik</Heading>
<div className="flex items-center gap-2">
<Select value={tage} onValueChange={setTage}>
<Select.Trigger className="w-40">
<Select.Value />
</Select.Trigger>
<Select.Content>
<Select.Item value="7">Letzte 7 Tage</Select.Item>
<Select.Item value="30">Letzte 30 Tage</Select.Item>
<Select.Item value="90">Letzte 90 Tage</Select.Item>
<Select.Item value="365">Letzte 12 Monate</Select.Item>
</Select.Content>
</Select>
{/* Der Download läuft über einen normalen Link, damit der Browser
die Datei speichert, statt sie im Speicher zu halten. */}
<Button variant="secondary" asChild>
<a href={`/admin/statistik/export?tage=${tage}`}>CSV herunterladen</a>
</Button>
</div>
</div>
{laedt && !daten ? (
<div className="px-6 py-8">
<Text className="text-ui-fg-subtle">Zahlen werden geladen…</Text>
</div>
) : !daten ? null : (
<>
<div className="grid gap-4 px-6 py-5 sm:grid-cols-2 lg:grid-cols-4">
<Kennzahl titel="Umsatz" wert={euro(daten.gesamt.umsatz)} zusatz={`davon bezahlt: ${euro(daten.gesamt.bezahlt)}`} />
<Kennzahl titel="Bestellungen" wert={String(daten.gesamt.bestellungen)} zusatz={daten.gesamt.storniert ? `${daten.gesamt.storniert} storniert` : "keine Stornos"} />
<Kennzahl titel="Durchschnitt je Bestellung" wert={euro(daten.gesamt.durchschnitt)} />
<Kennzahl titel="Zeitraum" wert={`${daten.zeitraum.tage} Tage`} />
</div>
<div className="px-6 py-5">
<Heading level="h2">Verlauf</Heading>
{daten.verlauf.length === 0 ? (
<Text size="small" className="text-ui-fg-subtle mt-2">Keine Bestellungen in diesem Zeitraum.</Text>
) : (
<div className="mt-3 space-y-2">
{daten.verlauf.map((tag) => (
<div key={tag.tag} className="flex items-center gap-3">
<Text size="small" className="text-ui-fg-subtle w-24 shrink-0">
{new Date(tag.tag).toLocaleDateString("de-DE", { day: "2-digit", month: "2-digit" })}
</Text>
<Balken anteil={tag.umsatz / hoechsterUmsatz} />
<Text size="small" className="w-28 shrink-0 text-right tabular-nums">
{euro(tag.umsatz)}
</Text>
<Text size="small" className="text-ui-fg-subtle w-20 shrink-0 text-right tabular-nums">
{tag.bestellungen} Best.
</Text>
</div>
))}
</div>
)}
</div>
<div className="px-6 py-5">
<Heading level="h2">Meistverkauft</Heading>
<Table>
<Table.Header>
<Table.Row>
<Table.HeaderCell>Produkt</Table.HeaderCell>
<Table.HeaderCell className="text-right">Menge</Table.HeaderCell>
<Table.HeaderCell className="text-right">Umsatz</Table.HeaderCell>
</Table.Row>
</Table.Header>
<Table.Body>
{daten.produkte.map((p) => (
<Table.Row key={p.titel}>
<Table.Cell>{p.titel}</Table.Cell>
<Table.Cell className="text-right tabular-nums">{p.menge}</Table.Cell>
<Table.Cell className="text-right tabular-nums">{euro(p.umsatz)}</Table.Cell>
</Table.Row>
))}
</Table.Body>
</Table>
</div>
<div className="grid gap-6 px-6 py-5 lg:grid-cols-2">
<div>
<Heading level="h2">Zahlarten</Heading>
<Table>
<Table.Header>
<Table.Row>
<Table.HeaderCell>Zahlart</Table.HeaderCell>
<Table.HeaderCell className="text-right">Bestellungen</Table.HeaderCell>
<Table.HeaderCell className="text-right">Anteil</Table.HeaderCell>
</Table.Row>
</Table.Header>
<Table.Body>
{daten.zahlarten.map((z) => (
<Table.Row key={z.zahlart}>
<Table.Cell>{z.zahlart}</Table.Cell>
<Table.Cell className="text-right tabular-nums">{z.bestellungen}</Table.Cell>
<Table.Cell className="text-right tabular-nums">
{bestellungenGesamt ? Math.round((z.bestellungen / bestellungenGesamt) * 100) : 0} %
</Table.Cell>
</Table.Row>
))}
</Table.Body>
</Table>
</div>
<div>
<Heading level="h2">Wohin geliefert wird</Heading>
<Table>
<Table.Header>
<Table.Row>
<Table.HeaderCell>Ort</Table.HeaderCell>
<Table.HeaderCell>Land</Table.HeaderCell>
<Table.HeaderCell className="text-right">Bestellungen</Table.HeaderCell>
</Table.Row>
</Table.Header>
<Table.Body>
{daten.orte.map((o) => (
<Table.Row key={`${o.ort}-${o.land}`}>
<Table.Cell>{o.ort}</Table.Cell>
<Table.Cell>{o.land}</Table.Cell>
<Table.Cell className="text-right tabular-nums">{o.bestellungen}</Table.Cell>
</Table.Row>
))}
</Table.Body>
</Table>
</div>
</div>
</>
)}
</Container>
);
};
export const config = defineRouteConfig({
label: "Statistik",
});
export default StatistikPage;
@@ -0,0 +1,86 @@
import { MedusaRequest, MedusaResponse } from "@medusajs/framework/http";
import { ContainerRegistrationKeys } from "@medusajs/framework/utils";
/**
* Bestellungen als CSV, eine Zeile je Bestellung.
*
* GET /admin/statistik/export?tage=365
*
* Für Buchhaltung und eigene Auswertungen in Excel. Semikolon als Trenner und
* Komma als Dezimalzeichen, weil Excel in deutscher Einstellung sonst Spalten
* und Beträge zerlegt. Die Datei beginnt mit einer Byte-Order-Mark, sonst
* zeigt Excel aus Umlauten Buchstabensalat.
*/
export async function GET(req: MedusaRequest, res: MedusaResponse) {
const knex: any = req.scope.resolve(ContainerRegistrationKeys.PG_CONNECTION);
const tage = Math.min(Math.max(Number((req.query.tage as string) ?? 365) || 365, 1), 3650);
const von = new Date(Date.now() - tage * 24 * 60 * 60 * 1000).toISOString();
const { rows } = await knex.raw(
`select o.display_id,
o.created_at,
o.status,
o.canceled_at,
o.email,
o.currency_code,
(s.totals->>'current_order_total')::numeric as summe,
(s.totals->>'paid_total')::numeric as bezahlt,
a.city, a.postal_code, a.country_code,
(select string_agg(distinct p.provider_id, ' | ')
from order_payment_collection opc
join payment p on p.payment_collection_id = opc.payment_collection_id
and p.deleted_at is null
where opc.order_id = o.id and opc.deleted_at is null) as zahlarten,
(select string_agg(li.product_title || ' x' || oi.quantity, ' | ')
from order_item oi
join order_line_item li on li.id = oi.item_id
where oi.order_id = o.id and oi.deleted_at is null) as positionen
from "order" o
join lateral (
select totals from order_summary
where order_id = o.id and deleted_at is null
order by version desc limit 1
) s on true
left join order_address a on a.id = o.shipping_address_id
where o.deleted_at is null and o.is_draft_order = false and o.created_at >= ?
order by o.created_at desc`,
[von]
);
const spalten = [
"Bestellnummer", "Datum", "Status", "Storniert", "E-Mail", "Währung",
"Summe", "Bezahlt", "Ort", "PLZ", "Land", "Zahlart", "Positionen",
];
/** Semikolon, Anführungszeichen und Zeilenumbrüche müssen maskiert werden. */
const feld = (wert: any) => {
if (wert === null || wert === undefined) return "";
const text = String(wert);
return /[";\n]/.test(text) ? `"${text.replace(/"/g, '""')}"` : text;
};
const betrag = (wert: any) => (wert === null ? "" : Number(wert).toFixed(2).replace(".", ","));
const zeilen = rows.map((r: any) =>
[
r.display_id,
new Date(r.created_at).toLocaleString("de-DE"),
r.status,
r.canceled_at ? "ja" : "nein",
r.email,
(r.currency_code ?? "").toUpperCase(),
betrag(r.summe),
betrag(r.bezahlt),
r.city,
r.postal_code,
(r.country_code ?? "").toUpperCase(),
r.zahlarten,
r.positionen,
].map(feld).join(";")
);
const datum = new Date().toISOString().slice(0, 10);
res.setHeader("Content-Type", "text/csv; charset=utf-8");
res.setHeader("Content-Disposition", `attachment; filename="bestellungen-${datum}.csv"`);
res.send("" + [spalten.join(";"), ...zeilen].join("\r\n"));
}
@@ -0,0 +1,120 @@
import { MedusaRequest, MedusaResponse } from "@medusajs/framework/http";
import { ContainerRegistrationKeys } from "@medusajs/framework/utils";
/**
* Zahlen für die Auswertungsseite im Admin.
*
* GET /admin/statistik?tage=30
*
* Bewusst als eine SQL-Abfrage je Kennzahl statt über das Datenmodell:
* Summen und Gruppierungen macht die Datenbank in einem Zug, das Laden aller
* Bestellungen in den Speicher würde bei wachsendem Bestand nicht mehr taugen.
*
* Die Summen einer Bestellung liegen als JSON in `order_summary`, und zwar je
* Fassung einmal — Stornierungen und Änderungen erzeugen neue Fassungen.
* Gezählt wird deshalb immer nur die neueste.
*/
/** Die jeweils neueste Fassung der Summen je Bestellung. */
const AKTUELLE_SUMME = `
join lateral (
select totals from order_summary
where order_id = o.id and deleted_at is null
order by version desc limit 1
) s on true
`;
export async function GET(req: MedusaRequest, res: MedusaResponse) {
const knex: any = req.scope.resolve(ContainerRegistrationKeys.PG_CONNECTION);
const tage = Math.min(Math.max(Number((req.query.tage as string) ?? 30) || 30, 1), 730);
const von = new Date(Date.now() - tage * 24 * 60 * 60 * 1000).toISOString();
const nurEchte = `o.deleted_at is null and o.is_draft_order = false and o.created_at >= ?`;
const [summe, verlauf, produkte, zahlarten, orte] = await Promise.all([
knex.raw(
`select count(*)::int as bestellungen,
coalesce(sum((s.totals->>'current_order_total')::numeric), 0) as umsatz,
coalesce(sum((s.totals->>'paid_total')::numeric), 0) as bezahlt,
count(*) filter (where o.canceled_at is not null)::int as storniert
from "order" o ${AKTUELLE_SUMME} where ${nurEchte}`,
[von]
),
knex.raw(
`select o.created_at::date as tag,
count(*)::int as bestellungen,
coalesce(sum((s.totals->>'current_order_total')::numeric), 0) as umsatz
from "order" o ${AKTUELLE_SUMME} where ${nurEchte}
group by tag order by tag`,
[von]
),
knex.raw(
`select li.product_title as titel,
sum(oi.quantity)::int as menge,
coalesce(sum(oi.quantity * li.unit_price), 0) as umsatz
from "order" o
join order_item oi on oi.order_id = o.id and oi.deleted_at is null
join order_line_item li on li.id = oi.item_id
where ${nurEchte}
group by titel order by menge desc limit 10`,
[von]
),
knex.raw(
`select p.provider_id as zahlart,
count(distinct o.id)::int as bestellungen,
coalesce(sum(p.amount), 0) as summe
from "order" o
join order_payment_collection opc on opc.order_id = o.id and opc.deleted_at is null
join payment p on p.payment_collection_id = opc.payment_collection_id and p.deleted_at is null
where ${nurEchte}
group by zahlart order by bestellungen desc`,
[von]
),
knex.raw(
`select coalesce(nullif(a.city, ''), 'ohne Angabe') as ort,
upper(coalesce(nullif(a.country_code, ''), '--')) as land,
count(*)::int as bestellungen
from "order" o
left join order_address a on a.id = o.shipping_address_id
where ${nurEchte}
group by ort, land order by bestellungen desc limit 15`,
[von]
),
]);
const zahl = (wert: any) => Number(wert ?? 0);
res.json({
zeitraum: { tage, von },
gesamt: {
bestellungen: summe.rows[0].bestellungen,
umsatz: zahl(summe.rows[0].umsatz),
bezahlt: zahl(summe.rows[0].bezahlt),
storniert: summe.rows[0].storniert,
durchschnitt: summe.rows[0].bestellungen
? zahl(summe.rows[0].umsatz) / summe.rows[0].bestellungen
: 0,
},
verlauf: verlauf.rows.map((r: any) => ({
tag: r.tag instanceof Date ? r.tag.toISOString().slice(0, 10) : String(r.tag).slice(0, 10),
bestellungen: r.bestellungen,
umsatz: zahl(r.umsatz),
})),
produkte: produkte.rows.map((r: any) => ({
titel: r.titel ?? "ohne Titel",
menge: r.menge,
umsatz: zahl(r.umsatz),
})),
zahlarten: zahlarten.rows.map((r: any) => ({
zahlart: r.zahlart,
bestellungen: r.bestellungen,
summe: zahl(r.summe),
})),
orte: orte.rows.map((r: any) => ({
ort: r.ort,
land: r.land,
bestellungen: r.bestellungen,
})),
});
}