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.

34 KiB

Raw Blame History Unescape Escape

账号管理

模块编码：account 端侧：Web专属（仅超级管理员）关联文档：01-模块划分 §1.1~1.4 / 02-功能清单-超级管理员 §1 / 03-业务流转逻辑-超级管理员 §1~3 / 05-接口规范 §9.2 / 06-项目技术要求 §4.1~4.3

功能概览

项目	说明
菜单名称	账号管理
子菜单	医院信息管理、物业公司信息管理、医院账号管理、物业公司管理员账号管理、到期账号管理、到期提醒规则配置
功能编号	SA-A-01 ~ SA-A-08
权限编码前缀	permission:user:* / permission:config:*

页面1：医院信息管理列表页

页面编号：SA-A-01-P01 端侧归属：Web专属 页面路径：/account/hospitals

界面布局

┌──────────────────────────────────────────────────────────────────┐
│ [面包屑] 账号管理 > 医院信息管理                                    │
├──────────────────────────────────────────────────────────────────┤
│ [查询条件区]                                                      │
│ 医院名称[____] 状态[▼] 联系人[____]                 [查询] [重置]  │
├──────────────────────────────────────────────────────────────────┤
│ [操作栏]  [新增医院]                                              │
├──────────────────────────────────────────────────────────────────┤
│ [列表区]                                                          │
│ 序号 | 医院名称 | 院区数 | 联系人 | 联系电话 | 状态 | 操作          │
│ 1    | XX医院   | 3      | 张三   | 138****1234| 启用 | 编辑 停用    │
│ 2    | YY医院   | 1      | 李四   | 139****5678| 停用 | 编辑 启用    │
├──────────────────────────────────────────────────────────────────┤
│ [分页]  共50条  每页[20▼]  < 1 2 3 >                              │
└──────────────────────────────────────────────────────────────────┘

查询条件

字段名	控件类型	必填	默认值	说明
医院名称	文本输入	否	—	模糊匹配
状态	下拉单选	否	全部	启用/停用
联系人	文本输入	否	—	模糊匹配

列表字段

序号	字段名	列宽	支持排序	说明
1	序号	60px	—	自增序号
2	医院名称	180px	是	—
3	院区数	80px	否	显示关联院区数量，点击展开院区列表
4	联系人	100px	否	—
5	联系电话	130px	否	脱敏显示
6	创建时间	150px	是	默认倒序
7	状态	80px	是	启用(绿色)/停用(红色)标签
8	操作	140px	—	编辑/启停

操作按钮

按钮	权限编码	位置	显示条件	说明
新增医院	permission:user:create	操作栏	始终	跳转新增页
编辑	permission:user:update	行操作	始终	跳转编辑页
启用/停用	permission:user:update	行操作	始终	二次确认弹窗

角色差异化视图

角色	可见按钮	数据范围	备注
超级管理员	全部按钮	全部医院	—

API端点

页面操作	API路径	方法	说明
列表查询	/api/v1/hospitals	GET	分页查询
启用/停用	/api/v1/hospitals/{id}/toggle-status	PUT	切换状态

页面2：医院信息新增/编辑页

页面编号：SA-A-01-P02 端侧归属：Web专属 页面路径：/account/hospitals/create 或 /account/hospitals/:id/edit

界面布局

┌──────────────────────────────────────────────────────────────────┐
│ [面包屑] 账号管理 > 医院信息管理 > 新增医院                         │
├──────────────────────────────────────────────────────────────────┤
│ ── 基本信息 ──────────────────────────────────────────────────    │
│ 医院名称：[____________]     状态：[●启用 ○停用]                    │
│ 医院地址：[____________________________]                           │
│ 联系人：  [__________]      联系电话：[____________]                 │
├──────────────────────────────────────────────────────────────────┤
│ ── 院区信息 ──────────────────────────────────────────────────    │
│ [ + 添加院区 ]                                                    │
│ ┌────────────────────────────────────────────────────────────┐   │
│ │ 院区1  名称：[主院区]  地址：[____]  联系人：[____]  [删除] │   │
│ │ 院区2  名称：[东院区]  地址：[____]  联系人：[____]  [删除] │   │
│ └────────────────────────────────────────────────────────────┘   │
├──────────────────────────────────────────────────────────────────┤
│                                         [取消]  [保存]            │
└──────────────────────────────────────────────────────────────────┘

