You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

27 KiB

Raw Blame History Unescape Escape

系统配置

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

功能概览

项目	说明
菜单名称	系统配置
子菜单	蓝牙设备管理、字典管理、微信配置、消息模板、数据补录审核
功能编号	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	—

交互流程要求

页面加载流程：进入页面 → 调用API加载Beacon列表 + 绑定位置级联数据
查询交互：填写条件 → 查询 → 重置到第1页
新增/编辑Beacon：点击"新增Beacon"→ 弹窗 → 填写表单 → 保存 → 刷新列表
解绑操作：点击"解绑"→ 二次确认 → API调用 → 刷新列表
删除操作：仅未绑定位置时可删除 → 二次确认 → API调用 → 刷新列表
联动交互：绑定位置使用级联选择器（楼栋→楼层→区域→点位）
异常处理：UUID格式错误即时提示；删除已绑定Beacon提示"请先解绑"
权限控制：无对应权限 → 操作按钮不渲染
[H1] 防重复请求：查询/新增/编辑/解绑按钮点击后 disabled + loading；分页切换 abort 前次未完成请求；行内操作（编辑/解绑/删除）点击后禁用当前行，弹窗/确认关闭后恢复
[H2] 超时控制：列表 GET /api/v1/beacons 超时 15s；新增 POST /api/v1/beacons 超时 30s；编辑 PUT 超时 30s；删除 DELETE 超时 30s；>3s 全局 Loading
[H3] 操作确认：删除操作必须二次确认 ElMessageBox.confirm（type=error），文案含"确定删除该Beacon设备吗？此操作不可恢复"；解绑操作二次确认（type=warning），文案含"确定解绑该Beacon的绑定位置吗？"
[H4] 脏数据检测：新增/编辑弹窗打开时 deep clone 表单初始值；表单字段变更后计算 isDirty；用户尝试关闭弹窗时若 isDirty 为 true 则拦截并提示"修改尚未保存，确定离开吗？"
[H8] 反馈机制：新增/编辑成功 ElMessage.success 2s 自动消失 + silent 刷新列表；失败 ElMessage.error 手动关闭；删除/解绑成功 2s 提示后刷新

组件规范

元素	组件	配置参数
列表	el-table	stripe, border, v-loading
状态标签	el-tag	在线:type="success", 离线:type="danger"
电量	el-progress	:percentage, :stroke-width=10, <20%:color="red"
新增/编辑弹窗	el-dialog	width="500px"
绑定位置级联	el-cascader	:options="locationTree", :props="{checkStrictly:true}"
绑定模块下拉	el-select	:options="[{label:'巡检',value:'inspection'},{label:'保洁',value:'cleaning'},{label:'考勤',value:'attendance'}]"
电量预警阈值	el-input-number	:min=0, :max=100, :step=5

校验规则

字段	规则	错误提示
Beacon名称	必填, 最大30字符	"请输入Beacon名称" / "名称不能超过30字符"
UUID	必填, UUID格式	"请输入UUID" / "UUID格式不正确"
电量预警阈值	0-100整数	"阈值范围为0-100"

响应式布局

断点	布局调整
≥1280px	查询条件一行；列表完整展示
1024-1279px	查询条件两行；"绑定模块""电量"列隐藏
768-1023px	查询条件竖向堆叠；列表仅显示：名称、绑定位置、状态、操作

页面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	—

交互流程要求

页面加载流程：进入页面 → 调用API加载字典类型列表 → 默认选中第一个类型 → 加载对应字典值
左侧类型交互：点击类型 → 右侧加载对应字典值列表
新增类型：点击"新增类型"→ 弹窗输入类型名称和编码 → 保存 → 刷新左侧列表
新增字典值：点击"新增字典值"→ 弹窗输入字典值和排序 → 保存 → 刷新右侧列表
启用/停用：被业务数据引用的字典值不可停用 → 提示"该字典值正在使用中，无法停用"
联动交互：字典值变更后，引用该字典的下拉选项实时刷新
异常处理：类型编码重复 → 提示"该编码已存在"

