# 前端工程文档导航

> 最后整理：2026-05-04
> 说明：本目录主要存放 `new_doc_review` 前端实现、联调、部署、能力评估类文档。

## 当前优先阅读

- 权限子页映射规范：`new_doc_review/docs/route-alias-guidelines.md`
- PostgREST 迁移盘点：
  - `new_doc_review/docs/PostgREST使用情况-后端API替代建议.md`
  - `new_doc_review/docs/PostgREST请求模块清单.md`
  - `new_doc_review/docs/PostgREST实际使用清单.md`
- 文档类型页面改造背景：`new_doc_review/docs/文档类型管理CRUD详细分析.md`
- 评查点域联调资料：`new_doc_review/docs/evaluation/`
- 部署与运行：`new_doc_review/docs/deployment-config.md`、`new_doc_review/docs/docker-deployment.md`

## 按主题分类

| 主题 | 重点文档 | 说明 |
|------|----------|------|
| 权限 / 会话 / 登录 | `RBAC路由权限集成说明.md`、`RBAC路由权限集成_修复说明.md`、`JWT_IMPLEMENTATION.md`、`统一登录流程_实施记录.md` | 登录、JWT、路由权限接入 |
| PostgREST 迁移 | `PostgREST使用情况-后端API替代建议.md`、`PostgREST请求模块清单.md`、`PostgREST实际使用清单.md`、`PostgREST未使用函数清单.md` | 哪些页面仍依赖 PostgREST、替代优先级 |
| 首页 / 数据首页 | `getHomeData_完整逻辑文档.md`、`home-api-analysis.md` | 首页数据获取与结构说明 |
| 文档类型 / 规则页 | `文档类型管理CRUD详细分析.md`、`attribute_type_frontend_integration.md`、`evaluation/` | 文档类型、评查点、属性类型联调 |
| 合同模板 / 起草 | `contract-drafting-*.md`、`contract-draft-*.md` | 合同模板搜索、列表、起草与历史重构记录 |
| Dify / 智能助手 | `dify-proxy-backend-integration.md`、`new-dify/`、`Token管理架构优化总结.md` | 智能助手、代理接入、Token 管理 |
| 文件 / 文档能力 | `minio-docx-extraction-fix.md`、`docxtemplater-placeholder-extraction.md`、`react-pdf功能总结.md` | 文件处理、占位符提取、PDF 能力 |
| 部署 / 运行维护 | `deployment-config.md`、`deployment-checklist.md`、`docker-deployment.md`、`postgresql-backup-guide.md` | 环境部署与备份 |

## 使用约束

- 这里偏前端实现细节，不替代 `docs/` 下的项目主文档
- 涉及当前主链路的事实判断，优先对照 `docs/HANDOFF.md` 与 `docs/接口/README.md`
- 临时排障文档若已失效，应合并进正式文档后删除，不再继续堆积“紧急说明”类文件