# 通用功能

> 模块编码：common
> 端侧：小程序
> 关联文档：01-模块划分.md §5.2、02-功能清单-小程序端.md §1、03-业务流转逻辑-小程序端.md §1&10、05-接口规范.md §2、06-项目技术要求.md §4.1

## 功能概览

| 项目 | 说明 |
|------|------|
| 菜单名称 | 通用功能 |
| 子菜单 | 快捷登录、个人信息、消息通知、数据补录申请、版本更新提示、通讯录 |
| 功能编号 | MP-C-01 ~ MP-C-06 |
| 权限编码 | —（通用功能，登录即可用） |

## 页面清单

### 页面1：登录页

- **页面路径**：`/pages/login/index`
- **页面元素**：
  - 微信授权登录按钮（获取openid）
  - 手机号绑定按钮（微信获取手机号组件）
  - 用户协议与隐私政策链接
  - 版本号展示
- **界面布局**：
  - 顶部：应用Logo + 系统名称
  - 中部：微信一键登录按钮（大按钮，居中）
  - 底部：版本号 + 协议链接
- **操作按钮**：
  | 按钮 | 权限 | 说明 |
  |------|------|------|
  | 微信一键登录 | — | 触发wx.login()获取code，后端换openid |
  | 获取手机号 | — | 微信获取手机号组件，绑定手机号 |

### 页面2：工作台首页

- **页面路径**：`/pages/workbench/index`
- **页面元素**：
  - 用户头像 + 姓名 + 角色
  - 功能入口网格（根据角色动态渲染）
  - 消息通知红点提示
  - 今日关键指标简卡
- **查询条件**：无
- **列表字段**：无
- **界面布局**：
  - 顶部：用户信息栏（头像 + 姓名 + 角色 + 消息入口）
  - 中部：功能入口网格（2列×N行，按角色动态显示）
    - 维修人员：我的工单、消息通知
    - 巡检人员：今日巡检、异常上报
    - 保洁人员：今日保洁、异常反馈
    - 主管：工单分配、审批中心、统计概览
    - 管理员：报修管理、巡检管理、保洁管理、考勤管理、评价管理、组织架构
  - 底部：底部Tab栏（工作台、消息、我的）
- **操作按钮**：
  | 按钮 | 权限 | 说明 |
  |------|------|------|
  | 各功能入口 | 按角色 | 根据权限集动态显示/隐藏 |

### 页面3：个人信息页

- **页面路径**：`/pages/profile/index`
- **页面元素**：
  - 头像（可点击查看大图）
  - 姓名（只读）
  - 手机号（脱敏显示，可修改）
  - 所属物业公司（只读）
  - 所属班组（只读）
  - 角色信息（只读）
  - 退出登录按钮
- **查询条件**：无
- **列表字段**：无
- **界面布局**：
  - 顶部：头像（居中，大尺寸）
  - 中部：信息列表（Label + Value形式）
  - 底部：退出登录按钮（红色文字）
- **操作按钮**：
  | 按钮 | 权限 | 说明 |
  |------|------|------|
  | 修改手机号 | — | 弹出微信获取手机号组件 |
  | 退出登录 | — | 清除本地token，跳转登录页 |

### 页面4：消息通知列表

- **页面路径**：`/pages/message/list`
- **页面元素**：
  - 消息分类Tab（全部 / 工单 / 审批 / 系统）
  - 消息列表
  - 未读标记红点
  - 全部标记已读按钮
- **查询条件**：
  | 条件 | 类型 | 说明 |
  |------|------|------|
  | 分类 | Tab切换 | 全部/工单/审批/系统 |
- **列表字段**：
  | 字段 | 说明 |
  |------|------|
  | 消息标题 | 通知标题 |
  | 消息摘要 | 内容前30字 |
  | 消息时间 | 相对时间（如"5分钟前"） |
  | 已读标记 | 红点显示未读 |
  | 消息类型图标 | 不同类型不同图标 |
- **界面布局**：
  - 顶部：分类Tab
  - 中部：消息列表（左图标 + 中标题摘要 + 右时间 + 未读红点）
  - 底部：全部标记已读按钮
- **操作按钮**：
  | 按钮 | 权限 | 说明 |
  |------|------|------|
  | 全部标记已读 | — | 将所有未读消息标为已读 |
  | 点击消息 | — | 跳转到对应业务详情页 |

### 页面5：数据补录申请页

- **页面路径**：`/pages/supplement/apply`
- **页面元素**：
  - 补录模块选择（报修/巡检/保洁/考勤）
  - 补录原因（下拉选择：蓝牙失灵/定位失败/系统异常/其他）
  - 补录说明（多行文本，最多200字）
  - 证明材料上传（照片，最多3张）
  - 补录数据表单（根据选择的模块动态渲染）
- **查询条件**：无
- **列表字段**：无
- **界面布局**：
  - 顶部：补录模块选择（下拉选择器）
  - 中部：补录原因 + 说明 + 上传证明
  - 下部：补录数据表单（动态）
  - 底部：提交按钮
