# 统计概览功能

> 模块编码：statistics
> 端侧：微信小程序
> 关联文档：01-模块划分.md（v4.0）、02-功能清单-小程序端.md（§8）、03-业务流转逻辑-小程序端.md（§8）、05-接口规范.md（§9）、06-项目技术要求.md

## 功能概览

| 项目 | 说明 |
|------|------|
| 菜单名称 | 统计概览 |
| 子菜单 | 简版统计概览 / 个人绩效统计 |
| 功能编号 | MP-ST-01 ~ MP-ST-02 |
| 权限编码 | statistics:{module}:* |

## 页面清单

### 页面1：简版统计概览

- **页面路径**：`/pages/statistics/overview`
- **适用角色**：管理员/主管
- **页面元素**：
  - 今日/本周切换标签
  - 关键指标卡片组
  - 简版趋势图
- **查询条件**：
  - 时间范围切换（今日/本周）
- **列表字段**：无（概览卡片模式）
- **界面布局**：
  - 顶部：今日/本周切换标签
  - 中部：四组指标卡片
    - **报修**：今日工单数 / 待处理 / 已完成
    - **巡检**：今日任务数 / 已完成 / 异常
    - **保洁**：今日任务数 / 已完成 / 超时
    - **考勤**：今日出勤率
  - 底部：简版趋势折线图（近7天工单量）
- **操作按钮**：
  - 无（纯展示页面，详细数据在Web端查看）

**数据来源**：物业公司各业务模块实时数据

**按角色权限显示**：
- 全局管理员：显示全部指标
- 主管：仅显示所管辖模块的指标

**需求追溯**：

| 功能点编号 | 功能名称 | 文档来源 | 后续服务 | 关联功能 |
|------------|----------|----------|----------|----------|
| MP-ST-01 | 简版统计概览 | 02-小程序端 §8 | 无 | 统计报表（Web端） |

---

### 页面2：个人绩效统计

- **页面路径**：`/pages/statistics/personal`
- **适用角色**：员工
- **页面元素**：
  - 个人关键指标卡片
  - 绩效评分展示
  - 近期趋势图
- **查询条件**：
  - 时间范围选择（本周/本月）
- **列表字段**：无（概览卡片模式）
- **界面布局**：
  - 顶部：时间范围选择
  - 中部：绩效指标卡片
    - **工单量**：已完成工单数 / 平均处理时长
    - **评分**：平均评分 / 评价数
    - **考勤**：出勤天数 / 迟到次数
  - 底部：近期绩效趋势图
- **操作按钮**：
  - 无（纯展示页面）

**数据来源**：
- 报修模块工单数据
- 评价模块评分数据
- 考勤模块打卡数据

**需求追溯**：

| 功能点编号 | 功能名称 | 文档来源 | 后续服务 | 关联功能 |
|------------|----------|----------|----------|----------|
| MP-ST-02 | 个人绩效统计 | 02-小程序端 §8 | 无 | 统计报表（Web端） |

---

## 业务规则

1. **数据实时性**：统计数据基于各业务模块实时数据计算
2. **权限隔离**：管理员/主管看到团队指标，员工仅看到个人绩效
3. **简版展示**：小程序端为简版概览，详细报表在Web端查看
4. **时间范围**：支持今日/本周切换，个人绩效支持本周/本月
5. **趋势图**：展示近7天数据趋势，辅助快速判断
6. **出勤率计算**：出勤率 = 实际出勤人数 / 应出勤人数 × 100%
7. **数据来源汇总**：

| 指标 | 数据来源 |
|------|----------|
| 工单数/待处理/已完成 | 报修模块工单数据 |
| 巡检任务数/已完成/异常 | 巡检模块任务数据 |
| 保洁任务数/已完成/超时 | 保洁模块任务数据 |
| 出勤率 | 考勤模块打卡数据 |
| 个人评分 | 评价模块评分数据 |

## 状态流转

本模块为纯展示功能，无状态流转。