组件规范

元素	组件	配置参数
左右分栏	el-container	左侧宽度250px
字典类型列表	el-menu	:default-active, @select
右侧字典值列表	el-table	stripe, border
状态标签	el-tag	启用:type="success", 停用:type="danger"
新增弹窗	el-dialog	width="400px"

校验规则

字段	规则	错误提示
类型名称	必填, 最大30字符	"请输入类型名称"
类型编码	必填, 字母数字下划线, 唯一	"请输入类型编码" / "该编码已存在"
字典值	必填, 最大50字符	"请输入字典值"

响应式布局

断点	布局调整
≥1280px	左右分栏，左侧250px
1024-1279px	左右分栏，左侧200px
768-1023px	上下分栏，类型列表改为横向tab切换

页面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	—

交互流程要求

页面加载流程：进入页面 → 调用API加载当前微信配置 → 回填表单（Secret字段脱敏显示）
表单提交流程：修改配置 → 点击"保存"→ 前端校验 → API调用 → 成功提示
测试连接：点击"测试连接"→ 调用API → 成功提示"连接成功" / 失败提示具体错误
安全交互：AppSecret字段默认脱敏，点击"显示"按钮后明文显示
异常处理：配置校验失败即时提示；测试连接失败提示具体原因
[H1] 防重复请求："保存"按钮点击后 disabled + loading，防止重复提交；"测试连接"按钮同样 disabled + loading
[H2] 超时控制：查询 GET /api/v1/system/wechat-config 超时 15s；保存 PUT 超时 30s；测试连接 POST 超时 30s；>3s 全局 Loading
[H4] 脏数据检测：页面加载时 deep clone 原始配置数据为原始快照；表单字段变更后与快照对比计算 isDirty；用户尝试离开路由时若 isDirty 通过 beforeRouteLeave 拦截并提示"配置尚未保存，确定离开吗？"
[H8] 反馈机制：保存成功 ElMessage.success("保存成功"，2s 自动消失)；测试连接成功/失败均 2s 提示自动消失；失败 ElMessage.error 手动关闭

组件规范

元素	组件	配置参数
表单	el-form	label-width="140px", :model, :rules
AppID	el-input	clearable
AppSecret	el-input	show-password, type="password"
服务器地址	el-input	clearable
保存按钮	el-button	type="primary", :loading
测试连接按钮	el-button	type="success", plain, :loading

校验规则

字段	规则	错误提示
小程序AppID	必填	"请输入小程序AppID"
小程序AppSecret	必填	"请输入小程序AppSecret"
服务器地址	必填, URL格式	"请输入服务器地址" / "地址格式不正确"

响应式布局

断点	布局调整
≥1280px	表单标签140px，输入区400px
1024-1279px	表单标签120px，输入区350px
768-1023px	表单标签100px，输入区100%

页面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	—

交互流程要求

页面加载流程：进入页面 → 调用API加载模板列表
编辑模板：点击"编辑"→ 弹窗回填模板内容 → 修改 → 保存 → 刷新列表
模板变量：编辑时显示可用变量列表，点击变量自动插入到模板内容中
异常处理：模板ID重复 → 提示"该模板ID已存在"

组件规范

元素	组件	配置参数
列表	el-table	stripe, border
状态标签	el-tag	启用:type="success", 停用:type="danger"
编辑弹窗	el-dialog	width="600px"
模板内容	el-input	type="textarea", :rows=6, maxlength=500, show-word-limit
变量列表	el-tag	v-for, type="info", size="small", @click="insertVariable"

校验规则

字段	规则	错误提示
模板名称	必填, 最大50字符	"请输入模板名称"
模板ID	必填	"请输入模板ID"
适用场景	必填	"请选择适用场景"
模板内容	必填, 最大500字符	"请输入模板内容"

响应式布局

