06 task breakdown

任务拆解、里程碑与验收

本文档用于把项目从需求定稿推进到正式开发。当前优先完成设计和评审，不按日期倒逼未确认的业务规则进入代码。

一、里程碑

里程碑	目标	进入条件	完成标志
M0 立项基线	统一项目方向和 CRMEB 复用边界	已审计项目、菜单、运行态和用户端组件	00-11、23、25 口径一致
M1 业务规则冻结	定稿云仓、租地、认养、溯源和结算	项目范围确认	12-14 评审通过
M2 产品与原型	明确各端页面和完整交互	M1 完成	IA、低/高保真和交互稿通过
M3 技术方案	完成数据、API、事件、权限和异常方案	M2 关键流程通过	ER/字段字典/API/ADR 通过
M4 代码改造蓝图	精确到五个项目和文件	M3 完成	新建/修改/重构清单通过
M5 测试与交付方案	确认可验收和可上线	M3/M4 完成	测试、回滚和教程计划通过
M6 开发启动	分配实现任务	M1-M5 全部通过	正式排期与负责人确定
M7 分域实现与联调	完成 P0 闭环	M6 完成	各域测试与跨域联调通过
M8 验收上线	数据初始化、回归和发布	M7 完成	验收、回滚演练和使用说明完成

开发前详细评审门见 16-pre-development-design-plan.md。

二、当前优先任务

M1：业务规则冻结

任务	负责人建议	产出	状态
核对项目总览与立项	项目负责人/产品	00、01	待评审
核对端、角色和权限边界	产品/运营/技术	02	待评审
核对供应链闭环	产品/商户运营/财务口径负责人	03	待评审
冻结 V1 页面与业务范围	产品/各角色代表	05	待评审
冻结商户与用户账本口径	产品/财务口径负责人/技术	07、08	待评审
冻结云仓活动与页面玩法	产品/平台运营	09	待评审
逐条确认业务决策	项目负责人/产品/技术/测试	12	待评审
评审云仓状态机和公式	产品/财务口径负责人/技术/测试	13	待评审
评审租地认养与溯源	产品/农业运营/履约/测试	14	待评审
记录变更和未决项	产品	决策变更记录	持续

当前阶段不需要法律或税务角色参与评审；支付、退款、优惠承担、商户货款和用户账本仍由产品、财务口径负责人和技术共同确认。

三、产品与 UI/UX 任务

1. 信息架构

详细页面树和编号见 17-v1-information-architecture.md。

端	任务
平台端	农业经营、溯源、营销下云仓、用户云仓和财务菜单树
商户端	商品溯源、云仓供货、供货验收、履约和货款菜单
用户端	农场专区、集市云仓、订单待选择、我的云仓和溯源入口
服务端	在 smartfarm_service 内保留原 PC 客服页，并新增农业桌面工作区和移动现场工作区；平台端只承载高风险审核与最终处置

2. 低保真原型

页面字段、状态与流程要求见 18-v1-page-and-prototype-spec.md。

P0 流程：

• 云仓活动创建、商品配置、发布预检。
• 用户抢购付款、继续抢购、稍后选择和自动代销。
• 邮寄补运费、自提核销、代销持仓。
• 二次零售分配、进度、三种结算和到期回购。
• 商户供货申请、入库验收和供货货款。
• 租地付款、地块分配、生产、采收和分批邮寄。
• 认养付款、个体/份额分配、产出、替换和邮寄。
• 现场记录、异常上报、运营审核和溯源发布。

3. 高保真与交付

• 使用已建立、由项目方持有的正式 Figma 文件。
• 复用 CRMEB、Element UI 和 uni-app 现有视觉规范。
• 先完成逐页“现有模板 + 直接复用 + 扩展复用 + 新增领域组件”映射和低保真评审，再进入高保真。
• 定义状态、进度、批次、账本、时间线和溯源组件。
• 完成桌面、H5、小程序主要视口。
• 标注页面、组件、间距、颜色、交互和切图。
• 对正常、空、加载、错误、冻结、售后和无权限状态逐一出稿。

