# DV-0003：文档编辑与文件操作 – 设计（Design）

## 上下文
`files.py`（API）、`storage.py`（读写）、前端 `DocumentPage/DocumentEditor`（pages/Document）、Markdown 组件 bytemd。

## 接口设计
- GET /api/v1/files/{project_id}/tree
- GET|POST /api/v1/files/{project_id}/file
- POST /api/v1/files/{project_id}/file/operate
- POST /api/v1/files/{project_id}/upload{,-document}
- POST /api/v1/files/{project_id}/import-documents
- GET /api/v1/files/{project_id}/export-directory
- GET /api/v1/files/{project_id}/export-pdf

## 前端
- 左侧目录树，右侧 Markdown 编辑/预览；PDF 用 react-pdf；长列表虚拟滚动。

## 状态与降级
- 写文件自动创建父目录；重命名目标冲突→400。