- **操作按钮**：
  | 按钮 | 权限 | 说明 |
  |------|------|------|
  | 提交申请 | — | 提交补录申请，等待主管审核 |

### 页面6：通讯录页

- **页面路径**：`/pages/contacts/index`
- **页面元素**：
  - 搜索框
  - 按班组分组显示联系人
  - 联系人信息卡片
- **查询条件**：
  | 条件 | 类型 | 说明 |
  |------|------|------|
  | 搜索关键词 | 输入框 | 按姓名/手机号搜索 |
- **列表字段**：
  | 字段 | 说明 |
  |------|------|
  | 头像 | 联系人头像 |
  | 姓名 | 联系人姓名 |
  | 角色 | 联系人角色 |
  | 手机号 | 脱敏显示，点击可拨打 |
  | 班组 | 所属班组 |
- **界面布局**：
  - 顶部：搜索框
  - 中部：按班组分组的联系人列表
    - 班组标题（灰色背景）
    - 联系人卡片（左头像 + 中姓名角色 + 右手机号图标）
- **操作按钮**：
  | 按钮 | 权限 | 说明 |
  |------|------|------|
  | 拨打电话 | — | 点击手机号直接拨打 |

### 页面7：版本更新提示弹窗

- **页面路径**：弹窗组件（非独立页面）
- **页面元素**：
  - 新版本号
  - 更新内容说明
  - 更新/取消按钮（小版本）
  - 强制更新按钮（大版本）
- **界面布局**：
  - 居中弹窗
  - 顶部：版本号
  - 中部：更新说明
  - 底部：操作按钮

## 需求追溯

| 功能点编号 | 功能名称 | 文档来源 | 后续服务 | 关联功能 |
|------------|----------|----------|----------|----------|
| MP-C-01 | 快捷登录 | 02-小程序端 §1 | 登录成功→加载权限集→渲染工作台 | 权限管理（角色分配） |
| MP-C-02 | 个人信息 | 02-小程序端 §1 | 修改手机号→更新sys_user | 通讯录 |
| MP-C-03 | 消息通知 | 02-小程序端 §1 | 点击消息→跳转业务详情 | 各业务模块（推送触发） |
| MP-C-04 | 数据补录申请 | 02-小程序端 §1 | 提交→触发补录审核→主管审批 | 各模块补录审核 |
| MP-C-05 | 版本更新提示 | 02-小程序端 §1 | 小版本→提示更新；大版本→强制更新 | 超管系统配置（版本管理） |
| MP-C-06 | 通讯录 | 02-小程序端 §1 | 点击拨打→调起手机拨号 | 组织架构（班组/人员） |

## 业务规则

1. **登录规则**（03-业务流转逻辑-小程序端 §1）：
   - 首次登录：微信授权获取openid → 绑定手机号 → 系统匹配物业公司+人员信息
   - 匹配成功：创建账号，进入工作台
   - 匹配失败：提示"未找到关联信息，请联系管理员"，无法使用
   - 再次登录：读取本地token → 有效则直接进入 → 无效则openid静默登录

2. **权限加载规则**（01-模块划分.md §5.3）：
   - 登录后获取角色及权限集（四级粒度）
   - 根据权限动态渲染：可见菜单项、页面内可见功能点、功能点可用动作、数据范围（行级隔离）

3. **Token管理**（06-项目技术要求.md §4.1）：
   - 小程序端存本地Storage，2小时过期
   - Token失效自动使用openid静默登录，刷新token

4. **版本更新规则**（03-业务流转逻辑-小程序端 §10）：
   - 启动时调用后台接口获取最新版本号 + 最低兼容版本
   - 版本一致：正常使用
   - 小版本更新（兼容）：提示"发现新版本，是否更新？"，用户可取消
   - 大版本更新（不兼容）：强制更新，引导前往微信更新小程序
   - SDK依赖校验：启动时校验蓝牙SDK、微信SDK等关键依赖版本

5. **消息通知规则**（01-模块划分.md §7）：
   - 通知场景：新工单、催单、审批、完工、异常上报等
   - 通知方式：小程序推送
   - 点击消息跳转对应业务详情

6. **数据补录规则**（06-项目技术要求.md §4.5）：
   - 补录数据必须标记 `is_supplement=true`
   - 补录申请需主管审核（Web+小程序均可）
   - 补录日志单独记录

## 状态流转

### 登录状态流转

```
未登录 ──[微信授权]──▶ 获取openid ──[绑定手机号]──▶ 匹配人员信息
                                                          │
                                              ┌───匹配成功───┐  ┌───匹配失败───┐
                                              │               │  │               │
                                              创建账号         提示联系管理员
                                              进入工作台       无法使用
```

### 补录申请状态流转

```
草稿 ──[提交]──▶ 待审核 ──[主管通过]──▶ 已通过（数据补录生效）
                         └──[主管驳回]──▶ 已驳回（通知申请人）
```