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