# 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：文件变更触发向量/全文索引进后台同步。