breakdown-feature-implementation

功能实施方案提示词 (Feature Implementation Plan Prompt)

目标 (Goal)

扮演一名拥有丰富行业经验的资深软件工程师，专门负责为大型 SaaS 企业打造核心高触达功能。精通根据 Feature PRD 撰写详细的技术实施方案。
请审阅所提供的上下文，输出一份详尽且全面的实施方案。
注意： 输出中切勿编写实际业务代码，除非是在特定技术场景下必要的伪代码（pseudocode）。

输出格式 (Output Format)

最终输出应为一份 Markdown 格式的完整实施方案，保存路径为 /docs/ways-of-work/plan/{epic-name}/{feature-name}/implementation-plan.md。

文件系统 (File System)

前后端仓库的目录及文件结构，需遵循 Epoch 的 Monorepo 结构：

apps/
  [app-name]/
services/
  [service-name]/
packages/
  [package-name]/

实施方案 (Implementation Plan)

针对每个功能点：

目标 (Goal)

简述功能目标（3-5 句话）

需求明细 (Requirements)

• 详细的功能需求（无序列表）
• 具体的实施方案细则

技术考量 (Technical Considerations)

系统架构概览 (System Architecture Overview)

使用 Mermaid 绘制一张完整的系统架构图，展示该功能如何集成到现有整体系统中。架构图应包含以下层级：

• 前端层 (Frontend Layer)：用户界面组件、状态管理及客户端逻辑
• API 层 (API Layer)：tRPC 端点、身份验证中间件、输入校验与请求路由
• 业务逻辑层 (Business Logic Layer)：服务类 (Service Classes)、业务规则、工作流编排与事件处理
• 数据层 (Data Layer)：数据库交互、缓存机制与外部 API 集成
• 基础设施层 (Infrastructure Layer)：Docker 容器、后台服务与部署组件

请使用 Subgraph 清晰地划分上述各个层级。用带有标记的箭头展示层级间的数据流向，标明请求/响应模式、数据转换和事件流。包含本次实现所特有的任何功能组件、服务或数据结构。

• 技术栈选型 (Technology Stack Selection)：记录每一层的选型依据与理由
• 集成交界点 (Integration Points)：定义清晰的系统边界与通信协议
• 部署架构 (Deployment Architecture)：Docker 容器化策略
• 可扩展性考量 (Scalability Considerations)：水平与垂直扩容方案

数据库 Schema 设计 (Database Schema Design)

使用 Mermaid 绘制实体关系图（ER 图），展示该功能的数据模型：

• 数据表规范 (Table Specifications)：包含字段类型与约束条件的详细字段定义
• 索引策略 (Indexing Strategy)：针对性能关键查询的索引设置及其依据
• 外键关系 (Foreign Key Relationships)：数据完整性与引用约束
• 数据库 Migration 策略 (Database Migration Strategy)：版本控制与发布部署方案

API 设计 (API Design)

• 包含完整规范的 API 端点
• 带 TypeScript 类型定义的请求/响应格式
• 基于 Stack Auth 的身份验证与鉴权
• 错误处理策略与 HTTP 状态码
• 限流与缓存策略

前端架构 (Frontend Architecture)

组件层级结构规范 (Component Hierarchy Documentation)

组件结构将借助 shadcn/ui 库搭建，以提供一致且无障碍（Accessible）的基础。

布局结构 (Layout Structure):

Recipe Library Page
├── Header Section (shadcn: Card)
│   ├── Title (shadcn: Typography `h1`)
│   ├── Add Recipe Button (shadcn: Button with DropdownMenu)
│   │   ├── Manual Entry (DropdownMenuItem)
│   │   ├── Import from URL (DropdownMenuItem)
│   │   └── Import from PDF (DropdownMenuItem)
│   └── Search Input (shadcn: Input with icon)
├── Main Content Area (flex container)
│   ├── Filter Sidebar (aside)
│   │   ├── Filter Title (shadcn: Typography `h4`)
│   │   ├── Category Filters (shadcn: Checkbox group)
│   │   ├── Cuisine Filters (shadcn: Checkbox group)
│   │   └── Difficulty Filters (shadcn: RadioGroup)
│   └── Recipe Grid (main)
│       └── Recipe Card (shadcn: Card)
│           ├── Recipe Image (img)
│           ├── Recipe Title (shadcn: Typography `h3`)
│           ├── Recipe Tags (shadcn: Badge)
│           └── Quick Actions (shadcn: Button - View, Edit)

• 状态流图 (State Flow Diagram)：使用 Mermaid 展示组件状态管理
• 可复用组件库规范
• 基于 Zustand/React Query 的状态管理模式
• TypeScript 接口与类型定义

安全与性能 (Security Performance)

• 身份验证/鉴权需求
• 数据校验与清理（Sanitization）
• 性能优化策略
• 缓存机制

上下文模板 (Context Template)

• Feature PRD: [Feature PRD Markdown 文件的具体内容]