# 系统配置

> 模块编码：system
> 端侧：Web专属
> 关联文档：01-模块划分 §3.9 / 02-功能清单-物业公司 §9 / 03-业务流转逻辑-物业公司 §9 / 05-接口规范 §9.2 / 06-项目技术要求 §4.4

## 功能概览

| 项目 | 说明 |
|------|------|
| 菜单名称 | 系统配置 |
| 子菜单 | 蓝牙设备管理、字典管理、微信配置、消息模板、数据补录审核 |
| 功能编号 | PR-S-01 ~ PR-S-05 |
| 权限编码前缀 | device:beacon:* / system:dict:* / system:wechat:* / system:template:* / system:bluetooth-policy:* |

---

## 页面1：蓝牙设备管理页

**页面编号**：PR-S-01-P01
**端侧归属**：Web专属
**页面路径**：/system/beacons

### 界面布局

```
┌──────────────────────────────────────────────────────────────────┐
│ [面包屑] 系统配置 > 蓝牙设备管理                                    │
├──────────────────────────────────────────────────────────────────┤
│ [查询条件区]                                                      │
│ Beacon名称[____] 状态[▼] 绑定位置[____]              [查询] [重置] │
├──────────────────────────────────────────────────────────────────┤
│ [操作栏]  [新增Beacon]                                            │
├──────────────────────────────────────────────────────────────────┤
│ [列表区]                                                          │
│ 序号| 名称   | UUID         | 绑定位置  | 状态 | 电量 | 最后心跳  │
│ 1  | B-001  | xxxx-xxxx... | 门诊1层  | 在线 | 85% | 10:30   │
│ 2  | B-002  | xxxx-xxxx... | 住院1层  | 离线 | 12% | 08:15   │
├──────────────────────────────────────────────────────────────────┤
│ [分页]  共30条  每页[20▼]  < 1 2 >                                │
└──────────────────────────────────────────────────────────────────┘
```

### 查询条件

| 字段名 | 控件类型 | 必填 | 默认值 | 说明 |
|--------|----------|------|--------|------|
| Beacon名称 | 文本输入 | 否 | — | 模糊匹配 |
| 状态 | 下拉单选 | 否 | 全部 | 在线/离线 |
| 绑定位置 | 文本输入 | 否 | — | 模糊匹配 |

### 列表字段

| 序号 | 字段名 | 列宽 | 支持排序 | 说明 |
|------|--------|------|----------|------|
| 1 | 名称 | 100px | 否 | — |
| 2 | UUID | 180px | 否 | — |
| 3 | 绑定位置 | 150px | 否 | 巡检点位/保洁区域/打卡点 |
| 4 | 绑定模块 | 80px | 否 | 巡检/保洁/考勤 |
| 5 | 状态 | 80px | 是 | 在线(绿)/离线(红) |
| 6 | 电量 | 70px | 是 | <20%=红色低电量 |
| 7 | 最后心跳时间 | 140px | 是 | 超过15分钟=离线 |
| 8 | 操作 | 120px | — | 编辑/解绑/删除 |

### 操作按钮

| 按钮 | 权限编码 | 位置 | 显示条件 | 说明 |
|------|----------|------|----------|------|
| 新增Beacon | device:beacon:create | 操作栏 | 始终 | — |
| 编辑 | device:beacon:update | 行操作 | 始终 | — |
| 解绑 | device:beacon:update | 行操作 | 已绑定 | — |
| 删除 | device:beacon:delete | 行操作 | 未绑定时 | 二次确认 |

### 表单字段（新增/编辑弹窗）

| 字段名 | 控件类型 | 必填 | 默认值 | 数据来源 | 校验规则 |
|--------|----------|------|--------|----------|----------|
| Beacon名称 | 文本输入 | 是 | — | 自填 | 最大30字 |
| UUID | 文本输入 | 是 | — | 自填 | UUID格式 |
| 绑定位置 | 级联选择 | 否 | — | 区域树 | — |
| 绑定模块 | 下拉单选 | 否 | — | 固定选项 | 巡检/保洁/考勤 |
| 电量预警阈值(%) | 数字输入 | 否 | 20 | — | 0~100 |

