耕法 · 工程方法论2 -九阶开发流程 · 从产品方案到可执行代码的系统化工程方法 -

耕法 · 工程方法论2 | 申耕志 · 算法策

方法论起源

有群云商是一个城乡双向流通的供应链枢纽平台，涉及供应商入驻、全国商品池管理、多租户铺货、自动分账、售后处理、供应商评级、消息通知等9大核心模块，需要同时开发4个端（供应商PC端、供应商小程序、租户后台、集团总后台），还要与已有的有群农场后端共享基础设施。

面对如此复杂的系统工程，我们从完整的开发实践中提炼出这套九阶开发流程法——将软件开发分为9个明确的阶段，每个阶段有清晰的进入条件、核心任务、产出物和退出标准。上一阶段未完成，禁止进入下一阶段。

核心流程 · 九阶开发流程

PHASE 0

模块化产品方案思考

深度思考业务逻辑、用户场景、商业价值，形成可讨论的产品方案框架。

产出：产品方案框架 PS

PHASE 1

PRD 定稿

将产品方案转化为标准化的产品需求文档，作为开发的唯一依据。

产出：PRD 文档

PHASE 2

技术方案评审

确定技术选型、架构方案、关键技术难点攻关。

产出：技术方案文档 TD

PHASE 3

数据库设计

设计完整的数据库表结构，编写 Alembic 迁移脚本。

产出：数据库设计文档 DB

PHASE 4

接口设计

定义所有API接口的请求/响应格式，生成接口文档。

产出：接口设计文档 API

PHASE 5

目录结构设计

创建项目目录结构，配置开发环境，制定代码规范。

产出：目录结构文档 DIR

PHASE 6 🆕

开发执行手册

制定详细的开发计划、阶段目标、任务分配、每日节奏、交付物清单。

产出：执行手册 EXEC

PHASE 7

代码开发

按PRD、接口文档、执行手册进行功能开发，前后端联调测试。

产出：功能代码 CODE

PHASE 8 🆕

开发方法论

将开发过程中的模式、经验、纪律提炼为可复用的方法论，为后续项目奠基。

产出：方法论文档 METHOD

有群云商实践

Phase 0 · 产品方案

9大模块方案框架，经过多轮专家研讨

Phase 1 · PRD

PRD V2.0，9大模块 + 3条核心链路 + 4个端 + 消息通知体系，10位专家审查通过

Phase 2 · 技术方案

确认完全复用有群农场技术栈（FastAPI + React + PostgreSQL），零新技术引入

Phase 3 · 数据库

新增14张表，扩展4张现有表，迁移脚本可直接执行

Phase 4 · 接口

复用111个 + 扩展20个 + 新增56个，共187个接口，与有群农场400个接口风格完全一致

Phase 5 · 目录结构

8个顶级目录，命名统一使用下划线，5位大厂技术总监终极审查通过

🆕 Phase 6 · 执行手册

一人三屏 + AI三窗口并行，四阶段开发计划，每日工作节奏明确

🆕 Phase 8 · 方法论

耕法·工程方法论 V3.0（单人+AI全栈开发流水线），为AI Agent开发做好准备

核心原则

阶段门禁

上一阶段未完成，禁止进入下一阶段

专家审查

每个阶段至少经过一轮专家审查

文档驱动

所有设计决策以文档形式沉淀

复用优先

最大化复用现有代码和基础设施

渐进式优化

先用最简单方案跑通，再逐步优化

命名统一

全项目统一命名规范，语义闭环

阶段门禁检查清单

Phase 0 → Phase 1：产品方案框架评审通过

Phase 1 → Phase 2：PRD通过专家委员会评审

Phase 2 → Phase 3：技术方案评审通过

Phase 3 → Phase 4：数据库迁移脚本执行成功

Phase 4 → Phase 5：前后端接口评审通过

Phase 5 → Phase 6：项目初始化完成，可运行Hello World

🆕 Phase 6 → Phase 7：开发执行手册评审通过

🆕 Phase 7 → Phase 8：各阶段功能测试通过

🆕 Phase 8 → 上线：方法论沉淀完成，准备上线

工具与产出物

工具/产出物	缩写	用途	对应阶段
产品方案框架	PS	模块化产品方案	Phase 0
产品需求文档	PRD	完整功能需求文档	Phase 1
技术方案文档	TD	技术选型与架构方案	Phase 2
数据库设计文档	DB	表结构设计与迁移脚本	Phase 3
接口设计文档	API	接口规范与Apifox配置	Phase 4
目录结构文档	DIR	项目初始化与配置	Phase 5
🆕 开发执行手册	EXEC	开发计划、任务分配、时间节点	Phase 6 🆕
功能代码	CODE	可运行的代码	Phase 7
🆕 开发方法论	METHOD	可复用的开发模式与纪律	Phase 8 🆕

核心纪律 · 77-1 ~ 77-10

77-1 阶段门禁：上一阶段未完成，禁止进入下一阶段

77-2 专家审查：每个阶段至少经过一轮专家审查

77-3 文档驱动：所有设计决策以文档形式沉淀

77-4 复用优先：最大化复用现有代码和基础设施

77-5 命名统一：全项目统一命名规范

77-6 渐进优化：先用最简单方案跑通，再逐步优化

77-7 独立产品独立目录：独立产品必须拥有独立目录

77-8 共享基础设施分离：共享代码统一管理

77-9 多租户一套代码：SaaS租户共用代码，编译切换

77-10 Python包命名规范：后端目录使用下划线

适用场景

✅ 完全适用

从0到1的新产品开发

✅ 适用

现有产品的大版本升级

⚠️ 可简化流程

小型功能迭代

❌ 走紧急流程

紧急Bug修复

版本记录

V1.0 2026-07 · 初始版本，提炼七阶开发流程法 · 来源项目：有群云商

V2.0 2026-07 · 完善七阶开发流程法，增加核心纪律和适用场景 · 来源项目：有群云商

V3.0 2026-07 · 升级为九阶开发流程法，新增Phase 6（开发执行手册）和Phase 8（开发方法论）· 来源项目：有群云商

耕法 · 工程方法论 V3.0

九阶开发流程法 —— 从产品方案到可执行代码的系统化工程方法论。每个阶段有清晰的进入条件、核心任务、产出物和退出标准。上一阶段未完成，禁止进入下一阶段。来源于有群云商从0到1的完整开发实践。新增开发执行手册和开发方法论两个关键阶段。

9开发阶段

6核心原则

9产出物

10核心纪律