Home

多商户智慧农业经营平台文档目录

本文档用于把现有 CRMEB 多商户商城系统改造为“多商户智慧农业经营平台”，作为立项、需求评审、任务拆解和开发协作的基础文档。

平台经营农业资产、平台自营商品、云仓活动、真实二次代销和结算
用户参与租地、认养、商品购买、云仓抢购、延后选择和云仓代销
商户上传商品、供货履约，并按首次有效购买获得云仓供货货款
平台复用 CRMEB 商城、订单、支付、物流、售后和通用营销能力
新增重点是云仓批次/持仓/回购、真实农业资产分配、产出履约和批次溯源

当前项目端划分

目录	建议定位	主要用户
smartfarm	后端服务/API/定时任务	系统内部
smartfarm_admin	平台管理端	平台管理员、运营、财务
smartfarm_mer	商户中心/供应链中心	入驻供应链商户
smartfarm_service	服务端/客服端	客服、履约人员、农事人员
smartfarm_user	用户端/H5/小程序	消费者、租地/认养用户、云仓用户

文档索引

文档	说明
00-project-overview.md	项目总览：定位、核心闭环、模块规划、V1 范围
01-project-charter.md	项目立项说明、目标、边界、商业模式
02-terminals-and-roles.md	使用端、用户角色、权限边界
03-supply-chain-product-loop.md	供应链商品经营闭环：商户供货、自营商品、云仓秒杀
04-module-map.md	功能模块拆解，按平台端/商户端/用户端分组
05-v1-scope-prd.md	V1 需求范围与核心页面 PRD
06-task-breakdown.md	开发任务拆解、里程碑、验收标准
07-settlement-and-ledger.md	商户货款、用户本金/收益/回购、账本与对账
08-v1-settlement-policy.md	V1 结算口径：商品成本、运费、售后期、优惠承担、云仓收益
09-cloud-warehouse-seckill.md	云仓秒杀：先付款后选择、用户持仓、二次代销、结算与回购
10-crmeb-baseline-capability-map.md	CRMEB 当前底座能力、可复用模块和智慧农业改造映射
11-current-menu-page-audit.md	当前平台端、商户端、用户端菜单页面审计和智慧农业落位建议
12-v1-business-decisions-and-glossary.md	V1 唯一业务决策口径、默认参数和统一术语
13-cloud-warehouse-process-and-state-machines.md	云仓首次购买、去向、批次、二次零售、结算和回购状态机
14-land-adoption-and-traceability-prd.md	租地、认养、生产、异常、产出邮寄和溯源详细 PRD
15-v1-data-model-draft.md	V1 业务实体、表、字段、约束、事务与幂等草案
16-pre-development-design-plan.md	原型、数据、API、代码蓝图、测试和开发启动评审门
17-v1-information-architecture.md	四端菜单、导航、页面编号和页面关系
18-v1-page-and-prototype-spec.md	P0 页面字段、操作、状态、低保真流程和 Figma 规范
19-v1-api-contract-draft.md	四端 API 目录、协议、幂等、错误码和第三方边界
20-v1-events-jobs-permissions-notifications.md	事件、队列、定时任务、权限、通知、审计和监控
21-v1-code-change-blueprint.md	五个项目逐文件新增、修改、复用和回归蓝图
22-v1-test-acceptance-release-manual-plan.md	测试矩阵、验收、发布准备、回退和分角色手册计划
23-crmeb-visual-baseline-audit.md	CRMEB 四端运行态、主题、菜单、DIY 装修和 Figma 基线审计
24-g3-g4-decision-register.md	开发前必须签字的架构、数据、账本、服务端和 UI 决策登记表
25-user-uniapp-reuse-audit.md	用户端路由、DIY、主题、交易链路、公共组件和页面复用矩阵
26-pre-development-master-checklist.md	持续目标的唯一进度账本、评审门、证据、活动队列和完成定义
27-autonomous-project-work-guide.md	Codex 跨会话自主推进、决策记录、验证和安全工作规约
28-v1-requirement-traceability-matrix.md	45 条业务决策到页面、数据、API、文件和测试的全链路覆盖矩阵
29-g3-technical-spike-report.md	G3 只读技术专项验证的源码事实、结论和跨文档回写
30-v1-p0-page-matrix.md	四端 108 个 P0 页面追踪对象的字段、动作、权限、状态、复用和低保真 Flow
31-v1-write-operation-contract-registry.md	242 个写操作的路由、权限、幂等、事务、版本和审计注册表
32-v1-event-job-operation-registry.md	104 个事件、48 个任务及其操作映射、重试和修复策略
33-v1-state-exception-transaction-matrix.md	状态迁移、异常、事务、补偿和界面动作矩阵
34-v1-database-field-dictionary.md	90 张农业业务表的字段、索引、约束、精度和迁移分组
35-v1-page-api-file-trace.md	108 个页面到 API、权限、代码文件、数据表和测试的逐页映射
36-v1-er-diagrams.md	云仓、租地认养、生产履约、溯源、权限和财务 ER 图
37-v1-api-field-contract-registry.md	API 请求/响应 DTO、字段类型、枚举、分页和附件契约
38-v1-platform-admin-manual.md	平台运营、农业运营、财务和异常处理设计态手册
39-v1-merchant-manual.md	商户商品、云仓供货、履约、售后和货款设计态手册
40-v1-user-help.md	用户租地、认养、云仓抢购、三去向、持仓和账本帮助
41-v1-service-and-field-manual.md	客服、农事、养殖、仓储和现场人员设计态手册
42-v1-development-task-packages.md	53 个可分配任务包、依赖、估算、里程碑、DoR 和 DoD
43-v1-test-catalog-and-fixtures.md	421 个领域用例、663 个注册项和固定测试数据目录
44-v1-release-operations-runbook.md	M01-M12、五端发布、四队列、对账、监控、恢复和 C0-C6
45-v1-design-handoff.md	108 页高保真、15 条 Flow、组件、资产、QA 和研发交接规范