四、技术设计任务

1. 数据库

以 15-v1-data-model-draft.md 为首版，完成：

• 正式 ER 图。
• 表和字段字典。
• 状态枚举和业务唯一键。
• 金额、数量、比例和时间精度。
• 索引、并发与容量评估。
• 事务和幂等边界。
• CRMEB 表与新业务表关联。
• 数据升级、初始化和回滚方案。

2. API

接口首版目录见 19-v1-api-contract-draft.md，事件、任务、权限和通知首版见 20-v1-events-jobs-permissions-notifications.md。

分类	需要设计
平台 API	农业资产、套餐、订单分配、生产、产出、异常、溯源、云仓活动、批次、结算
商户 API	供货申请、验收查看、履约售后、首次购买汇总、货款
用户 API	租地认养、集市云仓、抢购、待选择、补运费、持仓、账本、溯源
服务/现场 API	批次任务、过程记录、产出、异常和履约
内部能力	事件、监听器、队列、定时任务、支付/退款回调

每个接口必须写权限、校验、前置状态、状态迁移、幂等、事务、错误码和示例。

3. 架构决策

至少形成以下 ADR：

• 云仓为何独立建模而不是扩展普通秒杀枚举。
• 首次订单和二次零售订单如何关联。
• 云仓库存池和 CRMEB 普通库存边界。
• 二次零售最早到期批次分配时机。
• 用户业务账本与 CRMEB 余额关系。
• 商户供货账本与现有商户财务关系。
• 农业订单如何复用 CRMEB 支付、退款和物流。
• 生产批次统一建模还是种植/养殖拆表。
• 溯源版本、二维码和公开访问方案。

4. 外部能力

V1 优先使用项目已有能力，评审是否需要新增：

• 地图：V1 统一腾讯地图和 GCJ02，新业务字段固定为 longitude/latitude/coordinate_system；农场与统一自提点保存真实点位，区域/地块使用继承点位和示意图，复杂 GIS 后置。
• 物流：复用 CRMEB 物流查询和电子面单。
• 支付：复用 CRMEB 支付与退款。
• 短信/微信消息：复用现有通知能力，补充模板。
• 二维码：使用本地生成能力。
• 文件/视频：复用现有存储配置。
• IoT：V1 不接真实协议，可保留设备和数据关联接口设计。

五、代码改造蓝图任务

本阶段只产出清单，不写实现。首版逐文件清单见 21-v1-code-change-blueprint.md，待 G3 技术评审后冻结。

后端 smartfarm

• 路由文件。
• 平台、商户、用户、服务端控制器。
• 请求验证器。
• Repository、DAO、Model。
• 云仓活动、订单、库存、批次、结算领域服务。
• 农业资产、生产、产出、溯源领域服务。
• 支付/退款事件监听。
• 队列和定时任务。
• 权限菜单、配置、字典。
• 数据库升级、初始化和回滚文件。

平台端 smartfarm_admin

• 菜单和路由。
• 农业经营、溯源、云仓和财务页面。
• API 模块。
• 表单、表格、状态和详情组件。
• 批次进度、库存池、账本和时间线组件。
• 权限按钮与错误状态。

商户端 smartfarm_mer

• 云仓供货、验收、履约和货款页面。
• 商品溯源扩展。
• API、路由、权限和公共组件。

用户端 smartfarm_user

• 农场专区、租地、认养和溯源页面。
• 集市云仓、支付成功、待选择、补运费、我的云仓和账本页面。
• API、状态管理、页面路由和消息提醒。
• H5、小程序、App 差异处理。

服务端 smartfarm_service

