model-platform/docs/database/A卡运维平台-功能页面表关系-V0.1.md

A 卡运维平台功能、页面与表关系 V0.1

日期：2026-09-01
依据：对外原型 V1.10、三库边界确认、model_platform 18 张表、model_deploy 16 张表及银行表待补结论。
状态：分析稿；用于共同确认 model_operations V0.2，暂不执行删表或改表。

1. 当前结论

最终系统由三个数据库组成：

• model_platform：模型开发平台，提供统一登录、角色、项目空间、脚本、调度和对象存储。
• model_deploy：模型部署平台，提供模型、版本、部署详情、运行节点和聚合监控指标；银行表及模型—银行关系由模型方补充。
• model_operations：我方运维业务库，承载判级、处理、报告、流程、文档、配置和操作统计。

已确认从我方库删除重复主数据表：

• ops_banks
• ops_model_instances
• ops_model_versions

删除后，我方目标表为 21 张。其中 16 张归属明确，5 张仍需共同决定是否保留为“标准化快照/读模型”。

2. 三库关联原则

• 不建立跨数据库物理外键。
• 我方内部主键继续使用 CHAR(26) ULID。
• 开发平台引用使用 platform_user_id/platform_workspace_id CHAR(26)。
• 部署平台引用使用 deploy_id/deploy_version_id/bank_id BIGINT，最终类型以模型方银行表为准。
• 报告、判级和流程必须保存生成时快照，不能因为模型方后续修改名称或版本而改变历史。
• 前端不直接访问数据库，全部通过我方后端聚合三个库的数据。

3. 前端页面与功能、表关系

对外原型 V1.10 当前共有 13 个前端页面，页面与数据关系如下。

前端页面	主要功能	我方表（model_operations）	外部只读表	主要写入动作
我的工作台	KPI、待办、关注、催办、最近动态	ops_monitor_evaluations、ops_monitor_reviews、ops_reports、ops_workflows、ops_workflow_stages、ops_usage_events	model_deploy、银行表；用户显示名来自 model_platform.users	页面本身只读；操作跳转到处理、报告或流程接口
平台使用统计	登录、需求、报告阅读和下载统计	ops_usage_events	model_platform.users/roles	系统自动记录行为事件
模型大类概览	大类卡片、银行筛选、本行/同业 KS/PSI、趋势、等级下钻	ops_model_categories、ops_monitor_results、ops_monitor_evaluations	model_deploy.model_deploy、model_version、模型方银行及关系表	只读聚合
已上线模型详情	模型版本、开发时点指标、生命周期、评分逻辑、材料入口	ops_documents；必要时读取标准化监控快照	model_deploy、model_version、model_details、银行及关系表；文件来自 model_platform.storage_objects	上传评分逻辑或材料时写 ops_documents
模型监控概览	月度明细、多维筛选、异常等级和监控结果等级	ops_monitor_results、ops_monitor_evaluations、ops_monitor_reviews	模型、版本、银行名称来自 model_deploy	只读；处理动作进入复核表
模型监控详情	排序性、KS/PSI、IV/CSI、分布、命中规则、两段处理	ops_monitor_results、ops_monitor_feature_metrics、ops_monitor_distributions、ops_monitor_evaluations、ops_monitor_reviews、ops_reports	model_deploy、model_version、model_monitor_aggr	模型团队初审、业务团队终审写 ops_monitor_reviews
监控 / 诊断报告	自动生成、模型团队编辑、发送业务团队、导出	ops_reports、ops_report_revisions、ops_report_template_versions、ops_prompt_versions、ops_monitor_evaluations	模型、版本、银行信息来自 model_deploy	系统建报告；模型团队新增修订并发送；写 Outbox
报告汇总	历史报告查询、阅读状态、筛选和导出	ops_reports、ops_report_revisions	模型、版本、银行信息来自 model_deploy	阅读/下载写 ops_usage_events
全流程进度	需求发起、七阶段流转、预计日期、复用通用模型、催办	ops_workflows、ops_workflow_stages、ops_documents、ops_outbox_events	银行、模型、版本来自 model_deploy；用户来自 model_platform	业务发起、模型推进、业务确认均写流程表
文档知识库	按银行、模型、版本、环节检索流程材料	ops_documents、ops_workflows、ops_workflow_stages	文件元数据来自 model_platform.storage_objects；模型信息来自 model_deploy	上传/确认材料写 ops_documents
监控等级规则	13 行规则矩阵、版本发布、回滚、阈值影响测算	ops_rule_versions、ops_rule_items、ops_monitor_evaluations、ops_monitor_results	模型与银行信息来自 model_deploy	管理员发布规则；系统按新版本生成判级快照
报告 Prompt 管理	Prompt 编辑、版本、发布和历史样本回归	ops_prompt_versions、ops_prompt_regression_runs、ops_report_template_versions	历史监控样本来自部署/运维数据	模型团队维护 Prompt；系统写回归结果
系统配置	报告频率、输出日期、模板版本、通知、手动重算	ops_bank_report_configs、ops_report_template_versions、ops_outbox_events	银行列表来自模型方银行表；角色权限来自 model_platform	管理员修改配置并触发后台事件

