05 v1 scope prd

V1 需求范围与 PRD

一、V1 目标

V1 跑通四条可独立验收、又能在商城中协同的主线：

1. 用户租地/认养、查看真实生产过程，并按约定数量邮寄到家。
2. 平台自营商品和商户普通商品正常销售、履约、售后与结算。
3. 云仓秒杀先付款、后选邮寄/自提/代销，形成真实二次零售、分期结算和到期回购。
4. 商品、订单、农业资产、生产批次和采收/产出批次具备基础溯源。

二、V1 不变的 CRMEB 底座

V1 继续复用：

• 用户、会员、登录和账户。
• 商户入驻、商户员工和数据权限。
• 普通商品、SKU、购物车和普通订单。
• 支付、退款、售后、发货、物流和地址。
• 运费模板、包邮和配送设置。
• 优惠券、普通秒杀、拼团、会员价等原营销。
• 平台/商户菜单权限、素材、配置和消息能力。
• 商户普通财务、用户余额和基础账单能力。

新增业务不能破坏普通商城和普通营销流程。

三、角色与用户故事

平台运营

• 配置农场、区域、地块、栏舍和养殖资产。
• 配置租地、认养套餐和交付规则。
• 审核生产记录、异常事件和溯源内容。
• 维护平台自营商品并审核商户商品。
• 在营销下创建云仓活动和活动商品。
• 配置活动 SKU 库存、抢购价、去向、周期、结算模式、分成和回购。
• 查看用户待选择、批次库存、二次销售、进度和到期回购。

农事/养殖/仓储人员

• 查看负责的生产批次。
• 录入农事、饲喂、防疫、健康、采收和产出。
• 上报减产、死亡、延期、品质和物流异常。
• 处理产出入库、订单分配、打包和出库。

商户

• 上传并维护自己的商品、SKU、库存、运费和溯源材料。
• 提交商品/SKU 作为云仓供货商品。
• 查看平台审核、活动预占、入库/验收和首次购买数量。
• 处理约定由商户负责的普通订单或云仓履约售后。
• 查看普通商品货款和云仓首次供货货款。

用户

• 像普通商城一样购买平台和商户商品。
• 选择租地套餐和作物，付款后查看真实地块、农事记录、收成与邮寄。
• 选择认养套餐，查看个体或批次份额、养殖记录、产出与邮寄。
• 进入独立集市云仓抢购并先完成付款。
• 付款后继续抢购，稍后在订单中心选择整个明细的邮寄、自提或代销。
• 查看云仓持仓、批次销售进度、本金、收益、回购和账本。
• 从商品、订单和履约进入真实溯源档案。

财务/对账人员

• 查看商户普通商品与云仓首次供货货款。
• 查看用户云仓本金返还、收益、回购、冻结和冲正。
• 商户按自然日生成结算单；用户云仓账本逐笔关联实际资金入账。
• 导出订单、批次、金额、状态和结算依据。

客服

• 查询普通订单、租地/认养、云仓首次订单和二次订单。
• 解释待选择、自动代销、批次进度和回购规则。
• 处理有审批记录的去向异常修改、售后、冻结和用户通知。

四、平台管理端页面

农业资产与履约

页面	P	核心功能
农场/区域	P0	基础资料、地址、负责人、状态
地块与占用日历	P0	物理地块、面积、占用周期、休耕和异常
作物管理	P0	作物、品种、预计周期和单位
租地套餐	P0	农场区域、面积、作物、周期、交付数量、服务和邮寄
租地订单	P0	地块分配、生产批次、权益、异常和履约
认养分类/品种	P0	分类、品种、分配模式和预计产出
养殖资产/批次	P0	个体编号、栏舍、批次容量、可分配份额
认养套餐	P0	单体/份额、周期、交付、服务和异常规则
认养订单	P0	资产/份额分配、替换、产出和履约
生产批次	P0	种植/养殖计划、负责人和状态
过程记录审核	P0	农事/养殖记录审核、发布和撤回
采收/产出批次	P0	数量、质量、损耗、检测和分配
邮寄履约	P0	分批履约、物流、补发和退款
农业异常	P0	原因、证据、影响、方案、审批和通知
溯源档案	P0	版本、报告、证书、关联和二维码

