[refactor] 退款域业务代码零读 ods:全状态场景迁 std_*_all 镜像视图 #334

New Issue

tanzk · 2026-10-19T07:09:12+08:00

tanzk commented

2026-10-19 07:09:12 +08:00

目标：退款域业务代码零读 ods 原始层——全状态语义场景统一迁到 std 层全量镜像视图，ods 回归「仅供数 + 被治理」单一角色。

背景：#332 完成后审计发现仍有 7 类界面/分析读点直读 ods（均已声明例外）。用户拍板：全部迁移使用新表。

方案：

新增 5 个全量镜像视图 std_refund_online_all / std_wallet_flow_all / std_refund_shanmao_all / std_refund_manual_all / std_refund_record_all（SELECT * FROM ods.*，ods 在 T1 已带采纳四列）
经营统计继续读 std_* 采纳集（不动）；全状态场景改读 std_*_all
ods 仅保留：采集写入、采纳作业读取、质量治理标记

迁移范围（7 类读点）：

退款挽回专项 5 接口（_refund_recovery_core + person_devices/device_analysis/device_detail/recovery_analysis）
状态分布桶（refund_overview）
今日看板退款工作量（today/_staff）
导出原始明细 3 个 sheet（refund_export_all）
链路分析台账（refund_chain A 路径/沉淀清单/钱包台账）
设备档案/审计时间线退款记录（device_profile/audit_timeline）
决策概览·手动登记进水 + 对账勾稽匹配（reconcile/matcher E 勾稽桥）

验收标准：

5 个镜像视图经 Alembic 迁移落库，含 downgrade
业务代码 grep FROM (ods.)?(refunds|wallet_withdrawals|shanmao_refunds|manual_refunds|refund_record_reports) 仅剩采集/采纳/治理三类本职消费
全量 ruff + pytest 全绿
口径文档与 AGENTS.md 铁律 15 补「全状态语义也走 std_*_all」条款
标准发布生产 + 生产核验（各看板数字与迁移前一致）

**目标**：退款域业务代码零读 ods 原始层——全状态语义场景统一迁到 std 层全量镜像视图，ods 回归「仅供数 + 被治理」单一角色。 **背景**：#332 完成后审计发现仍有 7 类界面/分析读点直读 ods（均已声明例外）。用户拍板：全部迁移使用新表。 **方案**： - 新增 5 个全量镜像视图 `std_refund_online_all` / `std_wallet_flow_all` / `std_refund_shanmao_all` / `std_refund_manual_all` / `std_refund_record_all`（`SELECT * FROM ods.*`，ods 在 T1 已带采纳四列） - 经营统计继续读 `std_*` 采纳集（不动）；全状态场景改读 `std_*_all` - ods 仅保留：采集写入、采纳作业读取、质量治理标记 **迁移范围**（7 类读点）： 1. 退款挽回专项 5 接口（`_refund_recovery_core` + person_devices/device_analysis/device_detail/recovery_analysis） 2. 状态分布桶（refund_overview） 3. 今日看板退款工作量（today/_staff） 4. 导出原始明细 3 个 sheet（refund_export_all） 5. 链路分析台账（refund_chain A 路径/沉淀清单/钱包台账） 6. 设备档案/审计时间线退款记录（device_profile/audit_timeline） 7. 决策概览·手动登记进水 + 对账勾稽匹配（reconcile/matcher E 勾稽桥） **验收标准**： - [x] 5 个镜像视图经 Alembic 迁移落库，含 downgrade - [x] 业务代码 grep `FROM (ods.)?(refunds|wallet_withdrawals|shanmao_refunds|manual_refunds|refund_record_reports)` 仅剩采集/采纳/治理三类本职消费 - [x] 全量 ruff + pytest 全绿 - [x] 口径文档与 AGENTS.md 铁律 15 补「全状态语义也走 std_*_all」条款 - [x] 标准发布生产 + 生产核验（各看板数字与迁移前一致）

tanzk referenced this issue from a commit

2026-10-19 08:30:33 +08:00

refactor(refund): #334 退款域业务代码零读 ods —— 全状态场景迁 std_*_all 镜像视图

tanzk commented

2026-10-19 08:36:44 +08:00

