-
Notifications
You must be signed in to change notification settings - Fork 0
12 v1 business decisions and glossary
技术老胡 edited this page Jul 30, 2026
·
2 revisions
本文档是 V1 业务口径的统一事实来源。总览、PRD、页面原型、数据库设计、接口设计、测试用例与用户说明不得与本文件冲突。
-
已确认:可直接进入 PRD、原型和技术设计,不再作为开放问题反复讨论。 -
后续配置:业务机制已确认,具体数值由每场活动或每个套餐配置。 - 任何已确认规则发生变化,必须记录变更原因、影响范围和生效版本。
- 历史订单一律使用下单时的规则快照,不跟随新配置变化。
| 编号 | 主题 | V1 决策 | 状态 |
|---|---|---|---|
CW-001 |
云仓定位 | 云仓秒杀是 CRMEB 营销体系下新增的独立秒杀模块,用户端使用独立“集市云仓”页面 | 已确认 |
CW-002 |
商品来源 | 云仓活动商品可来自平台自营商品或商户供货商品 | 已确认 |
CW-003 |
抢购流程 | 用户先完成商品抢购与付款,付款时不强制选择邮寄、自提或代销 | 已确认 |
CW-004 |
延后选择 | 支付成功后可立即选择,也可继续抢购,活动结束后在订单中心统一处理 | 已确认 |
CW-005 |
明细去向 | 每个订单明细的全部数量只能选择一种处理方式;需要不同方式时必须分开下单 | 已确认 |
CW-006 |
可选方式 | V1 支持邮寄到家、线下自提、平台代销;云仓活动必须支持代销,可按商品额外开放邮寄或自提 | 已确认 |
CW-007 |
选择时限 | 默认截止时间为活动结束后 3 个自然日,活动商品可在 1 至 7 天内选择覆盖 | 已确认 |
CW-008 |
超时处理 | 用户在截止时间前未选择时,系统按下单前已展示并确认的规则自动转为平台代销 | 已确认 |
CW-009 |
运费 | 运费规则复用 CRMEB 运费模板;选择邮寄后再确认地址并计算、补付运费,包邮商品不补付 | 已确认 |
CW-010 |
活动批次 | 每场活动中的每个商品 SKU 形成一个独立云仓批次 | 已确认 |
CW-011 |
批次开售 | 去向选择截止后冻结代销数量,云仓批次才进入统一代销周期 | 已确认 |
CW-012 |
实际代销 | 只有关联该批次的 CRMEB 二次零售订单明细完成且超过售后观察期,才计入有效代销售出 | 已确认 |
CW-013 |
批次分配 | 多个批次按最早到期优先分配;同一批次内按持仓占比分摊销售结果。实体库存始终为整数,用户侧使用高精度经济等价数量和金额尾差规则,不虚构某一件商品先卖给某个持仓 | 已确认 |
CW-014 |
结算模式 | 每个活动 SKU 只能选择一种:批次结束统一结算、分期收益且结束返本金、分期本金和收益 | 已确认 |
CW-015 |
进度节点 | V1 固定使用 25%、50%、75%、100% 四个累计销售进度节点,不开放任意节点编辑;节点按跨越触发,金额按触发时真实累计销售结果计算,一次跨越多个节点只生成最高节点的一组差额账本 | 已确认 |
CW-016 |
默认模式 | V1 默认使用“分期本金和收益”,运营可按活动 SKU 改为其他两种模式 | 已确认 |
CW-017 |
收益率 | 预计销售周期和用户收益分成率在活动 SKU 中配置,并在用户付款时写入快照 | 已确认 |
CW-018 |
未抢完库存 | 活动结束并释放未支付锁定量后,未被用户付款购买的数量退回平台或商户来源库存 | 已确认 |
CW-019 |
代销滞销 | 代销周期到期仍未售出的用户云仓数量由平台回购,完成回购后批次才能关闭 | 已确认 |
CW-020 |
回购规则 | 回购基数为用户云仓抢购单价;支持 100%、90%、80% 和自定义比例,V1 默认 100% | 已确认 |
CW-021 |
商户结算 | 商户货款基于用户首次购买的有效数量结算,不依赖二次零售是否售出;满足条件后按自然日结单并进入商户可用余额 | 已确认 |
CW-022 |
商户结算条件 | 首次购买按去向完成、云仓入库/供货验收完成、首次交易售后观察期结束且无退款争议后进入待结算;不再叠加普通订单全局冻结期 | 已确认 |
CW-023 |
售价下限 | 平台不得让用户承担低于其抢购成本的二次销售价差;确需低价销售时差额由平台承担 | 已确认 |
CW-024 |
优惠承担 | 二次零售中的平台券、平台补贴和平台运营优惠由平台承担,不冲减用户收益计算基数 | 已确认 |
CW-025 |
运营成本 | V1 的仓储、推广、常规包装、支付手续费等日常成本从平台分成中承担,不临时向用户扣减 | 已确认 |
CW-026 |
用户负数账本 | 用户云仓账本不得形成负余额;二次售后先冲减未入账账本和同持仓未来应付,最终仍不足的差额由平台风险金额承担,不从用户可用余额追扣;只有审核确认的错误入账才允许独立冲正 | 已确认 |
CW-027 |
首次退款 | 待选择或代销批次冻结前,用户可按整个订单明细申请首次退款;批次开始代销后不再转回普通首次退款流程 | 已确认 |
CW-028 |
邮寄补运费 | 需要补运费时,邮寄选择在补运费支付成功后才最终生效;运费支付截止取“支付超时点”和“去向选择截止点”的较早值,截止任务先取消未成功运费单再自动代销,迟到成功只退款 | 已确认 |
CW-029 |
首次购买完成 | 邮寄以确认/自动收货、代销以持仓进入正式批次认定;自提可分次核销,已核销数量按核销事实完成,订单明细在全部数量完成核销、退款、改寄或异常回购后整体完成 | 已确认 |
CW-030 |
自提逾期 | 自提期限默认最终确认后 7 个自然日,活动商品可选 1 至 30 天;逾期进入异常待处理,剩余量可延期自提、补邮费改寄、退款或按活动回购比例由平台回购,回购只返对应本金且不加入已运行代销批次 | 已确认 |
CW-031 |
周期与分成 | 同一活动 SKU 批次只有一个预计销售周期和一组分成率;同一来源商品参加不同活动时可以使用不同配置 | 已确认 |
CW-032 |
活动库存前置 | V1 只有已完成平台仓入库或等价供货验收的真实库存才能配置为云仓活动库存,活动量不得超过验收可用量 | 已确认 |
CW-033 |
分成校验 | 用户收益分成率与平台收益分成率之和必须等于 100%;分成只作用于可分配销售利润 | 已确认 |
CW-034 |
回购审批 | 批次到期停止新分配,并在默认 30 天、可选 7 至 60 天的在途处置宽限期后冻结最终归属;自动计算回购预案并转入不可售待回购池,V1 经平台人工审核后原子完成用户账本、平台库存转入和回购事实 | 已确认 |
LA-001 |
租地模式 | 用户选择农场、区域、租赁套餐和作物,支付后由系统锁定并分配真实地块或地块占用单元 | 已确认 |
LA-002 |
地块复用 | 物理地块与本次租赁周期分开建模,通过地块占用周期管理同一地块的多期使用 | 已确认 |
LA-003 |
认养模式 | 牛、羊、猪等大牲畜采用单体认养;鸡群、蜂箱、蛋品等采用批次份额认养 | 已确认 |
LA-004 |
套餐承诺 | 租地/认养套餐以约定交付数量或最低交付数量作为履约口径,真实地块或养殖资产作为生产和溯源载体 | 已确认 |
LA-005 |
产出去向 | V1 的租地收成和认养产出只进入邮寄到家履约,不进入用户云仓或代销收益链路 | 已确认 |
LA-006 |
分批履约 | 同一租地/认养订单允许生成多次采收、产出和邮寄履约单;平台主动分批产生的额外运费由平台承担,用户主动拆包或升级配送才重新报价 | 已确认 |
LA-007 |
农业异常 | 减产、死亡、延期、品质或物流异常必须生成不可变方案;等价替换、确认期限、超时结果、短缺分配和未履约退款均按套餐快照执行,退款使用交付退款基数的累计差额公式 | 已确认 |
LA-008 |
资产分配预留 | 地块和认养候选查询不占容量;平台执行分配时先建立默认 5 分钟临时预留,确认时原子重查容量和版本,主动释放或超时均保留历史 | 已确认 |
TR-001 |
溯源粒度 | V1 以生产批次和采收/产出批次为主,大牲畜额外支持个体耳标或资产编号 | 已确认 |
TR-002 |
溯源链路 | 农场/区域/地块或养殖资产 → 生产批次 → 过程记录 → 采收/产出批次 → 报告证书 → 商品/订单 | 已确认 |
TR-003 |
发布机制 | 农事、养殖和溯源内容采用草稿、待审核、已发布、已撤回状态;已发布内容修改时保留版本 | 已确认 |
| 术语 | 定义 |
|---|---|
| 云仓秒杀活动 | 平台在营销体系中创建的云仓限时抢购活动,可包含多个活动商品 |
| 云仓活动商品 | 某个 SPU 参加某场云仓活动的公共展示和去向配置,可包含多个活动 SKU |
| 云仓活动 SKU | 用户可抢购的最小活动商品,独立配置价格、库存、限购、周期、分成、结算和回购规则 |
| 云仓批次 | 某场活动中某个商品 SKU 的独立经营批次,是库存、进度、二次销售和结算的最小公共批次 |
| 首次购买 | 用户在集市云仓中完成的抢购付款,表示用户取得对应数量商品的处理权 |
| 去向选择 | 用户付款后为整个订单明细选择邮寄到家、线下自提或平台代销 |
| 待选择 | 首次购买已付款,但订单明细尚未确定最终去向 |
| 用户云仓持仓 | 用户选择代销后,在某云仓批次中持有的代销数量、成本和规则快照 |
| 代销周期 | 批次冻结代销数量后,到预计到期日或提前全部有效售完之间的经营周期 |
| 二次零售订单 | 平台将云仓批次商品再次通过 CRMEB 商城卖给普通消费用户形成的真实零售订单 |
| 有效代销售出 | 二次零售订单明细已完成并超过售后观察期,未退款、未冻结的销售数量与金额 |
| 批次销售进度 | 批次累计有效代销售出数量 ÷ 批次冻结代销数量 |
| 批次结束 | 批次全部有效售完,或到期后完成剩余商品回购和全部应结算金额核算 |
| 用户本金 | 用户首次购买时为进入代销的商品数量支付的商品价款,不含后补运费 |
| 用户收益 | 批次可分配销售利润按用户持仓占比和用户收益分成率计算的金额 |
| 本金返还 | 已售商品对应本金或到期回购款按结算模式释放给用户 |
| 回购 | 代销周期到期后,平台按活动快照比例取得剩余商品所有权并向用户支付回购金额 |
| 商户供货货款 | 平台按供货价或已确认的商户结算模式,针对首次有效购买数量应结算给商户的金额 |
| 商户供货结单 | 按商户和自然日归集已具结算资格供货账本的不可变清单,是进入商户可用余额的依据 |
| 正式入账记录 | 将用户业务账本或商户供货结单原子映射到 CRMEB 最终账户和现有流水的唯一幂等记录 |
| 云仓补运费单 | 用户首次商品付款后选择邮寄时产生的独立平台收款单,不改变商品本金订单、商户货款或代销收益 |
| 补运费迟到支付 | 运费单已取消/超时或订单明细已转为其他去向后,渠道才确认收款;当前去向保持不变并全额退款 |
| 地块占用周期 | 真实物理地块在某一时间范围内分配给某个租地订单或种植批次的记录 |
| 单体认养 | 一个用户订单关联一个可唯一识别的养殖资产 |
| 批次份额认养 | 用户订单持有一个养殖批次中的约定份额,不虚构一一对应的动物个体 |
| 生产批次 | 一次种植或养殖经营周期,是过程记录和溯源的主对象 |
| 采收/产出批次 | 某生产批次的一次实际收成或产出,可关联多个商品 SKU、履约单和溯源档案 |
| 参数 | V1 默认值 | 配置层级 |
|---|---|---|
| 去向选择期限 | 活动结束后 3 个自然日 | 活动商品可选 1 至 7 天 |
| 超时默认去向 | 平台代销 | V1 固定 |
| 自提核销期限 | 最终确认后 7 个自然日 | 活动商品可选 1 至 30 天 |
| 结算进度节点 | 25%、50%、75%、100% | V1 固定 |
| 云仓结算模式 | 分期本金和收益 | 活动 SKU 可覆盖 |
| 到期回购比例 | 100% | 活动 SKU 可选 100%、90%、80% 或自定义 |
| 到期在途处置宽限期 | 30 个自然日 | 活动 SKU 可选 7 至 60 天 |
| 云仓商户结算方式 | 按供货价结算 | V1 固定 |
| 商户普通商品售后观察期 | T+7 | 商品可按固定选项覆盖 |
| 云仓首次交易售后观察期 | T+7 | 活动 SKU 可按固定选项覆盖 |
| 二次零售售后观察期 | T+7 | 活动 SKU 可按固定选项覆盖 |
| 售后观察期选项 | T+0、T+3、T+7、T+15、T+30、手动 | 商品或活动商品选择,默认 T+7 |
| 资产分配临时预留 | 5 分钟 | V1 固定 |
| 农业延期容忍期 | 7 个自然日 | 套餐必填,可选 0、3、7、15、30 天 |
| 农业异常方案确认期 | 3 个自然日 | 套餐快照,V1 固定 |
| 商户供货结单周期 | 每日 02:00 归集上一自然日 |
V1 固定,可在后续版本评估周结/月结 |
| 用户单笔自动入账上限 | 10,000 元 | 系统配置,超限转人工复核 |
| 用户自然日自动入账上限 | 50,000 元 | 系统配置,超限转人工复核 |
| 商户单张结单自动入账上限 | 100,000 元 | 系统配置,超限转人工复核 |
| 补运费支付截止 | min(运费单创建时间 + 活动支付超时, 去向选择截止时间) |
到点先关闭运费单,再按选择规则处理 |
| 补运费迟到支付处理 | 原渠道全额退款 | V1 固定,不恢复邮寄去向 |
| 账本精度 | 金额以分为最终分配单位,中间金额至少保留 8 位小数 | V1 固定 |
| 经济等价数量精度 | 6 位小数 | 只用于用户占比和预计/结算展示;实体库存仍为整数 |
所有“自然日”按 Asia/Shanghai 计算:事件发生当日不计为第 1 日,次日为第 1 日,第 N 日 23:59:59 截止。金额分摊采用最大余数法,余数从大到小分配最后若干分钱;余数相同时按 holding_id 升序,保证用户明细合计严格等于批次金额。
当前阶段先完成产品、业务、流程、数据、接口、原型、测试和运营使用规则。法律条款、税务处理和正式财务会计科目不作为当前需求定稿的阻塞条件,待上线准备阶段另行评审。
这不影响当前必须设计清楚的技术资金事实,包括支付、退款、优惠承担、商户货款、用户本金返还、用户收益、回购和账本冲正。
修改本文件任一决策前,至少检查以下影响:
- 用户端页面文案、交互和协议确认。
- 平台端活动配置、审核和批次操作。
- 商户端供货、入库、订单和结算展示。
- 订单状态、库存池、定时任务和消息提醒。
- 商户货款账本、用户本金账本、收益账本和回购账本。
- 数据库字段、索引、幂等键和历史快照。
- API 入参、出参、错误码与权限。
- 测试用例、初始化数据和管理员/商户/用户使用说明。
- 首页
- 项目总览
- 项目立项
- 端与角色
- 供应链经营闭环
- 模块地图
- V1 范围 PRD
- 任务拆解
- 结算与账本
- V1 结算口径
- 云仓秒杀
- CRMEB 底座能力映射
- 当前菜单页面审计
- V1 决策与术语
- 云仓流程与状态机
- 租地认养与溯源 PRD
- V1 数据模型草案
- 开发前设计计划
- V1 信息架构
- 页面与原型规格
- V1 API 契约草案
- 事件任务权限通知
- 五项目代码改造蓝图
- 测试验收发布与手册计划
- CRMEB 视觉基线审计
- G3/G4 决策登记表
- 用户端 uni-app 复用审计
- 开发前主清单
- 自主设计工作指引
- V1 需求追踪矩阵
- G3 技术专项验证报告
- V1 P0 页面矩阵
- 写操作契约注册表
- 事件任务操作注册表
- 状态异常事务矩阵
- 数据库字段字典
- 页面 API 文件追踪
- V1 ER 图
- API 字段契约注册表
- 平台管理员手册
- 商户手册
- 用户帮助
- 服务与现场手册
- 开发任务包
- 测试目录与 Fixtures
- 发布与运维手册
- 设计交付与研发交接