# 制造业算法开发与模型管理平台 V2.0 页面展示字段字典

> 版本：V2.0-R5。字段规则以业务对象为单位；页面只能组合展示对象字段，不能另建同名状态或用展示值覆盖服务端事实。

## 1. 通用字段

| 字段 | 类型/来源 | 展示规则 | 写入与校验 |
|---|---|---|---|
| 业务编号 | string / 系统生成 | 列表、详情、日志可复制 | 全局或对象域唯一，不允许覆盖 |
| 名称/标题 | string / 用户输入 | 显示原值和更新时间 | 草稿可编辑，正式对象按状态控制 |
| 版本/修订号 | string / 系统生成 | 同时显示当前版本、来源版本 | 写操作必须携带 revision/state_version |
| 状态与状态时间 | enum+datetime / 系统计算 | 不同状态维度分栏展示 | 只能由对应状态机迁移 |
| 来源对象 | object_ref / 系统关联 | 显示对象类型、编号、固定版本 | 派生、复制、重试必须绑定 |
| 负责人/协作者 | account_ref[] / 用户选择 | 显示有效账号和职责 | 保存与执行时重新校验账号及权限 |
| 请求/任务编号 | string / 系统生成 | 错误、日志、审计均可复制 | 贯穿异步执行、回调和补偿 |
| 结果/失败原因 | enum+text / 执行端或系统 | 执行结果、业务结论分开展示 | 终态只读；补充诊断另建记录 |
| 操作记录 | audit_ref[] / 审计生成 | 操作者、时间、前后状态、原因 | 不可修改或删除 |

<a id="fields-annotation"></a>
## 2. 标注任务与样本

| 对象 | 字段 | 类型/枚举 | 必填与来源 | 编辑、脱敏和校验 |
|---|---|---|---|---|
| 标注项目 | 项目编号、名称、标注类型、标签体系版本 | string/ref | 创建必填 | 标签体系启用后变更须新建版本 |
| 标注任务 | 任务编号、样本批次、模板版本、截止时间 | ref/datetime | 分配前必填 | 样本批次固定，禁止跨版本悄然追加 |
| 标注任务 | 分配人、标注人、复核人、验收人 | account_ref[] | 按动作必填 | 账号有效；普通账号标注与复核不能为同一人 |
| 标注任务 | 总数、待处理数、通过数、退回数、异常数 | integer | 系统汇总 | 由样本状态计算，页面不得写入 |
| 标注样本 | 样本编号、来源数据版本、内容指纹 | string/ref/hash | 系统生成 | 指纹只读；敏感内容按数据权限脱敏 |
| 标注样本 | 当前领取人、锁版本、锁到期时间 | account_ref/int/datetime | 领取后生成 | 心跳续租；过期后服务端释放并留痕 |
| 标注结果 | 标签值、标注版本、置信说明、附件 | json/string/file_ref | 提交必填 | 按标签体系校验；附件扫描并限类型 |
| 复核/验收 | 复核结论、退回原因、抽检规则、通过率 | enum/text/json/decimal | 复核或验收必填 | 原结论只读；重标生成新结果版本 |

<a id="fields-dev-environment"></a>
## 3. 代码工作台与开发环境

| 对象 | 字段 | 类型/枚举 | 必填与来源 | 编辑、执行和校验 |
|---|---|---|---|---|
| 代码工作区 | 工作区编号、分支、文件树、活动文件、协作者 | string/ref[] | 进入工作台必填 | 只允许工作区相对路径；对象范围和协作者权限服务端校验 |
| 代码文件 | 文件编号、相对路径、语言、内容摘要、当前修订 | string/enum/hash/ref | 创建或打开时生成 | 禁止绝对路径、`..` 和同路径重复；冻结版本只读 |
| 代码修订 | 修订编号、文件清单摘要、代码摘要、保存人、保存时间、来源修订 | string/hash/ref/datetime | 每次保存生成 | 不覆盖历史修订；保存失败保留未保存内容 |
| 环境快照 | 环境编号、镜像摘要、依赖锁摘要、运行时、硬件规格、快照编号 | ref/hash/json | 运行或测试前必填 | 凭证不回显；恢复快照生成新环境尝试，不改历史 |
| 运行尝试 | 尝试编号、代码修订、活动文件、入口、样本版本、参数、资源、状态、退出码、日志 | string/ref/json/enum | 每次运行生成 | 运行未保存内容时必须先形成临时摘要；终态和日志不可覆盖 |
| 测试运行 | 测试编号、代码修订、用例集、通过数、失败数、覆盖率、报告、状态 | string/ref/integer/decimal/enum | 每次测试生成 | 测试成功不等于算法版本冻结；失败保留逐用例证据 |
| 终端命令 | 命令编号、命令类型、参数摘要、环境快照、执行结果 | string/enum/json/ref | 执行时生成 | 仅允许白名单命令和受控参数；拒绝结果也写安全审计 |

