Tasuki · Last-Mile-Lieferplattform

Die Lieferseite eines Unternehmens, in deiner eigenen Cloud.

Die Lieferseite eines Unternehmens als Software, die du neben deiner eigenen betreibst. Dein System legt per API eine Lieferung an; Tasuki nennt Preis und ETA, disponiert den nächsten Kurier über ein echtes Straßennetz und streamt seine Position live aufs Handy des Kunden. Gebaut nach Produktionsstandards: idempotente Bestellungen, eine Kafka-Standort-Pipeline, schriftliche SLOs, Lasttests und Game Days.
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
01

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.

02

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.

03

So funktioniert es

  1. 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.

  2. 02

    Die Bestellung wird veröffentlicht

    Bestellung und Outbox-Zeile werden in einer PostgreSQL-Transaktion gespeichert. Ein Relay veröffentlicht das Event in Kafka.

  3. 03

    Ein Kurier wird zugewiesen

    Die Disposition wählt den nächsten verfügbaren Kurier.

  4. 04

    Der Kunde verfolgt die Lieferung

    Kurierpositionen fließen über den Ingest-Service zum Tracking-Service, der sie an die Tracking-Seite schickt.

fig. 01Bestellungen · Standorte · Betrieb
CLIENTSYour systemorders apiCouriergps · offersCustomertracking pageSimulatorplays the cityMONEY PATH · DJANGOordersidempotent · quotesPostgreSQLoutbox → relayLOCATION PATH · GOfleet-ingestgps → kafkatrackingsse · reads kafkadispatchoffers over sseKafka3 topics18,144 orders/hmeasured · one laptop641 gps/s · 0 failed ordersfleet-statenewest point / courierValkeycache · rebuilt from logOSRMtokyo roads · 23 wardsOPERATE · AP-NORTHEAST-1 · DASHED = WRITTEN, NOT YET APPLIEDEKS · KarpenterArgo CDKyvernoSLOs · burn raterollout gategame days
04

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).
05

Stack

Bestellungen
DjangoDjango REST FrameworkPostgreSQLTransactional Outbox
Flotte
GoKafkaValkey
Routing
OSRM
Konsole
ReactTypeScriptMapLibre
Plattform
TerraformEKSKarpenterArgo CD
Observability
OpenTelemetrySloth SLOsGrafana
06

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.

07

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.
→Zusammenarbeiten

Du willst Tasuki für dein Team betreiben oder etwas Ähnliches bauen lassen?