00 project overview

项目总览：多商户智慧农业经营平台

本文档用于在立项、团队沟通和需求评审时快速说明项目做什么。详细规则以 12-v1-business-decisions-and-glossary.md 为准。

一句话定位

基于 CRMEB 多商户商城，建设一个以“用户农业参与、平台自营与供应链商品、云仓秒杀代销、真实农业履约和批次溯源”为核心的多商户智慧农业经营平台。

核心参与主体

主体	定位	主要行为
平台	商城、农业资产、云仓活动和履约运营方	管资产、商品、活动、批次、履约、溯源和结算
用户	消费者、农业体验参与者、云仓参与者	购物、租地、认养、云仓抢购、提货/代销和查看账本
商户	供应链商品与履约方	上传商品、云仓供货、发货售后和获得货款
农事/养殖/仓储人员	生产与履约执行者	维护过程记录、产出、入库、打包、出库和异常
财务/对账人员	结算与核对人员	处理商户货款、用户本金/收益/回购和对账
客服	查询与异常协同人员	处理订单、去向、物流、售后、冻结和用户说明

四条核心闭环

闭环 1：用户租地/认养

平台配置真实农业资产和套餐
→ 用户选择套餐、作物或认养类型并付款
→ 系统分配真实地块、动物个体或养殖批次份额
→ 平台代种植/代养殖并记录过程
→ 形成一次或多次采收/产出
→ 按套餐约定数量邮寄到家
→ 用户查看物流、售后和溯源

V1 的租地收成和认养产出不进入云仓代销，也不产生用户收益账本。

闭环 2：平台自营商品

平台维护自营商品与溯源
→ 普通销售或配置进入云仓活动
→ 用户购买
→ 平台履约和售后
→ 平台形成销售收入

闭环 3：供应链商户商品

商户入驻并上传商品
→ 平台审核
→ 普通商城销售，或商户提交云仓供货
→ 商户/平台按约定履约
→ 售后观察期结束
→ 平台结算普通货款或云仓首次供货货款

商户是商品供给和履约主体，不参与用户云仓持仓与收益分配。

闭环 4：云仓秒杀与代销

平台在营销下创建云仓活动
→ 平台自营或商户商品/SKU 形成活动批次
→ 配置抢购价、库存、限购、周期、分成、结算模式和回购
→ 用户在独立“集市云仓”抢购并先付款
→ 用户可继续抢购，稍后选择整个订单明细的邮寄、自提或代销

代销链路：

选择代销或超时自动代销
→ 去向窗口关闭，冻结用户云仓持仓
→ 平台通过 CRMEB 产生真实二次零售订单
→ 订单完成并过售后观察期
→ 更新批次有效销售进度
→ 按 25%/50%/75%/100% 节点和结算模式返本金/收益
→ 到期未售数量由平台按快照回购
→ 批次最终结算并关闭

关键边界：

• 每场活动中的每个商品 SKU 是一个云仓批次。
• 每个订单明细只能有一种去向，需要不同去向时分开下单。
• 商户货款基于首次有效购买和供货验收，不等待二次零售。
• 用户本金、收益和回购分账展示。
• 活动没抢完退来源库存；代销到期没卖完由平台回购。

平台端模块

模块	核心内容
工作台	商城、农业参与、云仓批次、履约、异常和待结算
农业资产	农场、区域、地块、占用周期、栏舍、养殖资产/批次
租地经营	套餐、作物、订单分配、生产、采收和邮寄
认养经营	品种、套餐、个体/份额、养殖、产出和邮寄
生产记录	种植/养殖批次、过程事件、采收/产出和异常
溯源	档案、版本、报告、证书、二维码和订单关联
商品	平台自营、商户商品审核、库存、运费和售后
CRMEB 营销	原优惠券、普通秒杀、拼团、会员价等
云仓秒杀	活动、供货、活动商品、SKU 批次、去向和发布预检
云仓经营	库存池、二次零售分配、进度、节点、到期回购
财务	商户普通/云仓货款与按日结算单、用户本金/收益/回购账本与直接入账、统一对账

商户中心模块

模块	核心内容
工作台	销售、履约、供货验收和待结算
商品	上传、SKU、库存、运费、产地和溯源材料
云仓供货	申请、审核、预占、送达和验收
订单/售后	普通订单和约定由商户负责的云仓履约
货款	普通商品货款和云仓首次供货货款

用户端模块

模块	核心内容
普通商城	商品、店铺、购物车、订单、物流和售后
农场专区	租地、认养和农场内容
我的土地/认养	真实资产、过程、产出、异常和分批邮寄
集市云仓	活动、倒计时、活动商品、库存和抢购
云仓待选择	付款后选择邮寄、自提或代销
我的云仓	持仓、批次进度、本金、收益、回购和账本
溯源	从商品、订单和履约查看实际生产与产出批次

V1 必做

• 真实农业资产、租地/认养套餐和分配。
• 生产过程、采收/产出、农业异常和分批邮寄。
• 平台自营和商户普通商品销售。
• 云仓供货、活动、SKU 批次、抢购锁库存和支付超时。
• 先付款后选择、单一明细去向、邮寄补运费、自提和自动代销。
• 专属云仓库存池、真实二次零售、最早到期批次分配。
• 三种结算模式、固定进度节点、商户供货货款。
• 活动未抢完退库存、代销到期回购。
• 用户本金、收益、回购、冻结、冲正、幂等入账和资金流水。
• 真实批次溯源、审核、版本和二维码。
• CRMEB 普通商城和原营销完整回归。

V1 后置

• 真实 IoT 设备协议与联动。
• 复杂 GIS 地块编辑和用户实时选图。
• AI 农业建议。
• 外部渠道销售自动进入云仓进度。
• 复杂多供应商分账。
• 完整繁殖育种系统。
• 监管端和大型数据大屏。

第一阶段成功标准

• 用户能完成租地/认养，看到真实过程并收到约定产出。
• 商户能上传商品、供货、履约并核对货款。
• 用户能快速抢购、稍后选择且不会出现一个明细多种去向。
• 平台能以真实二次订单驱动批次进度。
• 三种结算、节点跨越、到期回购和售后冲正能正确对账。
• 商品、订单和履约能追到真实生产与产出批次。
• CRMEB 原商城、原营销和原财务流程不受破坏。

推荐阅读顺序

1. 本总览。
2. 01-project-charter.md。
3. 12-v1-business-decisions-and-glossary.md。
4. 05-v1-scope-prd.md。
5. 13-cloud-warehouse-process-and-state-machines.md。
6. 14-land-adoption-and-traceability-prd.md。
7. 08-v1-settlement-policy.md。
8. 15-v1-data-model-draft.md。
9. 16-pre-development-design-plan.md。