fix: docs

2026-06-13 11:44:15 +08:00
parent 0bcaa2db44
commit 9a1c92febf
10 changed files with 195 additions and 57 deletions
--- a/docs/sales_order_approval_and_red_flush.md
+++ b/docs/sales_order_approval_and_red_flush.md
@@ -68,13 +68,13 @@

 > 说明：在严出模式下，`consume_detail_ids` 列表中的 ID 必须为同仓库、同商户且未被消耗的入库明细 ID。系统会在审批通过时逐条扣减对应库存。

-## 8. 红冲（对冲）规划
+## 8. 红冲（对冲）落地状态

-与采购单一致，后续将通过库存红冲入口（`StockFlowService.offset_stock_change` 占位方法）实现销售单出库的反向抵销。关键原则：
+与采购单一致，销售单已支持整单红冲。已审批销售单可通过 `POST /api/v1/sales-orders/<id>/red-flush/` 触发，生成反向余额记录和反向库存记录。关键原则：

 - 采用新增反向记录的方式，保留所有历史变动。
 - 红冲记录需要指向原 `StockChangeRecord` / `StockSnapshot`，保证审计可追溯。
 - 红冲需与业务对象绑定，避免孤立库存操作。

-文档与测试应在红冲能力落地时同步更新，确保审批、出库、红冲形成闭环。 
+红冲能力已补充独立 API 文档与定向测试，确保审批、出库、红冲形成闭环。详细 API 见 `docs/2026-06-12_business_red_flush_api.md`。