DATAOPS_PHASE1_USER_OPERATION_GUIDE.md 5.7 KB
数据运营平台第一阶段用户操作指南
1. 适用范围
本指南用于数据运营平台第一阶段设备治理与运营场景，覆盖设备台账、设备语义 与本体、实体匹配、质量问题整改、设备运行维护、治理知识问答、治理指标和 平台管理。平台当前专注数据运营与治理，不作为分析开发或 BI 开发平台。
2. 角色说明
| 角色 | 主要职责 | 典型权限 |
|---|---|---|
| admin 管理员 | 用户、角色、责任、审计和业务治理管理 | 管理与业务读写 |
| editor 编辑者 | 维护设备治理数据、执行质量检查和整改 | 业务读写，不可管理用户与审计 |
| viewer 查看者 | 浏览已授权的业务结果与证据 | 只读，不可执行写操作 |
用户使用企业或平台分配的账号登录。第一阶段使用平台本地认证；企业单点登录 属于后续阶段，正式账号发放、停用和权限调整由企业管理员负责。
3. 首页与只读模式
登录后从数据研究中心进入各业务模块。查看者会看到只读提示，新增摄取和治理 评审等写入口不会显示。若某个页面没有可见数据，应先确认当前角色是否获得 对应业务域授权，不应把“无权限”和“无数据”混为一谈。
4. 设备台账
- 进入“设备资产”。
- 按设备名称、平台统一标识或来源标识筛选。
- 查看设备类型、位置、组织、负责人、版本和状态。
- 打开追溯入口，核对来源系统、来源记录标识及版本变化。
- 管理员或编辑者按受控流程导入或维护设备；查看者仅浏览。
验收重点是设备有稳定的平台统一标识、来源标识和责任人。导入失败时先检查 字段完整性、枚举值和当前账号写权限。
5. 设备语义与本体
- 进入“设备语义”或本体工作台。
- 查看当前草稿、已发布版本、类别、关系和映射。
- 编辑者提交变更前核对影响范围和映射完整性。
- 发布时记录版本和发布人；已发布版本不得静默覆盖。
- 下游查询以已发布版本为准，草稿不应替代正式语义。
6. 实体匹配与回滚
- 进入“实体匹配”，查看候选对、置信度和匹配信号。
- 打开证据详情，核对来源标识、属性和确定性规则。
- 确认合并前检查是否会影响台账、质量和运行维护关联。
- 合并后保留事件记录；发现误合并时执行回滚。
- 回滚后再次核对平台统一标识及关联数据。
自动合并默认关闭。置信度只能作为辅助信息，不能代替人员确认和证据核对。
7. 质量检查与问题整改
- 进入“设备质量”，查看已发布规则和规则版本。
- 管理员或编辑者执行质量检查。
- 从运行结果进入质量问题，查看对象、规则、来源和问题描述。
- 分派责任人，记录整改措施、验证结果和关闭说明。
- 关闭后通过治理指标检查闭环率和复发情况。
质量问题应可回溯到规则、对象和来源数据。没有验证证据时不得直接标记为关闭。
8. 设备运行与维护
- 进入运行维护中心，查看告警、停机和维护事件。
- 按设备、时间和事件类型筛选。
- 打开事件证据，核对关联设备、质量问题和维护记录。
- 发起根因分析时检查证据完整性。
- 当证据不足时，平台会明确提示无法确认根因，不会自动生成维修结论。
平台提供证据组织和治理辅助，不代替现场诊断、维修审批或安全作业流程。
9. 治理知识检索与问答
- 输入设备名称、来源标识或治理问题。
- 先查看检索结果及权限范围。
- 发起问答后核对回答状态、来源证据和引用。
- 模型不可用或证据不足时，平台会拒绝推测性回答。
- 需要业务决策时回到原始台账、事件和责任记录复核。
不同角色可能看到不同结果。查看者没有业务域权限时，空结果不代表平台没有 该数据。
10. 治理指标
治理指标中心展示台账完整率、责任覆盖率、实体映射率、质量问题闭环率和 复发率等指标。点击指标详情查看分子、分母和对象范围。指标下降时应先确认 统计范围和授权，再进入对应业务模块处理，不能只修改展示结果。
11. 管理功能
管理员可使用以下能力：
- 用户和角色：创建、停用用户并分配 admin、editor、viewer 角色。
- 治理责任：维护业务范围、责任角色和责任人。
- 审计中心：查看关键操作类别、安全检查和审计封印。
停用账号后应验证无法重新登录。角色变更后应使用目标账号复核页面入口和服务 端权限，不能只看管理员列表中的角色名称。
12. 常见问题
| 现象 | 建议检查 |
|---|---|
| 页面没有数据 | 当前角色的业务域授权、筛选条件、来源数据是否存在 |
| 按钮不可见 | 当前账号是否为 viewer，只读提示是否显示 |
| 请求返回 403 | 当前角色不具备该操作权限，联系管理员确认职责 |
| 导入返回 422 | 模板字段、必填值、枚举值和数据格式 |
| 知识问答无答案 | 模型状态、证据数量、权限范围和问题关键词 |
| 根因分析拒绝结论 | 关联事件、设备、质量问题或维护证据不充分 |
13. 使用约束
- 不在平台中录入明文密码、令牌或不必要的个人敏感信息。
- 不通过共享管理员账号绕过职责分离。
- 不把演示数据验证结果当作企业真实数据验收结论。
- 不把模型生成内容当作无须复核的事实或维修指令。
- 发现权限越界、数据错误或审计缺失时立即停止相关操作并上报。