<a id="fields-model-boundary"></a>
## 4. 算法资产、模型资产与模型版本边界

| 对象 | 拥有内容 | 允许来源/创建方式 | 明确不负责 |
|---|---|---|---|
| 算法资产 | 组件、源码、输入输出契约、参数契约、依赖、环境、工作区、流程、算法版本、训练交接包 | 算法开发中新建、复制、编辑、测试、冻结和交接 | 不承载训练生成权重的发布生命周期 |
| 模型资产 | 模型编号、业务归属、工业适用说明、字段模板、负责人、模型版本清单 | 模型负责人创建，作为多个模型版本的稳定归属容器 | 不维护源码、组件、算法包，不发起训练 |
| 模型版本 | 来源类型、算法版本、交接包、训练任务、产物摘要，或外部权重及来源证明 | 平台训练产物登记，或外部权重导入并校验 | 不反向改写算法版本、训练任务或历史权重 |
| 训练产物 | 权重、指标、日志、检查点、环境和完整性结论 | 训练任务成功或部分成功后由训练模块生成 | 未完成完整性确认不得登记为可评测模型版本 |

<a id="fields-workflow"></a>
## 5. 流程编排、节点、端口与缓存

| 对象 | 字段 | 类型/枚举 | 必填与来源 | 编辑与校验 |
|---|---|---|---|---|
| 流程版本 | 流程编号、修订号、DAG摘要、冻结状态 | string/hash/enum | 系统生成 | 冻结后不可原地修改 |
| 节点 | 节点编号、组件及版本、节点类型、坐标 | string/ref/enum/json | 新增必填 | 节点编号在流程修订内唯一 |
| 端口 | 端口编号、方向、数据类型、结构版本、是否必连 | string/enum/ref/bool | 组件定义 | 输入只能连接输出；类型和结构版本兼容 |
| 连线 | 来源节点/端口、目标节点/端口 | ref | 连接必填 | 禁止自环、重复连线和DAG环路 |
| 节点配置 | 参数、环境、资源规格、超时、重试策略 | json/ref/duration | 执行前必填 | 敏感参数只显示已配置，单位与边界明确 |
| 缓存策略 | 启用状态、缓存键、输入摘要、组件摘要、有效期 | bool/hash/duration | 启用时必填 | 任一摘要变化不得命中旧缓存 |
| 节点尝试 | 尝试编号、状态、开始/结束时间、失败类别 | string/enum/datetime | 运行时生成 | 每次重试新建尝试，不覆盖原尝试 |
| 中间产物 | 产物编号、节点、文件摘要、保留期、清理状态 | ref/hash/datetime/enum | 成功节点生成 | 下载鉴权；清理后保留元数据和原因 |

<a id="fields-evaluation"></a>
## 6. 技术评测与业务确认

| 对象 | 字段 | 类型/枚举 | 必填与来源 | 编辑与校验 |
|---|---|---|---|---|
| 技术评测任务 | 模型/权重版本、测试数据版本、规则快照、环境 | ref | 提交必填 | 均绑定冻结版本和摘要 |
| 技术评测任务 | 执行状态、子任务、原始指标、失败原因 | enum/json | 执行端回写 | 执行状态不得替代技术结论 |
| 技术报告 | 报告编号、规则判定、技术结论、有效期 | string/json/enum/datetime | 报告生成必填 | 报告只读；输入变化或过期转失效 |
| 业务确认 | 确认编号、业务场景、技术报告、样例集 | string/ref | 创建必填 | 必须绑定有效技术报告但结论独立 |
| 业务样例 | 样例编号、预期、实际输出、业务判定、问题 | string/json/enum/text | 确认必填 | 敏感输入按权限脱敏 |
| 确认签署 | 确认人、结论、原因、签署时间 | account_ref/enum/text/datetime | 提交结论必填 | 通过、退回、阻断均需证据 |

