bootjp

## プロジェクト概要・担当 株式会社hacomonoにて、マルチプロダクト展開と部分的なマイクロサービス化を支える、社内共通のスキーマ駆動イベントバスを設計・実装しました。プリンシパルエンジニア（分散システム）として、課題整理、アーキテクチャ設計・実装から、プロダクトチームへの導入支援、運用体制の整備までを主導しました。 ## 背景・解決すべき課題 既存のhacomonoと新規プロダクト間でデータを連携するにあたり、サービス同士が個別にAPIを呼び合う構成では、依存関係や変更の影響範囲が複雑になり、開発者の認知負荷や障害の波及リスクが増大することが課題でした。また、入退館・予約・決済など高い可用性を要求される機能を含むため、開発速度だけでなく、サービス間の障害分離も考慮する必要がありました。 そこで、既存基盤を活かした段階的なサービス分割を前提に、各サービスが連携先の実装ではなく、共通のイベント契約に依存する構成を採用しました。 ## 技術的な取り組み・設計判断 ### 1. イベントの受け付けと配信を分離したアーキテクチャ Publish/SubscribeとFire-and-Forgetを基本方針とし、送信元が個々の購読先や、その処理完了を意識しないイベント連携を設計しました。Amazon API GatewayとAWS Lambdaによる受信処理でイベントを検証し、Amazon SQSへの保存成功を確認してから送信元へ応答します。その後の配信は別のLambdaで非同期に実行し、他AWSアカウントのSQSや各サービスのWebhookへの配信に対応しました。 単に通信を非同期化するだけでなく、イベントを受け付けたかどうかは送信元が判断できるよう、同期処理と非同期処理の責任境界を明確にしました。 ### 2. スキーマとバリデーションを中心にした開発フロー Protocol Buffersでイベントスキーマを管理し、Bufの互換性チェックをCIに組み込むことで、破壊的なスキーマ変更を自動検出する仕組みを整備しました。イベントのシリアライズ形式にはJSONを採用しています。 また、protovalidateを用いて、形式・文字数・値の制約などのバリデーションをスキーマとともに管理し、サービスごとに検証ロジックが分散・乖離することを抑制しました。送受信には社内SDKを用意し、利用側がイベント連携の内部実装を都度作り込まずに済む開発フローを整備しました。 ### 3. 誤送信・不正イベント・重複発行への対策 サービスと環境ごとに異なる非対称鍵を用いたJWT署名・検証を導入し、送信元のなりすましや開発環境から本番環境への誤送信を拒否する構成としました。署名とスキーマの検証を通過したイベントのみを配信対象にしています。 加えて、Amazon DynamoDBに送信元とイベントIDの組み合わせを保持し、同一イベントの再投入を拒否することで、重複発行に起因する障害の抑制を図りました。この重複抑制をExactly-once保証とは区別し、Exactly-onceは保証対象としない設計を選択しました。保証を強めることで増える実装・運用の複雑さと、求められる信頼性のバランスを重視しています。 ## 導入・運用への取り組み 新規プロダクトFitFitsとhacomonoをつなぐ基盤として、施設情報、予約枠情報、店舗スタッフ情報、プログラム情報などの非同期データ連携から段階的に導入しました。既存の予約処理やジョブ基盤を一括で置き換えるのではなく、非同期化に適した処理から適用範囲を広げる方針を採りました。 導入にあたっては、新規プロダクト開発チームとイベント契約・導入手順・運用ルールを調整し、オンボーディングや問い合わせ対応を推進しました。あわせて、SLI/SLOの定義・計測と、Datadogのダッシュボード・アラートによる監視を整備し、実装だけでなく継続して運用できる状態まで取り組みました。 ## 成果・発揮した価値 hacomonoと新規プロダクトを疎結合に接続する共通基盤を構築し、実際のプロダクト間データ連携に導入しました。各サービスが個別に実装・管理する必要のある連携処理を、スキーマ、検証機構、SDKを通じて共通化し、開発者が共通の契約に基づいて機能を追加できる基盤を整備しました。 分散システムにおける信頼性と運用コストのトレードオフを具体的な設計に落とし込み、技術実装とチーム横断の導入・運用をつなぐ役割を担いました。設計思想と段階的な導入プロセスは、Platform Engineering Kaigi 2025で「疎結合でスキーマ駆動開発を実現するイベントバスの設計」として発表しました。 https://speakerdeck.com/hacomono/building-an-event-bus-for-schema-driven-development-in-a-loosely-coupled-architecture https://www.cnia.io/pek2025/sessions/e11d6f4d-eccf-47c5-95e9-f2664f5ab0c4/ https://techblog.hacomono.jp/entry/2026/04/07/110000