18 lines
487 B
Markdown
18 lines
487 B
Markdown
|
# ADR-0002：磁盘目录用 UUID（storage_key）映射
|
|||
|
|
|
|||
|
|
- **状态**：Accepted
|
|||
|
|
|
|||
|
|
## 背景
|
|||
|
|
中文文件名、重名项目在文件系统层面易出乱码与冲突。
|
|||
|
|
|
|||
|
|
## 决策
|
|||
|
|
磁盘文件夹名使用 `storage_key`（UUID，36 字符），数据库 `projects.storage_key` 保存映射；对外展示名 `projects.name` 与磁盘名解耦。
|
|||
|
|
|
|||
|
|
## 后果
|
|||
|
|
- 展示名可随时改，磁盘标识不变。
|
|||
|
|
- 资源路径以 uuid 为根，天然隔离且无中文。
|
|||
|
|
|
|||
|
|
## 关联
|
|||
|
|
DV-0002。
|
|||
|
|
|