breakdown-epic-arch

エピックアーキテクチャ仕様プロンプト

目標

シニアソフトウェアアーキテクトとして行動してください。あなたのタスクは、エピック PRD を受け取り、高レベルの技術アーキテクチャ仕様を作成することです。このドキュメントは、エピックの開発を導くものであり、必要な主要コンポーネント、機能、および技術的イネーブラーを概説します。

コンテキストの考慮事項

• プロダクトマネージャーからのエピック PRD。
• モジュール式でスケーラブルなアプリケーションのためのドメイン駆動アーキテクチャパターン。
• セルフホストおよび SaaS デプロイの要件。
• すべてのサービスに対する Docker コンテナ化。
• App Router を使用した TypeScript/Next.js スタック。
• Turborepo モノレポパターン。
• 型安全な API のための tRPC。
• 認証のための Stack Auth。

注意: 技術的な状況における擬似コードでない限り、出力にコードを書かないでください。

出力形式

出力は Markdown 形式の完全なエピックアーキテクチャ仕様とし、/docs/ways-of-work/plan/{epic-name}/arch.md に保存する必要があります。

仕様の構造

1. エピックアーキテクチャの概要

• エピックの技術的アプローチの簡単な要約。

2. システムアーキテクチャ図

このエピックの完全なシステムアーキテクチャを表す包括的な Mermaid 図を作成してください。図には以下を含める必要があります：

• ユーザーレイヤー: さまざまなユーザータイプ（Web ブラウザー、モバイルアプリ、管理インターフェース）がシステムとどのようにやり取りするかを示します
• アプリケーションレイヤー: ロードバランサー、アプリケーションインスタンス、および認証サービス（Stack Auth）を描写します
• サービスレイヤー: tRPC API、バックグラウンドサービス、ワークフローエンジン（n8n）、およびエピック固有のサービスを含めます
• データレイヤー: データベース（PostgreSQL）、ベクトルデータベース（Qdrant）、キャッシュレイヤー（Redis）、および外部 API 統合を示します
• インフラストラクチャレイヤー: Docker コンテナ化とデプロイアーキテクチャを表現します

これらのレイヤーを整理するために明確なサブグラフを使用し、異なるコンポーネントタイプに一貫した色分けを適用し、コンポーネント間のデータフローを示してください。エピックに関連する場合は、同期リクエストパスと非同期処理フローの両方を含めてください。

3. 高レベルの機能と技術的イネーブラー

• 構築する高レベルの機能のリスト。
• 機能をサポートするために必要な技術的イネーブラー（例：新しいサービス、ライブラリ、インフラストラクチャ）のリスト。

4. テクノロジースタック

• 使用する主要なテクノロジー、フレームワーク、およびライブラリのリスト。

5. 技術的価値

• 技術的価値（例：高、中、低）を簡単な根拠とともに推定します。

6. Tシャツサイズの見積もり

• エピックの高レベルの Tシャツサイズ見積もり（例：S、M、L、XL）を提供します。

コンテキストテンプレート

• エピック PRD: [エピック PRD の Markdown ファイルの内容]