# pb_tbl_auth_row_scopes

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

## 表用途

用于定义按用户或按角色生效的行级过滤范围，是 ABAC / 行级权限的核心表。

## 字段清单

| 字段名 | 类型 | 必填 | 说明 |
| :--- | :--- | :---: | :--- |
| `id` | `text` | 是 | PocketBase 记录主键 |
| `scope_id` | `text` | 是 | 范围业务 ID |
| `target_type` | `text` | 是 | 目标类型 |
| `target_id` | `text` | 是 | 目标 ID |
| `table_name` | `text` | 是 | 作用表名 |
| `filter_sql` | `editor` | 是 | 行级过滤表达式 |
| `is_delete` | `number` | 否 | 软删除标记，`0` 表示未删除，`1` 表示已删除，默认 `0` |

## 索引

| 索引名 | 类型 | 说明 |
| :--- | :--- | :--- |
| `idx_tbl_auth_row_scopes_scope_id` | `UNIQUE INDEX` | 保证 `scope_id` 唯一 |
| `idx_tbl_auth_row_scopes_target_type` | `INDEX` | 加速按目标类型查询 |
| `idx_tbl_auth_row_scopes_target_id` | `INDEX` | 加速按目标 ID 查询 |
| `idx_tbl_auth_row_scopes_table_name` | `INDEX` | 加速按作用表查询 |

## 补充约定

- `is_delete` 用于软删除控制，废弃的行级范围规则建议软删除保留，以便问题追溯。
- 集合默认查询规则已内置 `is_delete = 0`，行级范围列表/详情默认隐藏已软删除规则。
