三类建议单的状态与幂等
全文共 2208 字,阅读约需 5 分钟
三类建议单的状态与幂等:这套补课把同一瓶合成的柠檬茶,从销售记录、订单、仓库、工厂、物料清单一直追到预测、建议单、审批和模拟反馈。读者只需会四则运算、百分数和平方根。每章先手算,再运行程序,最后故意破坏一个输入,看系统有没有拒绝错误。
课程目录与学习记录 0 / 109
学习进度仅存于本机浏览器。原教程站的记录不会跨域自动迁移;可先在原站导出留存,新站按实际完成情况重新勾选。
入门数据与作业包
禾味数据为 2 店 × 8 SKU × 180 天,共 2,880 行,是可见教学数据,不是封存盲测集。起步包是模拟夹具,不表示已完成六行业预测实验。资源中心另有四专项工程、模型实验和计划实验,使用前请阅读各自能力边界。
新增离线教学实验,非生产流程。下载核心12章实验包。core-13已新增有限预售/PO/STO/WO联合实验;通用跨期联合优化未实现,审批、回写和执行仅在本地模拟。
共同运行方法与边界
从数据到离线决策的十二个补充实验
这套补课把同一瓶合成的柠檬茶,从销售记录、订单、仓库、工厂、物料清单一直追到预测、建议单、审批和模拟反馈。读者只需会四则运算、百分数和平方根。每章先手算,再运行程序,最后故意破坏一个输入,看系统有没有拒绝错误。
所有商品、销量、价格、人物角色和指标都是合成数据。所有订单、价格、曝光与反馈都只写入本地模拟账本。没有真实采购、调拨、制造、营销、食品放行或对外发送。 这些实验展示机制,不能作为生产就绪、真实收益、质量安全认证或完整企业系统的证明。
主商品是 SPU TEA 下的 SKU T-L(500 ml
柠檬茶一瓶)。另一 SKU T-P 只在流量实验作为桃茶对照。SKU
是可独立计数的商品,SPU 是产品家族。这里“一瓶”记作 ea;6
瓶为一箱。原料有糖浆 R-SYRUP、包装膜 R-FILM
和空瓶 R-BOTTLE。
统一决策时点为 2026-06-15 08:00 UTC,主要计划到货日为
06-17。event_date 是业务发生日期;target_date
是记录适用的预测/计划日期;known_at
是我们最早能使用这条记录的时间。三个字段不能互换。
阅读与运行
解压 forecast-core-gap-labs.zip,进入包目录,用 Python
3.10 或更高版本运行:
python core_lab.py --self-test只依赖 Python 标准库,不需要联网、账号、密钥或安装第三方包。程序读取
data/ 下的 CSV/JSON,输出
output/report.json、policy_daily.csv、orders.csv、approval_audit.csv
和 four_dimensions.csv。正常运行不会重建输入,所以修改 CSV
后能观察结果变化。--generate-fixtures
会明确重建合成输入,只在想恢复初始数据时使用。非法选项退出码为
2,不能当作实验通过。
所有练习修改都应在复制出来的实验目录做。--self-test
包含初始数据的标准答案断言,修改数据后这些断言可能失败,这正是需要解释的差异。想只计算修改后的输入,用
python core_lab.py --output-dir output_changed。不要为了得到“全部通过”而把错误答案写进断言。
预期阅读顺序:业务限制 → 主数据 → 可得时点 → 四层链路 → 补货算式 → 预售与来源分配 → 状态机 → 库存差异 → 采纳 → 三指标 → 流量 → 事件联动。每章的需求编号用于追溯原范围,不代表该范围已由独立审查判定完整。
core-07 三类建议单的状态与幂等
覆盖 A09。目标是在断网重试、重复回执和修改数量时,账本仍只记一次正确变化。
1 状态是门而不是标签
基本路径:DRAFT → VALIDATED → PENDING_APPROVAL → APPROVED → MOCK_SENT → PARTIALLY_FILLED → COMPLETED。审批也可到
REJECTED。箭头表示允许的一步;不能从草稿直接跳完成。
- DRAFT:数量和版本仍可修改。
- VALIDATED:通过单位、箱规和适用的资源检查。
- PENDING_APPROVAL:等待对应职责角色。
- APPROVED:批准的是确切版本和数量。
- MOCK_SENT:本地适配器已接受,不代表货到。
- PARTIALLY_FILLED:有唯一反馈,但累计数量未满。
- COMPLETED:反馈累计等于批准数量。
PO由采购经理批准,STO由物流经理,WO由生产经理。提出者planner不能自己批准。角色只是模拟字符串,不是身份认证。
2 修改后为什么要重新批准
批准摘要包括种类、业务ID、数量、修订号和动作详情。摘要hash可以理解为内容指纹:内容变了,指纹也应变。原单60瓶批准后改66瓶,旧批准不能沿用;STALE_OR_MISSING_APPROVAL会挡住。
正规修改会增加revision、保留修改理由并退回DRAFT。已经发出或部分完成的单不能直接重写;需要另外的撤回/冲销流程,本包没有实现真实撤销。
3 两层幂等
“幂等”就是同一件事重复传来,效果仍只有一次。
发送键:种类:业务ID:修订号。重复相同键和相同内容返回原回执;相同键内容不同必须冲突,不能把它当新单。
反馈键:唯一event_id。PO60第一条反馈36瓶,再来一次同一event_id的36瓶,不重复增加库存。第二个event_id反馈24瓶后累计36+24=60。若同一反馈ID从36改30,必须报告冲突。
数量守恒:未完成量 = 批准量 − 已完成量。第一条后60−36=24;第二条后0。不能接受66瓶回执,不能产生负的未完成量。
4 超时不是失败的证明
故障模式“适配器接受后回执丢失”会抛超时。此时不能新建第二个业务ID再发一单。先查/重用原幂等键,拿回已经存在的接受记录。测试
test_uncertain_ack 模拟了这个顺序。
5 项目与答案
输入基础计划三张单;输出
approval_audit.csv、订单状态及模拟账。三张单只产生三个发送接受记录,PO两次到货加STO一次、WO一次,共四次库存效果。全部发送和反馈再播一次,库存摘要完全相同。
练习:PO已经收36,还能把批准量直接改24吗?答案:不能;24是剩余未完成量,不是新的总批准量。调拨60以后远仓应为84−60=24,重放不得变为−36。
故障注入:错误角色批准、跳过提交、批准后直接改数量、重复不同内容的反馈、超额反馈,均有拒绝测试。
边界: 幂等表在单次Python进程内保存,示范事件重播,不保证进程重启后持久化恢复;没有数据库事务、分布式锁、真实鉴权或外部系统的exactly-once承诺。
仅保存在本机当前浏览器,无账号云同步;清除浏览器数据会丢失。不自动认定你通过测试。建议先保留输出文件和计算过程。
所有数据、系数与业务场景均为教学模拟。预测不等于采购或排产指令。来源与修订说明。