14.7 系统日志
系统日志用于记录用户对 IDMP 系统对象的所有修改操作。启用该功能后，IDMP 会自动生成不可修改的操作日志，完整保留每一次变更的执行人、时间、对象与前后内容，并提供查询、筛选和导出接口，便于合规审计和安全追溯。
该功能参考 21 CFR Part 11 等行业规范对电子记录的可追溯性要求设计，适用于医药、食品、能源、重工等对操作留痕有严格要求的行业场景。
系统日志菜单对所有具有相应权限的用户持续可见；功能的启用、关闭在 管理控制台 → 系统日志 页面内进行设置。
14.7.1 主要特点
- 全量记录： 覆盖所有系统对象（元素、模板、数据源、用户、角色、权限、系统配置等）的创建、修改、删除以及登录登出等关键操作
- 不可修改： 日志一经写入即无法编辑或删除，任何用户（包括超级管理员）均不具备修改权限
- 完整上下文： 每条日志包含操作人、操作时间、操作类型、对象类型、对象标识、变更前后的关键字段值以及来源 IP 等信息
- 可查询、可导出： 具有查看权限的用户可按时间、关键词、对象类型、操作类型等维度筛选查询，并将结果导出为 CSV 文件，供审计人员离线分析或归档
14.7.2 权限管理
系统日志功能设有独立的专属权限，分为以下两个层级：
- 查看系统日志： 具有该权限的用户可查看、筛选、搜索并导出系统日志
- 配置系统日志： 具有该权限的用户可修改系统日志配置，包括开启、关闭，以及各管控级别（如变更管理等）的设置
各角色的默认权限如下，超级管理员可按需为其他用户调整权限：
| 角色 | 查看系统日志 | 配置系统日志 |
|---|---|---|
| 工厂经理与主管 | ✓ | — |
| IT/OT 系统管理员 | ✓ | — |
| 维护人员 | — | — |
| 数据分析师 | — | — |
| 运营人员 | — | — |
| 工艺工程师 | — | — |
| 超级管理员 | ✓ | ✓ |
日志的开启、关闭及配置修改操作均需拥有配置系统日志权限，相关操作本身也会被写入审计日志。
14.7.3 管控级别
系统日志分为以下四个管控级别，级别由低到高逐步增强审计与合规能力：
| 级别 | 名称 | 说明 |
|---|---|---|
| 第一级 | Baseline 基础防护 | IDMP 的初始默认状态，不开启日志记录 |
| 第二级 | Log & Audit 日志记录 | 开启系统日志，记录所有操作日志，对普通用户无其他影响 |
| 第三级 | Change Control 变更管理 | 开启变更管理，用户针对特定对象的修改，需填写变更原因方可保存 |
| 第四级 | Review & Approval 复核管控 | 在变更管理基础上增加二次密码验证/电子签名，可选接入第三方审核（此级别功能规划中，暂未开放） |
在资源安全配置页面，可针对不同资源对象分别配置是否启用变更管理，保存后即刻生效。
14.7.4 启用系统日志
首次启用
- 进入 管理控制台 → 系统日志，右侧页面会提示当前日志功能尚未开启。
- 具有配置系统日志权限的用户，在提示信息下方可看到开启系统日志按钮，点击后系统弹出二次确认对话框。
- 再次点击确认后，立即生效并刷新列表，日志功能即正式生效，后续所有被审计的操作均开始记录。
启用前发生的操作不会被追溯记录。建议在系统正式上线或有合规审计要求时尽早开启。
日志配置
当日志开启后， 点击 管理控制台 → 系统配置 → 资源安全配置，进入资源安全配置页面。
此时，具有配置权限的用户可以点击编辑按钮，为每一类资源对象配置是否需要提交变更原因。一旦开通后，再对这类资源进行对应的操作时，必须提交变更原因。
查看日志
- 进入 管理控制台 → 系统日志，右侧页面会出现操作日志记录。
- 用户可根据资源类型，操作类型，时间段和关键词进行过滤查询。
- 用户点击设置表格显示列按钮控制列表显示字段（如新值，旧值等）。
开启与关闭
- 进入 管理控制台 → 系统日志，点击操作栏右侧的关闭系统日志按钮（仅具有配置系统日志权限的用户可见）。
- 关闭后，系统将不再记录操作日志，但是用户可以查看之前的操作日志。
- 开启后，系统将继续记录操作日志。
14.7.5 保存变更原因
配置资源在修改、删除需要提交变更原因后，用户对该对象进行修改或删除等关键操作并点击保存时，系统会弹出对话框，要求用户填写本次变更的原因后方可继续。
用户需要描述本次修改变更的业务背景或动因，如"工艺参数优化""设备更换""合规整改"等，并完整描述本次修改的具体对象和修改操作。
点击验证并继续后，系统会在完成对象变更的同时，将本次操作写入审计日志。日志中除包含 14.7.6 查看与查询 列出的常规字段外，还会额外保存以下内容：
- 变更原因：用户填写的变更原因全文
- 变更前状态快照：对象在本次操作之前的完整属性值
- 变更后状态快照：对象在本次操作之后的完整属性值
两份状态快照以 JSON 形式存储，必要时可用于对象的手动回滚。
- 只有在系统日志开启时，弹出对话框且变更原因输入框才会出现；关闭不会弹框，也不会保存系统日志。
- 对于批量操作（如批量删除元素），变更原因会通过操作接口统一应用到批量操作涉及的所有对象日志。
14.7.6 查看与查询
具有查看系统日志权限的用户可通过 管理控制台 → 系统日志 访问日志列表。页面以表格形式展示所有已记录的操作日志，按时间倒序排列。 日志列表包含以下字段，可以通过操作栏最右侧的设置按钮对显示列进行调整：
| 字段 | 说明 |
|---|---|
| 操作时间 | 操作发生的服务器时间，精确到秒 |
| 操作用户 | 执行操作的登录用户名 |
| 来源 IP | 发起请求的客户端 IP 地址 |
| 操作类型 | 创建、修改、删除、登录、登出等 |
| 对象类型 | 被操作对象的类别，如元素、模板、用户、角色、系统配置等 |
| 对象标识 | 被操作对象的名称或唯一标识 |
| 旧值 | 本次操作涉及的具体字段变更前的值 |
| 新值 | 本次操作涉及的具体字段变更后的值 |
| 操作结果 | 成功或失败；失败时附带错误信息 |
| 数据指纹 | 对该日志关键信息摘要的加密储存，确保原始信息完整且未被修改 |
筛选与搜索
日志展示与查询页面提供筛选栏，支持按以下维度组合进行筛选，悬浮查看单元格完整内容。
- 时间范围： 选择起止时间，快速定位特定时段的操作
- 对象类型： 下拉选择，如元素、模板、用户等
- 操作类型： 下拉选择，如创建、修改、删除等
- 关键字： 在对象标识或操作详情中模糊搜索
14.7.7 导出日志
在日志列表页面点击右上角的导出按钮，系统会将当前筛选条件下的全部日志导出为 CSV 文件。导出内容包含列表中展示的所有字段，并附带变更详情的完整 JSON 信息，便于导入第三方审计工具进一步分析。
若日志数据量较大，建议在导出前通过时间范围和对象类型进行筛选，以缩小导出规模，提升处理效率。
14.7.8 日志保留与存储
系统日志存储在 IDMP 系统后台配置的 TSDB 数据库中，默认保留 10 年的历史日志。
14.7.9 安全与合规说明
- 具有查看系统日志权限的用户可访问日志列表页面并执行导出操作
- 具有配置系统日志权限的用户可进行日志的开启、关闭及管控级别设置
- 系统日志的写入由后端服务直接完成，任何前端接口均不提供修改或删除日志的能力
- 日志的开启、关闭及配置变更操作本身均会被记录在审计日志中，确保配置变更可追溯
- 针对合规审计场景，建议结合 14.4 用户管理 的角色与权限控制，确保系统操作人可追溯到唯一自然人账号，避免共享账号
