883 B

Raw Blame History

DV-0002：项目与文件系统 – 设计（Design）

上下文

projects.py、storage.py、project_file_service.py、file_vector_sync_service.py。

数据模型

projects（storage_key/owner_id/status/access_pass…）
project_members（role: admin/editor/viewer）
document_meta、document_vector
细节见 DATABASE.md。

存储结构

STORAGE_ROOT/projects/<storage_key>/ + _assets/images|files + 默认 README.md。

接口设计

/api/v1/projects/*（CRUD、my、shared、transfer、members）
/api/v1/files/{project_id}/tree

路径安全

get_secure_path(storage_key, rel)：以 project_root 为根，relative_to 校验，失败 403。

状态与降级

权限不足→403；索引同步失败不阻塞文件写（最终一致）。

变更影响

ADR-0006：文件变更触发向量/全文索引进后台同步。