|
|
# 院方管理角色 Building 权限设置说明
|
|
|
|
|
|
## 一、数据库迁移
|
|
|
|
|
|
首先需要运行数据库迁移，创建 `admin_building_links` 表：
|
|
|
|
|
|
```bash
|
|
|
php artisan migrate
|
|
|
```
|
|
|
|
|
|
这将创建 `admin_building_links` 表，用于存储管理员与楼栋的关联关系。
|
|
|
|
|
|
## 二、角色设置
|
|
|
|
|
|
### 1. 确保存在"院方管理"角色
|
|
|
|
|
|
在系统中需要有一个角色名称包含"院方管理"的角色（例如："院方管理"、"院方管理员"等）。
|
|
|
|
|
|
### 2. 为管理员分配角色
|
|
|
|
|
|
1. 进入 **系统管理 > 管理员管理**
|
|
|
2. 编辑需要设置为"院方管理"的管理员
|
|
|
3. 在角色设置中，为该管理员分配"院方管理"角色
|
|
|
4. 确保该管理员的 `project_ids` 字段包含其需要管理的项目ID（逗号分隔）
|
|
|
|
|
|
## 三、楼栋权限关联设置
|
|
|
|
|
|
### 方法一：创建新楼栋时设置
|
|
|
|
|
|
1. 进入 **医院/项目管理 > 床位管理**
|
|
|
2. 选择对应的项目
|
|
|
3. 点击楼栋下拉框旁边的 **"+"** 按钮，创建新楼栋
|
|
|
4. 在弹出的对话框中：
|
|
|
- 填写楼栋名称
|
|
|
- 设置排序号
|
|
|
- **在"院方管理"下拉框中选择需要关联的院方管理员**（可多选）
|
|
|
5. 点击"保存"
|
|
|
|
|
|
### 方法二：编辑现有楼栋时设置
|
|
|
|
|
|
1. 进入 **医院/项目管理 > 床位管理**
|
|
|
2. 选择对应的项目
|
|
|
3. 选择需要编辑的楼栋
|
|
|
4. 点击楼栋下拉框旁边的 **"编辑"** 按钮（铅笔图标）
|
|
|
5. 在弹出的对话框中：
|
|
|
- 可以修改楼栋名称和排序号
|
|
|
- **在"院方管理"下拉框中选择需要关联的院方管理员**（可多选）
|
|
|
6. 点击"保存"
|
|
|
|
|
|
## 四、权限控制效果
|
|
|
|
|
|
设置完成后，具有"院方管理"角色的管理员将：
|
|
|
|
|
|
### 1. 订单列表页面 (`/admin/orders`)
|
|
|
- 只能查看其管理的楼栋下的所有订单
|
|
|
- 楼栋下拉框只显示其有权限的楼栋
|
|
|
- 病区下拉框只显示其有权限楼栋下的病区
|
|
|
|
|
|
### 2. 统计页面
|
|
|
- **财务统计** (`/admin/statistics/finance`)：只能查看其管理楼栋下的充值、退款记录
|
|
|
- **护理统计** (`/admin/statistics/huli`)：只能查看其管理楼栋下的病区数据
|
|
|
|
|
|
### 3. 陪护一览页面 (`/admin/orders/artboard`)
|
|
|
- 只显示其管理楼栋下的病区和床位信息
|
|
|
|
|
|
## 五、权限层级说明
|
|
|
|
|
|
系统的权限控制采用三级结构：
|
|
|
|
|
|
1. **项目级权限**：通过 `admins.project_ids` 字段控制，管理员只能访问其关联的项目
|
|
|
2. **角色级权限**：
|
|
|
- **护士长**：通过 `admin_area_links` 表关联病区，只能查看其管理病区下的数据
|
|
|
- **院方管理**：通过 `admin_building_links` 表关联楼栋，只能查看其管理楼栋下的数据（包括该楼栋下所有病区）
|
|
|
3. **数据级权限**：根据角色和关联关系，自动过滤查询结果
|
|
|
|
|
|
## 六、注意事项
|
|
|
|
|
|
1. **一个管理员可以同时拥有多个角色**，但权限控制逻辑为：
|
|
|
- 如果同时是"护士长"和"院方管理"，优先使用"护士长"的权限（更细粒度）
|
|
|
- 如果只是"院方管理"，则使用楼栋级别的权限
|
|
|
|
|
|
2. **一个楼栋可以关联多个院方管理员**，这些管理员都可以查看该楼栋下的所有数据
|
|
|
|
|
|
3. **删除楼栋时**，相关的 `admin_building_links` 记录会通过软删除保留，但权限会失效
|
|
|
|
|
|
4. **修改楼栋关联**时，系统会先删除旧的关联关系，再创建新的关联关系
|
|
|
|
|
|
## 七、数据表结构
|
|
|
|
|
|
### admin_building_links 表
|
|
|
|
|
|
| 字段 | 类型 | 说明 |
|
|
|
|------|------|------|
|
|
|
| id | int | 主键 |
|
|
|
| building_id | int | 楼栋ID |
|
|
|
| project_id | int | 项目ID |
|
|
|
| admin_id | string | 管理员ID |
|
|
|
| created_at | timestamp | 创建时间 |
|
|
|
| updated_at | timestamp | 更新时间 |
|
|
|
| deleted_at | timestamp | 软删除时间 |
|
|
|
|
|
|
## 八、API 接口
|
|
|
|
|
|
新增的接口：
|
|
|
|
|
|
- `GET /admin/project/get-yuanfang`：获取院方管理列表
|
|
|
- 参数：`project_id`（必填）、`building_id`（可选，用于编辑时标记已选中的管理员）
|
|
|
|
|
|
## 九、常见问题
|
|
|
|
|
|
### Q1: 为什么设置了权限但看不到数据？
|
|
|
A: 请检查：
|
|
|
1. 管理员是否已分配"院方管理"角色
|
|
|
2. 管理员的 `project_ids` 是否包含当前项目ID
|
|
|
3. 楼栋是否已正确关联到该管理员
|
|
|
|
|
|
### Q2: 如何查看某个楼栋关联了哪些管理员？
|
|
|
A: 可以通过编辑该楼栋，在"院方管理"下拉框中查看已选中的管理员。
|
|
|
|
|
|
### Q3: 如何批量设置多个楼栋的权限？
|
|
|
A: 目前需要逐个楼栋进行设置，或者可以通过数据库直接操作 `admin_building_links` 表。
|
|
|
|
