01 · コマース + ラストワンマイル物流 · メキシコ

店舗も、倉庫も、ドライバーも、経理も、ひとつのプラットフォームで。

Logistika Urbana は、複数のブランドをひとつのコマース・ラストワンマイル物流プラットフォームで運営しています。Yoon Lab の K-ビューティー(オンラインと実店舗)、Fleksi の配送、卸売、そしてドライバーネットワークです。私は 2024 年 3 月からこの会社のプリンシパル・フルスタックエンジニアで、主担当のエンジニアとして、アーキテクチャ、バックエンド、AWS、CI/CD、セキュリティ、そしてネイティブアプリの大部分を担当しています。
役割
プリンシパル・フルスタックエンジニア(契約)
期間
2024年3月 — 現在
契約形態
リモート契約
チーム
2024〜25 年は最大 4 人の開発者を統括。現在は 2 人のチーム
拠点
メキシコシティ · ラホールからリモート
コアバックエンドの全 2,372 コミット中
~2,300
のドメインモジュール · 約 535 の API ルート
26
の Terraform モジュール · AWS メキシコリージョン
11
つの ECS Fargate サービス、自動ロールバック
4
の Celery タスク · 22 の定期ジョブ
47
件のバックエンド自動テスト
436

推定ではなく実数 · クライアントのビジネス指標は含みません

01背景

JMA Logistika Urbana は、複数ブランドの販売と配送をひとつのシステムで行うメキシコの企業です。お客様は Yoon Lab や Fleksi のオンラインストア、または実店舗で購入し、卸売のバイヤーは B2B ポータルから注文します。ドライバーが配達し、店舗スタッフはカウンターで販売し、経営陣は管理ダッシュボードから事業を動かしています。

そのすべてが、私が設計したひとつのバックエンドで動いています。各ブランドは同じプラットフォーム上のポータルで、それぞれ独自のドメイン、決済マーチャント、メール設定を持ちながら、その下では同じ在庫テーブルと注文テーブルを共有しています。

02課題

2024 年 3 月に私が参加したとき、事業はテンプレートの ERP で動いていました。サーバー側で HTML をレンダリングする Django と MySQL です。バックオフィスの画面には十分でしたが、オンラインストア、ネイティブのドライバーアプリ、POS が共通で使える API はありませんでした。

販売チャネルを増やすたびに別のシステムが生まれ、システム間のすき間は誰かが手作業で突き合わせる仕事になっていました。その結果、誰も信用しない在庫数が残りました。

