Files
moyi-model-intelligence-hub/docs/DEVELOPMENT_PROCESS.md
T

333 lines
13 KiB
Markdown
Raw Normal View History

# 模亦灵枢产品开发流程
## 文档目的
本文档规定模亦灵枢从产品想法到上线运营的标准开发流程,以及每个阶段必须形成的阶段性产物。
2026-08-18 14:36:03 +08:00
流程参考了“需求分析、系统设计、实现、测试、部署、维护”的软件开发生命周期,并结合 MaaS 产品需要持续验证商业模式、模型供应商和用户体验的特点,增加了产品立项、可行性分析和原型评审环节。项目采用“阶段基线 + 小步迭代”的方式:每个阶段先形成可评审基线,进入开发后再通过受控变更持续迭代,不机械套用纯瀑布或纯敏捷流程。
2026-08-18 14:36:03 +08:00
参考文章:
- [软件开发全流程:从需求到上线的完整指南](https://blog.csdn.net/2301_80215285/article/details/148679049)
- [项目开发的完整流程(详解版)](https://blog.csdn.net/weixin_44621343/article/details/115512699)
## 一、总体流程
```text
2026-08-18 14:36:03 +08:00
项目启动与可行性分析
↓
2026-08-18 14:36:03 +08:00
用户需求与产品需求
↓
原型与交互设计
↓
2026-08-18 14:36:03 +08:00
总体设计 → 概要设计 → 详细设计
↓
开发实现与代码审查
↓
2026-08-18 14:36:03 +08:00
单元测试 → 集成测试 → 系统测试 → 用户验收
↓
2026-08-18 14:36:03 +08:00
发布评审与部署上线
↓
2026-08-18 14:36:03 +08:00
运营监控 → 价值评估 → 项目复盘 → 持续迭代
```
每个阶段都需要完成三个动作:
1. 明确本阶段要解决的问题。
2. 形成可查看、可评审、可追溯的产物。
3. 通过阶段评审后,才能进入下一阶段。
## 二、阶段和标准产物
| 阶段 | 核心问题 | 标准产物 | 阶段门禁 |
|---|---|---|---|
2026-08-18 14:36:03 +08:00
| 0. 项目启动 | 为什么做、为谁做、是否值得做 | 项目章程、目标与 ROI 假设、组织与职责、里程碑、风险清单 | 干系人对目标、范围、计划和职责达成一致 |
| 1. 产品定义 | 用户要解决什么、产品第一版做什么 | 用户需求、PRD、需求矩阵、用户故事、验收标准 | MVP 范围明确,正常与异常场景形成闭环 |
| 2. 原型设计 | 用户如何使用、页面如何组织 | 信息架构、用户流程、低保真/高保真原型 | 核心流程可走通,产品体验达成一致 |
2026-08-18 14:36:03 +08:00
| 3. 系统设计 | 如何稳定、安全、可扩展地实现 | 总体设计、概要设计、详细设计、数据模型、API、部署和安全设计 | 架构基线稳定,模块、接口和关键流程可实施 |
| 4. 开发实现 | 如何分工并交付可运行版本 | 任务拆分、代码、单元测试、代码评审记录 | 核心功能完成并通过代码审查 |
2026-08-18 14:36:03 +08:00
| 5. 测试验收 | 产品是否正确、稳定、安全 | 单元/集成/系统测试报告、缺陷记录、UAT 报告 | P0/P1 缺陷关闭,质量指标和验收标准达成 |
| 6. 发布上线 | 是否具备可控上线条件 | 发布评审记录、部署手册、监控告警、回滚方案 | Go/No-Go 评审通过,生产环境可用且可回滚 |
| 7. 运营复盘 | 上线后是否产生价值、下一步做什么 | 运营数据、价值评估、事故与项目复盘、版本计划 | 经验沉淀完成,用数据进入下一轮需求分析 |
## 三、各阶段工作说明
2026-08-18 14:36:03 +08:00
### 阶段 0:项目启动与可行性分析
#### 工作内容
- 明确产品愿景、当前阶段和长期方向。
- 明确目标用户和核心使用场景。
2026-08-18 14:36:03 +08:00
- 评估预期价值、投入成本与 ROI 假设。
- 判断供应商、资金、技术、运营和合规可行性。
- 明确当前版本的商业模式和不做事项。
2026-08-18 14:36:03 +08:00
- 明确发起人、产品、技术、测试、运营等关键角色及决策机制。
- 划分阶段、里程碑和沟通机制,召开项目启动会。
- 记录重大假设、风险和需要外部确认的问题。
#### 产物
- `README.md`:产品介绍和发展蓝图。
2026-08-18 14:36:03 +08:00
- 项目章程和项目启动材料。
- 产品定位与 ROI 假设。
- 目标用户与场景说明。
- 商业模式假设。
2026-08-18 14:36:03 +08:00
- 组织结构、职责矩阵和沟通机制。
- 阶段里程碑计划。
- 风险和依赖清单。
#### 评审重点
- 产品方向是否清楚。
- 第一阶段是否足够聚焦。
2026-08-18 14:36:03 +08:00
- 目标、计划、职责和决策人是否明确。
- 是否有无法绕开的外部依赖。
- 是否具备进入需求分析的条件。
### 阶段 1:需求分析与产品定义
#### 工作内容
2026-08-18 14:36:03 +08:00
- 收集用户需求,只描述用户目标、业务场景和期望价值。
- 将用户需求转化为可设计、可开发、可测试的产品需求。
- 建立用户角色、用户故事和用户流程。
- 把需求拆成 P0、P1、P2 优先级。
- 明确功能需求和非功能需求。
2026-08-18 14:36:03 +08:00
- 建立“用户需求—产品功能—验收标准—测试用例”的追踪关系。
- 评审正常流程、异常流程、业务闭环和跨系统影响。
- 编写 MVP 范围与验收标准。
#### 产物
2026-08-18 14:36:03 +08:00
- 用户需求说明。
- PRD 和产品需求规格说明。
- 产品需求矩阵及需求追踪矩阵。
- 用户故事地图。
- 功能清单和优先级。
- 业务规则说明。
- MVP 验收标准。
2026-08-18 14:36:03 +08:00
- 需求评审记录。
#### 评审重点
- 每个功能是否对应明确用户价值。
- 是否存在范围蔓延。
- 需求是否可以被设计、开发和测试。
2026-08-18 14:36:03 +08:00
- 正常、异常和边界场景是否完整并形成闭环。
- 产品、技术和测试是否对需求理解一致。
### 阶段 2:原型与交互设计
#### 工作内容
- 设计产品信息架构。
- 设计关键用户流程。
- 先完成低保真线框,再确定视觉方向。
- 明确页面状态、空状态、加载状态和错误状态。
- 设计开发者控制台和运营后台的核心路径。
#### 产物
- 信息架构图。
- 用户流程图。
- 低保真原型。
- 高保真视觉稿或可点击原型。
- 页面状态清单。
#### 评审重点
- 新用户能否完成第一次调用。
- 用户能否理解模型、价格和用量。
- 充值、扣费、失败和退款路径是否清楚。
- 管理员能否完成模型和供应商管理。
### 阶段 3:系统架构与详细设计
#### 工作内容
2026-08-18 14:36:03 +08:00
- 总体设计:确定系统边界、架构风格、核心子系统和关键技术风险,建立架构基线。
- 概要设计:划分模块和服务,明确调用关系、接口、数据流、全局数据结构和数据字典。
- 详细设计:逐模块描述处理流程、状态转换、数据结构、异常处理和关键算法。
- 选择技术栈和部署方式。
- 设计数据库、API 和事件模型。
- 设计认证、权限、密钥和数据保护方案。
- 评估并发、延迟、成本、容灾和可观测性。
2026-08-18 14:36:03 +08:00
- 使用业务流程图确认需求理解,使用时序图确认跨系统交互。
- 对核心调用链提前制作技术验证或压测原型。
- 记录关键技术决策及其替代方案。
#### 产物
2026-08-18 14:36:03 +08:00
- 总体设计说明书和系统架构图。
- 概要设计说明书、分层数据流图和数据字典。
- 各核心模块的详细设计说明书。
- 模块和服务边界说明。
- 数据库 ER 图和表结构。
- OpenAPI/API 文档。
2026-08-18 14:36:03 +08:00
- 关键业务流程图、状态图和系统时序图。
- 安全设计和威胁模型。
- 部署架构和环境说明。
- ADR 技术决策记录。
2026-08-18 14:36:03 +08:00
- 技术方案评审记录、工作量估算和交付计划。
#### 评审重点
- 是否覆盖 PRD 中的功能和质量要求。
- 模块职责是否清晰、依赖是否合理。
2026-08-18 14:36:03 +08:00
- 总体、概要和详细设计是否一致且可追溯。
- 计量、账本和权限是否可追溯。
- 供应商故障、重复扣费和数据泄露如何处理。
### 阶段 4:开发实现与代码审查
#### 工作内容
- 将需求和设计拆成可交付任务。
- 建立开发、测试和生产环境。
- 按代码规范实现模块。
2026-08-18 14:36:03 +08:00
- 开发人员同步编写并执行单元测试和必要的集成测试。
- 对高并发网关、流式响应和计费等核心链路尽早执行性能验证。
- 为关键过程保留结构化日志、指标和调用链,保证执行过程可观察。
- 通过 Pull Request 进行代码审查。
- 使用 Git 记录清晰、可回滚的版本历史。
#### 产物
- 可运行的源代码。
- 任务看板和迭代记录。
- 单元测试和集成测试。
2026-08-18 14:36:03 +08:00
- 核心链路性能验证记录。
- 代码审查记录。
- 开发环境和配置说明。
### 阶段 5:测试验证与用户验收
#### 工作内容
2026-08-18 14:36:03 +08:00
- 测试人员在需求阶段设计测试场景,在系统设计阶段完善测试用例。
- 依次执行单元测试、模块间集成测试和系统测试。
- 系统测试覆盖功能、回归、性能、稳定性、安全、安装部署和适应性。
- 验证流式响应、上游故障、限流和计费一致性。
- 记录、分级和关闭缺陷。
- 邀请目标用户进行 UAT。
#### 产物
2026-08-18 14:36:03 +08:00
- 测试计划和需求覆盖矩阵。
- 单元、集成和系统测试用例及报告。
- 缺陷记录。
- 性能测试报告。
2026-08-18 14:36:03 +08:00
- 稳定性测试报告。
- 安全检查记录。
- 用户验收报告。
### 阶段 6:部署上线与发布管理
#### 工作内容
- 准备部署清单和生产配置。
2026-08-18 14:36:03 +08:00
- 召开发布评审会,回溯范围、质量、风险、预期效果和上线条件。
- 执行数据库迁移和服务发布。
- 配置监控、日志、告警和状态页。
- 准备灰度、回滚和应急处理方案。
- 记录版本变更和已知问题。
#### 产物
- 部署手册。
2026-08-18 14:36:03 +08:00
- 发布评审记录和 Go/No-Go 结论。
- 发布检查清单。
- 回滚方案。
- 监控和告警说明。
- 版本发布说明。
2026-08-18 14:36:03 +08:00
### 阶段 7:运营监控、项目复盘与持续迭代
#### 工作内容
- 观察注册、调用、留存、成本和收入数据。
- 收集用户反馈、工单和故障信息。
- 监控供应商可用性和平台毛利。
- 定期复盘缺陷、事故和需求变化。
2026-08-18 14:36:03 +08:00
- 对照立项时的目标和 ROI 假设评估实际产品价值。
- 复盘各阶段的问题、原因和改进动作,不以追责为目的。
- 根据数据规划下一版本。
#### 产物
- 运营数据报告。
- 用户反馈记录。
2026-08-18 14:36:03 +08:00
- 产品价值评估报告。
- 事故复盘报告。
2026-08-18 14:36:03 +08:00
- 项目复盘和改进行动清单。
- 版本路线图。
- 下一轮 PRD。
2026-08-18 14:36:03 +08:00
## 四、项目治理与需求变更
### 基线和迭代
- 产品蓝图、已评审需求、原型、架构、API 和发布版本分别建立基线。
- 通用能力进入产品基线;客户或合作方的个性化诉求先判断能否抽象为通用需求。
- 研发过程允许小步迭代,但不能绕过需求、设计、测试和发布的责任边界。
### 需求变更
1. 记录变更原因、提出人、目标用户和期望价值。
2. 分析对范围、原型、架构、数据、接口、测试、进度和成本的影响。
3. 由产品负责人和项目决策人确认接受、延期或拒绝。
4. 更新受影响的基线文档、需求矩阵、任务和测试用例。
5. 在版本说明中记录变更,避免只在口头或聊天中确认。
### 核心角色
| 角色 | 主要责任 |
|---|---|
| 项目发起人/决策人 | 确认目标、预算、重大范围和阶段放行 |
| 产品负责人 | 用户研究、PRD、优先级、原型和产品验收 |
| 技术负责人 | 技术方案、架构基线、估算、质量和发布技术决策 |
| 开发人员 | 详细设计、实现、单元测试、自测和代码审查 |
| 测试负责人 | 测试策略、用例、系统测试、缺陷闭环和质量意见 |
| 运维/运营负责人 | 环境、发布、监控、应急、用户反馈和价值数据 |
## 五、模亦灵枢的协作方式
### 我负责的工作
- 整理产品文档和需求。
- 提出产品、交互和技术方案。
- 生成原型、架构、接口和测试产物。
- 在仓库中实施代码和文档变更。
- 执行验证、修复问题并提交阶段结果。
### 你负责确认的事项
- 目标用户和商业优先级。
- 合作方、供应商和资源条件。
- 品牌、价格、业务规则和合规边界。
- 每个阶段的范围和验收结果。
### 阶段协作规则
1. 我先提交本阶段产物草案。
2. 双方讨论并记录需要修改的决策。
3. 我根据确认结果完善产物。
4. 通过阶段评审后提交并推送 Git 仓库。
5. 再进入下一阶段,避免需求、原型和架构同时变化。
2026-08-18 14:36:03 +08:00
## 六、文档和版本规则
- 所有阶段产物优先保存到 `docs/`。
- 文档名称使用阶段编号,便于追踪顺序。
- 每份文档包含状态、负责人、更新时间和评审结论。
2026-08-18 14:36:03 +08:00
- 需求使用唯一编号,并在设计、接口、任务、测试和发布记录中引用。
- 重大产品和技术决策单独记录,不只存在聊天记录中。
- 阶段完成后使用独立 Git 提交,提交信息说明阶段和产物。
- 代码、API、部署和测试文档必须与实际版本保持一致。
2026-08-18 14:36:03 +08:00
## 七、当前进度
- 阶段 0:已完成产品蓝图和品牌定位。
2026-08-18 14:36:03 +08:00
- 当前阶段:阶段 1,产品定义;现有文档为待评审草案。
- 下一份产物:补齐需求矩阵并完成阶段 1 评审,随后进入阶段 2 可视化原型设计。
- 后续阶段:系统架构、数据模型、API 设计和开发计划。