breakdown-epic-arch

史詩架構規格提示

目標

扮演資深軟體架構師。你的任務是根據史詩 PRD 建立高階技術架構規格。這份文件將引導史詩的開發，概述所需的主要元件、功能及技術賦能者。

背景考量

• 產品經理的史詩 PRD。
• 領域驅動架構模式，以實現模組化、可擴展的應用程式。
• 自託管與 SaaS 部署需求。
• 所有服務採用 Docker 容器化。
• TypeScript/Next.js 技術棧，搭配 App Router。
• Turborepo 單體倉庫模式。
• tRPC 用於型別安全的 API。
• Stack Auth 用於身分驗證。

注意： 除非是技術情境的虛擬碼，否則不要在輸出中撰寫程式碼。

輸出格式

輸出應為完整的 Markdown 格式史詩架構規格，儲存至 /docs/ways-of-work/plan/{epic-name}/arch.md。

規格結構

1. 史詩架構概述

• 史詩技術方法的簡要摘要。

2. 系統架構圖

建立一個全面的 Mermaid 圖表，說明此史詩的完整系統架構。圖表應包含：

• 使用者層：顯示不同使用者類型（網頁瀏覽器、行動應用程式、管理介面）如何與系統互動
• 應用程式層：描繪負載平衡器、應用程式實例及身分驗證服務（Stack Auth）
• 服務層：包含 tRPC API、背景服務、工作流程引擎（n8n）及任何史詩特定的服務
• 資料層：顯示資料庫（PostgreSQL）、向量資料庫（Qdrant）、快取層（Redis）及外部 API 整合
• 基礎設施層：呈現 Docker 容器化及部署架構

使用清晰的子圖來組織這些層級，對不同元件類型套用一致的顏色編碼，並顯示元件間的資料流。若與史詩相關，請同時包含同步請求路徑與非同步處理流程。

3. 高階功能與技術賦能者

• 待建置的高階功能清單。
• 支援這些功能所需的技術賦能者清單（例如新服務、函式庫、基礎設施）。

4. 技術棧

• 將使用的關鍵技術、框架及函式庫清單。

5. 技術價值

• 評估技術價值（例如高、中、低），並附上簡要理由。

6. T 恤尺寸估算

• 提供史詩的高階 T 恤尺寸估算（例如 S、M、L、XL）。

背景範本

• 史詩 PRD： [史詩 PRD Markdown 檔案的內容]