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.

244 lines
13 KiB
Markdown

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# 统计报表
> 模块编码statistics
> 端侧Web专属
> 关联文档01-模块划分 §3.7 / 02-功能清单-物业公司 §7 / 03-业务流转逻辑-物业公司 §7 / 05-接口规范 §9.2
## 功能概览
| 项目 | 说明 |
|------|------|
| 菜单名称 | 统计报表 |
| 子菜单 | 报修统计、巡检统计、保洁统计、评价统计、考勤统计、综合看板、自定义报表 |
| 功能编号 | PR-ST-01 ~ PR-ST-07 |
| 权限编码前缀 | statistics:repair:* / statistics:inspection:* / statistics:cleaning:* / statistics:evaluation:* / statistics:attendance:* / statistics:dashboard:* / statistics:custom:* |
---
## 页面1报修统计页
**页面编号**PR-ST-01-P01
**端侧归属**Web专属
**页面路径**/statistics/repair
### 界面布局
```
┌──────────────────────────────────────────────────────────────────┐
│ [面包屑] 统计报表 > 报修统计 │
├──────────────────────────────────────────────────────────────────┤
│ [时间选择] 今天 / 本周 / 本月 / 本年 / 自定义 [起始]~[结束] │
│ [筛选] 班组[▼] 区域[▼] 紧急程度[▼] │
├──────────────────────────────────────────────────────────────────┤
│ [统计卡片区] │
│ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ │
│ │总工单│ │待分配│ │处理中│ │已完成│ │已关闭│ │完成率│ │
│ │ 156 │ │ 12 │ │ 23 │ │ 108 │ │ 13 │ │ 69% │ │
│ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ │
├──────────────────────────────────────────────────────────────────┤
│ [图表区] │
│ ┌─────────────────────────┐ ┌─────────────────────────┐ │
│ │ 工单趋势(折线图) │ │ 类型分布(饼图) │ │
│ └─────────────────────────┘ └─────────────────────────┘ │
│ ┌─────────────────────────┐ │
│ │ 班组工单量排名(柱状图) │ │
│ └─────────────────────────┘ │
├──────────────────────────────────────────────────────────────────┤
│ [数据表格] │
│ 班组 | 总工单 | 已完成 | 完成率 | 平均处理时长 | 评分 │
│ 水电班 | 56 | 42 | 75% | 4.2小时 | 4.3 │
│ 木工班 | 32 | 28 | 87% | 3.8小时 | 4.5 │
├──────────────────────────────────────────────────────────────────┤
│ [操作] [导出Excel] [导出PDF] │
└──────────────────────────────────────────────────────────────────┘
```
### 操作按钮
| 按钮 | 权限编码 | 位置 | 显示条件 | 说明 |
|------|----------|------|----------|------|
| 导出Excel | statistics:repair:export | 操作栏 | 始终 | — |
| 导出PDF | statistics:repair:export | 操作栏 | 始终 | — |
### API端点
| 页面操作 | API路径 | 方法 | 说明 |
|----------|---------|------|------|
| 统计数据 | /api/v1/statistics/repair | GET | 含卡片+图表+表格 |
| 导出 | /api/v1/statistics/repair/export | GET | 支持Excel/PDF |
---
## 页面2巡检统计页
**页面编号**PR-ST-02-P01
**端侧归属**Web专属
**页面路径**/statistics/inspection
### 统计指标
| 指标 | 说明 |
|------|------|
| 总巡检任务数 | 统计时间段内任务总数 |
| 完成率 | 已完成/总数 |
| 异常率 | 有异常记录数/已完成数 |
| 补录率 | 补录记录数/总记录数 |
| 蓝牙打卡率 | 蓝牙打卡数/总打卡数 |
### 操作按钮
| 按钮 | 权限编码 | 位置 | 显示条件 | 说明 |
|------|----------|------|----------|------|
| 导出 | statistics:inspection:export | 操作栏 | 始终 | — |
---
## 页面3保洁统计页
**页面编号**PR-ST-03-P01
**端侧归属**Web专属
**页面路径**/statistics/cleaning
### 统计指标
| 指标 | 说明 |
|------|------|
| 总保洁任务数 | — |
| 完成率 | — |
| 超时率 | 超时任务数/总数 |
| 抽查合格率 | 抽查合格数/抽查总数 |
| 补录率 | — |
---
## 页面4评价统计页
**页面编号**PR-ST-04-P01
**端侧归属**Web专属
**页面路径**/statistics/evaluation
### 统计指标
| 指标 | 说明 |
|------|------|
| 总评价数 | — |
| 平均评分 | — |
| 各模块评分对比 | 报修/巡检/保洁/综合 |
| 低评分占比 | ≤2分评价占比 |
| 回复率 | 已回复/总评价数 |
---
## 页面5考勤统计页
**页面编号**PR-ST-05-P01
**端侧归属**Web专属
**页面路径**/statistics/attendance
### 统计指标
| 指标 | 说明 |
|------|------|
| 出勤率 | 实际打卡人数/应打卡人数 |
| 迟到率 | 迟到人数/实际打卡人数 |
| 早退率 | — |
| 异常申诉率 | 申诉数/总打卡次数 |
| 蓝牙打卡率 | 蓝牙打卡数/总打卡数 |
---
## 页面6综合看板页
**页面编号**PR-ST-06-P01
**端侧归属**Web专属
**页面路径**/statistics/dashboard
### 界面布局
```
┌──────────────────────────────────────────────────────────────────┐
│ [面包屑] 统计报表 > 综合看板 │
├──────────────────────────────────────────────────────────────────┤
│ [时间选择] 今天 / 本周 / 本月 / 自定义 │
├──────────────────────────────────────────────────────────────────┤
│ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ │
│ │报修 │ │巡检 │ │保洁 │ │考勤 │ │
│ │完成率│ │完成率│ │完成率│ │出勤率│ │
│ │ 69% │ │ 92% │ │ 85% │ │ 96% │ │
│ └──────┘ └──────┘ └──────┘ └──────┘ │
│ ┌──────┐ ┌──────┐ │
│ │评价 │ │待处理│ │
│ │均分 │ │工单 │ │
│ │ 4.2 │ │ 12 │ │
│ └──────┘ └──────┘ │
├──────────────────────────────────────────────────────────────────┤
│ [趋势图] 各模块指标趋势对比 │
└──────────────────────────────────────────────────────────────────┘
```
---
## 页面7自定义报表页
**页面编号**PR-ST-07-P01
**端侧归属**Web专属
**页面路径**/statistics/custom
### 界面布局
```
┌──────────────────────────────────────────────────────────────────┐
│ [面包屑] 统计报表 > 自定义报表 │
├──────────────────────────────────────────────────────────────────┤
│ [配置区] │
│ 数据源:[▼多选] (报修/巡检/保洁/评价/考勤) │
│ 维度:[▼多选] (时间/班组/区域/人员/类型) │
│ 指标:[▼多选] (数量/完成率/平均时长/评分...) │
│ 时间范围:[起始]~[结束] │
│ 筛选条件:[动态添加] │
├──────────────────────────────────────────────────────────────────┤
│ [操作] [生成报表] [保存模板] [导出] │
├──────────────────────────────────────────────────────────────────┤
│ [结果展示区] │
│ 图表 + 数据表格 │
└──────────────────────────────────────────────────────────────────┘
```
### 操作按钮
| 按钮 | 权限编码 | 位置 | 显示条件 | 说明 |
|------|----------|------|----------|------|
| 生成报表 | statistics:custom:view | 操作栏 | 始终 | — |
| 保存模板 | statistics:custom:create | 操作栏 | 始终 | 保存当前配置为模板 |
| 导出 | statistics:custom:export | 操作栏 | 已生成报表 | — |
### API端点
| 页面操作 | API路径 | 方法 | 说明 |
|----------|---------|------|------|
| 生成报表 | /api/v1/statistics/custom | POST | 自定义维度+指标 |
| 保存模板 | /api/v1/statistics/custom/templates | POST | — |
| 导出 | /api/v1/statistics/custom/export | GET | — |
---
## 需求追溯
| 功能点编号 | 功能名称 | 文档来源 | 后续服务 | 关联功能 |
|------------|----------|----------|----------|----------|
| PR-ST-01 | 报修统计 | 02-物业公司 §7 / 03-物业公司 §7 | — | 在线报修(数据源) |
| PR-ST-02 | 巡检统计 | 02-物业公司 §7 / 03-物业公司 §7 | — | 巡检管理(数据源) |
| PR-ST-03 | 保洁统计 | 02-物业公司 §7 / 03-物业公司 §7 | — | 保洁管理(数据源) |
| PR-ST-04 | 评价统计 | 02-物业公司 §7 / 03-物业公司 §7 | — | 服务评价(数据源) |
| PR-ST-05 | 考勤统计 | 02-物业公司 §7 / 03-物业公司 §7 | — | 考勤打卡(数据源) |
| PR-ST-06 | 综合看板 | 02-物业公司 §7 | — | 全部模块(数据源) |
| PR-ST-07 | 自定义报表 | 02-物业公司 §7 | — | 全部模块(数据源) |
## 业务规则
1. **时间维度**:支持天/周/月/年/自定义时间段查询来源02-物业公司 §7
2. **导出格式**支持Excel和PDF导出来源02-物业公司 §7
3. **数据权限**物业公司管理员看本公司绑定医院数据主管看本班组数据来源01 §1.3
4. **补录数据标记**统计报表中补录数据单独标记可筛选排除来源03-物业公司 §2.3
5. **导出日志**每次导出操作记录审计日志来源06 §4.5