# 制造业算法开发与模型管理平台 V1.0 快速阅读指南

> 阅读目标：用 5-10 分钟了解平台解决什么问题、完整流程如何运转、不同角色应该看哪些文档。
>
> 当前基线：V1.0-R5，共 511 个历史追踪编号，其中 499 项属于 V1.0 实施范围，12 项远程接入已转后续版本、不参与 V1 正向验收。本文只负责帮助理解和导航；发生表述差异时，以对应专题文档及逐功能逻辑为准。

## 1. 一句话理解平台

平台把制造业算法从“数据和算法材料进入平台”到“训练、独立评测、审批、下载或 API 使用”的全过程串成一条可追溯、可阻断、可审计的业务闭环。

它不是在线写代码工具，也不在平台内做数据标注。V1.0 重点解决的是：使用了哪版数据和算法、模型如何训练出来、由谁评测和批准、最终发布的是否仍是同一份内容。

## 2. 完整流程

`数据接入 → 质检 → 冻结数据版本 → 登记并冻结算法包 → 创建训练 → 登记权重 → 独立评测 → 推理冒烟 → 发布申请与审批 → 下载发布或 API 服务 → 授权使用与审计`

| 阶段 | 用户要完成的事 | 系统必须保证 |
|---|---|---|
| 数据准备 | 导入已在外部准备好的数据和标签 | 问题可定位，未通过质检的数据不能冻结 |
| 版本固化 | 冻结可供训练引用的数据版本 | 冻结内容不可原地修改，修正时创建新版本 |
| 算法登记 | 上传算法包、依赖和运行入口 | 校验通过后形成不可变的算法包版本 |
| 模型训练 | 选择固定数据、算法、参数和算力执行训练 | 输入快照不漂移，资源状态与任务状态分开 |
| 权重登记 | 保存平台训练或外部训练的权重及来源材料 | 来源、文件摘要和完整性可追溯 |
| 独立评测 | 使用独立测试数据和固定规则验证模型 | 数据重叠、证据不足或指标不达标能够阻断 |
| 发布准备 | 完成冒烟，提交固定候选快照 | 审批后内容变化会使原批准失效 |
| 对外使用 | 发布下载包或单实例 API | 授权、凭证、限额、调用和下线均留痕 |

## 3. 六类核心对象

| 对象 | 通俗解释 | 关键规则 |
|---|---|---|
| 数据版本 | 某一时点可被稳定引用的数据快照 | 冻结后不可覆盖 |
| 算法包版本 | 代码、依赖、入口和声明的固定组合 | 校验通过后才能训练 |
| 训练任务 | 一次固定输入和资源条件下的执行记录 | 重试创建新记录，不覆盖失败历史 |
| 权重版本 | 训练产物或外部模型文件的正式登记对象 | 必须记录来源和文件摘要 |
| 评测报告 | 独立数据、固定规则和模型版本的技术结论 | 执行成功不等于指标通过 |
| 发布记录/在线服务 | 被批准并实际对外提供的模型形态 | 审批、部署、健康和发布是不同状态 |

最重要的关系是：下游只引用上游的固定版本。任何会改变内容的修正，都通过新版本、新任务或新申请完成。

## 4. 按角色阅读

| 你是谁 | 建议阅读顺序 | 重点 |
|---|---|---|
| 业务负责人/管理人员 | 本指南 → [01 用户故事](01-用户故事.md) → [05 用户旅程](05-用户旅程.md) | 建设价值、范围、角色协作和最终结果 |
| 产品经理/设计人员 | 本指南 → [02 功能需求](02-功能需求.md) → [03 功能清单](03-功能清单.md) → [06 字段字典](06-V1.0页面展示字段字典.md) | 页面能力、流程规则和展示字段 |
| 研发人员 | 本指南 → [13 完整PRD](13-制造业算法开发与模型管理平台-V1.0-完整PRD.md) → [14 核心链路](14-V1.0核心链路详细设计.md) → [04 研发需求](04-研发需求.md) → [07 状态矩阵](07-V1.0状态与操作矩阵.md) → [08 权限矩阵](08-V1.0角色权限与职责矩阵.md) → [12 配置规则](12-V1.0配置与联调规则.md) | 核心功能闭环、对象边界、接口行为、状态、权限和外部依赖 |
| 测试人员 | 本指南 → [09 验收用例](09-V1.0验收用例.md) → [07 状态矩阵](07-V1.0状态与操作矩阵.md) → [11 追踪基线](11-V1.0文档追踪与配置基线.md) | 正向、反向、权限、状态和证据 |
| 运维/安全人员 | 本指南 → [12 配置规则](12-V1.0配置与联调规则.md) → [04 研发需求](04-研发需求.md)相关章节 | 资源、超时、文件安全、认证、审计和上线验证 |