03アーキテクチャ
図 01本番トポロジー · aws メキシコ
CLIENTSStorefrontwebAdminreact · amplifyDriver appkotlin · swiftuiPOSoffline-firstKioskin-storeALB + WAFv2tls · managed rulesterraform · 11 modulesoidc deploys · auto-rollbackECS FARGATE · AUTOSCALE 2–6API (ASGI)django · channelsCelery worker47 tasksCelery beat22 schedulesOSRMself-hosted routingcircuit breaker · rolling deploysEXTERNALStripeCFDIEnviaTwilioTikTok ShopAmazonDATA · AWS MEXICORDS Postgresmulti-azRediscache · brokerOpenSearchcatalogS3signed urls
04構築したもの
  1. 012024年3月〜

    ひとつのデータモデルの上に、API ファーストで作り直す

    2024 年 3 月 8 日、会社の GitHub Organization が作られた翌日に、Django REST のバックエンドを書き始めました。在庫、注文、購買、財務、CRM、配車、POS、人事、サポート、分析は、ひとつの PostgreSQL スキーマの上にある独立したモジュールです。カウンターでの販売とウェブでの販売は同じ種類のイベントで、どちらも同じ在庫数を動かします。

    • 26 の Django アプリ、約 183 のモデル、約 535 の URL ルート、約 113k 行の Python
    • マルチテナントのポータル:ブランドごとに 1 つの Portal(ドメイン、マーチャント、メール設定)を持ち、リクエストごとに選択
    • ドライバーの位置追跡、チャット、リアルタイムのデータ同期に Channels WebSockets
    • Redis 上で動く 47 の Celery タスクと 22 の定期ジョブ
  2. 02

    AWS メキシコリージョンで、インフラをすべてコードに

    本番スタック全体が Terraform です。mx-central-1 に 11 のモジュールがあり、リモートステートは S3、ロックは DynamoDB に置いています。手作業で作った本番リソースはひとつもありません。

    • 2 つのアベイラビリティゾーンにまたがる VPC:プライベートサブネット、NAT、S3・ECR・CloudWatch Logs・Secrets Manager 向けの VPC エンドポイント
    • ACM 証明書付きの ALB、HTTP → HTTPS、WAFv2 のレート制限と AWS マネージドルールセット
    • RDS PostgreSQL 16 Multi-AZ:暗号化、30 日間のバックアップ、削除保護、Performance Insights
    • ElastiCache Redis 7.1 と、VPC 内からのみアクセスできる OpenSearch ドメイン。どちらも暗号化
    • Secrets Manager の値をタスク定義に注入、実行ロールとタスクロールの IAM を分離、GuardDuty
  3. 032026年3月

    EC2 上の docker-compose から ECS Fargate へ

    2026 年 3 月まで、本番は EC2 上の docker-compose で動いており、セルフホストランナーでデプロイし、Prometheus、Grafana、Loki で監視していました。2026 年 3 月 11 日に、これを ECS Fargate へ移行しました。4 つのサービスそれぞれに、CPU をターゲットにしたオートスケーリングと、自動でロールバックするデプロイサーキットブレーカーを設定しています。

    • Django API(ASGI、1 vCPU / 2 GB)。CPU 70% を目標に 2〜6 タスクでオートスケール
    • Celery worker(1〜3 タスク)と Celery beat
    • 距離に基づいてドライバーを割り当てるための、セルフホストの OSRM ルーティングサーバー(メキシコシティの地図データ)
    • CloudWatch Container Insights と、SNS に通知する 7 つのアラーム:ECS の CPU とメモリ、ALB 5xx、2 秒を超えるレイテンシ、RDS の CPU・ストレージ・接続数
  4. 04

    静的キーを使わないデプロイパイプライン

    本番ブランチへの push で GitHub Actions のパイプラインが動き、OIDC で AWS にサインインします。漏洩しうる長期のアクセスキーは存在しません。各ステップは、失敗したリリースがお客様の目に触れる前に止まるように並べています。

    • ビルドは一度だけ。コミット SHA をタグにして ECR に push
    • データベースのマイグレーションを単発の Fargate タスクとして実行し、失敗したら CloudWatch のログを出力
    • 在庫を再計算し、OpenSearch のインデックスをその場で再投入。カタログが空になる瞬間はありません
    • API、worker、beat の各サービスを入れ替え、安定するまで待機
    • 最後に読み取り専用のデータチェックと、TLS を検証するヘルスチェック
    • サードパーティの Action はすべてコミット SHA で固定。push のたびに Dependabot と gitleaks
  5. 052026

    チェックリストではなく、セキュリティプログラムとして

    2026 年、私はセキュリティ強化プログラムを主導し、会社の情報セキュリティポリシーを書きました。このポリシーでは、インフラの統制、アクセス権の付与と取り消し、インシデントのトリアージの責任者として私が指名されています。

    • gitleaks を pre-commit フックと CI ゲートの両方に導入
    • アプリケーションのシークレットをすべて AWS Secrets Manager に移行
    • 配送ラベル、ドライバーの書類、配達証明、人事ファイル、請求書を、署名付き URL でしか開けない非公開の S3 バケットに移行
    • メキシコの個人情報保護法(LFPDPPP)に対応したアカウントの匿名化。税法で保存が義務付けられた記録(CFDI)は残し、毎日 03:30 に実行
  6. 06

    メキシコの小売業に必要な外部連携

    実際のビジネスロジックの多くは、決済、税務インボイス、配送、マーケットプレイスといった外部との境界にあります。

    • 署名付き Webhook、ウォレット、返金、照合ジョブを備えた Stripe。Apple Pay と Google Pay にも対応
    • FacturAPI 経由の SAT CFDI 電子インボイス
    • Webhook の再送に対応した Envia の配送ラベル
    • Twilio によるドライバーとお客様の間のマスク通話、SMS、OTP。Firebase のプッシュ通知
    • TikTok Shop、Amazon SP-API、Meta Catalog、Google Merchant Center 向けのマーケットプレイス同期フレームワーク:暗号化した認証情報、Webhook、15 分ごとの在庫同期、注文のポーリング、トークンの更新、201 のテスト
