# 管理员小程序功能

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

## 功能概览

| 项目 | 说明 |
|------|------|
| 菜单名称 | 管理工作台 |
| 子菜单 | 报修管理 / 巡检管理 / 保洁管理 / 考勤管理 / 评价管理 / 组织架构查看 |
| 功能编号 | MP-PM-01 ~ MP-PM-06 |
| 权限编码 | repair:list:*、inspection:*:*、cleaning:*:*、attendance:*:*、evaluation:list:*、org:team:view |

> **说明**：管理员小程序功能是物业公司管理员/主管在小程序端的简化版管理功能，与Web端功能对应但功能简化。所有数据与Web端同一数据源，操作实时同步。

## 页面清单

### 页面1：报修管理

- **页面路径**：`/pages/manager/repair`
- **适用角色**：物业管理员/主管
- **页面元素**：
  - 工单统计卡片（待分配/处理中/待验收/已完成）
  - 工单列表
  - 工单分配操作
  - 工单流转操作
- **查询条件**：
  - 状态筛选（全部/待分配/处理中/待验收/已完成）
  - 日期筛选
  - 类型筛选
  - 关键词搜索
- **列表字段**：

| 字段 | 类型 | 说明 |
|------|------|------|
| 工单编号 | 文本 | 报修工单号 |
| 报修类型 | 标签 | 报修分类 |
| 报修描述 | 文本 | 问题描述摘要 |
| 报修人 | 文本 | 提交人姓名 |
| 状态 | 标签 | 待分配/处理中/待验收/已完成 |
| 创建时间 | 时间 | 工单创建时间 |

- **界面布局**：
  - 顶部：统计数字横向排列
  - 中部：筛选条件 + 工单卡片列表
  - 底部：操作按钮
- **操作按钮**：
  - 「分配」→ 分配工单到班组/人员（权限：repair:list:assign）
  - 「查看详情」→ 查看工单详情
  - 「审批延期」→ 审批维修人员延期申请（权限：repair:detail:approve）

**需求追溯**：

| 功能点编号 | 功能名称 | 文档来源 | 后续服务 | 关联功能 |
|------------|----------|----------|----------|----------|
| MP-PM-01 | 报修管理 | 02-小程序端 §9 | 通知维修人员 | 在线报修（Web端） |

---

### 页面2：巡检管理

- **页面路径**：`/pages/manager/inspection`
- **适用角色**：物业管理员/主管
- **页面元素**：
  - 巡检统计卡片（今日任务/已完成/异常）
  - 巡检看板（人员执行状态）
  - 巡检记录列表
  - 异常记录查看
- **查询条件**：
  - 日期筛选
  - 状态筛选
  - 人员筛选
- **列表字段**：

| 字段 | 类型 | 说明 |
|------|------|------|
| 计划名称 | 文本 | 巡检计划名称 |
| 执行人 | 文本 | 巡检人员姓名 |
| 区域 | 文本 | 巡检区域 |
| 状态 | 标签 | 待执行/进行中/已完成 |
| 异常数 | 数字 | 发现异常数量 |

- **界面布局**：
  - 顶部：统计数字 + 看板缩略
  - 中部：巡检记录卡片列表
  - 底部：无操作栏
- **操作按钮**：
  - 「查看详情」→ 查看巡检记录详情
  - 「审核补录」→ 审核巡检补录申请（权限：inspection:supplement:approve）

**需求追溯**：

| 功能点编号 | 功能名称 | 文档来源 | 后续服务 | 关联功能 |
|------------|----------|----------|----------|----------|
| MP-PM-02 | 巡检管理 | 02-小程序端 §9 | 无 | 巡检管理（Web端） |

---

### 页面3：保洁管理

- **页面路径**：`/pages/manager/cleaning`
- **适用角色**：物业管理员/主管
- **页面元素**：
  - 保洁统计卡片（今日任务/已完成/超时）
  - 保洁任务列表
  - 排班查看
  - 抽查操作
- **查询条件**：
  - 日期筛选
  - 区域筛选
  - 状态筛选
- **列表字段**：

| 字段 | 类型 | 说明 |
|------|------|------|
| 任务名称 | 文本 | 保洁区域+类型 |
| 执行人 | 文本 | 保洁人员姓名 |
| 区域 | 文本 | 保洁区域 |
| 状态 | 标签 | 待执行/进行中/待抽查/已完成 |
| 抽查结果 | 标签 | 合格/不合格/待抽查 |

- **界面布局**：
  - 顶部：统计数字
  - 中部：任务卡片列表
  - 底部：抽查操作按钮
- **操作按钮**：
  - 「抽查」→ 标记抽查合格/不合格（权限：cleaning:spot-check:approve）
  - 「审核补录」→ 审核保洁补录申请（权限：cleaning:supplement:approve）
  - 「查看详情」→ 查看任务详情

**需求追溯**：

| 功能点编号 | 功能名称 | 文档来源 | 后续服务 | 关联功能 |
|------------|----------|----------|----------|----------|
| MP-PM-03 | 保洁管理 | 02-小程序端 §9 | 不合格时重新生成任务 | 保洁管理（Web端） |

---

### 页面4：考勤管理

- **页面路径**：`/pages/manager/attendance`
- **适用角色**：物业管理员/主管
- **页面元素**：
  - 今日出勤统计卡片（应到/实到/缺勤/异常）
  - 考勤记录列表
  - 异常申诉审核
- **查询条件**：
  - 日期筛选
  - 班组筛选
  - 状态筛选（正常/迟到/早退/缺卡/异常）
- **列表字段**：