• 保留原 /kefu/dashboard PC 客服壳，新增 /kefu/farm/desk/* 农业桌面和 /kefu/farm/work/* 移动现场布局。
• 复用现有客服身份、Token、请求、上传和图标；补齐账号状态、农业职责权限码与对象范围。
• 完成农业/云仓查询、异常协同、任务、扫码、过程记录、产出、仓储、履约和异常上报页面。
• 平台端页面不能被视为可直接复制的服务端页面；高风险审核、结算、回购和最终处置仍保留平台端。

六、开发阶段任务包

只有 M1-M5 通过后才创建实现任务。

包 A：农业基础资产

• 农场、区域、地块和占用周期。
• 栏舍、个体资产和养殖批次。
• 作物、品种和基础字典。
• 权限、菜单和基础页面。

包 B：租地与认养

• 套餐、支付订单扩展和资产分配。
• 生产批次与过程记录。
• 采收/产出、分配和分批履约。
• 异常、替换、补足、补发和未履约退款。

包 C：商品与溯源

• 平台自营和商户商品扩展。
• 产出批次到商品/SKU 的关联。
• 溯源档案、审核、版本、材料和二维码。
• 商品、订单和履约入口。

包 D：云仓活动与首次购买

• 活动、供货审核、活动商品和 SKU 批次。
• 活动库存预占、抢购锁定和支付超时释放。
• 先付款后选择。
• 邮寄补运费、自提和代销入批次。
• 未抢完库存退回。

包 E：二次零售与批次

• cloud_only 二次代销映射 SKU 和专属云仓库存桥接池。
• 二次订单批次分配。
• 最早到期优先。
• 有效售出、退款冲减和进度快照。
• 到期暂停、回购和批次关闭。

包 F：结算与账本

• 商户普通和云仓供货货款。
• 用户本金、收益、回购、冻结和冲正。
• 三种结算模式。
• 结算单、余额入账、对账和导出。

包 G：联调、回归与交付

• 跨端联调。
• 初始化数据。
• CRMEB 普通商城与原营销回归。
• 并发、幂等、金额、权限和异常测试。
• 上线、回滚、监控和操作手册。

七、测试矩阵

完整 G5 计划、固定测试数据、P0 用例编号、发布准备和使用手册目录见 22-v1-test-acceptance-release-manual-plan.md。

范围	必测内容
库存	超卖、支付超时、重复回调、活动未抢完、二次锁定、退款、回购
状态	合法迁移、非法操作、重复任务、暂停/恢复、最终关闭
金额	优惠承担、补运费、供货价、三种结算、尾差、回购、冲正
权限	平台角色、商户隔离、用户数据隔离、现场人员范围
云仓	延后选择、单一去向、首次退款、补运费超时、自提逾期、自动代销、FEFO、节点跨越、滞销
农业	地块超分、单体重复、份额超发、产出超分、分批履约、异常替换
溯源	草稿、审核、发布、撤回、版本、订单真实批次
回归	普通商品、普通秒杀、券、支付、退款、发货、商户财务

八、P0 验收标准

• 12 中所有 P0 决策均有页面、字段、接口和测试映射。
• 云仓首次付款不被地址和去向阻塞。
• 每个云仓订单明细只能有一个去向。
• 批次库存与所有库存流水闭合。
• 二次订单过售后期后才增加有效进度。
• 三种结算模式、节点跨越和到期回购可重复验证且不重复入账。
• 商户货款不等待二次售完。
• 用户本金、收益和回购可分别解释和对账。
• 租地/认养分配真实资产且不超分。
• 生产记录、产出、履约和溯源形成真实链路。
• 异常不会通过删除历史数据处理。
• CRMEB 原商城、原营销和原商户财务通过回归。

九、风险清单

风险	控制措施
把云仓当普通秒杀加几个字段	使用独立活动、批次、持仓、二次分配和账本模型
去向与付款强绑定	独立首次订单状态和付款后待选择流程
一个明细拆多去向	数据与交互都强制单一去向
商户和用户结算混算	首次供货货款与二次代销账本完全分离
手工修改已售进度	只由真实二次订单和受控审核导入产生
到期滞销无闭环	V1 必做回购、库存转平台和最终结算
结算重复或金额尾差	累计差额、幂等键、高精度和最终尾差调整
农业资产超分	独立占用周期/份额、事务和容量约束
溯源只是宣传页	订单关联实际生产与产出批次，内容有审核和版本
过早开工导致返工	严格执行 M1-M5 评审门