Solution Design Playbook（方案设计阶段手册）

知识库位置：FDE Knowledge Base/05 Delivery/Delivery Phases/Solution-Design-Playbook.md

阶段目标：把业务需求转化为可实施的系统设计。

1. Objective（阶段目标）

确定系统如何工作，以及如何在客户现有环境中运行。

2. Entry Criteria（进入条件）

项目范围已经确认。
业务需求已经明确。
主要技术约束已经识别。
核心数据源和系统已经识别。

3. Key Activities（关键活动）

活动	具体内容
Workflow Design（流程设计）	设计目标业务流程
Architecture Design（架构设计）	设计系统架构
Data Design（数据设计）	设计数据流和数据模型
AI Design（AI 设计）	设计 RAG、Agent、模型调用等
Integration Design（集成设计）	设计 API、OAuth、Webhook 等
Security Design（安全设计）	设计身份、权限和数据保护
Deployment Design（部署设计）	设计云、On-premise（私有化部署）和环境
Evaluation Design（评估设计）	设计测试集和评估方式

4. Design Questions（设计问题）

业务：

系统将改变哪些业务步骤？
哪些步骤仍然需要人工参与？
谁对最终结果负责？

架构：

是 Workflow（工作流）还是 Agent（智能体）？
是 RAG（检索增强生成）还是直接查询业务 API？
是否需要异步处理？
如何与现有系统集成？

工程：

数据如何进入系统？
如何处理错误？
如何监控？
如何进行测试和版本管理？

安全：

用户如何认证？
权限如何继承？
数据如何隔离？
哪些操作需要人工审批？

5. Deliverables（交付物）

Solution Architecture Diagram（方案架构图）。
Data Flow Diagram（数据流图）。
Sequence Diagram（时序图）。
Integration Specification（集成规格说明）。
API Contract（API 契约）。
Security Design（安全设计）。
Deployment Design（部署设计）。
Evaluation Plan（评估计划）。
Architecture Decision Records（ADR，架构决策记录）。

6. Architecture Review（架构评审）

设计完成后必须组织评审。

建议至少邀请：

FDE。
Solution Architect（解决方案架构师）。
Engineering Lead（工程负责人）。
Customer IT（客户 IT）。
Security / Compliance（安全/合规）。
Business Owner（涉及流程变化时）。

评审重点不是技术是否先进，而是：

能否满足业务要求？
是否适合客户环境？
是否满足安全要求？
是否可以维护？
是否具备扩展能力？
是否有明确的失败处理方案？

详见 Architecture Review Playbook（架构评审手册）。

7. Exit Criteria（退出条件）

关键架构已经确认。
关键技术选型已经记录。
主要接口已经明确。
数据和安全方案已审核。
核心技术风险有验证计划。
Prototype（原型）的实施任务已经明确。

Common Failure Modes（常见失败模式）

一开始就设计复杂的微服务、Agent Mesh（智能体网格）和多模型架构，却没有证明业务确实需要这些能力。

FDE 应遵循：

Start Simple, Validate Early, Evolve When Necessary. （从简开始、尽早验证、必要时演进。）