| 字段 | 类型 | 说明 |
|------|------|------|
| 姓名 | 文本 | 员工姓名 |
| 班组 | 文本 | 所属班组 |
| 上班时间 | 时间 | 上班打卡时间 |
| 下班时间 | 时间 | 下班打卡时间 |
| 状态 | 标签 | 正常/迟到/早退/缺卡 |
| 打卡方式 | 标签 | 蓝牙/手动/补录 |

- **界面布局**：
  - 顶部：统计数字
  - 中部：考勤记录列表
  - 底部：审核操作按钮
- **操作按钮**：
  - 「审核申诉」→ 审核打卡异常申诉（权限：attendance:appeal:approve）
  - 「审核补录」→ 审核考勤补录（权限：attendance:supplement:approve）

**需求追溯**：

| 功能点编号 | 功能名称 | 文档来源 | 后续服务 | 关联功能 |
|------------|----------|----------|----------|----------|
| MP-PM-04 | 考勤管理 | 02-小程序端 §9 | 补录打卡记录 | 考勤打卡（Web端） |

---

### 页面5：评价管理

- **页面路径**：`/pages/manager/evaluation`
- **适用角色**：物业管理员/主管
- **页面元素**：
  - 评价统计卡片（总评价数/平均分/待回复）
  - 评价列表
  - 回复操作
- **查询条件**：
  - 评分筛选（全部/好评/中评/差评）
  - 回复状态筛选（全部/待回复/已回复）
  - 时间筛选
- **列表字段**：

| 字段 | 类型 | 说明 |
|------|------|------|
| 工单编号 | 文本 | 关联工单号 |
| 评分 | 数字 | 1~5分 |
| 评价内容 | 文本 | 留言摘要 |
| 评价时间 | 时间 | 提交评价时间 |
| 回复状态 | 标签 | 已回复/未回复 |

- **界面布局**：
  - 顶部：统计数字 + 平均分显示
  - 中部：评价卡片列表
  - 底部：回复操作
- **操作按钮**：
  - 「回复」→ 回复评价（权限：evaluation:list:update）
  - 「查看详情」→ 查看评价详情

**需求追溯**：

| 功能点编号 | 功能名称 | 文档来源 | 后续服务 | 关联功能 |
|------------|----------|----------|----------|----------|
| MP-PM-05 | 评价管理 | 02-小程序端 §9 | 通知报修人 | 服务评价（Web端） |

---

### 页面6：组织架构查看

- **页面路径**：`/pages/manager/org`
- **适用角色**：物业管理员/主管
- **页面元素**：
  - 班组列表
  - 班组成员查看
  - 人员基本信息查看
- **查询条件**：
  - 班组筛选
  - 关键词搜索（姓名/职位）
- **列表字段**：

| 字段 | 类型 | 说明 |
|------|------|------|
| 班组名称 | 文本 | 班组名 |
| 班组长 | 文本 | 负责人姓名 |
| 人数 | 数字 | 班组人数 |
| 技能标签 | 标签组 | 班组主要技能 |

- **界面布局**：
  - 顶部：搜索框 + 筛选
  - 中部：班组卡片列表 → 点击展开成员列表
  - 底部：无操作栏
- **操作按钮**：
  - 「查看班组」→ 展开班组成员列表
  - 「查看人员」→ 查看人员详情
  - 「拨打电话」→ 调用手机拨号功能

**数据来源**：与Web端组织架构同一数据源

**需求追溯**：

| 功能点编号 | 功能名称 | 文档来源 | 后续服务 | 关联功能 |
|------------|----------|----------|----------|----------|
| MP-PM-06 | 组织架构查看 | 02-小程序端 §9 | 无 | 组织架构（Web端） |

---

## 业务规则

1. **数据同步**：管理员小程序端与Web端同一数据源，操作实时同步
2. **功能简化**：小程序端为简化版管理功能，完整管理操作在Web端进行
3. **权限继承**：管理员小程序端的权限与Web端角色权限一致，通过四级权限体系控制
4. **双端审批**：以下审批场景支持Web+小程序双端操作：
   - 工单延期审批 ✅
   - 工单分配 ✅
   - 工单验收 ✅
   - 打卡异常审核 ✅
   - 数据补录审核 ✅
   - 保洁抽查 ✅
5. **仅限物业端审批**：合同审批、合同变更审批、合同续签审批、付款确认、定标审批仅Web端（医院账号）
6. **推送通知**：审批待办通过微信小程序推送通知管理员
7. **操作日志**：所有管理操作记录审计日志

## 状态流转

管理员小程序端的状态流转与Web端一致，具体参见各模块文档：
- 报修工单流转 → 参见02-功能清单-物业公司/01-在线报修.md
- 巡检任务流转 → 参见02-功能清单-物业公司/02-巡检管理.md
- 保洁任务流转 → 参见02-功能清单-物业公司/03-保洁管理.md

## 双端审批对照表

| 审批场景 | Web端 | 小程序端 | 审批角色 |
|----------|-------|----------|----------|
| 工单延期审批 | ✅ | ✅ | 物业(主管) |
| 工单分配 | ✅ | ✅ | 物业(主管) |
| 工单验收 | ✅ | ✅ | 物业(主管/报修人) |
| 合同审批 | ✅ | — | 医院账号（仅Web端） |
| 合同变更审批 | ✅ | — | 医院账号（仅Web端） |
| 合同续签审批 | ✅ | — | 医院账号（仅Web端） |
| 付款确认 | ✅ | — | 医院账号（仅Web端） |
| 定标审批 | ✅ | — | 医院账号（仅Web端） |
| 打卡异常审核 | ✅ | ✅ | 物业(主管) |
| 数据补录审核 | ✅ | ✅ | 物业(主管) |
| 保洁抽查 | ✅ | ✅ | 物业(主管) |