数据治理与 API 管理

01 功能入口与分工

「数据治理」包含三个当前入口：

• 数据质量：查看业务数据集的健康状态、可用行、异常行、运行阶段和最近可用产物。
• 国家&区域：维护国家与区域关系，供销售目标、视图和其他范围治理使用。
• API 管理：查看提取器、同步任务、接口目录及最近健康检查证据。

三个页面分别受读取和动作权限控制。接口管理权限不能替代店铺、利润、物流等业务模块自己的同步权限；没有业务权限时，不能借通用任务绕过。

02 阅读数据质量状态

1. 先选择数据来源或目标数据集，确认当前查看的是哪条业务链路。
2. 区分核心业务数据、补充数据、可用行和待处理异常。
3. 检查最近运行状态、正式产物时间及是否沿用上次成功结果。
4. 展开详情查看失败阶段与可重试范围，再交给对应负责人。

警告不一定代表整个数据集不可用。例如物流轨迹或详情补充失败时，核心订单仍可能可用；页面会把待处理异常与业务终态忽略项分开。

03 API 目录与健康检查

API 管理以服务端目录为当前事实源，展示来源路径、数据粒度、产物、管理方式和排程所有者。前端静态目录仅在接口失败时提供只读降级，不代表运行时现状。

查看最近健康结果时，先区分连通性、Dry Run 与正式同步：健康检查使用有界样本验证接口和转换，不会替代业务同步，也不会写入正式业务表。手工执行健康检查需要专门权限；完成后应查看每个提供方的真实结果。

接口限流、鉴权、网络和转换错误含义不同。排查时记录提供方、接口名称、检查时间和错误类别，不只截取一个总状态。

04 国家与区域配置

国家区域映射影响业务视图、销售目标区域归并及其他范围选项。修改前应核对平台、国家、区域和当前启用状态，并确认下游影响。

销售目标主国家在同一区域内具有专门含义：设置后，同区域其他启用国家只在销售目标模块并入主国家。切换或停用主国家会产生治理变化，不应理解为通用地理数据被删除。

保存后到实际使用页面核对候选项和结果范围。历史快照或已经生成的业务结果不会因为治理配置变化自动改写。

05 常见问题