|
|
# 管理员小程序功能
|
|
|
|
|
|
> 模块编码：property-manager
|
|
|
> 端侧：微信小程序
|
|
|
> 关联文档：01-模块划分.md（v4.0）、02-功能清单-小程序端.md（§9）、03-业务流转逻辑-小程序端.md（§9）、05-接口规范.md（§9）、06-项目技术要求.md
|
|
|
> 强制规范遵循 `07-前端界面开发规范.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端） |
|
|
|
|
|
|
### 交互流程要求
|
|
|
|
|
|
1. **页面加载流程**：进入页面 → 并行调用：统计卡片数据 + 工单列表（默认全部状态）
|
|
|
2. **筛选交互**：选择状态/日期/类型 → 触发列表刷新；搜索框输入 → 回车或点击搜索
|
|
|
3. **分配操作**：点击"分配"→ 弹出人员选择弹窗（按班组筛选）→ 选择人员 → 确认 → 调用API → 成功提示 → 推送通知维修人员
|
|
|
4. **查看详情**：点击工单卡片 → 跳转工单详情页
|
|
|
5. **审批延期**：点击"审批延期"→ 弹窗展示延期原因 → 同意/拒绝 → API调用 → 通知申请人
|
|
|
6. **异常处理**：分配失败提示；网络离线提示
|
|
|
7. **权限控制**：无分配权限 → "分配"按钮不显示；无审批权限 → "审批延期"不显示
|
|
|
|
|
|
8. **[H1]防重复请求**
|
|
|
- 分配操作：点击"分配"后按钮 disabled + loading态，API返回后恢复
|
|
|
- 审批延期操作：点击后弹窗底部确认按钮 disabled + loading
|
|
|
- 筛选切换：状态/日期切换时 abort 上一次列表请求再发新的
|
|
|
- 下拉刷新：refreshing 标志位防止重复触发
|
|
|
|
|
|
9. **[H2]超时与加载反馈**
|
|
|
- 统计卡片+列表查询 timeout=15秒
|
|
|
- 分配/审批操作 timeout=30秒
|
|
|
- 超过3秒 wx.showLoading({ title: '加载中', mask: true })
|
|
|
- 超时 → wx.showToast({ icon: 'none', title: '请求超时' }) + 重试按钮
|
|
|
|
|
|
10. **[H3]操作确认机制**
|
|
|
- 分配确认：选择人员后 uni.showModal({ content: '确定将工单分配给{人员姓名}？', success: res => { if(res.confirm) ... } })
|
|
|
- 审批延期同意：uni.showModal({ content: '确定同意该延期申请？', ... })
|
|
|
- 审批延期拒绝：必须填写拒绝原因（弹窗内输入框）
|
|
|
|
|
|
11. **[H8]操作结果反馈**
|
|
|
- 分配成功：wx.showToast({ icon: 'success', title: '分配成功' }) + 刷新列表
|
|
|
- 操作失败：wx.showToast({ icon: 'none', title: errMsg })
|
|
|
- 网络异常：wx.showModal({ title: '提示', content: '网络连接异常', confirmText: '重试' })
|
|
|
|
|
|
### 组件规范
|
|
|
|
|
|
| 元素 | 组件 | 配置参数 |
|
|
|
|------|------|----------|
|
|
|
| 页面容器 | scroll-view | scroll-y, refresher-enabled, @scrolltolower |
|
|
|
| 统计卡片 | view | class="stat-card", v-for, horizontal scroll |
|
|
|
| 状态筛选 | uni-segmented-control | :values="['全部','待分配','处理中','待验收','已完成']" |
|
|
|
| 工单列表 | view | v-for, class="order-card" |
|
|
|
| 状态标签 | uni-tag | :type按状态变化 |
|
|
|
| 分配按钮 | button | size="mini", type="primary" |
|
|
|
| 人员选择弹窗 | uni-popup | type="bottom" |
|
|
|
| 人员列表 | radio-group | v-for |
|
|
|
|
|
|
### 校验规则
|
|
|
|
|
|
无表单校验
|
|
|
|
|
|
### 响应式布局
|
|
|
|
|
|
- 适配机型：iPhone SE ~ iPad mini
|
|
|
- 统计卡片：横向滚动
|
|
|
- 工单卡片：全宽
|
|
|
- 触摸区域：按钮≥44px
|
|
|
|
|
|
---
|
|
|
|
|
|
### 页面2：巡检管理
|
|
|
|
|
|
- **页面路径**：`/pages/manager/inspection`
|
|
|
- **适用角色**：物业管理员/主管
|
|
|
- **页面元素**：
|
|
|
- 巡检统计卡片（今日任务/已完成/异常）
|
|
|
- 巡检看板（人员执行状态）
|
|
|
- 巡检记录列表
|
|
|
- 异常记录查看
|
|
|
- **查询条件**：
|
|
|
- 日期筛选
|
|
|
- 状态筛选
|
|
|
- 人员筛选
|
|
|
- **列表字段**：
|
|
|
|
|
|
| 字段 | 类型 | 说明 |
|
|
|
|------|------|------|
|
|
|
| 计划名称 | 文本 | 巡检计划名称 |
|
|
|
| 执行人 | 文本 | 巡检人员姓名 |
|
|
|
| 区域 | 文本 | 巡检区域 |
|
|
|
| 状态 | 标签 | 待执行/进行中/已完成 |
|
|
|
| 异常数 | 数字 | 发现异常数量 |
|
|
|
|
|
|
- **界面布局**：
|
|
|
- 顶部：统计数字 + 看板缩略
|
|
|
- 中部：巡检记录卡片列表
|
|
|
- 底部：无操作栏
|
|
|
- **操作按钮**：
|
|
|
- 「查看详情」→ 查看巡检记录详情
|
|
|
- 「审核补录」→ 审核巡检补录申请（权限：inspection:supplement:approve）
|
|
|
|
|
|
**需求追溯**：
|
|
|
|
|
|
| 功能点编号 | 功能名称 | 文档来源 | 后续服务 | 关联功能 |
|
|
|
|------------|----------|----------|----------|----------|
|
|
|
| MP-PM-02 | 巡检管理 | 02-小程序端 §9 | 无 | 巡检管理（Web端） |
|
|
|
|
|
|
### 交互流程要求
|
|
|
|
|
|
1. **页面加载流程**：进入页面 → 并行加载统计卡片 + 巡检记录列表
|
|
|
2. **筛选交互**：选择日期/状态/人员 → 触发列表刷新
|
|
|
3. **查看详情**：点击记录卡片 → 跳转巡检详情页
|
|
|
4. **审核补录**：点击"审核补录"→ 弹窗展示补录原因+证据 → 同意/拒绝 → API调用 → 通知申请人
|
|
|
5. **异常处理**：数据加载失败显示重试；网络离线提示
|
|
|
6. **权限控制**：无补录审核权限 → "审核补录"按钮不显示
|
|
|
7. **[H1]防重复请求**
|
|
|
- 筛选操作点击后 disabled + loading态，API返回后恢复
|
|
|
- 审核补录操作点击后 disabled + loading态
|
|
|
- 使用 pending 标志位去重，页面卸载时 onUnload 必须 abort 未完成请求（wx.requestTask.abort()）
|
|
|
8. **[H2]超时与加载反馈**
|
|
|
- GET列表查询 timeout=15秒；POST/PUT/DELETE写操作 timeout=30秒
|
|
|
- 超时 → wx.showToast({icon:'none', title:'请求超时，请检查网络后重试'})
|
|
|
- 加载>2秒显示 wx.showLoading
|
|
|
9. **[H3]操作确认机制**（有不可逆操作时）
|
|
|
- 审核补录: wx.showModal 确认
|
|
|
10. **[H8]操作结果反馈**
|
|
|
- 成功: wx.showToast({icon:'success', duration:2000})
|
|
|
- 失败: wx.showToast({icon:'none'}) 需手动关闭
|
|
|
- 网络/离线: 异常提示+重试按钮
|
|
|
|
|
|
### 组件规范
|
|
|
|
|
|
| 元素 | 组件 | 配置参数 |
|
|
|
|------|------|----------|
|
|
|
| 页面容器 | scroll-view | scroll-y, refresher-enabled |
|
|
|
| 统计卡片 | view | class="stat-card", v-for |
|
|
|
| 巡检记录列表 | view | v-for, class="inspection-card" |
|
|
|
| 状态标签 | uni-tag | 待执行:type="info", 进行中:type="primary", 已完成:type="success" |
|
|
|
| 审核补录弹窗 | uni-popup | type="bottom" |
|
|
|
| 同意/拒绝按钮 | button | 同意:type="primary", 拒绝:type="warn" |
|
|
|
|
|
|
### 校验规则
|
|
|
|
|
|
无
|
|
|
|
|
|
### 响应式布局
|
|
|
|
|
|
- 适配机型：iPhone SE ~ iPad mini
|
|
|
- 统计卡片横向排列
|
|
|
- 记录卡片全宽
|
|
|
- 按钮触摸区≥44px
|
|
|
|
|
|
---
|
|
|
|
|
|
### 页面3：保洁管理
|
|
|
|
|
|
- **页面路径**：`/pages/manager/cleaning`
|
|
|
- **适用角色**：物业管理员/主管
|
|
|
- **页面元素**：
|
|
|
- 保洁统计卡片（今日任务/已完成/超时）
|
|
|
- 保洁任务列表
|
|
|
- 排班查看
|
|
|
- 抽查操作
|
|
|
- **查询条件**：
|
|
|
- 日期筛选
|
|
|
- 区域筛选
|
|
|
- 状态筛选
|
|
|
- **列表字段**：
|
|
|
|
|
|
| 字段 | 类型 | 说明 |
|
|
|
|------|------|------|
|
|
|
| 任务名称 | 文本 | 保洁区域+类型 |
|
|
|
| 执行人 | 文本 | 保洁人员姓名 |
|
|
|
| 区域 | 文本 | 保洁区域 |
|
|
|
| 状态 | 标签 | 待执行/进行中/待抽查/已完成 |
|
|
|
| 抽查结果 | 标签 | 合格/不合格/待抽查 |
|
|
|
|
|
|
- **界面布局**：
|
|
|
- 顶部：统计数字
|
|
|
- 中部：任务卡片列表
|
|
|
- 底部：抽查操作按钮
|
|
|
- **操作按钮**：
|
|
|
- 「抽查」→ 标记抽查合格/不合格（权限：cleaning:spot-check:approve）
|
|
|
- 「审核补录」→ 审核保洁补录申请（权限：cleaning:supplement:approve）
|
|
|
- 「查看详情」→ 查看任务详情
|
|
|
|
|
|
**需求追溯**：
|
|
|
|
|
|
| 功能点编号 | 功能名称 | 文档来源 | 后续服务 | 关联功能 |
|
|
|
|------------|----------|----------|----------|----------|
|
|
|
| MP-PM-03 | 保洁管理 | 02-小程序端 §9 | 不合格时重新生成任务 | 保洁管理（Web端） |
|
|
|
|
|
|
### 交互流程要求
|
|
|
|
|
|
1. **页面加载**：进入页面 → 加载统计卡片 + 保洁任务列表
|
|
|
2. **抽查操作**：点击"抽查"→ 弹窗选择合格/不合格 → 提交 → 不合格时系统自动重新生成任务
|
|
|
3. **审核补录**：同巡检补录审核流程
|
|
|
4. **异常处理**：抽查提交失败提示；不合格重新生成任务失败提示
|
|
|
|
|
|
5. **[H1]防重复请求**
|
|
|
- 抽查操作：点击"抽查"后按钮 disabled + 弹窗确认按钮 loading
|
|
|
- 审核补录：同上
|
|
|
- 筛选切换时 abort 上次请求
|
|
|
|
|
|
6. **[H2]超时与加载反馈**
|
|
|
- 列表查询 timeout=15秒；抽查/审核操作 timeout=30秒
|
|
|
- >3秒 wx.showLoading；超时提示+重试
|
|
|
|
|
|
7. **[H3]操作确认机制**
|
|
|
- 抽查不合格：uni.showModal({ content: '确定标记为不合格？系统将自动重新生成任务', ... })
|
|
|
- 抽查合格：uni.showModal({ content: '确定标记为合格？', ... })
|
|
|
|
|
|
8. **[H8]操作结果反馈**
|
|
|
- 成功：wx.showToast({ icon: 'success' }) + 刷新
|
|
|
- 失败：wx.showToast({ icon: 'none', title: errMsg })
|
|
|
|
|
|
### 组件规范
|
|
|
|
|
|
| 元素 | 组件 | 配置参数 |
|
|
|
|------|------|----------|
|
|
|
| 抽查弹窗 | uni-popup | type="bottom" |
|
|
|
| 合格/不合格 | radio-group | 合格/不合格 |
|
|
|
| 抽查结果标签 | uni-tag | 合格:type="success", 不合格:type="error", 待抽查:type="info" |
|
|
|
|
|
|
### 校验规则
|
|
|
|
|
|
无
|
|
|
|
|
|
### 响应式布局
|
|
|
|
|
|
- 适配机型：iPhone SE ~ iPad mini
|
|
|
- 触摸区域≥44px
|
|
|
|
|
|
---
|
|
|
|
|
|
### 页面4：考勤管理
|
|
|
|
|
|
- **页面路径**：`/pages/manager/attendance`
|
|
|
- **适用角色**：物业管理员/主管
|
|
|
- **页面元素**：
|
|
|
- 今日出勤统计卡片（应到/实到/缺勤/异常）
|
|
|
- 考勤记录列表
|
|
|
- 异常申诉审核
|
|
|
- **查询条件**：
|
|
|
- 日期筛选
|
|
|
- 班组筛选
|
|
|
- 状态筛选（正常/迟到/早退/缺卡/异常）
|
|
|
- **列表字段**：
|
|
|
|
|
|
| 字段 | 类型 | 说明 |
|
|
|
|------|------|------|
|
|
|
| 姓名 | 文本 | 员工姓名 |
|
|
|
| 班组 | 文本 | 所属班组 |
|
|
|
| 上班时间 | 时间 | 上班打卡时间 |
|
|
|
| 下班时间 | 时间 | 下班打卡时间 |
|
|
|
| 状态 | 标签 | 正常/迟到/早退/缺卡 |
|
|
|
| 打卡方式 | 标签 | 蓝牙/手动/补录 |
|
|
|
|
|
|
- **界面布局**：
|
|
|
- 顶部：统计数字
|
|
|
- 中部：考勤记录列表
|
|
|
- 底部：审核操作按钮
|
|
|
- **操作按钮**：
|
|
|
- 「审核申诉」→ 审核打卡异常申诉（权限：attendance:appeal:approve）
|
|
|
- 「审核补录」→ 审核考勤补录（权限：attendance:supplement:approve）
|
|
|
|
|
|
**需求追溯**：
|
|
|
|
|
|
| 功能点编号 | 功能名称 | 文档来源 | 后续服务 | 关联功能 |
|
|
|
|------------|----------|----------|----------|----------|
|
|
|
| MP-PM-04 | 考勤管理 | 02-小程序端 §9 | 补录打卡记录 | 考勤打卡（Web端） |
|
|
|
|
|
|
### 交互流程要求
|
|
|
|
|
|
1. **页面加载**：进入页面 → 加载今日出勤统计 + 考勤记录列表
|
|
|
2. **审核申诉**：点击"审核申诉"→ 弹窗展示申诉原因+证据 → 同意/拒绝 → API调用
|
|
|
3. **审核补录**：同上补录审核流程
|
|
|
4. **异常处理**：审核失败提示
|
|
|
|
|
|
5. **[H1]防重复请求**
|
|
|
- 审核申诉/补录：操作按钮点击后 disabled + loading
|
|
|
- 筛选切换 abort 上次请求
|
|
|
|
|
|
6. **[H2]超时与加载反馈**
|
|
|
- 列表查询 timeout=15秒；审核操作 timeout=30秒
|
|
|
- >3秒 wx.showLoading；超时提示+重试
|
|
|
|
|
|
7. **[H3]操作确认机制**
|
|
|
- 审核通过：uni.showModal({ content: '确定同意该申诉/补录？', ... })
|
|
|
- 审核拒绝：uni.showModal + 必填拒绝原因
|
|
|
|
|
|
8. **[H8]操作结果反馈**
|
|
|
- 成功：wx.showToast({ icon: 'success' }) + 刷新
|
|
|
- 失败：wx.showToast({ icon: 'none', title: errMsg })
|
|
|
|
|
|
### 组件规范
|
|
|
|
|
|
| 元素 | 组件 | 配置参数 |
|
|
|
|------|------|----------|
|
|
|
| 统计卡片 | view | class="stat-card" |
|
|
|
| 状态标签 | uni-tag | 正常:type="success", 迟到:type="warning", 早退:type="warning", 缺卡:type="error" |
|
|
|
| 打卡方式标签 | uni-tag | 蓝牙:type="primary", 手动:type="info", 补录:type="warning" |
|
|
|
| 审核弹窗 | uni-popup | type="bottom" |
|
|
|
|
|
|
### 校验规则
|
|
|
|
|
|
无
|
|
|
|
|
|
### 响应式布局
|
|
|
|
|
|
- 适配机型：iPhone SE ~ iPad mini
|
|
|
- 触摸区域≥44px
|
|
|
|
|
|
---
|
|
|
|
|
|
### 页面5：评价管理
|
|
|
|
|
|
- **页面路径**：`/pages/manager/evaluation`
|
|
|
- **适用角色**：物业管理员/主管
|
|
|
- **页面元素**：
|
|
|
- 评价统计卡片（总评价数/平均分/待回复）
|
|
|
- 评价列表
|
|
|
- 回复操作
|
|
|
- **查询条件**：
|
|
|
- 评分筛选（全部/好评/中评/差评）
|
|
|
- 回复状态筛选（全部/待回复/已回复）
|
|
|
- 时间筛选
|
|
|
- **列表字段**：
|
|
|
|
|
|
| 字段 | 类型 | 说明 |
|
|
|
|------|------|------|
|
|
|
| 工单编号 | 文本 | 关联工单号 |
|
|
|
| 评分 | 数字 | 1~5分 |
|
|
|
| 评价内容 | 文本 | 留言摘要 |
|
|
|
| 评价时间 | 时间 | 提交评价时间 |
|
|
|
| 回复状态 | 标签 | 已回复/未回复 |
|
|
|
|
|
|
- **界面布局**：
|
|
|
- 顶部：统计数字 + 平均分显示
|
|
|
- 中部：评价卡片列表
|
|
|
- 底部：回复操作
|
|
|
- **操作按钮**：
|
|
|
- 「回复」→ 回复评价（权限：evaluation:list:update）
|
|
|
- 「查看详情」→ 查看评价详情
|
|
|
|
|
|
**需求追溯**：
|
|
|
|
|
|
| 功能点编号 | 功能名称 | 文档来源 | 后续服务 | 关联功能 |
|
|
|
|------------|----------|----------|----------|----------|
|
|
|
| MP-PM-05 | 评价管理 | 02-小程序端 §9 | 通知报修人 | 服务评价（Web端） |
|
|
|
|
|
|
### 交互流程要求
|
|
|
|
|
|
1. **页面加载**：进入页面 → 加载评价统计 + 评价列表
|
|
|
2. **回复操作**：点击"回复"→ 弹窗输入回复内容 → 提交 → API调用 → 成功后通知报修人
|
|
|
3. **查看详情**：点击评价卡片 → 跳转评价详情页
|
|
|
4. **异常处理**：回复失败提示
|
|
|
|
|
|
5. **[H1]防重复请求**
|
|
|
- 回复操作：点击"回复"后按钮 disabled + 弹窗提交按钮 loading
|
|
|
- 筛选切换 abort 上次请求
|
|
|
|
|
|
6. **[H2]超时与加载反馈**
|
|
|
- 列表查询 timeout=15秒；回复提交 timeout=30秒
|
|
|
- >3秒 wx.showLoading；超时提示+重试
|
|
|
|
|
|
7. **[H8]操作结果反馈**
|
|
|
- 回复成功：wx.showToast({ icon: 'success', title: '回复成功' }) + 刷新
|
|
|
- 回复失败：wx.showToast({ icon: 'none', title: errMsg })
|
|
|
|
|
|
### 组件规范
|
|
|
|
|
|
| 元素 | 组件 | 配置参数 |
|
|
|
|------|------|----------|
|
|
|
| 评分展示 | uni-rate | :size=16, :readonly=true |
|
|
|
| 回复状态标签 | uni-tag | 已回复:type="success", 未回复:type="warning" |
|
|
|
| 回复弹窗 | uni-popup | type="bottom" |
|
|
|
| 回复输入 | uni-easyinput | type="textarea", maxlength=200 |
|
|
|
|
|
|
### 校验规则
|
|
|
|
|
|
| 字段 | 规则 | 错误提示 |
|
|
|
|------|------|----------|
|
|
|
| 回复内容 | 必填, 最大200字符 | "请输入回复内容" |
|
|
|
|
|
|
### 响应式布局
|
|
|
|
|
|
- 适配机型：iPhone SE ~ iPad mini
|
|
|
- 触摸区域≥44px
|
|
|
|
|
|
---
|
|
|
|
|
|
### 页面6：组织架构查看
|
|
|
|
|
|
- **页面路径**：`/pages/manager/org`
|
|
|
- **适用角色**：物业管理员/主管
|
|
|
- **页面元素**：
|
|
|
- 班组列表
|
|
|
- 班组成员查看
|
|
|
- 人员基本信息查看
|
|
|
- **查询条件**：
|
|
|
- 班组筛选
|
|
|
- 关键词搜索（姓名/职位）
|
|
|
- **列表字段**：
|
|
|
|
|
|
| 字段 | 类型 | 说明 |
|
|
|
|------|------|------|
|
|
|
| 班组名称 | 文本 | 班组名 |
|
|
|
| 班组长 | 文本 | 负责人姓名 |
|
|
|
| 人数 | 数字 | 班组人数 |
|
|
|
| 技能标签 | 标签组 | 班组主要技能 |
|
|
|
|
|
|
- **界面布局**：
|
|
|
- 顶部：搜索框 + 筛选
|
|
|
- 中部：班组卡片列表 → 点击展开成员列表
|
|
|
- 底部：无操作栏
|
|
|
- **操作按钮**：
|
|
|
- 「查看班组」→ 展开班组成员列表
|
|
|
- 「查看人员」→ 查看人员详情
|
|
|
- 「拨打电话」→ 调用手机拨号功能
|
|
|
|
|
|
**数据来源**：与Web端组织架构同一数据源
|
|
|
|
|
|
**需求追溯**：
|
|
|
|
|
|
| 功能点编号 | 功能名称 | 文档来源 | 后续服务 | 关联功能 |
|
|
|
|------------|----------|----------|----------|----------|
|
|
|
| MP-PM-06 | 组织架构查看 | 02-小程序端 §9 | 无 | 组织架构（Web端） |
|
|
|
|
|
|
### 交互流程要求
|
|
|
|
|
|
1. **页面加载**：进入页面 → 调用API加载班组列表
|
|
|
2. **查看班组**：点击班组卡片 → 展开班组成员列表（手风琴模式，同时只展开一个）
|
|
|
3. **查看人员**：点击人员 → 跳转人员详情页（姓名、职位、电话、技能标签）
|
|
|
4. **拨打电话**：点击"拨打电话"→ 调用 `uni.makePhoneCall` → 拨号
|
|
|
5. **搜索**：输入关键词 → 实时筛选班组/人员
|
|
|
6. **异常处理**：拨号失败（无电话号码）→ 提示"该人员未设置联系电话"
|
|
|
|
|
|
### 前端硬性约束
|
|
|
|
|
|
> - **H1 防重复提交**：
|
|
|
> - 搜索/筛选请求使用 pending 标志位去重，避免频繁触发 API 调用。
|
|
|
> - 页面卸载时（`onUnload`）必须 `abort` 未完成的请求。
|
|
|
> - **H2 超时处理**：
|
|
|
> - 班组列表（GET）接口超时 **15秒**；超过 3 秒未响应展示 loading 动画。
|
|
|
> - 搜索防抖处理（300ms），避免高频输入触发过多请求。
|
|
|
> - **H8 操作反馈**：
|
|
|
> - 数据加载成功 `uni.showToast({ icon: 'success', duration: 2000 })`，拨号失败 `icon: 'none'` 提示具体原因。
|
|
|
|
|
|
### 组件规范
|
|
|
|
|
|
| 元素 | 组件 | 配置参数 |
|
|
|
|------|------|----------|
|
|
|
| 搜索框 | uni-easyinput | placeholder="搜索姓名/职位", clearable |
|
|
|
| 班组卡片 | uni-card | :isFull=true, @click="toggleExpand" |
|
|
|
| 展开收起 | uni-icons | type="bottom"/"top" |
|
|
|
| 成员列表 | view | v-for, v-show="expanded" |
|
|
|
| 技能标签 | uni-tag | v-for, type="primary", size="mini" |
|
|
|
| 拨打电话按钮 | button | size="mini", type="primary", @click="makePhoneCall" |
|
|
|
|
|
|
### 校验规则
|
|
|
|
|
|
无
|
|
|
|
|
|
### 响应式布局
|
|
|
|
|
|
- 适配机型：iPhone SE ~ iPad mini
|
|
|
- 班组卡片全宽
|
|
|
- 成员列表全宽
|
|
|
- 触摸区域≥44px
|
|
|
|
|
|
---
|
|
|
|
|
|
## 业务规则
|
|
|
|
|
|
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端） |
|
|
|
| 打卡异常审核 | ✅ | ✅ | 物业(主管) |
|
|
|
| 数据补录审核 | ✅ | ✅ | 物业(主管) |
|
|
|
| 保洁抽查 | ✅ | ✅ | 物业(主管) |
|