# 历史 API 与权限文档索引

> 最后整理：2026-05-04
> 说明：`new_doc_review/auth_doc/` 目录以历史阶段的 API、RBAC、前端对接快照为主，适合补背景，不适合作为当前系统唯一事实来源。

## 使用方式

- 当前主链路以 `docs/HANDOFF.md` 与 `docs/迁移与兼容/旧接口文档导航.md` 为准
- `new_doc_review/auth_doc/` 里的文档，多数写于旧接口或 PostgREST 仍是主依赖的时期
- 若历史文档与现网代码冲突，以现网代码和主文档为准

## 建议优先查阅的历史文档

| 主题 | 文档 | 说明 |
|------|------|------|
| RBAC 总说明 | `new_doc_review/auth_doc/RBAC_API_GUIDE_V3.4.md` | 当前最接近可用的 RBAC API 总览 |
| RBAC 历史全量设计 | `new_doc_review/auth_doc/RBAC_COMPLETE_GUIDE_V3.3.md` | 适合追溯设计演进 |
| 入口模块 API | `new_doc_review/auth_doc/ENTRY_MODULE_API.md`、`new_doc_review/auth_doc/entry_modules_api.md` | 入口模块旧接口资料 |
| 文档类型 API | `new_doc_review/auth_doc/document_types_api.md` | 文档类型早期接口说明 |
| 评查点前端接口 | `new_doc_review/auth_doc/review_points_api_frontend.md` | 评查点老链路前端接口说明 |
| 交叉评查 | `new_doc_review/auth_doc/交叉评查接口文档.md`、`new_doc_review/auth_doc/交叉评查接口对接状态报告.md` | 交叉评查历史对接资料 |
| 路由 / 共享权限 | `new_doc_review/auth_doc/通用权限前端对接文档.md`、`new_doc_review/auth_doc/通用权限前端对接文档(1).md`、`new_doc_review/auth_doc/角色-路由权限实现方案.md` | 一个是 RBAC 总对接文档，一个是共享权限专项说明，一个是后端设计说明 |

## 本次清理

- 已删除被新版覆盖或明显重复的副本：
  - `new_doc_review/auth_doc/entry_modules_api(1).md`
  - `new_doc_review/auth_doc/交叉评查接口文档(1).md`
  - `new_doc_review/auth_doc/API_RESPONSE_EXAMPLES_V3.2.md`
- 保留 `new_doc_review/auth_doc/API_RESPONSE_EXAMPLES_V3.3.md` 作为现存最新响应示例
