マイクロサービス設計¶

Recerdoのバックエンドは、責務ごとに分離されたマイクロサービスで構成されています。各サービスは独立してデプロイ可能で、キュー抽象化レイヤー（キュー抽象化設計）を介した非同期メッセージングで連携します。実装は Beta では Redis + BullMQ / asynq、本番では OCI Queue Service に差し替わります（コード変更なし、Feature Flag + 環境変数で切替）。

サービス一覧¶

横断基盤ドキュメント¶

サービス間通信¶

API Gateway
    ├── auth-svc          ← 認証・トークン検証
    ├── album-svc         ← アルバム操作
    ├── events-svc        ← イベント管理
    ├── timeline-svc      ← フィード取得
    ├── storage-svc       ← メディアアップロード
    └── admin-console-svc ← 管理者コンソール・モデレーション

各サービス → audit-svc            (Queue Port 経由で監査ログ送信)
auth-svc   → events-svc           (Queue Port: トークン無効化通知)
admin-*    → feature-flag-svc     (Flag 変更・Kill Switch)
全 Write 系 → feature-flag-svc     (評価問い合わせ、毎リクエスト)

テクノロジースタック（環境別）¶

すべての差分は Feature Flag + 環境変数 で切替可能（環境抽象化 参照）。AWS サービスは Cognito のみ 利用し、SQS / SES / S3 / DynamoDB / RDS / MinIO / EC2 / EKS / ElastiCache / Lambda / CloudFront は採用しない（基本的方針（ポリシー） 参照）。

追加設計プラン反映（大規模類似サービスモデル準拠）¶

基本的方針（Policy）§8 の Iteration-02（コミット 464267 コメント起点）をマイクロサービス設計に反映する。

課題・レビュー観点（横断）¶

• サービスごとの失敗時動作（再試行/打ち切り/通知抑制）を同じ粒度で記述する。
• 実装サンプルがセキュリティ要件（TLS 必須など）を満たすことをレビュー観点に固定する。
• ポート/アダプタ切替時に API 契約やイベント契約を変えないことを運用チェックに含める。
• Timeline の縮退パス（フォロワー規模/Feature Flag 切替）と SLO の紐付けを必ず記載する。
• Outbox → QueuePort → DLQ の再試行回数・可視性タイムアウト・監査閾値（DLQ 10 件/時）を共通パラメータで扱う。

横断標準（Cross-cutting Standards）¶

基本的方針（Policy）§8 の「追加設計プラン」を各マイクロサービスに適用するための対応表です。

横断レビュー観点（Peer Review Checklist）¶

新規 PR / 設計変更のレビュー時に、以下を**必ず確認**する。

1. 禁止キーワードは policy.md §1.3 AWS 利用ポリシー の禁止一覧を正として確認し、その語が**採用文脈**で登場していないか。
2. Write API に Idempotency-Key の受理が記述されているか（または既存の共通ミドルウェアを継承しているか）。
3. ドメインイベント発行が Outbox 経由 になっているか（QueuePort 直叩きが残っていないか）。
4. 外部呼び出しに Circuit Breaker / Retry 方針が明記されているか。
5. 主要エンドポイントに SLO（p95/p99）が設定されているか。
6. SMTP 送信がある場合、STARTTLS / TLS 1.2+ / AUTH 拡張確認が実装されているか。
7. ログに PII（本文・email・電話番号）が含まれていないか。ID 以外の個人情報は書き出さない。

最終更新: 2026-04-19 ポリシー適用（追加設計プラン反映・Iteration-02 再整理）