表单字段（基本信息）

字段名	控件类型	必填	默认值	数据来源	校验规则
医院名称	文本输入	是	—	自填	最大50字，全局唯一
状态	单选按钮	是	启用	固定选项	—
医院地址	文本输入	否	—	自填	最大200字
联系人	文本输入	否	—	自填	最大20字
联系电话	文本输入	否	—	自填	手机号格式

表单字段（院区信息，支持多条）

字段名	控件类型	必填	默认值	数据来源	校验规则
院区名称	文本输入	是	—	自填	最大30字，同医院内唯一
院区地址	文本输入	是	—	自填	最大200字
联系人	文本输入	否	—	自填	最大20字

通知触发

触发操作	通知对象	通知方式	消息模板	文档来源
创建医院	—	—	—	仅记录操作日志

API端点

页面操作	API路径	方法	说明
新增医院	/api/v1/hospitals	POST	含院区列表
编辑医院	/api/v1/hospitals/{id}	PUT	含院区列表
查询详情	/api/v1/hospitals/{id}	GET	编辑时回填

页面3：物业公司信息管理列表页

页面编号：SA-A-02-P01 端侧归属：Web专属 页面路径：/account/property-companies

界面布局

┌──────────────────────────────────────────────────────────────────┐
│ [面包屑] 账号管理 > 物业公司信息管理                                 │
├──────────────────────────────────────────────────────────────────┤
│ [查询条件区]                                                      │
│ 公司名称[____] 状态[▼] 联系人[____]                 [查询] [重置]  │
├──────────────────────────────────────────────────────────────────┤
│ [操作栏]  [新增物业公司]                                           │
├──────────────────────────────────────────────────────────────────┤
│ [列表区]                                                          │
│ 序号 | 公司名称 | 服务医院 | 联系人 | 联系电话 | 状态 | 操作        │
│ 1    | XX物业   | A医院    | 王五   | 137****9012| 启用 | 编辑 停用  │
├──────────────────────────────────────────────────────────────────┤
│ [分页]  共30条  每页[20▼]  < 1 2 >                                │
└──────────────────────────────────────────────────────────────────┘

查询条件

字段名	控件类型	必填	默认值	说明
公司名称	文本输入	否	—	模糊匹配
状态	下拉单选	否	全部	启用/停用
联系人	文本输入	否	—	模糊匹配

列表字段

序号	字段名	列宽	支持排序	说明
1	序号	60px	—	自增序号
2	公司名称	180px	是	—
3	服务医院	150px	否	显示关联医院名称列表
4	联系人	100px	否	—
5	联系电话	130px	否	脱敏显示
6	创建时间	150px	是	默认倒序
7	状态	80px	是	启用/停用标签
8	操作	140px	—	编辑/启停

操作按钮

按钮	权限编码	位置	显示条件	说明
新增物业公司	permission:user:create	操作栏	始终	跳转新增页
编辑	permission:user:update	行操作	始终	—
启用/停用	permission:user:update	行操作	始终	二次确认

API端点

页面操作	API路径	方法	说明
列表查询	/api/v1/property-companies	GET	分页查询
启用/停用	/api/v1/property-companies/{id}/toggle-status	PUT	—

页面4：物业公司信息新增/编辑页

页面编号：SA-A-02-P02 端侧归属：Web专属 页面路径：/account/property-companies/create 或 /account/property-companies/:id/edit

表单字段

字段名	控件类型	必填	默认值	数据来源	校验规则
公司名称	文本输入	是	—	自填	最大50字，全局唯一
公司地址	文本输入	否	—	自填	最大200字
联系人	文本输入	是	—	自填	最大20字
联系电话	文本输入	是	—	自填	手机号格式

