# ADR-0001:混合架构「DB 权限 + FS 内容」 - **状态**:Accepted - **日期**:对应仓库基线 ## 背景 需要平衡权限管理的可控性与内容数据的可迁移/透明性。 ## 决策 结构化元数据(用户/项目/权限/菜单/日志/向量状态等)存 MySQL;文档内容、图片、附件以原生文件存于服务器磁盘(`STORAGE_ROOT` 下 `projects/`)。 ## 后果 - 正向:文件即真理,备份/迁移只需拷贝目录 + 导出 DB。 - 代价:需要自行实现严格的路径安全校验(见 DV-0002 / NFR-3)。 ## 关联 PO-1, PO-2, PO-3;DV-0002;NFR-3。