# 数据运营平台第一阶段用户操作指南

## 1. 适用范围

本指南用于数据运营平台第一阶段设备治理与运营场景，覆盖设备台账、设备语义
与本体、实体匹配、质量问题整改、设备运行维护、治理知识问答、治理指标和
平台管理。平台当前专注数据运营与治理，不作为分析开发或 BI 开发平台。

## 2. 角色说明

| 角色 | 主要职责 | 典型权限 |
|---|---|---|
| admin 管理员 | 用户、角色、责任、审计和业务治理管理 | 管理与业务读写 |
| editor 编辑者 | 维护设备治理数据、执行质量检查和整改 | 业务读写，不可管理用户与审计 |
| viewer 查看者 | 浏览已授权的业务结果与证据 | 只读，不可执行写操作 |

用户使用企业或平台分配的账号登录。第一阶段使用平台本地认证；企业单点登录
属于后续阶段，正式账号发放、停用和权限调整由企业管理员负责。

## 3. 首页与只读模式

登录后从数据研究中心进入各业务模块。查看者会看到只读提示，新增摄取和治理
评审等写入口不会显示。若某个页面没有可见数据，应先确认当前角色是否获得
对应业务域授权，不应把“无权限”和“无数据”混为一谈。

## 4. 设备台账

1. 进入“设备资产”。
2. 按设备名称、平台统一标识或来源标识筛选。
3. 查看设备类型、位置、组织、负责人、版本和状态。
4. 打开追溯入口，核对来源系统、来源记录标识及版本变化。
5. 管理员或编辑者按受控流程导入或维护设备；查看者仅浏览。

验收重点是设备有稳定的平台统一标识、来源标识和责任人。导入失败时先检查
字段完整性、枚举值和当前账号写权限。

## 5. 设备语义与本体

1. 进入“设备语义”或本体工作台。
2. 查看当前草稿、已发布版本、类别、关系和映射。
3. 编辑者提交变更前核对影响范围和映射完整性。
4. 发布时记录版本和发布人；已发布版本不得静默覆盖。
5. 下游查询以已发布版本为准，草稿不应替代正式语义。

## 6. 实体匹配与回滚

1. 进入“实体匹配”，查看候选对、置信度和匹配信号。
2. 打开证据详情，核对来源标识、属性和确定性规则。
3. 确认合并前检查是否会影响台账、质量和运行维护关联。
4. 合并后保留事件记录；发现误合并时执行回滚。
5. 回滚后再次核对平台统一标识及关联数据。

自动合并默认关闭。置信度只能作为辅助信息，不能代替人员确认和证据核对。

## 7. 质量检查与问题整改

1. 进入“设备质量”，查看已发布规则和规则版本。
2. 管理员或编辑者执行质量检查。
3. 从运行结果进入质量问题，查看对象、规则、来源和问题描述。
4. 分派责任人，记录整改措施、验证结果和关闭说明。
5. 关闭后通过治理指标检查闭环率和复发情况。

质量问题应可回溯到规则、对象和来源数据。没有验证证据时不得直接标记为关闭。

## 8. 设备运行与维护

1. 进入运行维护中心，查看告警、停机和维护事件。
2. 按设备、时间和事件类型筛选。
3. 打开事件证据，核对关联设备、质量问题和维护记录。
4. 发起根因分析时检查证据完整性。
5. 当证据不足时，平台会明确提示无法确认根因，不会自动生成维修结论。

平台提供证据组织和治理辅助，不代替现场诊断、维修审批或安全作业流程。

## 9. 治理知识检索与问答

1. 输入设备名称、来源标识或治理问题。
2. 先查看检索结果及权限范围。
3. 发起问答后核对回答状态、来源证据和引用。
4. 模型不可用或证据不足时，平台会拒绝推测性回答。
5. 需要业务决策时回到原始台账、事件和责任记录复核。

不同角色可能看到不同结果。查看者没有业务域权限时，空结果不代表平台没有
该数据。

## 10. 治理指标

治理指标中心展示台账完整率、责任覆盖率、实体映射率、质量问题闭环率和
复发率等指标。点击指标详情查看分子、分母和对象范围。指标下降时应先确认
统计范围和授权，再进入对应业务模块处理，不能只修改展示结果。

## 11. 管理功能

管理员可使用以下能力：

- 用户和角色：创建、停用用户并分配 admin、editor、viewer 角色。
- 治理责任：维护业务范围、责任角色和责任人。
- 审计中心：查看关键操作类别、安全检查和审计封印。

停用账号后应验证无法重新登录。角色变更后应使用目标账号复核页面入口和服务
端权限，不能只看管理员列表中的角色名称。

## 12. 常见问题

| 现象 | 建议检查 |
|---|---|
| 页面没有数据 | 当前角色的业务域授权、筛选条件、来源数据是否存在 |
| 按钮不可见 | 当前账号是否为 viewer，只读提示是否显示 |
| 请求返回 403 | 当前角色不具备该操作权限，联系管理员确认职责 |
| 导入返回 422 | 模板字段、必填值、枚举值和数据格式 |
| 知识问答无答案 | 模型状态、证据数量、权限范围和问题关键词 |
| 根因分析拒绝结论 | 关联事件、设备、质量问题或维护证据不充分 |

## 13. 使用约束

- 不在平台中录入明文密码、令牌或不必要的个人敏感信息。
- 不通过共享管理员账号绕过职责分离。
- 不把演示数据验证结果当作企业真实数据验收结论。
- 不把模型生成内容当作无须复核的事实或维修指令。
- 发现权限越界、数据错误或审计缺失时立即停止相关操作并上报。