商品、营销与云仓

页面	P	核心功能
平台自营商品	P0	复用商品能力，增加来源和溯源
商户商品审核	P0	商品、资质、产地和溯源材料
CRMEB 原营销	复用	优惠券、普通秒杀、拼团、会员价等
云仓活动列表	P0	场次、状态、成交、待选择、代销和结算概览
云仓活动编辑	P0	时间、支付超时、活动商品
云仓活动商品	P0	SKU 批次、价格、库存、去向、周期、分成、结算、回购
云仓发布预检	P0	库存、供货、规则和用户端预览校验
云仓去向处理	P0	待选择、用户选择、自动代销和异常修改
云仓批次	P0	库存池、有效销售、进度、节点和到期
二次零售分配	P0	二次订单明细与批次分配、退款和有效状态
到期回购	P0	未售数量、比例、金额、库存转入和审核
用户云仓持仓	P0	用户、来源订单、批次、数量、本金和收益
云仓异常	P0	库存、质量、售后、暂停和恢复

财务

页面	P	核心功能
商户普通货款	复用/扩展	普通订单货款和结算
商户云仓货款	P0	有效首次购买、供货价、验收、观察期和结算
用户云仓账本	P0	本金、收益、回购、冻结和冲正
用户云仓正式入账	P0	账本审核、幂等入账、异常复核和导出
对账中心	P0	订单、库存、批次、账本、商户结算单、入账记录和资金流水

五、商户中心页面

页面	P	核心功能
工作台	P0	销售、待发货、售后、供货验收和待结算
商品列表/编辑	复用/扩展	商品、SKU、库存、运费、产地和溯源材料
云仓供货申请	P0	选择商品/SKU、供货价、数量、履约说明
云仓供货记录	P0	审核、预占、送达、验收和活动信息
云仓履约/售后	P0	商户负责的发货、质量和首次售后
云仓首次购买汇总	P0	有效数量和退款，不展示用户收益数据
普通订单	复用	发货、物流、售后
普通货款	复用	佣金、优惠、退款和结算
云仓供货货款	P0	供货价、有效数量、扣减、待结算和已结算
商户资料	P1	资质、品牌、供货能力和结算账户

六、用户端页面

页面	P	核心功能
首页	P0	商城、农场专区和集市云仓入口
普通商品/店铺/订单	复用/扩展	产地、供应商和溯源入口
农场专区	P0	租地、认养和农场内容
租地列表/详情	P0	套餐、作物、周期、交付、服务和异常规则
租地下单	P0	选择作物和服务并支付
我的土地	P0	地块、周期、农事、采收、异常和履约
认养列表/详情	P0	品种、单体/份额、产出和规则
认养下单	P0	套餐确认与支付
我的认养	P0	个体/份额、养殖、产出、异常和履约
收成/产出履约	P0	地址、分批物流和售后
集市云仓	P0	场次、倒计时、商品、库存和抢购
云仓商品详情	P0	去向、选择期限、周期、结算、分成和回购
云仓抢购确认	P0	数量、商品价款和规则确认，不要求地址
云仓支付成功	P0	立即选择、继续抢购和截止提醒
云仓待选择	P0	订单中心逐笔选择邮寄、自提或代销
云仓邮寄补运费	P0	地址、运费模板和补付
我的云仓	P0	持仓、批次进度、本金、收益、回购和状态
云仓账本	P0	本金、收益、回购、冻结和冲正明细
溯源详情	P0	资产、生产、产出、报告、证书和订单关联

七、核心业务规则

租地

• 用户选择农场、区域、套餐和作物，付款后由系统分配真实地块或占用单元。
• 物理地块与占用周期分开，容量不可超分。
• 套餐以固定或最低交付数量作为验收口径。
• 允许多次采收和分批邮寄。
• 减产、绝收和延期进入异常事件与补足/替换/退款流程。

