Tasuki · ラストワンマイル配送プラットフォーム

ビジネスの配送部分を、 自分のクラウドで。

ビジネスの配送部分を、自社システムの隣で動かすソフトウェアにしたものです。あなたのシステムが API で配送を作成すると、Tasuki が料金と到着予定時刻を見積もり、実際の都市の道路網で最寄りの配達員を割り当て、配達員の位置を顧客のスマートフォンにライブで届けます。冪等な注文、Kafka による位置情報パイプライン、文書化した SLO、負荷テスト、ゲームデーと、本番水準で作っています。
ステータス
フェーズ 1/7 · ローカルで検証済み
ライセンス
MIT
GitHub
★ 1 · ⑂ 0
件/時の注文をフル設計規模で処理(ノート PC 1 台)
18,144
GPS ポイント/秒、注文の失敗は 0 件
641
件のゲームデー計画。初回は実施済みでポストモーテムあり
12
01

作った理由

Tasuki は、ビジネスの配送部分を自社システムの隣にデプロイするソフトウェアです。あなたのシステムが API で配送を作成すると、Tasuki が料金と到着時刻を見積もり、最寄りの配達員を見つけ、配達員の位置を顧客のスマートフォンに配信し、ステータスが変わるたびにそれを報告します。

名前は、駅伝でランナーが受け渡すたすきに由来します。設計は 1 つの都市で月 150 万件の注文を想定しており、リポジトリはこの種のプラットフォームの難しい問題それぞれを薄く貫く実装を、判断の理由とともに積み上げています。

リファレンス環境は東京 23 区で、実際の東京の道路を使います。会社は架空で、加盟店、配達員、顧客はシミュレーションです。

02

できること

  • 注文を失わず、二重請求もしない

    すべての注文に冪等キーがあり、トランザクショナル・アウトボックスが API から Kafka へ注文を運ぶので、リトライやクラッシュがあっても注文が二重に作られることはありません。

  • ライブの配達員データ

    Go のサービスが配達員の GPS 更新を Kafka に取り込み、そのログからキャッシュを再構築します。設計目標は毎秒約 750 件の更新です。

  • 実際の道路での配車

    東京の自転車用道路グラフで OSRM が計算した道路距離を使って配達員をマッチングします。OSRM がなければ直線距離にフォールバックし、配車はそのまま動きます。

  • ライブマップと追跡ページ

    React のコンソールが配達員を地図上に表示し、すべての注文に顧客が開ける追跡リンクがあります。

  • シミュレーションの都市

    シミュレーターが公開 API を通して加盟店、顧客、配達員を演じます。雨の金曜日のようなシナリオもあり、負荷をかけてプラットフォームをテストできます。

  • 本番サービスと同じ運用

    バーンレートアラートつきの文書化した SLO、コードで管理するダッシュボード、アラートごとのランブック、脅威モデル、アーキテクチャ決定記録、ゲームデー計画。

03

仕組み

  1. 01

    あなたのシステムが配送を作成する

    冪等キーをつけて注文を API に送ります。API は料金、到着時刻、追跡リンクを返します。

  2. 02

    注文がパブリッシュされる

    注文とアウトボックスの行は 1 つの PostgreSQL トランザクションで保存されます。リレーがイベントを Kafka にパブリッシュします。

  3. 03

    配達員が割り当てられる

    配車サービスが、空いている最寄りの配達員を選びます。

  4. 04

    顧客が配達を追える

    配達員の位置は取り込みサービスから追跡サービスへ流れ、追跡ページに届けられます。

fig. 01注文 · 位置情報 · 運用
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

自分で動かす

コマンド 1 つで PostgreSQL、Kafka、Valkey とすべてのサービスをビルドして起動します。Compose v2 つきの Docker と GNU Make 4 が必要です(macOS では brew install make のあと gmake と入力します)。

$ git clone https://github.com/codewithmuh/tasuki-delivery-platform.git$ cd tasuki-delivery-platform$ cp .env.example .env$ make up$ make sim-up
  • ライブマップ: http://localhost:8088
  • 注文 API: http://localhost:8000
  • make sim-up でシミュレーターが起動します。加盟店と配達員を登録したあと、注文が流れ始めます。
  • make routing-up で実際の東京の道路を使う OSRM を追加します(初回のビルドには 10〜20 分かかります)。
05

技術スタック

注文
DjangoDjango REST FrameworkPostgreSQLトランザクショナル・アウトボックス
配達員
GoKafkaValkey
ルーティング
OSRM
コンソール
ReactTypeScriptMapLibre
プラットフォーム
TerraformEKSKarpenterArgo CD
オブザーバビリティ
OpenTelemetrySloth SLOsGrafana
06

現在の状況

実装済み

  • 注文:見積もり、冪等な注文、アウトボックスのリレー(PostgreSQL の競合状態に対してテスト済み)
  • 配達員データの取り込み、配達員の状態管理、追跡
  • 東京の道路でのルーティング、シミュレーター、ライブコンソール
  • SLO、アラート、ロールアウトゲート、ダッシュボード

未実装

  • 任意の都市への対応:GeoJSON ファイルからのゾーン、通貨と税の設定
  • 署名つき Webhook とログインつきのダッシュボード
  • 配達員アプリ
  • シングルサーバーでのインストールと Helm チャート
  • 実際の AWS クラスターでの初稼働(あえて最後のフェーズにしています)

会社は架空で、トラフィックはシミュレーションです。EKS と GitOps のレイヤーは記述・検証済みですが、まだクラスター上では動かしていません。

07

よくある質問

Tasuki は実在する配送会社ですか?
いいえ。Tasuki は、本物のプラットフォームを作るための架空の会社です。トラフィックはシミュレーターが生成しています。
ノート PC で動かせますか?
はい。コマンド 1 つで、PostgreSQL、Kafka、Valkey とすべてのサービスが Docker Compose で起動します。
東京でしか使えませんか?
リファレンス環境は東京 23 区です。ゾーン、通貨、税を任意の都市向けに設定できるようにするのが次のフェーズです。
AWS で動いていますか?
まだです。Terraform と GitOps のレイヤーは記述・検証済みで、クラスター上で動かすのはロードマップの最後のフェーズです。
ライセンスは何ですか?
MIT です。
→お仕事のご依頼

Tasuki をチームで動かしたい、あるいは似たものを作りたいとお考えですか?