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