# leaudit-platform 文档地图

> 最后整理：2026-05-04
> 当前主线：以后端 `fastapi_leaudit` 的 `/docs` 为主整理入口，前端文档仅保留必要索引引用。

## 先看什么

- 给老板汇报当前状态：先看 `docs/HANDOFF.md`
- 接手继续开发：先看 `docs/HANDOFF.md`，再看 `docs/接口/README.md`
- 查具体模块：按下面“功能模块索引”找对应文档
- 查规则引擎与后端处理链路：看 `docs/leaudit/README.md` 与 `docs/规则编辑/README.md`
- 查前端历史对接资料：看 `new_doc_review/docs/README.md`
- 查旧版 RBAC / API 存量资料：看 `docs/历史API与权限文档索引.md`

## 当前后端主文档

- `docs/HANDOFF.md`：当前状态、已完成事项、下一步、关键代码位置
- `docs/接口/README.md`：后端接口文档导航
- `docs/权限与地区隔离文档导航.md`：权限、路由、地区隔离主线
- `docs/leaudit/README.md`：稳定架构、表结构、处理流水线
- `docs/规则编辑/README.md`：规则管理、Bridge 接入、落地实施顺序

## 功能模块索引

| 模块 | 重点文档 | 说明 |
|------|----------|------|
| 全局交接 / 当前状态 | `docs/HANDOFF.md` | 当前主线、已完成事项、剩余阻塞、关键代码位置 |
| 后端接口总览 | `docs/接口/README.md` | 当前有效接口文档的阅读入口 |
| 首页入口模块 / 菜单 | `docs/接口/入口模块绑定最终设计方案.md` | 首页入口展示、绑定、RBAC 最小可用链路 |
| 文档上传 / 文档列表 / 文档详情 | `docs/接口/文档上传与列表接口分析.md` | 上传、列表、详情/更新/删除、评查触发、数据隔离 |
| 文档类型 / 规则绑定 | `docs/接口/评查点分组目标结构与迁移方案.md` | 文档类型、入口模块、规则组、规则集关系 |
| 评查点分组迁移 | `docs/接口/评查点分组目标结构与迁移方案.md`、`docs/接口/评查点分组迁移执行前检查清单.md` | 新老分组模型梳理与迁移脚本执行建议 |
| 权限 / 路由 / 地区隔离 | `docs/权限与地区隔离文档导航.md`、`docs/接口/用户权限与权限点清单.md`、`docs/用户与地区权限完整设计方案.md` | RBAC、路由、用户与地区隔离设计 |
| 规则引擎 / OSS / Bridge | `docs/规则编辑/README.md`、`docs/leaudit/README.md` | 规则 DSL、执行链路、对象存储、Bridge 设计 |
| 历史资料索引 | `docs/历史API与权限文档索引.md` | 老阶段 RBAC / API 快照的使用入口 |
| 前端权限别名 | `new_doc_review/docs/route-alias-guidelines.md` | 什么时候加 alias，什么时候补真实菜单路由 |

## 文档目录约束

### `docs/`

- 这里是当前项目的主文档目录
- 只保留当前主线设计、接口、交接、迁移、规则架构文档
- 新增业务说明优先写到这里，不要再散落到临时目录

### `new_doc_review/docs/`

- 这里保留前端工程实现文档
- 偏实现、联调、部署、组件能力说明
- 如果某项内容已经上升为“全项目共识”，应同步沉淀回 `docs/`

### `new_doc_review/auth_doc/`

- 这里以历史 API / RBAC / 前端对接资料为主
- 多数是老阶段快照，不应直接当成当前系统唯一事实来源
- 使用前先对照 `docs/HANDOFF.md` 与 `docs/接口/README.md`

## 本次已清理

- 删除重复或已被新版本覆盖的 Markdown：
  - `docs/routes/http_routes_dedup_2026-04-27.md`
  - `docs/superpowers/plans/2026-04-28-fix-double-finalize-and-bindings-api.md`
  - `docs/用户权限开发TaskList.md`
  - `docs/leaudit/SYSTEM_OVERVIEW.md`
  - `docs/接口/新系统版_documents_list接口.md`
  - `docs/接口/首页菜单最小可用收口说明.md`
  - `docs/接口/系统设置入口恢复说明.md`
  - `docs/规则编辑/开发任务拆解清单.md`
  - `docs/规则编辑/跑通全流程所需准备项.md`
  - `docs/规则编辑/为什么仍然需要Bridge适配层.md`
  - `docs/规则编辑/yaml规则在线编辑设计.md`
  - `docs/规则编辑/worker并发执行改造方案.md`
  - `docs/leaudit/并发与重试参数说明.md`
  - `docs/接口/文档上传与评查接口.md`
  - `docs/接口/首页入口接口落地说明.md`
  - `docs/接口/评查点分组正式迁移执行建议.md`
  - `docs/接口/文档类型与评查组关联方案.md`
  - `docs/老系统_docauditai_用户权限架构深度分析.md`
  - `docs/接口/前端联调404与资源缺口收口清单.md`
  - `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/docs/URGENT-前端必须修改.md`
- 补齐文档导航：
  - `docs/README.md`
  - `docs/接口/README.md`
  - `docs/权限与地区隔离文档导航.md`
  - `docs/leaudit/README.md`
  - `docs/规则编辑/README.md`
  - `docs/历史API与权限文档索引.md`
  - `new_doc_review/docs/README.md`
- 统一现状入口：`docs/HANDOFF.md`

## 后续维护规则

- 新功能如果已经进入当前主线，优先补 `docs/HANDOFF.md` 的“已完成 / 待做”
- 接口发生变化时，优先更新 `docs/接口/` 下对应文档
- 只用于阶段排障的“临时说明”在问题关闭后要么合并进正式文档，要么删除
- 带版本号或带 `(1)` 的副本文件，原则上不继续新增