You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
操作日志
模块编码：audit-log
端侧：Web专属
关联文档：01-模块划分 §3.8 / 02-功能清单-物业公司 §8 / 03-业务流转逻辑-物业公司 §8 / 05-接口规范 §9.2 / 06-项目技术要求 §4.5
功能概览
| 项目 |
说明 |
| 菜单名称 |
操作日志 |
| 子菜单 |
日志时间轴、日志列表、日志详情、日志导出、数据补录日志 |
| 功能编号 |
PR-AL-01 ~ PR-AL-05 |
| 权限编码前缀 |
audit-log:list:* / audit-log:supplement:view |
页面1：日志时间轴页
页面编号：PR-AL-01-P01
端侧归属：Web专属
页面路径：/audit-log/timeline
界面布局
┌──────────────────────────────────────────────────────────────────┐
│ [面包屑] 操作日志 > 日志时间轴 │
├──────────────────────────────────────────────────────────────────┤
│ [查询条件区] │
│ 模块[▼] 操作人[____] 日期[起始]~[结束] [查询] [重置] │
├──────────────────────────────────────────────────────────────────┤
│ [时间轴视图] │
│ ┃ 2026-04-16 10:30:25 张三 提交了报修工单 #WX20260416001 │
│ ┃ [查看详情] │
│ ┃ 2026-04-16 10:15:10 李四 审批通过了延期申请 #DQ20260416003 │
│ ┃ [查看详情] │
│ ┃ 2026-04-16 09:45:00 王五 完成了巡检打卡 门诊楼1层 │
│ ┃ [查看详情] │
│ ┃ 2026-04-16 09:00:12 赵六 上班打卡 1号楼大厅 │
│ ▼ [查看详情] │
└──────────────────────────────────────────────────────────────────┘
查询条件
| 字段名 |
控件类型 |
必填 |
默认值 |
说明 |
| 模块 |
下拉单选 |
否 |
全部 |
报修/巡检/保洁/考勤/评价/组织架构/系统配置 |
| 操作人 |
文本输入 |
否 |
— |
模糊匹配 |
| 日期范围 |
日期范围 |
否 |
今天 |
— |
操作按钮
| 按钮 |
权限编码 |
位置 |
显示条件 |
说明 |
| 查看详情 |
audit-log:list:view |
时间轴节点 |
始终 |
弹窗展示完整信息 |
API端点
| 页面操作 |
API路径 |
方法 |
说明 |
| 时间轴查询 |
/api/v1/audit-logs/timeline |
GET |
— |
页面2：日志列表页
页面编号：PR-AL-02-P01
端侧归属：Web专属
页面路径：/audit-log/list
查询条件
| 字段名 |
控件类型 |
必填 |
默认值 |
说明 |
| 模块 |
下拉单选 |
否 |
全部 |
— |
| 操作人 |
文本输入 |
否 |
— |
模糊匹配 |
| 操作类型 |
下拉多选 |
否 |
全部 |
查看/新增/编辑/删除/审批/导出/分配 |
| 日期范围 |
日期范围 |
否 |
今天 |
— |
列表字段
| 序号 |
字段名 |
列宽 |
支持排序 |
说明 |
| 1 |
操作时间 |
150px |
是 |
默认倒序 |
| 2 |
操作人 |
80px |
否 |
— |
| 3 |
模块 |
80px |
否 |
— |
| 4 |
操作类型 |
80px |
否 |
彩色标签 |
| 5 |
操作内容 |
250px |
否 |
— |
| 6 |
响应状态 |
80px |
否 |
成功(绿)/失败(红) |
| 7 |
操作 |
80px |
— |
查看详情 |
操作按钮
| 按钮 |
权限编码 |
位置 |
显示条件 |
说明 |
| 查看详情 |
audit-log:list:view |
行操作 |
始终 |
弹窗 |
日志详情弹窗
┌──────────────────────────────────────────────────────────────────┐
│ 操作日志详情 [×] │
├──────────────────────────────────────────────────────────────────┤
│ 操作人：张三（水电维修班） │
│ 操作时间：2026-04-16 10:30:25 │
│ 操作IP：192.168.1.100 │
│ 操作模块：在线报修 → 工单列表 → 工单管理 → 新增 │
│ 操作内容：提交报修工单 #WX20260416001 │
│ 变更前数据：（无，新增操作） │
│ 变更后数据：{ "id": "WX20260416001", "type": "水电", ... } │
│ 请求参数：{ "type": "水电", "description": "3楼灯管不亮", ... } │
│ 响应状态：成功 │
├──────────────────────────────────────────────────────────────────┤
│ [关闭] │
└──────────────────────────────────────────────────────────────────┘
API端点
| 页面操作 |
API路径 |
方法 |
说明 |
| 列表查询 |
/api/v1/audit-logs |
GET |
分页查询 |
| 详情 |
/api/v1/audit-logs/{id} |
GET |
含完整信息 |
页面3：日志导出
页面编号：PR-AL-04-P01
端侧归属：Web专属
页面路径：导出弹窗
操作按钮
| 按钮 |
权限编码 |
位置 |
显示条件 |
说明 |
| 导出Excel |
audit-log:list:export |
列表页操作栏 |
始终 |
导出当前筛选结果 |
页面4：数据补录日志页
页面编号：PR-AL-05-P01
端侧归属：Web专属
页面路径：/audit-log/supplement
查询条件
| 字段名 |
控件类型 |
必填 |
默认值 |
说明 |
| 模块 |
下拉单选 |
否 |
全部 |
巡检/保洁/考勤 |
| 补录人 |
文本输入 |
否 |
— |
模糊匹配 |
| 审核状态 |
下拉单选 |
否 |
全部 |
待审核/通过/驳回 |
| 日期范围 |
日期范围 |
否 |
— |
— |
列表字段
| 序号 |
字段名 |
列宽 |
支持排序 |
说明 |
| 1 |
补录时间 |
140px |
是 |
默认倒序 |
| 2 |
补录人 |
80px |
否 |
— |
| 3 |
模块 |
80px |
否 |
— |
| 4 |
补录原因 |
100px |
否 |
蓝牙故障/系统异常/其他 |
| 5 |
审核状态 |
90px |
否 |
— |
| 6 |
审核人 |
80px |
否 |
— |
| 7 |
审核时间 |
140px |
否 |
— |
操作按钮
| 按钮 |
权限编码 |
位置 |
显示条件 |
说明 |
| 查看详情 |
audit-log:supplement:view |
行操作 |
始终 |
— |
API端点
| 页面操作 |
API路径 |
方法 |
说明 |
| 补录日志 |
/api/v1/audit-logs/supplement |
GET |
— |
需求追溯
| 功能点编号 |
功能名称 |
文档来源 |
后续服务 |
关联功能 |
| PR-AL-01 |
日志时间轴 |
02-物业公司 §8 / 03-物业公司 §8.2 |
— |
— |
| PR-AL-02 |
日志列表 |
02-物业公司 §8 / 03-物业公司 §8.2 |
— |
— |
| PR-AL-03 |
日志详情 |
02-物业公司 §8 / 03-物业公司 §8.2 |
— |
— |
| PR-AL-04 |
日志导出 |
02-物业公司 §8 |
— |
— |
| PR-AL-05 |
数据补录日志 |
02-物业公司 §8 / 03-物业公司 §8.1 |
— |
巡检/保洁/考勤补录审核 |
业务规则
- 日志记录范围：在线报修/巡检管理/保洁管理/考勤打卡/服务评价/组织架构/系统配置（来源：03-物业公司 §8.1）
- 自动记录：所有写操作通过AOP切面统一记录，业务代码无感知（来源：06 §4.5）
- 记录内容：操作人、时间、IP、模块、操作类型、变更前后数据快照（来源：06 §4.5 / 03-物业公司 §8.2）
- 日志保留：至少保留1年，支持导出（来源：06 §4.5）
- 物业管理员数据范围：仅查看本公司绑定医院的操作日志（来源：01 §1.3）