05画面
Logistika Urbana · 管理画面数値は非表示
Logistika Urbana の管理ダッシュボード。期間を指定するコントロール、サマリーカード、日別の売上グラフ、商品別の内訳を含む売上の概要。左側のナビゲーションには注文、POS、在庫、CRM、財務、購買、ユーザー、人事、外部連携、サポート、配車、分析が並んでいます
図 02運用ダッシュボード。左側に業務モジュールが並びます。クライアントの売上数値は伏せています。
06技術スタック
サービス
Python 3.12DjangoDjango REST FrameworkChannelsCelery + beatPostgreSQL 16RedisOpenSearchWeasyPrinti18n
プラットフォーム
TerraformECS FargateRDS Multi-AZElastiCacheALB · WAFv2Secrets ManagerGuardDutyCloudWatchGitHub Actions (OIDC)gitleaks
フロントエンド・アプリ
ReactTypeScriptViteMUIAWS AmplifyKotlinSwiftUI
外部連携
StripeFacturAPI (CFDI)EnviaTwilioFirebaseOSRMTikTok ShopAmazon SP-APIMeta CatalogGoogle Merchant Center
07私の担当
  • アーキテクチャと技術的な方向性。創業者と一緒に決めています
  • コアバックエンドの全 2,372 コミット中 約 2,300、マージされた 653 件のプルリクエスト中 649 件。リリースの可否は私が判断しています
  • インフラ、CI/CD、本番ビルド、監視に関わるすべてのコミット(109 件中 109 件)
  • 会社の GitHub Organization の管理者(作成された日から。非公開リポジトリ 19 個)
  • React の管理ダッシュボードで 2 番目に多いコントリビューター(990 コミット中 405)
  • 2024〜25 年は、モバイルアプリ、POS、管理画面にわたって最大 4 人の開発者を率いました。現在のチームは 2 人で、私がリードし、もう 1 人の開発者と一緒に開発しています。この規模の開発を、テスト、CI ゲート、レビューに支えられた AI コーディングエージェント(Claude Code)を使って回しています。
08レビューする方へ
  • これは非公開のクライアントシステムです。コードは公開されておらず、リンクもしていません。このページの数値はすべて、リポジトリ、Terraform、git 履歴から数えたものです。ビジネス指標はひとつも含まれていません。それはクライアントのものです。
  • 本番は Kubernetes ではなく ECS Fargate で動いています。私の Kubernetes の実績(EKS、Helm、Argo CD)は、この実績ページの下にある Tasuki などのオープンソースのプロジェクトで見られます。
  • 会社の創業者からのリファレンスは、ご依頼に応じてご紹介できます。
→採用担当の方へ

プラットフォーム、DevOps、AI プラットフォームのポジションなら、ぜひお話ししましょう。

AWS 上で本番システムを構築・運用し、その中でモデルをデプロイ・運用しています。シニアのプラットフォーム、DevOps、または AI プラットフォームのポジションを探しています。職務経歴書とリファレンスはご依頼に応じてお送りします。

役割
シニア・プラットフォームエンジニア · バックエンド、DevOps、AWS インフラ
拠点
パキスタン・ラホール
言語
英語(ビジネスレベル)· ウルドゥー語(ネイティブ)· 日本語(初級、毎日学習中)
メール
contact@codewithmuh.com