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