### 通知触发

| 触发操作 | 通知对象 | 通知方式 | 消息模板 | 文档来源 |
|----------|----------|----------|----------|----------|
| Beacon离线(>15分钟) | 物业管理员 | 系统内通知 | Beacon离线预警 | 05 §5.2 (BEACON_OFFLINE) / 06 §5.4 |
| Beacon低电量(<20%) | 物业管理员 | 系统内通知 | Beacon低电量预警 | 05 §5.2 (BEACON_LOW_BATTERY) |

### API端点

| 页面操作 | API路径 | 方法 | 说明 |
|----------|---------|------|------|
| 列表查询 | /api/v1/beacons | GET | — |
| 新增 | /api/v1/beacons | POST | — |
| 编辑 | /api/v1/beacons/{id} | PUT | — |
| 解绑 | /api/v1/beacons/{id}/unbind | PUT | — |
| 删除 | /api/v1/beacons/{id} | DELETE | — |

---

## 页面2：字典管理页

**页面编号**：PR-S-02-P01
**端侧归属**：Web专属
**页面路径**：/system/dicts

### 界面布局

```
┌──────────────────────────────────────────────────────────────────┐
│ [面包屑] 系统配置 > 字典管理                                       │
├──────────────────────────────────────────────────────────────────┤
│ [左侧-字典类型]      │ [右侧-字典值]                              │
│ ┌──────────────┐    │ ┌──────────────────────────────────────┐   │
│ │ 报修类型      │◀── │ 序号 | 字典值 | 排序 | 状态 | 操作      │   │
│ │ 巡检类型      │    │ 1    | 水电   | 1    | 启用 | 编辑 停用│   │
│ │ 保洁类型      │    │ 2    | 木工   | 2    | 启用 | 编辑 停用│   │
│ │ 班组类型      │    │ 3    | 空调   | 3    | 停用 | 编辑 启用│   │
│ │ 班次类型      │    │                                       │   │
│ │ [新增类型]    │    │ [新增字典值]                           │   │
│ └──────────────┘    │ └──────────────────────────────────────┘   │
└──────────────────────────────────────────────────────────────────┘
```

### 操作按钮

| 按钮 | 权限编码 | 位置 | 显示条件 | 说明 |
|------|----------|------|----------|------|
| 新增字典类型 | system:dict:create | 左侧 | 始终 | — |
| 新增字典值 | system:dict:create | 右侧 | 始终 | — |
| 编辑 | system:dict:update | 行操作 | 始终 | — |
| 启用/停用 | system:dict:update | 行操作 | 始终 | 被引用时不可停用 |

### API端点

| 页面操作 | API路径 | 方法 | 说明 |
|----------|---------|------|------|
| 字典类型列表 | /api/v1/dict-types | GET | — |
| 字典值列表 | /api/v1/dict-types/{typeCode}/values | GET | — |
| 新增类型 | /api/v1/dict-types | POST | — |
| 新增值 | /api/v1/dict-types/{typeCode}/values | POST | — |

---

## 页面3：微信配置页

**页面编号**：PR-S-03-P01
**端侧归属**：Web专属
**页面路径**：/system/wechat

### 表单字段

| 字段名 | 控件类型 | 必填 | 默认值 | 数据来源 | 校验规则 |
|--------|----------|------|--------|----------|----------|
| 小程序AppID | 文本输入 | 是 | — | 微信公众平台 | — |
| 小程序AppSecret | 密码输入 | 是 | — | 微信公众平台 | — |
| 公众号AppID | 文本输入 | 否 | — | 微信公众平台 | — |
| 公众号AppSecret | 密码输入 | 否 | — | 微信公众平台 | — |
| 服务器地址(URL) | 文本输入 | 是 | — | 自填 | URL格式 |