<a id="fields-release"></a>
## 7. 多实例、灰度、蓝绿与回滚

| 对象 | 字段 | 类型/枚举 | 必填与来源 | 编辑与校验 |
|---|---|---|---|---|
| 发布执行 | 执行编号、审批快照、策略类型、目标版本 | string/ref/enum | 执行前必填 | 审批快照失效时禁止启动 |
| 服务实例 | 实例编号、模型版本、规格、节点、实例状态 | string/ref/json/enum | 调度生成 | 每实例独立状态，不以平均值覆盖 |
| 健康检查 | 规则版本、检查时间、健康结论、失败明细 | ref/datetime/enum/json | 实例启动后必填 | 未响应记未知，不沿用旧健康 |
| 灰度批次 | 批次号、候选/稳定版本、目标比例、观察窗口 | string/ref/decimal/duration | 灰度必填 | 比例0-100%；扩大前重新校验指标 |
| 蓝绿环境 | 蓝/绿环境版本、入口路由、活动环境 | ref/json/enum | 蓝绿必填 | 非活动环境先验证，切换使用路由版本锁 |
| 流量策略 | 路由版本、实例权重、实际生效权重、生效时间 | string/json/datetime | 切流生成 | 配置值与网关实值分别保存 |
| 回滚记录 | 回滚目标、切换前快照、触发原因、恢复结果 | ref/json/text/enum | 回滚必填 | 目标须可用；失败进入回滚失败/未知 |

<a id="fields-feedback"></a>
## 8. 反馈回流、脱敏、去重与版本生成

| 对象 | 字段 | 类型/枚举 | 必填与来源 | 编辑、脱敏和校验 |
|---|---|---|---|---|
| 用户反馈 | 反馈编号、来源调用、模型版本、问题类型、描述 | string/ref/enum/text | 提交必填 | 来源调用和模型版本固定 |
| 回流批次 | 批次编号、筛选条件、样本范围、授权依据 | string/json/ref | 创建必填 | 仅复制获准范围，不直接复用线上原文 |
| 脱敏记录 | 规则版本、字段清单、处理结果、前后摘要 | ref/json/enum/hash | 入池前必填 | 保存摘要不保存可逆映射；失败样本阻断 |
| 去重记录 | 业务主键、内容指纹、命中对象、处置结果 | string/hash/ref/enum | 脱敏后生成 | 主键或指纹冲突需人工裁决 |
| 人工确认 | 确认人、可用性结论、拒绝原因、确认时间 | account_ref/enum/text/datetime | 入标注前必填 | 未确认或拒绝样本不得入版 |
| 回流样本 | 来源反馈、脱敏副本、标签状态、质检状态 | ref/enum | 系统关联 | 原始、脱敏、标注结果分开存储 |
| 新数据版本 | 版本编号、入版样本清单、来源批次、质量结论 | ref[]/enum | 冻结前必填 | 仅纳入确认、标注和质检通过样本 |
| 迭代来源链 | 迭代计划、训练实验、新模型版本、验证结论 | ref[] | 迭代后生成 | 不覆盖原数据、训练或模型版本 |

## 9. 其他领域字段与展示约束

| 领域 | 关键字段 |
|---|---|
| 工作台 | 事项类型、紧急程度、截止时间、来源模块、下一步动作、未读状态 |
| 数据加工/治理 | 输入版本、规则、字段映射、输出版本、质量、元数据、标准、血缘 |
| 算法资产/工作区 | 输入输出契约、代码文件、代码修订、环境快照、运行/测试记录、参数、协作者、交接版本 |
| 训练分析 | 实验组、指标、参数、资源、日志、产物、对比基线、分析结论 |
| 模型资产/版本 | 模型归属、来源类型、来源算法版本、交接包、训练任务、产物摘要、外部来源证明 |

- 列表必须覆盖加载中、空结果、无权限、失败、未知和分页状态。
- 详情必须显示对象、版本、各状态维度、来源、下游引用和操作记录。
- 凭证、Key、原始敏感样本和内部堆栈不得明文展示。
- 数值字段必须注明单位、精度、默认值、最小值、最大值和统计窗口。

## 10. 全域对象字段基线

> 下表为八组专项以外对象的最低持久化与展示字段。字段接口名、类型、是否必填、脱敏级别和可编辑状态见 15 号契约；实现不得用页面临时字段替代权威对象字段。

