## Overview

本次变更是一次“文档基线收敛 + OpenSpec 补记”。运行时 schema 已经完成修改，因此设计重点不是实现新逻辑，而是把现有真实状态沉淀成可检索、可归档、可继续维护的标准资料。

## Documentation Strategy

### Per-collection database docs

数据库结构文档统一拆成按 collection 命名的单文件：

- `pb_tbl_system_dict.md`
- `pb_tbl_company.md`
- `pb_tbl_attachments.md`
- `pb_tbl_document.md`
- `pb_tbl_document_operation_history.md`
- `pb_tbl_auth_users.md`
- `pb_tbl_auth_resources.md`
- `pb_tbl_auth_roles.md`
- `pb_tbl_auth_role_perms.md`
- `pb_tbl_auth_user_overrides.md`
- `pb_tbl_auth_row_scopes.md`

混合型老文档删除，避免一张表同时出现在多份说明中。

### Uniform format

每份文档统一包含以下章节：

1. 来源
2. 类型
3. 读写规则
4. 表用途
5. 字段清单
6. 索引
7. 补充约定

字段信息以线上实际 collection 回读为主，脚本为辅；这能规避脚本历史遗留误差。

## OpenSpec Recording Strategy

### pocketbase-native-data-access

记录当前项目允许直接走 PocketBase 原生 API / SDK 的边界：

- `tbl_company` 公开创建与公开列表 / 条件查询
- `tbl_system_dict` 公开读
- `tbl_document` 公开读

### pocketbase-schema-docs

记录数据库结构文档必须采用按表命名和统一格式的规范，避免未来继续出现零散说明。

## Validation

- 文档字段以线上 PocketBase collection 回读结果为准
- OpenSpec 变更在归档前完成 `openspec validate`
