第 7 页 · 文字版
07 从查询结果走到受控动作 可用量查询返回的是判断依据。预留动作会改变业务状态,两者不能混为一谈。Palantir 的动作提交条件 可以结合用户、参数、对象和关系设定;具体条件仍由团队设计。[S05]
教学计算的表达
对质检通过的候选批次,计算在库量减去有效预留量,再求和;其他批次本例不计入。查询同时返回所 用批次、质检依据、预留明细和数据时点。调用者得到 20 这个结果时,也应能说明它从哪里来。
教学动作契约 完整预留订单物料
契约项 本例约定
输入 订单 ID 物料 ID 请求数量 请求 ID;本例需完整预留 30 件
授权 只有被授权的计划员可提交;只读角色可查询
新请求须校验:订单可分配,请求量等于该物料待预留需求,数据时点满足政策, 前置条件 候选批次质检通过且当前可用量足够
成功结果 一次建立覆盖全部请求量的有效预留;返回预留 ID 及逐批占用数量
不足或冲突 不建立任何部分预留;返回不足或冲突,重新获取数据判断
同一请求 ID 且业务参数相同,返回已记录结果,不再次占库;参数冲突时拒绝复用 重复请求 该 ID
并发场景中,查询时足够不代表提交时仍足够。实施需要正确设计事务、冲突检测或由权威业务服务原 子完成校验与预留。仅配置一个表面条件,不能证明跨对象或外部系统的库存不变量已经安全。[S06]
上表是教学契约。幂等、权威服务调用和并发保护需要具体实现与测试,不是写成 Action 后全部自动得 到的保证。
文字版便于检索与复制,图表和排版请切回「图文」。