认养

• 牛、羊、猪等采用单体认养；鸡群、蜂群等采用批次份额。
• 套餐发布时固定分配模式。
• 单体不可重复分配，批次份额不可超发。
• 套餐以固定或最低交付数量作为验收口径。
• 死亡、疾病和延期保留原记录并通过替换、延期或退款处理。

云仓首次购买

• 云仓活动位于营销下，但使用独立业务状态。
• 每场活动的每个商品 SKU 为一个批次。
• 活动库存必须来自已经入库/供货验收的真实可用数量。
• 用户先付款，后选择整个订单明细的邮寄、自提或代销。
• 默认活动结束后 3 天截止选择，超时自动代销。
• 邮寄时再选择地址并使用独立运费单补付；补运费超时按是否超过选择截止时间返回待选择或自动代销，迟到支付保持当前去向并全额退款。
• 待选择或代销批次冻结前支持整个订单明细首次退款，批次开始后进入云仓异常/售后处理。
• 未支付订单超时释放库存；活动未抢完数量退回来源库存。

云仓代销

• 选择窗口关闭后冻结代销数量并开始批次周期。
• 只有 CRMEB 二次零售订单完成且过售后观察期才算有效售出。
• 跨批次按最早到期优先，同批次用户按持仓占比分摊进度。
• 结算节点固定为 25%、50%、75%、100%。
• 每个活动 SKU 只能选择一种结算模式。
• 到期未售数量由平台按抢购价和回购比例快照回购。

结算

• 商户云仓货款按有效首次购买和供货验收结算，不等待二次零售。
• 用户云仓本金、收益和回购分别记账。
• 平台券和平台补贴不降低用户收益计算的批次确认销售收入。
• 日常运营成本从平台分成承担。
• 用户账本不形成负余额。
• 所有账本使用累计差额、幂等、冻结和冲正。

溯源

• V1 以生产批次和采收/产出批次为核心。
• 大牲畜可增加个体编号。
• 用户看到实际关联到商品/订单的批次，而不是只有通用宣传内容。
• 内容经草稿、审核、发布、撤回流程，已发布修改保留版本。

八、P0 验收闭环

租地/认养

• 可创建资产和套餐。
• 用户付款后能分配真实资产或份额。
• 过程记录可审核并展示。
• 采收/产出可分批分配和邮寄。
• 交付、剩余和退款数量闭合。
• 异常和替换记录不会覆盖历史事实。

普通商城

• 平台和商户商品正常销售、支付、发货、售后。
• 原优惠券、普通秒杀和商户结算无回归。

云仓

• 活动发布前能校验供货、库存和完整规则。
• 抢购库存不会超卖，未付款会释放。
• 用户付款后可继续抢购并稍后选择。
• 每个明细只能选择一种方式。
• 超时自动代销幂等且有通知。
• 邮寄补运费、自提核销和代销入批次均可完成。
• 首次退款、补运费超时/迟到退款和自提逾期有明确状态、资金与库存结果。
• 二次订单真实关联批次并在售后期后更新进度。
• 三种模式都能按累计差额正确结算。
• 未抢完退库存、到期未售回购可闭合。
• 商户货款不依赖二次售完。
• 用户本金、收益、回购和冲正可追溯。

溯源

• 商品、订单和履约能进入稳定溯源档案。
• 档案可追到真实生产与产出批次。
• 审核发布和版本保留可验证。

九、V1 后置

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

云仓到期回购、农业异常、售后冲正不再属于后置能力，它们是 V1 闭环的一部分。

十、关联文档

• 12-v1-business-decisions-and-glossary.md
• 13-cloud-warehouse-process-and-state-machines.md
• 14-land-adoption-and-traceability-prd.md
• 15-v1-data-model-draft.md
• 17-v1-information-architecture.md
• 18-v1-page-and-prototype-spec.md