### 操作按钮

| 按钮 | 权限编码 | 位置 | 显示条件 | 说明 |
|------|----------|------|----------|------|
| 保存 | system:wechat:update | 底部 | 始终 | — |
| 测试连接 | system:wechat:view | 底部 | 始终 | 验证配置是否正确 |

### API端点

| 页面操作 | API路径 | 方法 | 说明 |
|----------|---------|------|------|
| 查询配置 | /api/v1/system/wechat-config | GET | — |
| 保存 | /api/v1/system/wechat-config | PUT | — |
| 测试连接 | /api/v1/system/wechat-config/test | POST | — |

---

## 页面4：消息模板管理页

**页面编号**：PR-S-04-P01
**端侧归属**：Web专属
**页面路径**：/system/message-templates

### 列表字段

| 序号 | 字段名 | 列宽 | 支持排序 | 说明 |
|------|--------|------|----------|------|
| 1 | 模板名称 | 150px | 否 | 如：新工单通知 |
| 2 | 模板ID | 150px | 否 | 微信模板消息ID |
| 3 | 适用场景 | 120px | 否 | 工单分配/催单/审批/超时... |
| 4 | 模板变量 | 200px | 否 | {{工单号}}, {{人员姓名}}... |
| 5 | 状态 | 80px | 否 | 启用/停用 |
| 6 | 操作 | 100px | — | 编辑 |

### 表单字段（编辑弹窗）

| 字段名 | 控件类型 | 必填 | 默认值 | 数据来源 | 校验规则 |
|--------|----------|------|--------|----------|----------|
| 模板名称 | 文本输入 | 是 | — | 自填 | 最大50字 |
| 模板ID | 文本输入 | 是 | — | 微信后台 | — |
| 适用场景 | 下拉单选 | 是 | — | 固定选项 | — |
| 模板内容 | 多行文本 | 是 | — | 微信后台复制 | 最大500字 |
| 模板变量说明 | 多行文本 | 否 | — | 自填 | — |

### API端点

| 页面操作 | API路径 | 方法 | 说明 |
|----------|---------|------|------|
| 列表查询 | /api/v1/message-templates | GET | — |
| 编辑 | /api/v1/message-templates/{id} | PUT | — |

---

## 页面5：蓝牙策略配置页

**页面编号**：PR-S-05-P01（含数据补录审核）
**端侧归属**：Web专属
**页面路径**：/system/bluetooth-policy

### 界面布局

```
┌──────────────────────────────────────────────────────────────────┐
│ [面包屑] 系统配置 > 蓝牙策略配置                                    │
├──────────────────────────────────────────────────────────────────┤
│ [策略配置]                                                         │
│ ┌────────────────────────────────────────────────────────────┐   │
│ │ 场景           │ 策略       │ 说明                          │   │
│ │ 巡检打卡       │ [▼REQUIRED]│ 必须连接Beacon打卡             │   │
│ │ 巡检拍照       │ [▼OPTIONAL]│ 可自由拍照                    │   │
│ │ 保洁打卡       │ [▼REQUIRED]│ 必须连接Beacon打卡             │   │
│ │ 保洁拍照       │ [▼OPTIONAL]│ 可自由拍照                    │   │
│ │ 考勤打卡       │ [▼REQUIRED]│ 必须连接Beacon打卡             │   │
│ └────────────────────────────────────────────────────────────┘   │
├──────────────────────────────────────────────────────────────────┤
│                                         [保存] [提交审核]         │
└──────────────────────────────────────────────────────────────────┘
```

### 策略配置说明

