diff --git a/docs/project/DESIGN_REVIEW_PROCESS.md b/docs/project/DESIGN_REVIEW_PROCESS.md new file mode 100644 index 0000000..1174ced --- /dev/null +++ b/docs/project/DESIGN_REVIEW_PROCESS.md @@ -0,0 +1,122 @@ +# AI-Box设计评审流程规范 + +## 1. 设计评审适用范围 + +### 必须进行正式设计评审的重要设计结果: +- **系统架构设计方案** (孙大圣负责) +- **产品需求规格书(PRD)** (猪小杰负责) +- **核心模块详细设计文档** +- **接口定义和协议规范** +- **电源管理策略设计** +- **安全性和可靠性设计方案** + +### 可以简化评审的常规设计: +- **工具脚本和辅助程序** +- **非核心功能模块设计** +- **文档格式和排版调整** + +## 2. 飞书审批流集成方案 + +### 2.1 审批流配置需求 +由于当前飞书应用权限限制,需要申请以下审批流相关权限: +- `approval:approval_instance` - 审批实例管理 +- `approval:approval_template` - 审批模板管理 + +### 2.2 临时审批流程(当前可用) +在获得完整审批权限前,采用以下临时流程: + +#### 步骤1: 文档创建与初审 +- 设计者在飞书云文档中创建设计文档 +- 在文档开头添加 **【设计评审】** 标识 +- @相关评审人员进行初步技术评审 + +#### 步骤2: 评审会议组织 +- 在 **04 项目会议** 文件夹中创建评审会议 +- 邀请所有相关干系人参加 +- 会议议程包含:设计介绍、问题讨论、决策确认 + +#### 步骤3: 评审结果记录 +- 在会议文档中记录评审结论 +- 明确标注:**通过/有条件通过/不通过** +- 列出所有需要修改的问题项和负责人 + +#### 步骤4: 文档更新与确认 +- 设计者根据评审意见修改文档 +- 在文档修订历史中记录修改内容 +- 评审人员确认修改后,在评论区回复 **【确认通过】** + +### 2.3 正式审批流流程(权限开通后) +一旦获得审批流权限,将升级为正式审批流程: + +#### 自动化审批触发 +- 设计文档保存时自动触发审批流 +- 系统自动识别文档类型并分配相应审批人 +- 审批流包含:技术评审 → 架构评审 → 项目经理确认 → 最终批准 + +#### 审批状态跟踪 +- 实时显示审批进度 +- 超时自动提醒审批人 +- 审批历史完整记录 + +## 3. 评审角色与职责 + +### 3.1 评审委员会组成 +| 角色 | 人员 | 职责 | +|------|------|------| +| **技术评审员** | 孙大圣 | 技术可行性、架构合理性 | +| **产品评审员** | 猪小杰 | 需求符合度、用户体验 | +| **项目经理** | 唐小僧 | 进度影响、资源协调 | +| **质量保证** | 测试团队 | 可测试性、质量标准 | + +### 3.2 评审标准 +- **技术先进性**: 是否采用合适的技术方案 +- **需求符合度**: 是否完全满足产品需求 +- **可实施性**: 开发团队是否具备实施能力 +- **可维护性**: 后续维护和扩展的便利性 +- **风险可控性**: 技术风险是否在可接受范围内 + +## 4. 评审流程执行细节 + +### 4.1 评审准备 +- **提前通知**: 评审前至少24小时通知评审人员 +- **材料准备**: 提供完整的背景资料和参考文档 +- **环境准备**: 确保演示环境和测试数据就绪 + +### 4.2 评审会议 +- **时间控制**: 单次评审会议不超过2小时 +- **议题聚焦**: 严格按照议程进行,避免偏离主题 +- **记录完整**: 指定专人记录会议要点和决策 + +### 4.3 评审后续 +- **问题跟踪**: 所有问题必须有明确的解决计划 +- **状态更新**: 每周更新评审问题的解决进度 +- **闭环验证**: 问题解决后必须进行验证确认 + +## 5. Gitea与飞书协同机制 + +### 5.1 双向同步规则 +- **飞书为主**: 设计文档以飞书版本为准 +- **Gitea备份**: 评审通过的最终版本必须同步到Gitea +- **版本对应**: 飞书文档版本号与Gitea提交哈希对应 + +### 5.2 同步时机 +- **评审前**: 在飞书创建和编辑文档 +- **评审后**: 评审通过24小时内同步到Gitea +- **重大变更**: 任何重大修改都需要重新评审 + +## 6. 应急处理机制 + +### 6.1 紧急设计决策 +对于紧急情况下的设计决策: +- **快速通道**: 项目经理可授权临时决策 +- **事后补审**: 72小时内必须补办正式评审 +- **风险评估**: 必须记录决策的风险和应对措施 + +### 6.2 评审争议处理 +当评审出现重大分歧时: +- **升级机制**: 提交给更高层级决策 +- **专家咨询**: 邀请外部专家提供意见 +- **原型验证**: 通过快速原型验证方案可行性 + +--- +**本规范自发布之日起生效,所有重要设计结果必须遵循此评审流程。项目经理负责监督执行,并根据实际运行情况进行优化调整。** \ No newline at end of file