|
|
# 操作日志
|
|
|
|
|
|
> 模块编码：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 | — | 巡检/保洁/考勤补录审核 |
|
|
|
|
|
|
## 业务规则
|
|
|
|
|
|
1. **日志记录范围**：在线报修/巡检管理/保洁管理/考勤打卡/服务评价/组织架构/系统配置（来源：03-物业公司 §8.1）
|
|
|
2. **自动记录**：所有写操作通过AOP切面统一记录，业务代码无感知（来源：06 §4.5）
|
|
|
3. **记录内容**：操作人、时间、IP、模块、操作类型、变更前后数据快照（来源：06 §4.5 / 03-物业公司 §8.2）
|
|
|
4. **日志保留**：至少保留1年，支持导出（来源：06 §4.5）
|
|
|
5. **物业管理员数据范围**：仅查看本公司绑定医院的操作日志（来源：01 §1.3）
|