API端点

页面操作	API路径	方法	说明
新增	/api/v1/property-companies	POST	—
编辑	/api/v1/property-companies/{id}	PUT	—

页面5：医院账号管理列表页

页面编号：SA-A-03-P01 端侧归属：Web专属 页面路径：/account/hospital-accounts

界面布局

┌──────────────────────────────────────────────────────────────────┐
│ [面包屑] 账号管理 > 医院账号管理                                    │
├──────────────────────────────────────────────────────────────────┤
│ [查询条件区]                                                      │
│ 登录账号[____] 绑定医院[▼] 状态[▼] 有效期[▼]        [查询] [重置] │
├──────────────────────────────────────────────────────────────────┤
│ [操作栏]  [新增医院账号]                                           │
├──────────────────────────────────────────────────────────────────┤
│ [列表区]                                                          │
│ 序号 | 登录账号 | 绑定医院 | 角色 | 有效期至 | 状态 | 操作          │
│ 1    | hospital01| XX医院 | 医院查看 | 2027-04-16| 正常 | 编辑 续期│
│ 2    | hospital02| YY医院 | 医院查看 | 2026-03-01| 即将到期| 续期  │
│ 3    | hospital03| ZZ医院 | 医院查看 | 2026-01-01| 已过期| 续期    │
├──────────────────────────────────────────────────────────────────┤
│ [分页]  共20条  每页[20▼]  < 1 >                                  │
└──────────────────────────────────────────────────────────────────┘

查询条件

字段名	控件类型	必填	默认值	说明
登录账号	文本输入	否	—	精确匹配
绑定医院	下拉单选	否	全部	数据来源：医院信息管理
状态	下拉单选	否	全部	正常/即将到期/已过期/已停用
有效期	下拉单选	否	全部	已过期/7天内到期/30天内到期/正常

列表字段

序号	字段名	列宽	支持排序	说明
1	序号	60px	—	自增
2	登录账号	130px	否	—
3	绑定医院	150px	是	—
4	角色	120px	否	显示分配的角色名称
5	有效期至	120px	是	即将到期=橙色，已过期=红色
6	状态	100px	是	正常(绿)/即将到期(橙)/已过期(红)/已停用(灰)
7	操作	200px	—	编辑/续期/启停/重置密码

操作按钮

按钮	权限编码	位置	显示条件	说明
新增医院账号	permission:user:create	操作栏	始终	—
编辑	permission:user:update	行操作	始终	—
续期	permission:user:update	行操作	始终	修改有效期
启用/禁用	permission:user:update	行操作	始终	二次确认，禁用立即生效
重置密码	permission:user:update	行操作	始终	重置为默认密码

通知触发

触发操作	通知对象	通知方式	消息模板	文档来源
账号禁用	被禁用账号	—	已登录session立即失效	03-超级管理员 §2
重置密码	账号持有人	—	下次登录使用新密码	—

API端点

页面操作	API路径	方法	说明
列表查询	/api/v1/accounts/hospital	GET	分页查询
启用/禁用	/api/v1/accounts/{id}/toggle-status	PUT	禁用立即失效session
续期	/api/v1/accounts/{id}/renew	PUT	修改有效期
重置密码	/api/v1/accounts/{id}/reset-password	PUT	—

页面6：新增医院账号页

页面编号：SA-A-03-P02 端侧归属：Web专属 页面路径：/account/hospital-accounts/create

界面布局

┌──────────────────────────────────────────────────────────────────┐
│ [面包屑] 账号管理 > 医院账号管理 > 新增医院账号                      │
├──────────────────────────────────────────────────────────────────┤
│ 登录账号：[____________]     初始密码：[________]（自动生成）       │
│ 绑定医院：[▼必选]                                                │
│ 有效期至：[日期选择] （必填）                                       │
│ 分配角色：[▼多选]   □ 医院查看模板  □ 自定义...                    │
├──────────────────────────────────────────────────────────────────┤
│                                         [取消]  [保存]            │
└──────────────────────────────────────────────────────────────────┘