推荐推进方式

1. 每次继续项目先看 26-pre-development-master-checklist.md，恢复当前活动任务、证据和阻塞状态。
2. 新会话或交接先看 27-autonomous-project-work-guide.md，按统一规则调查、决策和验证。
3. 看 00-project-overview.md 和 01-project-charter.md，确认项目业务方向和 V1 目标。
4. 逐条确认 12-v1-business-decisions-and-glossary.md，它是后续文档的唯一业务口径。
5. 用 05-v1-scope-prd.md 核对页面与 P0 范围。
6. 分别评审 13-cloud-warehouse-process-and-state-machines.md 和 14-land-adoption-and-traceability-prd.md。
7. 再确认 07-settlement-and-ledger.md 与 08-v1-settlement-policy.md。
8. 阅读 10-crmeb-baseline-capability-map.md 和 11-current-menu-page-audit.md，确认复用边界和菜单落位。
9. 阅读 23-crmeb-visual-baseline-audit.md 和 25-user-uniapp-reuse-audit.md，确认四端视觉和用户端组件复用边界。
10. 结合 24-g3-g4-decision-register.md 与 29-g3-technical-spike-report.md 完成只读技术核验，先确认会影响页面结构的 UI、订单载体、分包和服务端边界。
11. 用 17-v1-information-architecture.md 和 18-v1-page-and-prototype-spec.md 完成页面结构、组件映射与低保真原型。
12. 把低保真发现的问题写回 24-g3-g4-decision-register.md，再逐项冻结其余 G3/G4 决策。
13. 使用 28-v1-requirement-traceability-matrix.md 检查每条业务决定是否覆盖页面、数据、API、文件和测试。
14. 联合评审 15/19/20 与 31-v1-write-operation-contract-registry.md、32-v1-event-job-operation-registry.md、33-v1-state-exception-transaction-matrix.md，冻结写操作、状态、事务、事件和任务。
15. 用 34-v1-database-field-dictionary.md、36-v1-er-diagrams.md 和 37-v1-api-field-contract-registry.md 完成字段级数据/API 评审。
16. 用 35-v1-page-api-file-trace.md 和 21-v1-code-change-blueprint.md 核对五项目文件范围、组件复用点与普通商城回归边界。
17. 以 38-41 评审各角色教程，以 43-v1-test-catalog-and-fixtures.md 和 44-v1-release-operations-runbook.md 评审测试、发布、回退、对账与恢复。
18. 以 45-v1-design-handoff.md 验收 Figma RC-1，再按 42-v1-development-task-packages.md 在研发启动会认领首轮 Ready 任务。

V1 一句话目标

V1 优先跑通四件事：用户租地/认养真实履约，平台/商户商品正常销售，云仓秒杀完成先付款后选择、真实二次代销和到期回购，平台可分别完成商户货款与用户本金/收益/回购结算。