bridge

风控审核数据桥。把上游 1B 运营后台的订单、账变、下注等原始数据同步到 ClickHouse，并按《风控判断所需数据与后台位置清单》提供用户审核快照。只读，不对上游做任何写操作。除 /api/health 外，所有接口需要请求头 X-Api-Key。

GET/api/risk/users/{userId}/review-snapshot

需求清单 §三的统一接口。一次返回 20 类数据源，每类带 status（SUCCESS / EMPTY / FAILED / PARTIAL / NOT_CONFIGURED）、上游来源、后台位置、拉取时间；completeness.recommendation_mode 为 AUTO_ALLOWED 或 MANUAL_REVIEW_ONLY（任一核心数据源 FAILED）。默认先对该用户做一次增量同步（60 秒内做过则跳过）再从 ClickHouse 读；库不可用时回退直连上游，data_source 与 meta.warnings 会说明。手机、卡号、IFSC、IP、邮箱在响应中脱敏。

调用

X-Api-Key

userId*path上游用户 IDdaysquery回溯窗口天数，1..180。订单、账变、下注、游戏分布都按此窗口取。rowsquery1 含明细行，0 只返回汇总（约 40 KB）max_rowsquery每类明细列表的上限，最新在前syncquery0 跳过读前的增量同步，直接读库sourcequerylive 强制直连上游，不走库

/api/risk/users/%7BuserId%7D/review-snapshot

curl -s -H 'X-Api-Key: <key>' '/api/risk/users/%7BuserId%7D/review-snapshot'

响应

200	ReviewSnapshot：snapshot_id, user_id, generated_at, data_source, window, completeness, domains, sources
400	userId 不是正整数
401	缺少或错误的 X-Api-Key
404	上游没有这个用户
502	上游接口异常
503	服务未配置密钥，或依赖不可用