| 场景 | 配置项 | 强制蓝牙(REQUIRED) | 非强制(OPTIONAL) | 文档来源 |
|------|--------|-------------------|------------------|----------|
| 巡检打卡 | inspection_check_in | 必须连接Beacon打卡，失败进补录 | 可手动打卡 | 06 §4.4 |
| 巡检拍照 | inspection_photo | 必须在蓝牙连接下拍照 | 可自由拍照 | 06 §4.4 |
| 保洁打卡 | cleaning_check_in | 必须连接Beacon打卡，失败进补录 | 可手动打卡 | 06 §4.4 |
| 保洁拍照 | cleaning_photo | 必须在蓝牙连接下拍照 | 可自由拍照 | 06 §4.4 |
| 考勤打卡 | attendance_check | 必须连接Beacon打卡，失败提交异常申诉 | 可手动打卡 | 06 §4.4 |

### 操作按钮

| 按钮 | 权限编码 | 位置 | 显示条件 | 说明 |
|------|----------|------|----------|------|
| 保存 | system:bluetooth-policy:update | 底部 | 始终 | 保存草稿 |
| 提交审核 | system:bluetooth-policy:approve | 底部 | 始终 | 提交医院账号审核 |

### 通知触发

| 触发操作 | 通知对象 | 通知方式 | 消息模板 | 文档来源 |
|----------|----------|----------|----------|----------|
| 策略提交审核 | 医院账号 | Web提醒 | 蓝牙策略变更审核 | 06 §4.4 |
| 审核通过 | 物业管理员 | 系统内通知 | 蓝牙策略已生效 | 06 §4.4 |
| 审核拒绝 | 物业管理员 | 系统内通知 | 蓝牙策略审核被拒绝 | 06 §4.4 |

### 审核流程

```
物业公司配置策略 → 提交审核 → 医院账号审核
                                │
                    ┌──审核通过──┐  ┌──审核拒绝──┐
                    策略生效       维持原配置
                    通知物业       通知物业
```

### API端点

| 页面操作 | API路径 | 方法 | 说明 |
|----------|---------|------|------|
| 查询策略 | /api/v1/system/bluetooth-policy | GET | — |
| 保存 | /api/v1/system/bluetooth-policy | PUT | — |
| 提交审核 | /api/v1/system/bluetooth-policy/submit | POST | — |

---

## 需求追溯

| 功能点编号 | 功能名称 | 文档来源 | 后续服务 | 关联功能 |
|------------|----------|----------|----------|----------|
| PR-S-01 | 蓝牙设备管理 | 02-物业公司 §9 / 03-物业公司 §9.1 | Beacon→绑定位置→打卡 | 巡检区域管理 / 保洁区域管理 / 考勤打卡点 |
| PR-S-02 | 字典管理 | 02-物业公司 §9 / 03-物业公司 §9.2 | 字典→各模块下拉选项 | 报修类型管理 / 巡检类型 / 保洁类型 |
| PR-S-03 | 微信配置 | 02-物业公司 §9 | 配置→小程序登录+推送 | 小程序端(登录/通知) |
| PR-S-04 | 消息模板 | 02-物业公司 §9 / 03-物业公司 §9.3 | 模板→微信推送消息 | 通知机制 |
| PR-S-05 | 数据补录审核 | 02-物业公司 §9 | 审核→补录数据生效 | 巡检/保洁/考勤补录 |

## 业务规则

1. **Beacon心跳检测**：每5分钟上报心跳，超过15分钟标记OFFLINE（来源：06 §5.4）
2. **Beacon电量预警**：电量<20%时系统内通知预警（来源：06 §5.4 / 05 §5.2）
3. **字典租户隔离**：字典数据仅对本物业公司（租户）可见（来源：03-物业公司 §9.2）
4. **蓝牙策略审核**：物业公司提交配置→医院账号审核通过后生效，审核拒绝则维持原配置（来源：06 §4.4）
5. **蓝牙打卡判定**：不判断距离，只要成功连接蓝牙设备即可打卡，RSSI > -70dBm（来源：06 §5.4）
6. **消息模板变量**：支持自定义模板变量（工单号、人员姓名、时间等）（来源：03-物业公司 §9.3）