表单字段

字段名	控件类型	必填	默认值	数据来源	校验规则
登录账号	文本输入	是	—	自填	4~20位字母数字，全局唯一
初始密码	文本输入	是	系统生成	自动生成	可手动修改，6~20位
绑定医院	下拉单选	是	—	医院信息列表	—
有效期至	日期选择	是	—	自填	不早于当前日期
分配角色	下拉多选	是	—	角色管理-医院适用角色	至少选一个

API端点

页面操作	API路径	方法	说明
新增	/api/v1/accounts/hospital	POST	—

页面7：物业公司管理员账号管理列表页

页面编号：SA-A-04-P01 端侧归属：Web专属 页面路径：/account/property-accounts

界面布局

┌──────────────────────────────────────────────────────────────────┐
│ [面包屑] 账号管理 > 物业管理员账号管理                               │
├──────────────────────────────────────────────────────────────────┤
│ [查询条件区]                                                      │
│ 登录账号[____] 绑定物业公司[▼] 服务医院[▼] 状态[▼]  [查询] [重置] │
├──────────────────────────────────────────────────────────────────┤
│ [操作栏]  [新增物业管理员账号]                                      │
├──────────────────────────────────────────────────────────────────┤
│ [列表区]                                                          │
│ 序号 | 登录账号 | 绑定物业 | 服务医院 | 角色 | 有效期至 | 状态 | 操作│
│ 1    | prop01   | XX物业  | A医院    | 管理员| 2027-04| 正常 | ...│
├──────────────────────────────────────────────────────────────────┤
│ [分页]  共40条  每页[20▼]  < 1 2 >                                │
└──────────────────────────────────────────────────────────────────┘

查询条件

字段名	控件类型	必填	默认值	说明
登录账号	文本输入	否	—	精确匹配
绑定物业公司	下拉单选	否	全部	数据来源：物业公司信息管理
服务医院	下拉单选	否	全部	数据来源：医院信息管理
状态	下拉单选	否	全部	正常/即将到期/已过期/已停用

列表字段

序号	字段名	列宽	支持排序	说明
1	序号	60px	—	自增
2	登录账号	120px	否	—
3	绑定物业公司	120px	是	—
4	服务医院	120px	是	—
5	角色	120px	否	—
6	有效期至	110px	是	颜色标记同医院账号
7	状态	90px	是	同医院账号
8	操作	200px	—	编辑/续期/启停/重置密码

操作按钮

按钮	权限编码	位置	显示条件	说明
新增物业管理员账号	permission:user:create	操作栏	始终	—
编辑	permission:user:update	行操作	始终	—
续期	permission:user:update	行操作	始终	—
启用/禁用	permission:user:update	行操作	始终	禁用时下属账号同步失效
重置密码	permission:user:update	行操作	始终	—

通知触发

触发操作	通知对象	通知方式	消息模板	文档来源
账号禁用	物业管理员	—	session失效+小程序同步下线	03-超级管理员 §2
账号禁用	下属人员	小程序推送	关联下属账号同步失效	01 §1.4

API端点

页面操作	API路径	方法	说明
列表查询	/api/v1/accounts/property-admin	GET	分页查询
启用/禁用	/api/v1/accounts/{id}/toggle-status	PUT	禁用同步下线下属
续期	/api/v1/accounts/{id}/renew	PUT	—

页面8：新增物业管理员账号页

页面编号：SA-A-04-P02 端侧归属：Web专属 页面路径：/account/property-accounts/create

表单字段

字段名	控件类型	必填	默认值	数据来源	校验规则
登录账号	文本输入	是	—	自填	4~20位字母数字，全局唯一
初始密码	文本输入	是	系统生成	自动生成	可修改
绑定物业公司	下拉单选	是	—	物业公司信息列表	—
服务医院	下拉单选	是	—	医院信息列表	—
有效期至	日期选择	是	—	自填	不早于当前日期
分配角色	下拉多选	是	—	角色管理-物业适用角色	至少选一个

