Files
Neo-ZQYY/docs/audit
Neo 87a5e3b08e docs(audit): F1-5b MP-1 储值卡充值字段语义复核 (false alarm) (W1)
走查发现 board-finance "储值卡充值实收" 66000 vs ETL 直查 ~132000
2 倍差异,怀疑前后端字段错位。

复核结论:链路完全正确,无代码改动。
- 小程序 board-finance.ts L409 'recharge.actualIncome' ← 后端 actual_income
- 后端 fdw_queries:2825 SELECT SUM(recharge_cash) AS actual_income
- 用的是 recharge_cash(现金口径),非 recharge_total(全口径=cash+gift)

DB 直查 site=2790685415443269 / 2026-04 月度:
- recharge_cash  = 66998
- recharge_gift  = 66998
- recharge_total = 133996(= cash + gift,刚好 2 倍)

走查时 132000 = recharge_total(全口径),66000 = recharge_cash
(现金实收),两者本就不同语义。recharge_cash 是"实收"应有的现金
口径(赠送非真实现金流入,业务上不算"实收"),后端字段使用正确。

端到端验证(weixin-devtools-mcp + DB):
- sandbox=4-20: 小程序 actualIncome=66000(SQL stat_date<=4-20)
- 与 DB 全月 SUM(recharge_cash) 66998 差额 998 = 4-21 之后被
  sandbox 业务日上界裁剪(F1-5b T1/A1 收益,跨任务交叉验证)

留给 Wave B 的改进建议(非本次任务范围):
- 小程序 helpKey 'rechargeActual' 文案补充"现金口径(不含赠送)"
- DWS 视图列注释明确 cash/gift/total 三字段语义

审计:
- docs/audit/changes/2026-05-05__wave1_f1_5b_mp1_recharge_field_clarification.md

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-05 18:43:54 +08:00
..

审计目录docs/audit/

项目级统一审计落地点。所有模块ETL、后端、小程序、管理后台等的审计产物均写入此目录。

子目录与文件

目录/文件 说明
changes/ AI 逐次变更审计记录(<YYYY-MM-DD>__<slug>.md
prompt_logs/ Prompt 日志文件(每次 prompt 生成一个独立文件,按时间戳命名)
session_logs/ 全量会话记录(按 YYYY-MM/DD/ 分层),含双索引和 LLM 操作摘要。详见 SESSION-LOG-GUIDE.md
audit_dashboard.md 审计一览表(自动生成,勿手动编辑)
SESSION-LOG-GUIDE.md Session 日志使用指南(索引字段、查询方法、典型场景)

维护约定

  • prompt_logs/prompt-audit-log Hook 自动管理,请勿手动编辑
  • session_logs/agentStop Hook 自动提取,索引由提取脚本自动更新
  • audit_dashboard.md/audit 流程自动刷新,也可通过 python scripts/audit/gen_audit_dashboard.py 手动重新生成
  • 变更审计记录由 /audit 流程audit-writer 子代理)生成,包含 session_id 字段与 Session 日志双向关联
  • 历史记录(迁移前 ETL 子项目的审计)已合并至此目录

审计追溯链

Prompt 日志 ←→ Session 日志 ←→ 变更审计记录
(用户说了什么)   (AI 做了什么)   (正式变更文档)

通过 Prompt-ID 和 Session-ID 可在三者之间双向追溯。详见 SESSION-LOG-GUIDE.md