断点	布局调整
≥1280px	列表完整展示；编辑弹窗600px
1024-1279px	"模板变量"列隐藏；编辑弹窗550px
768-1023px	列表仅显示：模板名称、适用场景、状态、操作；编辑弹窗90vw

页面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	—

交互流程要求

页面加载流程：进入页面 → 调用API加载当前蓝牙策略 → 回填各场景配置
策略配置交互：每个场景行内下拉选择策略（REQUIRED/OPTIONAL）→ 实时保存为草稿
保存草稿：点击"保存"→ 调用API → 成功提示"草稿已保存"
提交审核：点击"提交审核"→ 二次确认（"提交后需医院账号审核，确认提交？"）→ 调用API → 成功提示"已提交审核"→ 按钮变为"审核中"不可再次点击
审核状态展示：待审核时显示"审核中"标签；审核通过显示"已生效"；审核拒绝显示拒绝原因+重新编辑按钮
联动交互：选择"强制蓝牙"策略时，显示补录说明"蓝牙连接失败时自动进入补录流程"
异常处理：保存失败提示错误；提交审核时策略未变更提示"策略未修改"
[H1] 防重复请求："保存"按钮点击后 disabled + loading；"提交审核"按钮点击后 disabled + loading 且提交中状态不可重复点击
[H2] 超时控制：查询 GET /api/v1/system/bluetooth-policy 超时 15s；保存 PUT 超时 30s；提交审核 POST 超时 30s；>3s 全局 Loading
[H4] 脏数据检测：页面加载时 deep clone 当前策略配置为原始快照；任一场景策略下拉变更后计算 isDirty；用户尝试离开路由时若 isDirty 通过 beforeRouteLeave 拦截并提示"策略配置有未保存的修改，确定离开吗？"
[H8] 反馈机制：保存成功 ElMessage.success("草稿已保存"，2s)；提交审核成功 2s 后按钮变为"审核中"；失败 ElMessage.error 手动关闭

组件规范

元素	组件	配置参数
策略表格	el-table	:data="policies", border
策略下拉	el-select	:options="[{label:'强制蓝牙',value:'REQUIRED'},{label:'非强制',value:'OPTIONAL'}]"
补录说明	el-alert	type="info", :closable=false, v-if="policy==='REQUIRED'"
审核状态标签	el-tag	审核中:type="warning", 已生效:type="success", 已拒绝:type="danger"
保存按钮	el-button	type="primary", :loading
提交审核按钮	el-button	type="success", :loading, :disabled="审核中"
拒绝原因	el-alert	type="error", :closable=false, v-if="rejected"

校验规则

字段	规则	错误提示
策略配置	每个场景必须选择	"请完成所有场景的策略配置"

响应式布局

断点	布局调整
≥1280px	策略表格全宽
1024-1279px	策略表格"说明"列隐藏
768-1023px	策略表格改为卡片列表模式，每场景一个卡片

需求追溯

功能点编号	功能名称	文档来源	后续服务	关联功能
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	审核→补录数据生效	巡检/保洁/考勤补录

业务规则

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

27 KiB Raw Blame History Unescape Escape

系统配置

功能概览

页面1：蓝牙设备管理页

界面布局

查询条件

列表字段

操作按钮

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

通知触发

API端点

交互流程要求

组件规范

校验规则

响应式布局

页面2：字典管理页

界面布局

操作按钮

API端点

交互流程要求

组件规范

校验规则

响应式布局

页面3：微信配置页

表单字段

操作按钮

API端点

交互流程要求

组件规范

校验规则

响应式布局

页面4：消息模板管理页

列表字段

表单字段（编辑弹窗）

API端点

交互流程要求

组件规范

校验规则

响应式布局

页面5：蓝牙策略配置页

界面布局

策略配置说明

操作按钮

通知触发

审核流程

API端点

交互流程要求

组件规范

校验规则

响应式布局

需求追溯

业务规则

27 KiB

Raw Blame History Unescape Escape