Neo-ZQYY/docs/audit/changes/2026-02-14__replace-role-area-new-api-doc.md

替换 role_area_association 为 member_consumption_statistics + 文档更新 — 审计记录

Prompt-ID: P20260214-083000

日期

2026-02-14（Asia/Shanghai）

原始原因

用户 Prompt（P20260214-083000，已脱敏）：

role_area_association 替换成：统计某种卡的合计余额。卡种为 cardTypeId，cardTypeId 不传此值则全部卡。 fetch("https://pc.ficoo.vip/apiprod/admin/v1/MemberProfile/QueryMemberConsumptionStatistics", {...}) 重新获取，放入示例库，撰写文档。tenant_member_balance_overview：recharge_card_list 和 give_card_list 要展开。 完成以上任务，给我 2 个表的新的设计方案。

（Authorization Bearer token 已脱敏为 [REDACTED]）

直接原因

1. role_area_association 是权限配置查询，非业务数据，不适合入 ODS。用户要求替换为 QueryMemberConsumptionStatistics（会员消费统计），该接口按门店维度统计卡种资金流向，有明确的 ODS 入库价值。
2. tenant_member_balance_overview 的 rechargeCardList / giveCardList 需要展开为独立列（而非 JSONB），以便 DWS 层直接查询。

Changed

文件	变更类型	说明
docs/api-reference/samples/member_consumption_statistics.json	新建	新 API 的 JSON 样本
docs/api-reference/samples/role_area_association.json	删除	旧 API 样本
docs/api-reference/member_consumption_statistics.md	新建	新 API 参考文档（11 个字段详解）
docs/api-reference/role_area_association.md	删除	旧 API 文档
docs/api-reference/endpoints/role_area_association.md	删除	旧 API 文档副本
docs/api-reference/api_registry.json	修改	替换 role_area_association 条目为 member_consumption_statistics；tenant_member_balance_overview 的 ods_table 从 null 改为表名
docs/api-reference/README.md	修改	索引表更新
docs/api-reference/tenant_member_balance_overview.md	修改	ODS 表标注从"无"改为"待建"

Risk / Verify

• 风险：纯文档变更，无运行时影响。role_area_association 的旧文档已删除，如需恢复可从 git 历史找回。
• 验证步骤：
  1. ls docs/api-reference/samples/member_consumption_statistics.json → 文件存在
  2. ls docs/api-reference/member_consumption_statistics.md → 文件存在
  3. python -c "import json; d=json.load(open('docs/api-reference/api_registry.json')); ids=[x['id'] for x in d]; assert 'member_consumption_statistics' in ids; assert 'role_area_association' not in ids; print('OK')" → OK