新增: 初始化 DevFlow 项目仓库
Tauri 2 + Vue 3 + Vite 6 桌面应用,Rust workspace 含 13 个 crate (df-ai / df-storage / df-workflow / df-core / df-execute 等)。 核心能力:AI 聊天 agentic 循环(工具调用+人工审批)、工作流引擎、 任务/想法/项目/阶段管理、可追溯性,及配套前端组件。
This commit is contained in:
38
docs/01-技术文档/SQLite-CRUD模式.md
Normal file
38
docs/01-技术文档/SQLite-CRUD模式.md
Normal file
@@ -0,0 +1,38 @@
|
||||
# SQLite CRUD 模式
|
||||
|
||||
> 创建: 2026-06-10 | 状态: 初稿
|
||||
|
||||
---
|
||||
|
||||
## 概述
|
||||
|
||||
DevFlow 使用 SQLite (rusqlite) 作为本地存储引擎。df-storage 负责 SQLite 连接管理、Schema 迁移和 CRUD 操作。
|
||||
|
||||
## 当前状态
|
||||
|
||||
- SQLite 连接池: 已实现
|
||||
- Schema 迁移 (6 张表 + 4 索引): 已实现
|
||||
- CRUD 层: **待实施**
|
||||
|
||||
## 设计要点
|
||||
|
||||
### 待实施内容
|
||||
|
||||
1. **泛型 CRUD trait** — 定义统一的 `Repository<T>` 接口
|
||||
2. **SQL 构建** — 参数化查询,防止 SQL 注入
|
||||
3. **事务支持** — 跨表操作的原子性保证
|
||||
4. **批量操作** — `insert_batch` / `update_batch`
|
||||
5. **查询构建器** — 条件查询、分页、排序
|
||||
|
||||
### 约定
|
||||
|
||||
- ID 字段统一使用 `TEXT` (UUID v4)
|
||||
- 时间字段使用 `INTEGER` (Unix timestamp)
|
||||
- JSON 字段使用 `TEXT` 存储 JSON 字符串
|
||||
- 所有写操作返回 `Result<(), df_core::error::Error>`
|
||||
|
||||
## 相关文件
|
||||
|
||||
- `crates/df-storage/src/lib.rs` — 存储层入口
|
||||
- `crates/df-storage/src/schema.rs` — Schema 定义与迁移
|
||||
- `crates/df-core/src/error.rs` — 统一错误类型
|
||||
47
docs/01-技术文档/Tauri-IPC模式.md
Normal file
47
docs/01-技术文档/Tauri-IPC模式.md
Normal file
@@ -0,0 +1,47 @@
|
||||
# Tauri IPC 模式
|
||||
|
||||
> 创建: 2026-06-10 | 状态: 初稿
|
||||
|
||||
---
|
||||
|
||||
## 概述
|
||||
|
||||
Tauri v2 的 IPC 机制是 DevFlow 前后端通信的核心桥梁。本文档描述 DevFlow 中 Tauri IPC 的设计模式。
|
||||
|
||||
## 当前状态
|
||||
|
||||
- Tauri Commands: 仅 `greet` 示例命令
|
||||
- 业务 IPC: **待实施**
|
||||
|
||||
## 设计要点
|
||||
|
||||
### 待实施内容
|
||||
|
||||
1. **Command 定义** — 在 `src-tauri/src/commands/` 下按模块组织
|
||||
2. **序列化约定** — Rust 结构体 derive `Serialize`/`Deserialize`
|
||||
3. **错误传递** — `Result<T, String>` 返回给前端
|
||||
4. **流式支持** — AI 输出、Shell 输出的流式推送
|
||||
5. **状态注入** — 通过 `tauri::State` 共享 Rust 运行时状态
|
||||
|
||||
### IPC 层次
|
||||
|
||||
```
|
||||
Vue Component
|
||||
→ Pinia Store (Action)
|
||||
→ @tauri-apps/api (invoke)
|
||||
→ Tauri Command (Rust)
|
||||
→ Crate 业务逻辑
|
||||
→ df-storage (SQLite)
|
||||
```
|
||||
|
||||
### 命名约定
|
||||
|
||||
- Rust command: `#[tauri::command] fn get_projects(...)`
|
||||
- 前端调用: `invoke("get_projects", { ... })`
|
||||
- Store action: `async fetchProjects()`
|
||||
|
||||
## 相关文件
|
||||
|
||||
- `src-tauri/src/main.rs` — Tauri 入口
|
||||
- `src-tauri/src/commands/` — IPC 命令目录
|
||||
- `frontend/src/stores/` — Pinia Store
|
||||
Reference in New Issue
Block a user