Skip to content

Home

Jump to bottom
技术老胡 edited this page Jul 29, 2026 · 5 revisions

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

本文档用于把现有 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 测试矩阵、验收、发布准备、回退和分角色手册计划

推荐推进方式

  1. 先看 00-project-overview.md，确认项目业务方向。
  2. 再确认 01-project-charter.md 中的项目定位和 V1 目标。
  3. 逐条确认 12-v1-business-decisions-and-glossary.md，它是后续文档的唯一口径。
  4. 用 05-v1-scope-prd.md 核对页面与 P0 范围。
  5. 分别评审 13-cloud-warehouse-process-and-state-machines.md 和 14-land-adoption-and-traceability-prd.md。
  6. 再确认 07-settlement-and-ledger.md 与 08-v1-settlement-policy.md。
  7. 阅读 10-crmeb-baseline-capability-map.md 和 11-current-menu-page-audit.md，确认复用边界和菜单落位。
  8. 用 17-v1-information-architecture.md 和 18-v1-page-and-prototype-spec.md 完成页面结构与 Figma 原型。
  9. 联合评审 15-v1-data-model-draft.md、19-v1-api-contract-draft.md 和 20-v1-events-jobs-permissions-notifications.md，冻结 G3 技术设计。
  10. 用 21-v1-code-change-blueprint.md 核对五个项目的文件范围与普通商城回归边界。
  11. 用 22-v1-test-acceptance-release-manual-plan.md 建立需求追踪、测试、发布与教程基线。
  12. 按 16-pre-development-design-plan.md 完成开发前评审门，再用 06-task-breakdown.md 分配任务。

V1 一句话目标

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

SmartFarm 文档

Clone this wiki locally