E-Commerce
Regeln
- Warenkorbzustand: Zustand-Store mit
localStorage-Persistenz – übersteht Seitenaktualisierung und Tab-Schließen
- Produktvarianten: Als separate SKUs mit gemeinsamem übergeordnetem Produkt modellieren – jede Variante hat eigenen Preis, Bestand, Bild
- Checkout: Stripe Checkout Sessions (serverseitig) – Preise niemals vom Client senden
- Bestand: Lagerbestand serverseitig vor Erstellung der Checkout-Session prüfen – Race-Condition-Schutz durch Datenbanktransaktionen
- Bestelllebenszyklus:
pending → paid → shipped → delivered – Aktualisierung über Webhook-Ereignisse, nicht durch Client-Aktionen
- Produktliste: Serverseitiges Filtern/Sortieren/Paginieren – URL-Suchparameter für teilbare gefilterte Ansichten
- Preise: In Cent speichern (Ganzzahlen) – Anzeige mit
Intl.NumberFormat und Währungscode
- Warenkorboperationen: Hinzufügen, Entfernen, Mengenaktualisierung, Leeren – Bestand bei jeder Warenkorbaktion validieren
Muster
import { create } from "zustand";
import { persist } from "zustand/middleware";
interface CartItem { productId: string; variantId: string; quantity: number; price: number; }
interface CartStore {
items: CartItem[];
addItem: (item: CartItem) => void;
removeItem: (variantId: string) => void;
updateQuantity: (variantId: string, quantity: number) => void;
clear: () => void;
total: () => number;
}
export const useCart = create<CartStore>()(
persist(
(set, get) => ({
items: [],
addItem: (item) => set((state) => {
const existing = state.items.find((i) => i.variantId === item.variantId);
if (existing) {
return { items: state.items.map((i) =>
i.variantId === item.variantId ? { ...i, quantity: i.quantity + item.quantity } : i
)};
}
return { items: [...state.items, item] };
}),
removeItem: (variantId) => set((s) => ({ items: s.items.filter((i) => i.variantId !== variantId) })),
updateQuantity: (variantId, quantity) => set((s) => ({
items: quantity <= 0
? s.items.filter((i) => i.variantId !== variantId)
: s.items.map((i) => (i.variantId === variantId ? { ...i, quantity } : i)),
})),
clear: () => set({ items: [] }),
total: () => get().items.reduce((sum, i) => sum + i.price * i.quantity, 0),
}),
{ name: "cart-storage" }
)
);
Vermeiden
- Preise vom Client senden, um einen Checkout zu erstellen – Preise immer serverseitig aus der Datenbank auflösen
- Warenkorb nur im React-Status speichern – persistierten Zustand oder localStorage verwenden, damit der Warenkorb eine Aktualisierung übersteht
- Bestand bei "In den Warenkorb" abbuchen – Bestand erst beim Checkout reservieren, bei Sitzungsablauf freigeben
- Bestellstatus vom Client aktualisieren – Stripe-Webhooks für
checkout.session.completed verwenden
- Fließkommazahlen für Geldbeträge – als Ganzzahlen (Cent) speichern, nur zur Anzeige formatieren