21 lines
749 B
Markdown
21 lines
749 B
Markdown
|
# 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。
|
|||
|
|
|