关闭凭证核验 (2026-10-19)

验收标准	核验方式	结果
5 个镜像视图经 Alembic 迁移落库含 downgrade	迁移 `b443c1a2d3e4`；生产 `alembic_version=b443c1a2d3e4`；五视图行数与 ods 源表逐一相等（204914/37604/2091/10652/40459）	✅
业务代码 grep 仅剩采集/采纳/治理三类本职消费	`grep 'FROM refunds\|wallet_withdrawals\|shanmao_refunds\|manual_refunds\|refund_record_reports\|FROM ods.'` backend/app/services 仅剩 quality_disposition_service（质量治理本职）+ governance 采纳/维表作业	✅
全量 ruff + pytest 全绿	`ruff check app/ tests/` All checks passed；全量 pytest 2513 用例第二轮 0 FAILED（首轮 5 个为既有串扰 flake，单跑全过、重跑收敛）	✅
口径文档与 AGENTS.md 铁律 15 补「全状态语义也走 std_*_all」条款	docs/standards/退款五路数据标准与采纳规则.md §架构图+#334 分层补全；AGENTS.md 铁律 15 末款（commit b5b7b8a）	✅
标准发布生产 + 生产核验	`deploy/upgrade.sh --git --branch main` → git-20261019003208；health=ok；A 路采纳 48,622/excluded 156,292，最新作业 2026-10-19 08:06 自动增量成功；决策概览 10-01~18 A 路 2,641 笔/¥345,907.57（与迁移前口径一致，差异仅为期间增量流水）	✅

迁移明细：analytics/refund.py 18 处、refund_chain.py 3 处、today/_staff.py 2 处、device_profile 5 处、audit_timeline 7 处、reconcile_check 24 处、matcher 8 处、reconcile.py 7 处（读；写路径一律不动仍落 ods）。quality_disposition_service 保留 ods 读（质量治理本职，铁律第三本职）。

结论：退款域业务代码零读 ods，ods 回归「采集写入/采纳作业/质量治理」三本职。

## 关闭凭证核验 (2026-10-19) | 验收标准 | 核验方式 | 结果 | |---|---|---| | 5 个镜像视图经 Alembic 迁移落库含 downgrade | 迁移 `b443c1a2d3e4`；生产 `alembic_version=b443c1a2d3e4`；五视图行数与 ods 源表逐一相等（204914/37604/2091/10652/40459） | ✅ | | 业务代码 grep 仅剩采集/采纳/治理三类本职消费 | `grep 'FROM refunds\|wallet_withdrawals\|shanmao_refunds\|manual_refunds\|refund_record_reports\|FROM ods.'` backend/app/services 仅剩 quality_disposition_service（质量治理本职）+ governance 采纳/维表作业 | ✅ | | 全量 ruff + pytest 全绿 | `ruff check app/ tests/` All checks passed；全量 pytest 2513 用例第二轮 0 FAILED（首轮 5 个为既有串扰 flake，单跑全过、重跑收敛） | ✅ | | 口径文档与 AGENTS.md 铁律 15 补「全状态语义也走 std_*_all」条款 | docs/standards/退款五路数据标准与采纳规则.md §架构图+#334 分层补全；AGENTS.md 铁律 15 末款（commit b5b7b8a） | ✅ | | 标准发布生产 + 生产核验 | `deploy/upgrade.sh --git --branch main` → git-20261019003208；health=ok；A 路采纳 48,622/excluded 156,292，最新作业 2026-10-19 08:06 自动增量成功；决策概览 10-01~18 A 路 2,641 笔/¥345,907.57（与迁移前口径一致，差异仅为期间增量流水） | ✅ | 迁移明细：analytics/refund.py 18 处、refund_chain.py 3 处、today/_staff.py 2 处、device_profile 5 处、audit_timeline 7 处、reconcile_check 24 处、matcher 8 处、reconcile.py 7 处（读；写路径一律不动仍落 ods）。quality_disposition_service 保留 ods 读（质量治理本职，铁律第三本职）。结论：退款域业务代码零读 ods，ods 回归「采集写入/采纳作业/质量治理」三本职。

tanzk closed this issue

2026-10-19 08:36:45 +08:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: tanzk/csctalon#334