4. 我方 21 张表逐表归属

4.1 数据接入与标准化（5 张，均需定案）

表	作用	写入方	主要页面	当前判断
ops_model_categories	标准A卡/白户A卡/大额A卡/反欺诈评分业务分类	我方管理员或种子	模型大类概览、规则、流程	暂留；若模型方补业务大类字段，可改为映射表
ops_monitor_batches	月度数据批次、修订号和发布状态	同步任务	监控、报告、系统配置	建议保留，模型方当前无批次/修订/发布结构
ops_monitor_results	月度排序性、KS、PSI及样本快照	同步任务	大类、监控、报告	建议保留为标准化月度快照，不由模型团队手工写
ops_monitor_feature_metrics	特征级 IV/CSI及变化	同步任务	监控详情、诊断报告	建议保留；model_monitor_aggr 只有通用 metricName，结构不足
ops_monitor_distributions	评分区间和特征分箱分布	同步任务	监控详情、诊断报告	建议保留；模型方当前 SQL 无对应结构

4.2 判级与处理（4 张，归属明确）

表	写入方	主要页面
ops_rule_versions	管理员	监控等级规则
ops_rule_items	管理员	监控等级规则
ops_monitor_evaluations	判级服务	工作台、概览、详情、报告
ops_monitor_reviews	模型团队初审、业务团队终审	工作台、监控详情

4.3 报告与 AI 治理（6 张，归属明确）

表	写入方	主要页面
ops_report_template_versions	管理员	报告、系统配置
ops_prompt_versions	模型团队/管理员	Prompt 管理、报告
ops_prompt_regression_runs	回归任务	Prompt 管理
ops_reports	报告生成服务、模型团队发送	报告、报告汇总、工作台
ops_report_revisions	报告生成服务、模型团队编辑	报告、报告汇总
ops_bank_report_configs	管理员	系统配置

4.4 流程、材料与使用统计（4 张，归属明确）

表	写入方	主要页面
ops_workflows	业务团队发起、流程服务维护	全流程进度、工作台
ops_workflow_stages	模型团队/业务团队操作，流程服务落库	全流程进度、工作台
ops_documents	模型团队/业务团队上传，文档服务落库	流程、知识库、模型详情
ops_usage_events	系统自动记录	平台使用统计、报告汇总

4.5 异步可靠性（2 张，归属明确）

表	写入方	主要用途
ops_outbox_events	与业务操作同事务写入	判级、报告、提醒、超时、流程通知
ops_consumer_inbox	后台消费者	防止任务重复执行

5. 关键写入责任

• 模型方只写 model_deploy，不直接写我方判级、报告和流程表。
• 我方同步任务从 model_deploy 读取数据，规范化后写入 4 张 ops_monitor_* 快照表。
• 业务团队和模型团队不直接执行 SQL；其页面操作通过后端服务写入复核、报告修订、流程阶段和文档表。
• 管理员通过页面维护规则、模板、Prompt 和按银行配置。
• 后台任务通过 Outbox/Inbox 处理判级、报告生成、催办和超时默认流转。

6. 需要共同定案的 5 项

1. 统一身份主源：前端登录继续以 model_platform.users/roles/workspaces 为准，还是改用 model_deploy.sys_user/sys_project_space。建议继续使用现有 model_platform 登录。
2. 模型大类来源：模型方是否在 model_deploy 增加标准A/白户A/大额A/反欺诈业务分类；若不增加，我方保留 ops_model_categories 与部署模型的映射。
3. 监控快照保留：是否接受我方把 model_monitor_aggr 转换为稳定的月度结果、特征和分布快照。建议保留，避免历史报告随源数据变化。
4. 银行关系结构：模型方补充一对多还是多对多关系。通用模型存在多银行复用，建议 bank + model_deploy_bank 两张表。
5. 缺失监控字段：排序性、CSI、特征分箱、基准期/当期分布、样本量和批次修订由模型方新增结构还是通过固定 extra JSON 提供。建议明确字段表，不依赖无约束 JSON。

7. 建议的下一步

先不要再次执行 V0.1 完整建表脚本。按本文件共同确认上述 5 项后：

1. 输出 model_operations V0.2 正式表清单。
2. 生成 V0.1 → V0.2 的非破坏性迁移 SQL。
3. 给模型方一份只读表、字段和样例数据需求清单。
4. 再生成 ORM 与首条“模型列表—详情—单月监控结果”真实接口。