# df-storage 存储层

> 创建: 2026-06-10 | 状态: 初稿

---

## 概述

df-storage 是 DevFlow 的数据持久化层，基于 SQLite (rusqlite)，负责连接管理、Schema 迁移和 CRUD 操作。

## 当前状态

| 功能 | 状态 |
|------|------|
| SQLite 连接管理 | ✅ 已实现 |
| Schema 迁移 (6 张表) | ✅ 已实现 |
| CRUD 操作 | ⬜ 待实施 |
| 事务支持 | ⬜ 待实施 |

## 数据表

Phase 1 已创建的 6 张核心表：

1. **ideas** — 想法池
2. **projects** — 项目
3. **tasks** — 任务
4. **workflow_defs** — 工作流定义
5. **workflow_runs** — 工作流执行
6. **artifacts** — 产出物

完整表结构见 `ARCHITECTURE.md` 数据模型章节。

## 依赖关系

```
df-core (错误类型、ID 生成)
  ← df-storage
```

## 文件结构

```
crates/df-storage/src/
├── lib.rs        — 模块入口，导出公共 API
├── connection.rs — SQLite 连接管理
├── schema.rs     — Schema 定义与迁移
└── crud.rs       — CRUD 操作 (待创建)
```

## 相关文档

- [SQLite CRUD 模式](../01-技术文档/SQLite-CRUD模式.md)
- [前后端类型对齐](../02-架构设计/前后端类型对齐.md)