Aufgabe
Eine Buchhandlung brauchte einen Onlineshop für Kunden aus verschiedenen Ländern. Käufer sollen vor der Zahlung den Gesamtpreis einschließlich Versand und Steuer sehen; der Shop darf nur vorhandene Exemplare verkaufen.
Bestehende Bestellungen sollen ihre Bedingungen bei Preis- und Kursänderungen behalten. Eine Stornierung muss die Bücher wieder verfügbar machen und die Erstattung bereits gezahlter Beträge anstoßen.
Lösung
Das System besteht aus einer Django-REST-API und einer Vue-Oberfläche. Die API prüft Bestände und erstellt die Bestellung in einer Transaktion mit gesperrten Buchzeilen. Titel, Preise, Währung, Adresse und Versandkosten werden zum Kaufzeitpunkt in der Bestellung gespeichert.
Für Zahlungen stehen Stripe Checkout und ein eigener Demo-Anbieter bereit. Im Stripe-Modus bestätigt ein signierter Webhook die Zahlung. Trifft sie nach einer Stornierung ein, bleibt die Bestellung storniert und eine Erstattung wird ausgelöst. Jede Erstattung besitzt einen eigenen Datensatz und Idempotenzschlüssel.
Umgesetzte Aufgaben
- Katalog mit Volltextsuche und Tippfehlertoleranz umgesetzt
- Bestandsprüfung, Bestellerstellung und Abbuchung der Bücher in einer Transaktion verbunden
- Versand nach Zone und Gewicht sowie Steuer nach Land, Bundesstaat oder Postleitzahl berechnet
- Stripe Checkout und einen separaten Anbieter für Testkarten angebunden
- Preise, Währung und Adresse als unabhängigen Stand jeder Bestellung gespeichert
- Stornierung mit Bestandsrückgabe sowie vollständige und teilweise Erstattungen umgesetzt
- Den ursprünglichen Shop und Katalog ins Russische, Englische, Französische und Deutsche übersetzt
- Währungen, Versand und Steuern in die Verwaltung sowie Kursupdates und Erstattungswiederholungen in einen Scheduler aufgenommen
Ergebnis
Käufer finden Bücher, sehen den Gesamtpreis, bestellen und bezahlen in einer Oberfläche. Nach der Stornierung stehen die Bücher wieder zum Verkauf; für bereits gezahlte Beträge beginnt die Erstattung. Mitarbeiter verwalten Katalog, Bestellungen und Einstellungen über die Verwaltung.
Die eingebettete Demo zeigt diesen Ablauf mit erfundenen Büchern und Adressen. Testzahlung, Stornierung und zwei Käufe desselben Restbestands nutzen ein gemeinsames lokales Browsermodell.
Anmerkung des Entwicklers
Was schwierig war
Die größte Aufgabe war die Konsistenz von Bestellung, Bestand und Zahlung. Während der Zahlung kann eine Bestellung storniert werden. Eine erfolgreiche Zahlung darf die Stornierung weder aufheben noch Bücher doppelt zurückbuchen. Die API prüft Status unter einer Sperre und erstattet verspätete Zahlungen.
Wiederholte Benachrichtigungen und Anbieterfehler dürfen keine doppelte Erstattung auslösen. Jede Erstattung erhält deshalb einen eigenen Datensatz und einen festen Idempotenzschlüssel für den Anbieter. Ein Scheduler wiederholt fehlgeschlagene Versuche.
Was leicht fiel
Die klare Trennung von API und Oberfläche vereinfachte Katalog, Warenkorb und Bestellabschluss. Prüfungen und Berechnungen liegen auf dem Server; Vue zeigt Daten und Vorgangsstatus. Änderungen am Bildschirm erfordern keine doppelten Bestellregeln.
Versand-, Steuer- und Währungseinstellungen passten in die Standardverwaltung von Django. Mitarbeiter können die Tabellen ohne Codeänderungen pflegen, während bestehende Bestellungen ihre ursprünglichen Bedingungen behalten.
Technologien
PythonDjango REST FrameworkVue 3TypeScriptPostgreSQLStripeDocker