| 页面对象域 | 权威对象 | 对象主键 | 必备业务字段 | 版本与写入规则 |
|---|---|---|---|---|
| <a id="fields-workbench"></a>工作台首页 | 聚合事项 | `work_item_id` | 事项类型、来源对象、来源状态、紧急程度、截止时间、更新时间、目标路由 | 写操作携带 `revision/state_version`；冻结、发布或被执行引用后只允许派生新修订 |
| <a id="fields-dataset-lineage"></a>数据集管理 | 数据集与血缘关系 | `dataset_id` | 数据集编号、版本、来源节点、目标节点、关系类型、采集时间、影响范围 | 写操作携带 `revision/state_version`；冻结、发布或被执行引用后只允许派生新修订 |
| <a id="fields-dataset-version"></a>数据集版本 | 数据集版本 | `dataset_version_id` | 版本编号、来源版本、样本清单摘要、结构摘要、质量结论、适用范围、冻结时间 | 写操作携带 `revision/state_version`；冻结、发布或被执行引用后只允许派生新修订 |
| <a id="fields-data-ingestion"></a>数据接入 | 数据源与同步任务 | `ingestion_task_id` | 数据源编号、协议、授权引用、采集范围、游标、调度、重连策略、解析结果 | 写操作携带 `revision/state_version`；冻结、发布或被执行引用后只允许派生新修订 |
| <a id="fields-data-processing"></a>数据加工 | 数据加工任务 | `processing_task_id` | 输入版本、规则版本、字段映射、执行参数、输出版本、异常记录、产物摘要 | 写操作携带 `revision/state_version`；冻结、发布或被执行引用后只允许派生新修订 |
| <a id="fields-data-quality"></a>数据质检 | 数据质量任务 | `quality_task_id` | 规则版本、检查范围、指标结果、问题样本、质量结论、整改责任人、复检记录 | 写操作携带 `revision/state_version`；冻结、发布或被执行引用后只允许派生新修订 |
| <a id="fields-data-governance"></a>数据治理 | 元数据、标准与血缘资产 | `governance_asset_id` | 资产类型、责任人、标签、标准版本、字段映射、血缘摘要、影响范围、采集时间 | 写操作携带 `revision/state_version`；冻结、发布或被执行引用后只允许派生新修订 |
| <a id="fields-data-api"></a>数据服务 | 数据 API | `data_api_id` | API编号、路径、方法、输入输出契约、鉴权策略、限流、版本、调用统计 | 写操作携带 `revision/state_version`；冻结、发布或被执行引用后只允许派生新修订 |
| <a id="fields-algorithm-asset"></a>算法资产 | 算法资产与组件 | `algorithm_asset_id` | 算法编号、组件版本、输入输出契约、参数契约、代码摘要、依赖摘要、测试结论 | 写操作携带 `revision/state_version`；冻结、发布或被执行引用后只允许派生新修订 |
| <a id="fields-workspace"></a>开发工作区 | 开发工作区 | `workspace_id` | 工作区编号、数据版本、算法版本、参数修订、协作者、代码引用、环境引用、保存点 | 写操作携带 `revision/state_version`；冻结、发布或被执行引用后只允许派生新修订 |
| <a id="fields-debug-validation"></a>调试与开发验证 | 调试运行与兼容性检查 | `debug_run_id` | 样本版本、输入快照、算法修订、环境摘要、输出摘要、日志、兼容性结论、失败原因 | 写操作携带 `revision/state_version`；冻结、发布或被执行引用后只允许派生新修订 |
| <a id="fields-algorithm-handoff"></a>算法版本与训练交接 | 算法版本与训练交接包 | `handoff_package_id` | 算法版本、代码摘要、数据契约、环境摘要、运行入口、镜像摘要、安全扫描、完整性结论 | 写操作携带 `revision/state_version`；冻结、发布或被执行引用后只允许派生新修订 |
| <a id="fields-training-experiment"></a>训练实验 | 训练实验与实验组 | `experiment_id` | 实验编号、模板版本、算法版本、数据版本、参数空间、随机种子、评价目标、创建人 | 写操作携带 `revision/state_version`；冻结、发布或被执行引用后只允许派生新修订 |
| <a id="fields-training-run"></a>训练执行 | 训练任务与检查点 | `training_run_id` | 任务编号、实验快照、资源引用、运行状态、检查点、日志、指标、产物、失败类别 | 写操作携带 `revision/state_version`；冻结、发布或被执行引用后只允许派生新修订 |
| <a id="fields-compute-resource"></a>算力选择与资源申请 | 资源需求与使用记录 | `resource_request_id` | 资源申请编号、CPU/GPU/内存、时长、评估依据、推荐规格、关联任务、实际用量 | 写操作携带 `revision/state_version`；冻结、发布或被执行引用后只允许派生新修订 |
| <a id="fields-training-monitor"></a>训练监控与诊断 | 训练监控与告警 | `training_alert_id` | 任务编号、指标名称、采样时间、当前值、阈值、告警级别、诊断结论、处理入口 | 写操作携带 `revision/state_version`；冻结、发布或被执行引用后只允许派生新修订 |
| <a id="fields-experiment-analysis"></a>训练结果与实验分析 | 训练结果与实验分析 | `experiment_result_id` | 实验版本、指标集、参数快照、资源消耗、模型产物、对比基线、分析结论、复现任务 | 写操作携带 `revision/state_version`；冻结、发布或被执行引用后只允许派生新修订 |
| <a id="fields-evaluation-rule"></a>评测规则 | 评测规则版本 | `evaluation_rule_id` | 规则编号、指标定义、阈值、适用范围、生效时间、失效时间、版本摘要、发布人 | 写操作携带 `revision/state_version`；冻结、发布或被执行引用后只允许派生新修订 |
| <a id="fields-release-admission"></a>评测结论与发布准入 | 发布准入与环境差异 | `admission_record_id` | 模型版本、技术结论、业务结论、验证环境、目标环境、差异项、处置结论、准入状态 | 写操作携带 `revision/state_version`；冻结、发布或被执行引用后只允许派生新修订 |
| <a id="fields-model-asset"></a>模型库 | 模型资产与字段模板 | `model_id` | 模型编号、归属、工业适用说明、字段模板、版本清单、负责人、状态、最新模型版本 | 写操作携带 `revision/state_version`；冻结、发布或被执行引用后只允许派生新修订 |
| <a id="fields-model-version"></a>模型版本详情 | 模型版本 | `model_version_id` | 版本编号、来源类型、来源算法版本、训练交接包、来源训练任务、产物摘要、外部来源证明、状态历史 | 写操作携带 `revision/state_version`；冻结、发布或被执行引用后只允许派生新修订 |
| <a id="fields-model-adaptation"></a>模型适配与量化 | 模型量化与适配任务 | `adaptation_task_id` | 源模型、目标格式、精度、目标设备、运行时、兼容性结果、性能结果、输出版本 | 写操作携带 `revision/state_version`；冻结、发布或被执行引用后只允许派生新修订 |
| <a id="fields-deployment"></a>服务部署管理 | 服务部署与回切记录 | `deployment_id` | 服务编号、目标版本、部署策略、实例清单、健康结论、稳定版本、回切结果、失败原因 | 写操作携带 `revision/state_version`；冻结、发布或被执行引用后只允许派生新修订 |
| <a id="fields-service"></a>服务详情 | 模型服务、实例与流量策略 | `service_id` | 服务编号、发布版本、实例、健康、路由版本、期望权重、实际权重、告警、调度目标 | 写操作携带 `revision/state_version`；冻结、发布或被执行引用后只允许派生新修订 |
| <a id="fields-model-monitoring"></a>模型效果与漂移 | 模型效果监控与重训练触发 | `monitoring_rule_id` | 模型版本、指标、统计窗口、基线、当前值、漂移量、阈值、异常样例、冷却期、触发任务 | 写操作携带 `revision/state_version`；冻结、发布或被执行引用后只允许派生新修订 |
| <a id="fields-marketplace"></a>模型列表 | 模型广场投影、收藏、评价与反馈 | `market_item_id` | 发布投影、模型版本、业务达标摘要、授权范围、收藏状态、评分、评价、本人反馈 | 写操作携带 `revision/state_version`；冻结、发布或被执行引用后只允许派生新修订 |
| <a id="fields-system-log"></a>系统日志 | 审计与异常日志 | `log_id` | 日志编号、请求编号、事件类型、业务对象、操作者、前后摘要、错误码、发生时间、保留期 | 写操作携带 `revision/state_version`；冻结、发布或被执行引用后只允许派生新修订 |