知识库管理
这篇解决什么
项目资料空间怎么建、系统文件夹怎么长出来、文档中心从哪进。读完能对上 project_document、POST /ensure-space，以及菜单「项目文档」。这里不是大模型知识库。
默认端口 48080，管理端前缀 /admin-api。PC 开发页 http://127.0.0.1:5800。在线编辑和权限见 文档与协作。工程启动见 快速开始。
示意图：每个已立项台账有一份资料树。文件落在同一套文件客户端，节点记在 project_document。
从哪开
| 名称 | 说明 | 仓库路径 |
|---|---|---|
| 表 | 文件夹和文件同一张表 | project_document |
| 接口 | 初始化、树、分页、上传 | @RequestMapping("/project/document") |
| 实现 | 空间与目录同步 | .../service/document/ProjectDocumentServiceImpl.java |
| 文档中心 | 跨项目选台账再进树 | ruoyi-office-vben/apps/web-antd/src/views/project/document/center/ |
| 台账页签 | 详情里的「项目文档」 | views/project/ledger/detail/components/document-library.vue |
| 菜单 | 8170「项目文档」 | /project/project-document |
官方菜单挂在 5430 项目下。权限字 project:document:query / upload / update / delete。查询按钮也挂在台账 5431 上。
不要写成 AI 知识库
大模型切片、问答在 yudao-module-ai，菜单一般叫知识库 / RAG。项目资料是台账上的文件夹树，入口是「项目 → 项目文档」。
打开中心后选一个台账，前端会调 POST /project/document/ensure-space。没有根目录就按项目名建一份，并补系统文件夹。
本系统截图：项目 → 项目文档 → 查询统计。有文件数和来源分布，说明文档中心已经在跑。切到「文档管理」才是资料树。
系统文件夹
ProjectDocumentFolderKind 决定哪些目录是系统建的。
| 名称 | 说明 | 仓库路径 |
|---|---|---|
root | 根，名称用台账项目名 | 首次 ensureSpace |
apply / change / acceptance | 立项 / 变更 / 验收 | 根下固定三夹 |
uncategorized | 未归类 | 根下 sort 90 |
phase | 阶段夹，跟着任务树 taskType=1 | syncPhaseFolders |
type | 项目类型配置的资料目录 | folderSchema，最多三层 |
custom | 人手新建 | POST /folder/create |
节点类型：0 文件夹，1 文件。来源 ProjectDocumentSourceType：资料库上传、任务、执行、进度、立项、变更。流程附件用 list-by-source / replace-source 挂回业务单，不必再抄一套附件表。
示意图：先有根，再补固定夹。类型目录来自项目类型配置。阶段夹跟任务阶段走。
客户默认包 ruoyi-office-db/dump/latest/ 带 project_document 及相关表。新环境先导入 schema，再导入 static_data。
配置与操作
打开 项目 → 项目文档（菜单 8170，挂在 5430 下），选一个已立项台账。前端调 POST /project/document/ensure-space：没有根目录就按项目名建一份，并补立项 / 变更 / 验收 / 未归类。权限字 project:document:query / upload / update / delete。
阶段夹跟任务树 taskType=1 走 syncPhaseFolders。类型目录来自项目类型配置的 folderSchema（最多三层）。人手新建走 POST /folder/create。节点 0 文件夹、1 文件。台账详情「项目文档」页签和中心是同一棵树。
