feat(fulfillment): 建立正式履约影子模型

This commit is contained in:
yml2213
2026-11-05 21:07:11 +08:00
parent b424333a30
commit bd7dd4efcc
6 changed files with 1110 additions and 5 deletions
+1 -1
View File
@@ -1,6 +1,6 @@
# order_site 文档索引
> 最后补充:2026-11-05,新增《履约系统架构复盘与优化方案》;生产代码基线 `e8b76b3b` / 迁移 `136`,开发分支 `dev_11.5_2` 已推进到迁移 `140`(履约统一状态写入口与追加事件)。
> 最后补充:2026-11-05,新增《履约系统架构复盘与优化方案》;生产代码基线 `e8b76b3b` / 迁移 `136`,开发分支 `dev_11.5_2` 已推进到迁移 `141`(履约统一状态、追加事件与正式影子模型)。
> 数据基线:生产 dump `backups/postgres/order_site-20261022-092601.dump`(数据 2026-07-10 ~ 2026-10-22);历史全量数字仅作基线,**上线验收以 [财务上线初始化与验收-2026-10-26.md](财务上线初始化与验收-2026-10-26.md) 为准**。
> 本文是 `docs/` 的唯一入口。**整体财务流程看 [财务流程总览-2026-11-01.md](财务流程总览-2026-11-01.md)**;数据模型看 [成本中心与履约模型.md](成本中心与履约模型.md),接口看 [成本中心API契约.md](成本中心API契约.md)。
> 新增文档必须在下表登记状态;过期文档不再直接改写结论,统一移入 `docs/archive/`。
@@ -10,7 +10,7 @@ status: draft
> 状态:**方案**,尚未实施。
> 最后校准:2026-11-05。
> 代码基线:`e8b76b3b` + `dev_11.5_2` 履约架构改造。
> 数据库基线:生产迁移 `136`;开发分支迁移 `140`。
> 数据库基线:生产迁移 `136`;开发分支迁移 `141`。
> 生产核对方式:只读 SQL、后台页面、现行文档与源码交叉检查。
## 实施进度
@@ -31,7 +31,10 @@ status: draft
- 已完成:人工履约配置、标准商品关联、自动发货/接单平台商品回填、模板重置和调度补挂统一通过状态映射接口写入,并校验并发期间的原商品值。
- 已完成:任务创建先锁订单项并复用已有活跃尝试,避免并发调度重复插入同一当前尝试。
- 已完成:新增真实 PostgreSQL 状态事件集成测试;全新库 `001 → 140` 迁移和既有履约路由集成测试通过。
- 待继续:正式 `fulfillments / attempts / issues` 表、独立售后队列和生产存量修复。
- 已完成:迁移 `141` 建立 `fulfillments / fulfillment_attempts / fulfillment_issues` 影子模型,从现有读模型回填,并由订单项、任务、工单触发器持续双写。
- 已完成:审计脚本增加影子履约、尝试、开放异常和事件关联差异检查;当前读路径仍保持原表,未切换。
- 已完成:修正统一视图“明确渠道仍被判定为缺渠道”的旧口径,已有渠道直接视为已路由。
- 待继续:观察生产影子差异、切换读路径、停止旧字段写入、独立售后队列和生产存量修复。
### 历史数据边界