郑龙捷
7d5e3e9a50
- 删除模型大类概览和细分银行概览中原型未包含的过渡跳转按钮，保留卡片点击、筛选、指标趋势和详情入口。 - 移除运维系统配置页中的模型平台新增页面依赖、登录角色来源等内部说明，仅保留实际配置内容。 - 将开发工作台访问控制统一收敛到 dashboard:view，业务团队仅保留运维工作台权限；直接访问开发工作台时自动回到运维工作台。 - 补充架构实现基线、外部写入协议、运维 API 清单、三角色权限验收说明和首条纵向链路联调手册。 - 按当前实现更新架构变更记录和本周目标完成情况。
3.2 KiB
3.2 KiB
A 卡模型运维模块首条纵向链路联调手册 V0.1
状态：接口和前端调用已完成；真实非空数据到位后即可执行 日期：2026-09-02
一、联调目标
验证以下链路使用同一套模型和监控结果口径：
model_deploy / model_operations
→ GET 模型列表
→ GET 模型详情
→ GET 指定月份监控结果
→ React 页面展示
二、前置条件
- 后端已配置
model_platform、model_deploy和model_operations三个数据库连接。 - 前端
VITE_OPERATIONS_API_MODE=api。 - 已执行数据库初始化和角色权限 SQL。
- 已有一个可访问目标 Workspace 的登录账号。
- 模型方按《数据库外部写入协议》提供最小非空数据。
三、请求顺序
以下命令中的 <workspace_id>、<model_id> 和 <cookie> 替换为实际值。
3.1 检查服务
curl -i http://127.0.0.1:8010/api/v1/health
curl -i http://127.0.0.1:8010/api/v1/operations/health
3.2 获取当前会话和权限
curl -sS \
-H 'Cookie: access_token=<cookie>' \
http://127.0.0.1:8010/api/v1/auth/me
确认返回 role_code、permissions 和目标 Workspace。
3.3 查询模型列表
curl -sS \
-H 'Cookie: access_token=<cookie>' \
'http://127.0.0.1:8010/api/v1/operations/models?workspace_id=<workspace_id>'
记录返回的 model_id、模型名称、版本和银行。
3.4 查询模型详情
curl -sS \
-H 'Cookie: access_token=<cookie>' \
'http://127.0.0.1:8010/api/v1/operations/models/<model_id>?workspace_id=<workspace_id>'
核对列表与详情的银行、模型名称、模型 ID、版本、KS、PSI 和排序性。
3.5 查询单月监控结果
curl -sS \
-H 'Cookie: access_token=<cookie>' \
'http://127.0.0.1:8010/api/v1/operations/models/<model_id>/monitor-results?workspace_id=<workspace_id>&month=2026-07'
核对详情页和单月接口的监控月份、KS、PSI、排序性、环比降幅和异常命中次数。
四、前端验收路径
- 打开
/operations/models。 - 从模型列表点击目标模型。
- 进入模型监控详情。
- 选择目标监控月份。
- 检查页面顶部模型信息和单月监控结果。
- 打开浏览器 Network，确认三次请求均为
/api/v1/operations/*，没有本地 Mock 请求。
五、空数据验收
在模型方数据未到位前，也应确认：
- 模型列表页面正常展示空列表，不跳转说明页。
- 工作台 KPI 卡片保留且显示 0。
- 缺表时返回明确的
OPERATIONS_SCHEMA_NOT_READY。 - 不存在月份返回
MONITOR_RESULT_NOT_FOUND，详情页面保持结构。 - 前端没有硬编码模型、银行、报告和流程示例数据。
六、最终验收标准
真实非空数据到位后，以下内容必须全部满足：
- 列表返回至少 1 个模型。
- 列表点击可以进入详情。
- 详情可以获取指定月份结果。
- 三个接口中的模型 ID、版本、月份、KS、PSI、排序性一致。
published批次可见，writing、failed和superseded批次不可作为当前结果展示。- 业务团队、模型团队和管理员分别通过权限验收。