feat: Liefergebiet im Admin-Bereich umschaltbar (Deutschland / EU)

Admin-Bereich → Inhalte → Firmendaten → "Liefergebiet". Auswahl zwischen
"Nur Deutschland" und "Europäische Union". Der Wert steuert drei Stellen
gleichzeitig, damit sie nicht auseinanderlaufen koennen:

1. Checkout-Formular: bei "EU" eine Laenderauswahl mit den 27
   Mitgliedstaaten, bei "Nur Deutschland" stattdessen ein Satz, der das
   Gebiet benennt — bevor jemand die Adresse eintippt und erst beim
   Abschicken erfaehrt, dass daraus nichts wird. Eine Auswahl mit einem
   einzigen Eintrag waere eine Attrappe.

2. api/checkout/route.ts: verbindliche Pruefung. Die Auswahl im Formular
   ist Bequemlichkeit, kein Schutz — der Endpunkt nimmt JSON entgegen und
   laesst sich ohne Formular aufrufen. Ohne diese Pruefung entstuende eine
   Bestellung mit einer Lieferadresse, fuer die weder Versandweg noch
   Umsatzsteuerpflicht geklaert sind, und bezahlt waere sie dann auch
   schon. Abgewiesen wird mit einer Meldung, die sagt, was stattdessen
   geht (Adresse im Gebiet oder Abholung).

3. Seite "Versand und Zahlung": eigener Abschnitt "Liefergebiet" mit dem
   passenden Satz. Eigener Abschnitt statt Nebensatz, weil die Frage vor
   dem Warenkorb entscheidet, ob ein Kauf ueberhaupt zustande kommt.

Die Vorgabe ist "Nur Deutschland", und zwar an jeder Stelle einzeln: ein
fehlender oder unsinniger Wert, eine nicht durchgereichte Prop — im
Zweifel liefert der Shop in WENIGER Laender, nie in mehr.

"EU" heisst die 27 Mitgliedstaaten, nicht Europa im geografischen Sinn.
Schweiz, Norwegen und das Vereinigte Koenigreich sind Zollausland; dorthin
zu liefern braucht mehr als einen Haken im Admin-Bereich.

Technisch dazugekommen:
  - lib/shipping-region.ts, reine Logik ohne Datenbankzugriff (wie
    shipping-calc.ts), 11 Tests.
  - content-registry.ts kennt jetzt den Feldtyp "select" mit "options" —
    ein Freitextfeld waere hier falsch: ein Tippfehler im Liefergebiet
    wuerde stillschweigend auf den Vorgabewert zurueckfallen, und niemand
    saehe, dass die Umstellung nicht gegriffen hat.
  - Laendernamen ueber Intl.DisplayNames statt 27 Namen je Sprache im
    Woerterbuch: eine eigene Liste waere ab dem naechsten Beitritt falsch.
  - 3 weitere Tests in der Checkout-Route (Abweisung, EU-Mitglied durch,
    Drittland trotzdem abgewiesen).

tsc: 0 Fehler. vitest: 350/350 gruen (zuvor 336). eslint: 0 Warnungen.
"next build" laeuft durch.

Co-Authored-By: Claude Opus 5 (1M context) <[email protected]>
This commit is contained in:
Nick SzaunigandClaude Opus 5 committed 2026-09-19 07:59:15 +02:00
1 parent 29f59adc6b
commit 6d7a77c8dd
13 files changed
+383 -7

No files matched your search

+91
View File
@@ -0,0 +1,91 @@
/**
* Tests fuer das Liefergebiet.
*
* Die Frage "darf in dieses Land geliefert werden" entscheidet, ob eine
* Bestellung zustande kommt. Ein Fehler in die eine Richtung sperrt zahlende
* Kundschaft aus, einer in die andere erzeugt Lieferungen in Laender, fuer
* die weder Steuer noch Zoll geklaert sind.
*/
import { describe, test, expect } from "vitest";
import {
DEFAULT_SHIPPING_REGION,
EU_COUNTRY_CODES,
allowedCountryCodes,
isCountryAllowed,
parseShippingRegion,
} from "./shipping-region";
describe("parseShippingRegion", () => {
test("erkennt die beiden gueltigen Werte", () => {
expect(parseShippingRegion("DE")).toBe("DE");
expect(parseShippingRegion("EU")).toBe("EU");
});
test("ist unempfindlich gegen Schreibweise und Leerzeichen", () => {
expect(parseShippingRegion(" eu ")).toBe("EU");
expect(parseShippingRegion("de")).toBe("DE");
});
test("faellt bei fehlendem oder unsinnigem Wert auf den engsten Zuschnitt zurueck", () => {
// Wichtige Richtung: im Zweifel WENIGER Laender, nicht mehr. Ein Shop
// liefert nie versehentlich weiter, als er wollte.
expect(parseShippingRegion(null)).toBe("DE");
expect(parseShippingRegion("")).toBe("DE");
expect(parseShippingRegion("WELTWEIT")).toBe("DE");
expect(DEFAULT_SHIPPING_REGION).toBe("DE");
});
});
describe("allowedCountryCodes", () => {
test('"DE" erlaubt genau ein Land', () => {
expect(allowedCountryCodes("DE")).toEqual(["DE"]);
});
test('"EU" erlaubt die 27 Mitgliedstaaten, sortiert und ohne Dubletten', () => {
const codes = allowedCountryCodes("EU");
expect(codes).toHaveLength(27);
expect(codes).toEqual([...codes].sort());
expect(new Set(codes).size).toBe(27);
});
test("Drittlaender in Europa sind NICHT enthalten", () => {
// Schweiz, Norwegen und das Vereinigte Koenigreich liegen in Europa, sind
// aber Zollausland — dorthin zu liefern braucht mehr als einen Haken im
// Admin-Bereich.
const codes = allowedCountryCodes("EU");
expect(codes).not.toContain("CH");
expect(codes).not.toContain("NO");
expect(codes).not.toContain("GB");
});
test("Griechenland steht als ISO-Code GR, nicht als EL", () => {
expect(EU_COUNTRY_CODES as readonly string[]).toContain("GR");
expect(EU_COUNTRY_CODES as readonly string[]).not.toContain("EL");
});
});
describe("isCountryAllowed", () => {
test('bei "DE" kommt nur Deutschland durch', () => {
expect(isCountryAllowed("DE", "DE")).toBe(true);
expect(isCountryAllowed("DE", "AT")).toBe(false);
expect(isCountryAllowed("DE", "FR")).toBe(false);
});
test('bei "EU" kommen Mitgliedstaaten durch, Drittlaender nicht', () => {
expect(isCountryAllowed("EU", "AT")).toBe(true);
expect(isCountryAllowed("EU", "DE")).toBe(true);
expect(isCountryAllowed("EU", "CH")).toBe(false);
expect(isCountryAllowed("EU", "US")).toBe(false);
});
test("akzeptiert Kleinschreibung und Leerzeichen aus dem Formular", () => {
expect(isCountryAllowed("EU", " at ")).toBe(true);
expect(isCountryAllowed("DE", "de")).toBe(true);
});
test("ein fehlendes Land ist nie erlaubt", () => {
expect(isCountryAllowed("EU", null)).toBe(false);
expect(isCountryAllowed("EU", "")).toBe(false);
expect(isCountryAllowed("EU", " ")).toBe(false);
});
});