## 5. 按问题查文档

| 想解决的问题 | 查看文档 |
|---|---|
| 为什么建设、V1.0 做到什么程度 | [01 用户故事](01-用户故事.md) |
| 产品范围、完整业务规则 | [02 功能需求](02-功能需求.md) |
| 每个模块和页面应有什么功能 | [03 功能清单](03-功能清单.md) |
| 后端、任务、文件和接口如何实现 | [04 研发需求](04-研发需求.md) |
| 用户跨角色如何完成完整流程 | [05 用户旅程](05-用户旅程.md) |
| 页面具体展示哪些字段 | [06 字段字典](06-V1.0页面展示字段字典.md) |
| 某状态下能做什么、如何迁移 | [07 状态矩阵](07-V1.0状态与操作矩阵.md) |
| 谁能看、谁能操作、Admin 有何例外 | [08 权限矩阵](08-V1.0角色权限与职责矩阵.md) |
| 如何验收、需要什么证据 | [09 验收用例](09-V1.0验收用例.md) |
| 查询某个 FR 编号的完整处理逻辑 | [10 逐功能逻辑](10-V1.0逻辑文档.md) |
| 检查某条需求是否已映射到逻辑和验收 | [11 追踪基线](11-V1.0文档追踪与配置基线.md) |
| 查看默认配置和真实环境联调规则 | [12 配置规则](12-V1.0配置与联调规则.md) |
| 连续评审产品范围与六条核心功能闭环 | [13 完整 PRD](13-制造业算法开发与模型管理平台-V1.0-完整PRD.md) |
| 单独开发数据、训练、评测、发布、服务和调用链路 | [14 核心链路详细设计](14-V1.0核心链路详细设计.md) |

`13`已经包含功能需求正文和六条核心链路的页面、字段、流程、权限、异常、依赖、审计与验收规格。`10`和`11`是查询与追踪材料，不建议从头到尾顺序通读；研发需要稳定锚点和独立分册时使用`14`。

## 6. 最容易误解的规则

1. 自动审批通过只表示申请规则校验通过，不表示算力已经就绪。
2. 任务执行成功只表示执行结束，不表示产物完整、指标通过或模型可发布。
3. 评测工程师给出技术结论，发布审批人做发布决策，两者不是同一个结论。
4. 发布审批通过不等于已经发布；下载发布和 API 部署还要分别执行。
5. API 部署成功不等于服务健康，也不等于已经对外开放。
6. 冻结对象不能原地修改；修正数据、算法、权重或发布内容时创建新版本或新申请。
7. 普通账号的发布申请、审批和执行由不同账号承担；有效 Admin 可以兼任，但不能绕过准入、快照和审计。
8. “未知”表示当前无法确认真实状态，不得用旧的成功状态代替。
9. 失败重试保留原记录，并建立新的任务或执行尝试。
10. 跨模块“只读引用”只允许选择固定版本，不自动获得原对象的编辑、下载或停用权限。

## 7. 当前交付边界

现有静态原型可用于产品评审、交互确认和研发联调准备。它证明页面、规则映射和本地交互能够成立，但不等于真实后端、存储、算力、扫描、认证、网关、归档、密钥托管、性能和安全已经通过生产验收。

研发交付时必须继续使用真实接口、执行端和审计证据逐项关闭 V1 实施范围内的 [09 验收用例](09-V1.0验收用例.md) 与 [11 追踪基线](11-V1.0文档追踪与配置基线.md)。511 个编号有文档映射不代表 511 项都需要实现；需求映射、代码显式引用、原型交互与真实环境验收是不同层级的证据。已转后续版本的 12 项仅核验 V1 没有可操作入口。