Recerdo Developer Docs¶

Recerdo は旧友・仲良かったグループとの思い出を共有するソーシャルメディアアプリ（Viejo）です。
このサイトでは、APIリファレンス・マイクロサービス設計・クリーンアーキテクチャ設計を一元管理します。

API ドキュメント

各サービスが公開するREST APIのエンドポイント・リクエスト/レスポンス仕様一覧。

APIドキュメントを見る
マイクロサービス設計

ドメインモデル・ユースケース・インフラ設計などのDD（Design Document）。

マイクロサービス設計を見る
クリーンアーキテクチャ設計

レイヤーアーキテクチャ・依存性設計・テスト戦略の詳細設計書。

CA設計を見る
機能仕様

機能レベルの詳細設計書。ユースケース・シーケンス図・API設計を含む。

機能仕様を見る
ローカル開発 (Tilt)

tilt up で Recerdo 全体を起動。兄弟 repo clone 手順・Docker 要件・Live Update 対応状況。

Tilt でシステム起動

インフラ・運用ポリシー（2026-04-19 適用）¶

AWS は Cognito のみ利用（認証のみ）。他のAWSサービスはOSS/OCIに置き換え。
Beta: XServer VPS（6 core / 10 GB RAM） + CoreServerV2 CORE+X（6 GB） / Garage（S3互換OSS） / MySQL（MariaDB互換） / Redis + BullMQ・asynq / Postfix + Dovecot + Rspamd。
本番は OCI ファースト: OCI Object Storage / OCI MySQL HeatWave / OCI Queue Service / OCI Cache with Redis。メール基盤のみ CoreServerV2 CORE+X 継続。
Feature Flag: Flipt。ログ: Loki。プッシュ通知: FCM。
メディア: 動画は HLS（360/720/1080p・6秒セグメント）、HEIC は JPEG/WebP に自動変換、Live Photo は画像+動画ペア保存（Apple asset_identifier で関連付け）。
ハイライトビデオはユーザー指定のみ（自動生成なし）。
設計思想: Hexagonal / Feature Flag / 12-factor。

アーキテクチャ概要¶

graph TB
    Client["🖥️ iOS / Web Client"]
    GW["API Gateway<br/><small>ルーティング・認可・レート制限</small>"]
    Cognito["AWS Cognito<br/><small>認証のみ</small>"]
    Permission["permission-svc<br/><small>認可</small>"]
    Album["album-svc"]
    Events["events-svc"]
    Storage["storage-svc"]
    Timeline["timeline-svc"]
    Audit["audit-svc<br/><small>横断的監査ログ</small>"]
    Queue["Queue<br/><small>Beta: Redis+BullMQ / 本番: OCI Queue</small>"]
    Object["Object Storage<br/><small>Beta: Garage / 本番: OCI Object Storage</small>"]

    Client -->|"JWT (RS256)"| GW
    GW -->|"JWKS 検証"| Cognito
    GW --> Permission
    GW --> Album
    GW --> Events
    GW --> Storage
    GW --> Timeline

    Storage --> Object
    Album -->|"イベント発行"| Queue
    Events -->|"イベント発行"| Queue
    Storage -->|"イベント発行"| Queue
    Timeline -->|"イベント購読"| Queue
    Queue --> Audit

    classDef client fill:#1565c0,stroke:#1565c0,color:#fff,rx:8
    classDef gateway fill:#6a1b9a,stroke:#6a1b9a,color:#fff
    classDef service fill:#1976d2,stroke:#1976d2,color:#fff
    classDef infra fill:#37474f,stroke:#37474f,color:#fff
    classDef aws fill:#ff9900,stroke:#ff9900,color:#000

    class Client client
    class GW gateway
    class Permission,Album,Events,Storage,Timeline service
    class Audit,Queue,Object infra
    class Cognito aws

サービス一覧¶

サービス	リポジトリ	役割
API Gateway	recerdo-api-gateway	ルーティング・Cognito JWKS 検証
Auth Service (Deprecated)	recerdo-auth	AWS Cognito へ移行中
Permission Service	recerdo-permission	認可・ロール・組織権限
Events Service	recerdo-events	イベント・招待
Album Service	recerdo-album	アルバム・写真
Storage Service	recerdo-storage	メディアファイル
Timeline Service	recerdo-timeline	フィード・タイムライン
Audit Service	recerdo-audit	監査ログ（横断的）

ステータス: Draft — 2026年4月現在、設計フェーズ

最終更新: 2026-04-19 ポリシー適用