# pb_tbl_auth_user_overrides

> 来源：线上 PocketBase collection 回读、`script/pocketbase.newpb.js`
> 类型：`base`
> 读写规则：仅管理员 / 管理角色允许

## 表用途

用于给单个用户覆盖角色默认权限，实现细粒度例外授权。

## 字段清单

| 字段名 | 类型 | 必填 | 说明 |
| :--- | :--- | :---: | :--- |
| `id` | `text` | 是 | PocketBase 记录主键 |
| `override_id` | `text` | 是 | 覆盖权限业务 ID |
| `users_convers_id` | `text` | 是 | 目标用户会话 ID |
| `res_id` | `text` | 是 | 资源业务 ID |
| `access_level` | `number` | 是 | 权限级别 |
| `priority` | `number` | 否 | 优先级 |
| `is_delete` | `number` | 否 | 软删除标记，`0` 表示未删除，`1` 表示已删除，默认 `0` |

## 索引

| 索引名 | 类型 | 说明 |
| :--- | :--- | :--- |
| `idx_tbl_auth_user_overrides_override_id` | `UNIQUE INDEX` | 保证 `override_id` 唯一 |
| `idx_tbl_auth_user_overrides_users_convers_id` | `INDEX` | 加速按用户查询 |
| `idx_tbl_auth_user_overrides_res_id` | `INDEX` | 加速按资源查询 |
| `idx_tbl_auth_user_overrides_unique_map` | `UNIQUE INDEX` | 保证 `users_convers_id + res_id` 唯一 |

## 补充约定

- `is_delete` 用于软删除控制，用户覆盖权限取消时建议软删除保留记录。
- 集合默认查询规则已内置 `is_delete = 0`，用户覆盖权限列表/详情默认隐藏已软删除记录。