API端点

页面操作	API路径	方法	说明
新增	/api/v1/accounts/property-admin	POST	—

页面9：到期账号管理页

页面编号：SA-A-07-P01 端侧归属：Web专属 页面路径：/account/expiring

界面布局

┌──────────────────────────────────────────────────────────────────┐
│ [面包屑] 账号管理 > 到期账号管理                                    │
├──────────────────────────────────────────────────────────────────┤
│ [统计卡片区]                                                      │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐                           │
│ │已过期     │ │7天内到期  │ │30天内到期 │                           │
│ │    3      │ │    5      │ │    12    │                           │
│ └──────────┘ └──────────┘ └──────────┘                           │
├──────────────────────────────────────────────────────────────────┤
│ [查询条件区]                                                      │
│ 账号类型[▼] 到期状态[▼]                           [查询] [重置]    │
├──────────────────────────────────────────────────────────────────┤
│ [列表区]                                                          │
│ 序号 | 登录账号 | 账号类型 | 绑定单位 | 有效期至 | 剩余天数 | 操作  │
│ 1    | hospital01| 医院    | XX医院   | 2026-04-20| 4天   | 续期  │
│ 2    | prop01    | 物业    | XX物业   | 2026-03-01| -46天 | 续期  │
├──────────────────────────────────────────────────────────────────┤
│ [分页]  共20条  每页[20▼]  < 1 >                                  │
└──────────────────────────────────────────────────────────────────┘

查询条件

字段名	控件类型	必填	默认值	说明
账号类型	下拉单选	否	全部	医院/物业管理员
到期状态	下拉单选	否	全部	已过期/7天内到期/30天内到期

列表字段

序号	字段名	列宽	支持排序	说明
1	序号	60px	—	自增
2	登录账号	130px	否	—
3	账号类型	100px	否	医院/物业管理员
4	绑定单位	150px	否	医院名称或物业公司名称
5	有效期至	120px	是	—
6	剩余天数	90px	是	已过期显示负数，红色标记
7	操作	100px	—	续期

操作按钮

按钮	权限编码	位置	显示条件	说明
续期	permission:user:update	行操作	始终	弹窗修改有效期

通知触发

触发操作	通知对象	通知方式	消息模板	文档来源
续期成功	被续期账号	—	账号恢复可用，记录操作日志	03-超级管理员 §3

API端点

页面操作	API路径	方法	说明
列表查询	/api/v1/accounts/expiring	GET	筛选到期账号
续期	/api/v1/accounts/{id}/renew	PUT	—

页面10：到期提醒规则配置页

页面编号：SA-A-08-P01 端侧归属：Web专属 页面路径：/account/expiry-settings

界面布局

┌──────────────────────────────────────────────────────────────────┐
│ [面包屑] 账号管理 > 到期提醒规则配置                                 │
├──────────────────────────────────────────────────────────────────┤
│ ── 提醒天数配置 ────────────────────────────────────────────       │
│ 提前提醒天数：[7] [15] [30] 天  （可多选，点击添加/移除）          │
│                                                                  │
│ ── 提醒方式 ──────────────────────────────────────────────       │
│ ☑ 用户登录时弹窗提醒                                              │
│ ☐ 邮件提醒（暂未开放）                                            │
│                                                                  │
│ ── 提醒行为 ──────────────────────────────────────────────       │
│ 提醒弹窗关闭后：☑ 可正常使用  ☐ 限制部分功能                       │
│ 账号过期后：    ☑ 禁止登录  ☐ 仅提醒                               │
├──────────────────────────────────────────────────────────────────┤
│                                         [取消]  [保存]            │
└──────────────────────────────────────────────────────────────────┘

表单字段

字段名	控件类型	必填	默认值	数据来源	校验规则
提前提醒天数	标签多选	是	7, 15, 30	—	至少选一个
用户登录弹窗	开关	是	开	—	—
弹窗关闭后行为	单选	是	可正常使用	固定选项	—
过期后行为	单选	是	禁止登录	固定选项	—

