Tasuki · Last-Mile-Lieferplattform
Die Lieferseite eines Unternehmens, in deiner eigenen Cloud.
- Status
- Phase 1 von 7 · lokal erprobt
- Lizenz
- MIT
- Auf GitHub
- ★ 1 · ⑂ 0
- Bestellungen/h bei voller Auslegung, auf einem Laptop
- 18.144
- GPS-Punkte/s, ohne eine fehlgeschlagene Bestellung
- 641
- Game-Day-Pläne; der erste durchgeführt, mit Postmortem
- 12
Warum es das gibt
Tasuki ist die Lieferseite eines Unternehmens als Software, die du neben deiner eigenen deployst. Dein System legt per API eine Lieferung an. Tasuki nennt Preis und Ankunftszeit, findet den nächsten Kurier, streamt seine Position aufs Handy des Kunden und meldet jede Statusänderung zurück.
Der Name kommt von der Schärpe, die sich Staffelläufer beim Ekiden übergeben. Das Design ist für 1,5 Millionen Bestellungen im Monat in einer Stadt ausgelegt, und das Repository baut für jedes harte Problem einer solchen Plattform einen schmalen Durchstich – mit schriftlich festgehaltener Begründung.
Das Referenz-Deployment sind die 23 Bezirke Tokios auf echten Tokioter Straßen. Das Unternehmen ist fiktiv, und Händler, Kuriere und Kunden sind simuliert.
Was es kann
Bestellungen, die nie verloren gehen oder doppelt abgerechnet werden
Jede Bestellung trägt einen Idempotency Key, und eine Transactional Outbox bringt sie von der API zu Kafka. Ein Retry oder ein Absturz kann also keine zweite Bestellung erzeugen.
Live-Flottendaten
Ein Go-Service schreibt die GPS-Updates der Kuriere in Kafka, und ein Cache wird aus diesem Log neu aufgebaut. Ziel der Auslegung sind etwa 750 Updates pro Sekunde.
Disposition über echte Straßen
Kuriere werden anhand von Straßendistanzen aus OSRM auf einem Fahrrad-Graphen von Tokio zugeordnet. Ohne OSRM fällt die Disposition auf Luftlinie zurück und funktioniert weiter.
Eine Live-Karte und eine Tracking-Seite
Eine React-Konsole zeigt die Flotte auf einer Karte, und jede Bestellung hat einen Tracking-Link, den der Kunde öffnen kann.
Eine simulierte Stadt
Ein Simulator spielt Händler, Kunden und Kuriere über die öffentlichen APIs durch, mit Szenarien wie einem verregneten Freitag, damit sich die Plattform unter Last testen lässt.
Betrieben wie ein Produktionsdienst
Schriftliche SLOs mit Burn-Rate-Alerts, Dashboards als Code, ein Runbook pro Alert, ein Bedrohungsmodell, Architecture Decision Records und Game-Day-Pläne.
So funktioniert es
- 01
Dein System legt eine Lieferung an
Es schickt die Bestellung mit einem Idempotency Key an die API. Die API antwortet mit Preis, Ankunftszeit und Tracking-Link.
- 02
Die Bestellung wird veröffentlicht
Bestellung und Outbox-Zeile werden in einer PostgreSQL-Transaktion gespeichert. Ein Relay veröffentlicht das Event in Kafka.
- 03
Ein Kurier wird zugewiesen
Die Disposition wählt den nächsten verfügbaren Kurier.
- 04
Der Kunde verfolgt die Lieferung
Kurierpositionen fließen über den Ingest-Service zum Tracking-Service, der sie an die Tracking-Seite schickt.
Selbst ausführen
Ein Befehl baut und startet PostgreSQL, Kafka, Valkey und alle Services. Du brauchst Docker mit Compose v2 und GNU Make 4 (unter macOS: brew install make, dann gmake eingeben).
$ git clone https://github.com/codewithmuh/tasuki-delivery-platform.git$ cd tasuki-delivery-platform$ cp .env.example .env$ make up$ make sim-up- Live-Karte: http://localhost:8088
- Order-API: http://localhost:8000
- make sim-up startet den Simulator: Er legt Händler und Kuriere an, dann fließen Bestellungen.
- make routing-up fügt OSRM auf echten Tokioter Straßen hinzu (der erste Build dauert 10 bis 20 Minuten).
Stack
Aktueller Stand
Fertig
- Bestellungen: Angebote, idempotente Bestellungen und das Outbox-Relay, gegen PostgreSQL-Race-Conditions getestet
- Flotten-Ingest, Flottenstatus und Tracking
- Routing auf Tokioter Straßen, der Simulator und die Live-Konsole
- SLOs, Alerts, das Rollout-Gate und Dashboards
Noch offen
- Jede Stadt: Zonen aus einer GeoJSON-Datei, mit konfigurierbarer Währung und Steuer
- Signierte Webhooks und ein Dashboard mit Login
- Eine Kurier-App
- Eine Single-Server-Installation und ein Helm-Chart
- Der erste Lauf auf einem echten AWS-Cluster – bewusst die letzte Phase
Das Unternehmen ist fiktiv und der Traffic simuliert. Die EKS- und GitOps-Schichten sind geschrieben und geprüft, laufen aber noch auf keinem Cluster.
Fragen
- Ist Tasuki ein echtes Lieferunternehmen?
- Nein. Tasuki ist ein fiktives Unternehmen, mit dem eine echte Plattform gebaut wird. Der Traffic kommt aus einem Simulator.
- Kann ich es auf meinem Laptop laufen lassen?
- Ja. Ein Befehl startet PostgreSQL, Kafka, Valkey und alle Services mit Docker Compose.
- Funktioniert es nur für Tokio?
- Das Referenz-Deployment nutzt die 23 Bezirke Tokios. Zonen, Währung und Steuer für jede Stadt konfigurierbar zu machen, ist die nächste Phase.
- Läuft es auf AWS?
- Noch nicht. Die Terraform- und GitOps-Schichten sind geschrieben und geprüft; sie auf einem Cluster laufen zu lassen, ist die letzte Phase der Roadmap.
- Unter welcher Lizenz steht es?
- MIT.
Du willst Tasuki für dein Team betreiben oder etwas Ähnliches bauen lassen?