API端点

页面操作	API路径	方法	说明
查询配置	/api/v1/system/configs/expiry-reminder	GET	—
保存配置	/api/v1/system/configs/expiry-reminder	PUT	—

需求追溯

功能点编号	功能名称	文档来源	后续服务	关联功能
SA-A-01	医院信息管理	02-超级管理员 §1 / 03-超级管理员 §1	创建医院→创建医院账号	医院账号管理(绑定医院)
SA-A-02	物业公司信息管理	02-超级管理员 §1 / 03-超级管理员 §1	创建物业公司→创建物业账号	物业管理员账号管理(绑定物业)
SA-A-03	医院账号管理	02-超级管理员 §1 / 03-超级管理员 §1~2	账号创建→权限分配	权限管理(角色绑定)
SA-A-04	物业管理员账号管理	02-超级管理员 §1 / 03-超级管理员 §1~2	账号创建→权限分配，禁用→下属同步失效	权限管理(角色绑定) / 物业组织架构(下属账号)
SA-A-05	账号有效期设置	02-超级管理员 §1 / 03-超级管理员 §3 / 01 §1.4	创建时设置有效期	到期账号管理 / 到期提醒规则
SA-A-06	账号可用性控制	02-超级管理员 §1 / 03-超级管理员 §2	禁用→session立即失效+小程序下线	操作日志(记录启停操作)
SA-A-07	到期账号管理	02-超级管理员 §1 / 03-超级管理员 §3 / 01 §1.4	手动续期→账号恢复	到期提醒规则配置
SA-A-08	到期提醒规则配置	02-超级管理员 §1 / 03-超级管理员 §3 / 01 §1.4	配置→系统按规则自动提醒	到期账号管理 / 系统配置

业务规则

新建使用单位流程：医院信息→物业公司信息→医院账号→物业管理员账号，四步顺序创建（来源：03-超级管理员 §1）
账号有效期必填：创建医院/物业管理员账号时必须设置有效期（来源：01 §1.4）
物业下属不单独设有效期：下属人员随物业公司管理员账号到期而自动失效（来源：01 §1.4 / 03-超级管理员 §3）
禁用立即生效：禁用账号后session立即失效，小程序同步下线（来源：03-超级管理员 §2）
到期提醒弹窗：到期前N天登录时弹窗提醒，关闭后可正常使用（来源：01 §1.4 / 03-超级管理员 §3）
过期禁止登录：账号过期后禁止登录，需超管手动续期（来源：01 §1.4 / 03-超级管理员 §3）
超管不涉及业务数据：超级管理员仅管理系统配置与账号数据，不查看任何业务数据（来源：01 §1.3 / 03-超级管理员 §7）
所有操作记录日志：账号创建/启停/续期等操作自动记录操作日志（来源：06-项目技术要求 §4.5）

34 KiB Raw Blame History Unescape Escape

账号管理

功能概览

页面1：医院信息管理列表页

界面布局

查询条件

列表字段

操作按钮

角色差异化视图

API端点

页面2：医院信息新增/编辑页

界面布局

表单字段（基本信息）

表单字段（院区信息，支持多条）

通知触发

API端点

页面3：物业公司信息管理列表页

界面布局

查询条件

列表字段

操作按钮

API端点

页面4：物业公司信息新增/编辑页

表单字段

API端点

页面5：医院账号管理列表页

界面布局

查询条件

列表字段

操作按钮

通知触发

API端点

页面6：新增医院账号页

界面布局

表单字段

API端点

页面7：物业公司管理员账号管理列表页

界面布局

查询条件

列表字段

操作按钮

通知触发

API端点

页面8：新增物业管理员账号页

表单字段

API端点

页面9：到期账号管理页

界面布局

查询条件

列表字段

操作按钮

通知触发

API端点

页面10：到期提醒规则配置页

界面布局

表单字段

API端点

需求追溯

业务规则

34 KiB

Raw Blame History Unescape Escape