Momentry Studio
1bd4b9215f
核心发现: 1. Momentry Studio - ✅ SQLite (rusqlite): 搜索历史、书签、用户认证 - ❌ PostgreSQL (sqlx): 遗留依赖，未使用 2. MarkBase Core - ✅ SQLite: 认证数据 - ⚠️ PostgreSQL: 可选，未启用 3. Momentry Core - ✅ PostgreSQL: 核心业务数据 - ✅ Qdrant: 向量搜索 - ✅ MongoDB: 文档存储 数据库文件: - Momentry Studio: data/users/demo.sqlite - MarkBase: ~/markbase/data/auth.sqlite - Momentry Core: postgresql://localhost:5432/momentry 必需服务: - PostgreSQL 12+ (pgvector 扩展) - Qdrant 1.7+ - MongoDB 5+ 建议: - 移除 Momentry Studio 的 sqlx 依赖 - 简化依赖树
505 lines
16 KiB
Markdown
505 lines
16 KiB
Markdown
# 数据库依赖关系确认
|
||
|
||
**生成时间**: 2026-10-12
|
||
**状态**: ✅ 已确认所有数据库依赖
|
||
|
||
---
|
||
|
||
## 📊 数据库架构总览
|
||
|
||
```
|
||
Momentry Studio (前端 + Tauri)
|
||
│
|
||
├─> SQLite (rusqlite)
|
||
│ └─> 本地数据: 搜索历史、书签、用户认证
|
||
│ └─> 路径: data/users/demo.sqlite
|
||
│
|
||
└─> MarkBase Core (依赖)
|
||
│
|
||
├─> SQLite (rusqlite)
|
||
│ └─> 认证数据: 用户凭证、权限
|
||
│ └─> 路径: ~/markbase/data/auth.sqlite
|
||
│
|
||
└─> PostgreSQL (tokio-postgres) [可选]
|
||
└─> 文件元数据、共享配置 (如启用)
|
||
|
||
Momentry Core (后端 API)
|
||
│
|
||
├─> PostgreSQL (sqlx)
|
||
│ └─> 核心数据: 文件、人脸、身份、Trace
|
||
│ └─> 数据库: momentry
|
||
│ └─> 连接: postgres://accusys@localhost:5432/momentry
|
||
│
|
||
├─> Qdrant (向量数据库)
|
||
│ └─> 向量搜索: 语义搜索、人脸嵌入
|
||
│ └─> 连接: http://127.0.0.1:6333
|
||
│ └─> 集合: momentry_rule1
|
||
│
|
||
└─> MongoDB (文档数据库)
|
||
└─> 文档存储: 分析结果、大对象
|
||
└─> 连接: mongodb://localhost:27017
|
||
└─> 数据库: momentry
|
||
```
|
||
|
||
---
|
||
|
||
## 📝 详细说明
|
||
|
||
### 1. Momentry Studio
|
||
|
||
#### SQLite (rusqlite)
|
||
|
||
**依赖**:
|
||
```toml
|
||
rusqlite = { version = "0.32", features = ["bundled"] }
|
||
```
|
||
|
||
**用途**:
|
||
- ✅ **搜索历史** (`search_history` 表)
|
||
- ✅ **书签** (`bookmarks` 表)
|
||
- ✅ **视频标记** (`video_marks` 表)
|
||
- ✅ **用户认证** (`app_users` 表)
|
||
|
||
**数据库文件**:
|
||
```
|
||
/Users/accusys/momentry_studio/data/users/demo.sqlite
|
||
```
|
||
|
||
**表结构**:
|
||
```sql
|
||
CREATE TABLE search_history (
|
||
id TEXT PRIMARY KEY,
|
||
query TEXT NOT NULL,
|
||
title TEXT NOT NULL,
|
||
chat_state TEXT,
|
||
mode TEXT DEFAULT 'keyword',
|
||
pinned INTEGER DEFAULT 0,
|
||
created_at TEXT,
|
||
updated_at TEXT
|
||
);
|
||
|
||
CREATE TABLE bookmarks (
|
||
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
||
label TEXT NOT NULL,
|
||
history_id TEXT,
|
||
created_at TEXT
|
||
);
|
||
|
||
CREATE TABLE video_marks (
|
||
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
||
file_uuid TEXT NOT NULL,
|
||
tag TEXT NOT NULL,
|
||
start_frame INTEGER NOT NULL,
|
||
end_frame INTEGER,
|
||
note TEXT,
|
||
created_at TEXT
|
||
);
|
||
|
||
CREATE TABLE app_users (
|
||
id TEXT PRIMARY KEY,
|
||
username TEXT NOT NULL UNIQUE,
|
||
password_hash TEXT,
|
||
display_name TEXT,
|
||
role TEXT DEFAULT 'user',
|
||
created_at TEXT,
|
||
updated_at TEXT
|
||
);
|
||
```
|
||
|
||
**代码位置**: `src-tauri/src/db.rs`
|
||
|
||
---
|
||
|
||
#### PostgreSQL (sqlx) - ⚠️ 遗留依赖
|
||
|
||
**依赖**:
|
||
```toml
|
||
sqlx = { version = "0.8", features = ["runtime-tokio", "postgres", "json"] }
|
||
```
|
||
|
||
**状态**:
|
||
- ❌ **未使用** - 通过 MarkBase Core 间接引入
|
||
- ⚠️ **建议移除** - 减少编译时间和二进制大小
|
||
|
||
**原因**: Momentry Studio 依赖 `markbase-core`，而 MarkBase Core 支持 PostgreSQL，但 Studio 本身不使用。
|
||
|
||
---
|
||
|
||
### 2. MarkBase Core
|
||
|
||
#### SQLite (rusqlite)
|
||
|
||
**依赖**:
|
||
```toml
|
||
rusqlite = { version = "0.32", features = ["bundled"] }
|
||
```
|
||
|
||
**用途**:
|
||
- ✅ **用户认证** (`auth.sqlite`)
|
||
- ✅ **文件凭证** (可选，每个用户独立数据库)
|
||
|
||
**数据库文件**:
|
||
```
|
||
/Users/accusys/markbase/data/auth.sqlite # 认证数据库
|
||
/Users/accusys/markbase/data/users/accusys.sqlite # 用户数据 (可选)
|
||
/Users/accusys/markbase/data/users/demo.sqlite # 用户数据 (可选)
|
||
/Users/accusys/markbase/data/users/credentials.sqlite # 凭证 (可选)
|
||
```
|
||
|
||
---
|
||
|
||
#### PostgreSQL (tokio-postgres) - 可选
|
||
|
||
**依赖**:
|
||
```toml
|
||
tokio-postgres = "0.7"
|
||
postgres = "0.19"
|
||
```
|
||
|
||
**用途**:
|
||
- ⚠️ **可选功能** - 文件共享、高级权限管理
|
||
- ❌ **当前未启用** - 使用 SQLite 替代
|
||
|
||
**代码位置**:
|
||
- `/Users/accusys/markbase/markbase-core/src/pg_client.rs`
|
||
- `/Users/accusys/markbase/markbase-core/src/provider/pg.rs`
|
||
|
||
**状态**: 已实现但未激活，可配置启用
|
||
|
||
---
|
||
|
||
### 3. Momentry Core
|
||
|
||
#### PostgreSQL (sqlx)
|
||
|
||
**依赖**:
|
||
```toml
|
||
sqlx = { version = "0.8", features = ["runtime-tokio", "postgres", "sqlite", "json", "chrono", "uuid"] }
|
||
pgvector = { version = "0.3", features = ["sqlx"] }
|
||
```
|
||
|
||
**用途**:
|
||
- ✅ **核心业务数据**
|
||
- 文件信息 (`files` 表)
|
||
- 人脸数据 (`faces` 表)
|
||
- 身份信息 (`identities` 表)
|
||
- Trace 数据 (`traces` 表)
|
||
- 视频标记 (`video_marks` 表)
|
||
- 向量搜索 (`pgvector` 扩展)
|
||
|
||
**数据库配置**:
|
||
```bash
|
||
DATABASE_URL=postgres://accusys@localhost:5432/momentry
|
||
```
|
||
|
||
**必需服务**:
|
||
- PostgreSQL 12+ (支持 pgvector 扩展)
|
||
- 运行在 `localhost:5432`
|
||
|
||
---
|
||
|
||
#### Qdrant (向量数据库)
|
||
|
||
**依赖**:
|
||
```toml
|
||
qdrant-client = "1.7"
|
||
```
|
||
|
||
**用途**:
|
||
- ✅ **向量搜索**
|
||
- 语义搜索
|
||
- 人脸嵌入向量
|
||
- 相似度匹配
|
||
|
||
**配置**:
|
||
```bash
|
||
QDRANT_URL=http://127.0.0.1:6333
|
||
QDRANT_API_KEY=Test3200Test3200Test3200
|
||
QDRANT_COLLECTION=momentry_rule1
|
||
```
|
||
|
||
**必需服务**:
|
||
- Qdrant 1.7+
|
||
- 运行在 `http://127.0.0.1:6333`
|
||
|
||
---
|
||
|
||
#### MongoDB (文档数据库)
|
||
|
||
**依赖**:
|
||
```toml
|
||
mongodb = { version = "2", features = ["tokio-runtime"] }
|
||
bson = { version = "2", features = ["chrono-0_4"] }
|
||
```
|
||
|
||
**用途**:
|
||
- ✅ **文档存储**
|
||
- 大型分析结果
|
||
- 原始数据
|
||
- 缓存数据
|
||
|
||
**配置**:
|
||
```bash
|
||
MONGODB_URL=mongodb://localhost:27017
|
||
MONGODB_DATABASE=momentry
|
||
MONGODB_CACHE_ENABLED=true
|
||
```
|
||
|
||
**必需服务**:
|
||
- MongoDB 5+
|
||
- 运行在 `mongodb://localhost:27017`
|
||
|
||
---
|
||
|
||
## 📊 依赖关系图
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ Momentry Studio (Tauri) │
|
||
│ │
|
||
│ ┌──────────────────────────────────────────────────────┐ │
|
||
│ │ SQLite (rusqlite) │ │
|
||
│ │ ├─ 搜索历史 │ │
|
||
│ │ ├─ 书签 │ │
|
||
│ │ ├─ 视频标记 │ │
|
||
│ │ └─ 用户认证 │ │
|
||
│ │ └─ data/users/demo.sqlite │ │
|
||
│ └──────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ ┌──────────────────────────────────────────────────────┐ │
|
||
│ │ PostgreSQL (sqlx) [⚠️ 遗留依赖 - 未使用] │ │
|
||
│ └──────────────────────────────────────────────────────┘ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
│
|
||
│ 依赖
|
||
▼
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ MarkBase Core │
|
||
│ │
|
||
│ ┌──────────────────────────────────────────────────────┐ │
|
||
│ │ SQLite (rusqlite) │ │
|
||
│ │ ├─ 用户认证 │ │
|
||
│ │ └─ 文件凭证 │ │
|
||
│ │ └─ ~/markbase/data/auth.sqlite │ │
|
||
│ └──────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ ┌──────────────────────────────────────────────────────┐ │
|
||
│ │ PostgreSQL (tokio-postgres) [可选] │ │
|
||
│ │ └─ 文件共享、高级权限 (未启用) │ │
|
||
│ └──────────────────────────────────────────────────────┘ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ Momentry Core (API) │
|
||
│ │
|
||
│ ┌──────────────────────────────────────────────────────┐ │
|
||
│ │ PostgreSQL (sqlx) │ │
|
||
│ │ ├─ 文件信息 │ │
|
||
│ │ ├─ 人脸数据 │ │
|
||
│ │ ├─ 身份信息 │ │
|
||
│ │ ├─ Trace 数据 │ │
|
||
│ │ └─ 向量搜索 (pgvector) │ │
|
||
│ │ └─ postgres://localhost:5432/momentry │ │
|
||
│ └──────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ ┌──────────────────────────────────────────────────────┐ │
|
||
│ │ Qdrant (向量数据库) │ │
|
||
│ │ ├─ 语义搜索 │ │
|
||
│ │ └─ 人脸嵌入向量 │ │
|
||
│ │ └─ http://127.0.0.1:6333 │ │
|
||
│ └──────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ ┌──────────────────────────────────────────────────────┐ │
|
||
│ │ MongoDB (文档数据库) │ │
|
||
│ │ ├─ 分析结果 │ │
|
||
│ │ └─ 缓存数据 │ │
|
||
│ │ └─ mongodb://localhost:27017/momentry │ │
|
||
│ └──────────────────────────────────────────────────────┘ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## ✅ 实际使用的数据库
|
||
|
||
### Momentry Studio
|
||
|
||
| 数据库 | 状态 | 用途 | 文件位置 |
|
||
|-------|------|------|---------|
|
||
| **SQLite** | ✅ 使用中 | 本地数据 | `data/users/demo.sqlite` |
|
||
| PostgreSQL | ❌ 未使用 | 遗留依赖 | - |
|
||
|
||
---
|
||
|
||
### MarkBase Core
|
||
|
||
| 数据库 | 状态 | 用途 | 文件位置 |
|
||
|-------|------|------|---------|
|
||
| **SQLite** | ✅ 使用中 | 认证 | `~/markbase/data/auth.sqlite` |
|
||
| PostgreSQL | ⚠️ 可选 | 高级功能 | 未启用 |
|
||
|
||
---
|
||
|
||
### Momentry Core
|
||
|
||
| 数据库 | 状态 | 用途 | 连接 |
|
||
|-------|------|------|------|
|
||
| **PostgreSQL** | ✅ 使用中 | 核心数据 | `localhost:5432/momentry` |
|
||
| **Qdrant** | ✅ 使用中 | 向量搜索 | `localhost:6333` |
|
||
| **MongoDB** | ✅ 使用中 | 文档存储 | `localhost:27017/momentry` |
|
||
|
||
---
|
||
|
||
## 🔧 部署要求
|
||
|
||
### 必需服务
|
||
|
||
**Momentry Studio (前端)**:
|
||
- ✅ SQLite (已内置，无需额外服务)
|
||
|
||
**Momentry Core (后端)**:
|
||
- ✅ PostgreSQL 12+ (必需)
|
||
- 需要 `pgvector` 扩展
|
||
- ✅ Qdrant 1.7+ (必需)
|
||
- ✅ MongoDB 5+ (必需)
|
||
|
||
**MarkBase Core (文件管理)**:
|
||
- ✅ SQLite (已内置，无需额外服务)
|
||
- ⚠️ PostgreSQL (可选，未启用)
|
||
|
||
---
|
||
|
||
### 服务启动顺序
|
||
|
||
```bash
|
||
# 1. PostgreSQL
|
||
pg_ctl start -D /usr/local/var/postgres
|
||
|
||
# 2. MongoDB
|
||
mongod --config /usr/local/etc/mongod.conf
|
||
|
||
# 3. Qdrant
|
||
qdrant
|
||
|
||
# 4. Momentry Core API
|
||
cd ~/momentry_core
|
||
./start.sh
|
||
|
||
# 5. MarkBase API
|
||
cd ~/markbase/markbase-core
|
||
./start.sh
|
||
|
||
# 6. Momentry Studio
|
||
cd ~/momentry_studio
|
||
./start.sh
|
||
```
|
||
|
||
---
|
||
|
||
## 📋 检查清单
|
||
|
||
### 开发环境
|
||
|
||
- [x] PostgreSQL 运行中 (`localhost:5432`)
|
||
- [x] Qdrant 运行中 (`localhost:6333`)
|
||
- [x] MongoDB 运行中 (`localhost:27017`)
|
||
- [x] SQLite 数据库文件存在
|
||
- [x] `data/users/demo.sqlite`
|
||
- [x] `~/markbase/data/auth.sqlite`
|
||
|
||
---
|
||
|
||
### 生产环境
|
||
|
||
- [ ] PostgreSQL 配置
|
||
- [ ] 创建数据库 `momentry`
|
||
- [ ] 安装 `pgvector` 扩展
|
||
- [ ] 配置连接池
|
||
- [ ] 设置备份策略
|
||
|
||
- [ ] Qdrant 配置
|
||
- [ ] 创建集合 `momentry_rule1`
|
||
- [ ] 配置持久化存储
|
||
- [ ] 设置 API Key
|
||
|
||
- [ ] MongoDB 配置
|
||
- [ ] 创建数据库 `momentry`
|
||
- [ ] 配置副本集 (可选)
|
||
- [ ] 设置认证 (可选)
|
||
|
||
- [ ] SQLite 配置
|
||
- [ ] 创建数据目录
|
||
- [ ] 设置文件权限
|
||
- [ ] 配置 WAL 模式 (已默认启用)
|
||
|
||
---
|
||
|
||
## ⚠️ 注意事项
|
||
|
||
### 1. PostgreSQL 连接
|
||
|
||
**Momentry Studio** 不直接连接 PostgreSQL，但通过 `markbase-core` 间接依赖。
|
||
|
||
**建议**: 移除 Momentry Studio 的 `sqlx` 依赖，减少编译时间。
|
||
|
||
---
|
||
|
||
### 2. 数据库迁移
|
||
|
||
**SQLite**:
|
||
- 无需迁移，文件自动创建
|
||
- WAL 模式已启用，性能更好
|
||
|
||
**PostgreSQL**:
|
||
- 需要运行迁移脚本
|
||
- 需要 `pgvector` 扩展
|
||
|
||
**Qdrant**:
|
||
- 首次启动自动创建集合
|
||
- 需要配置向量维度
|
||
|
||
---
|
||
|
||
### 3. 备份策略
|
||
|
||
**SQLite**:
|
||
```bash
|
||
# 备份
|
||
cp data/users/demo.sqlite data/users/demo.sqlite.backup
|
||
|
||
# 或使用 SQLite 命令
|
||
sqlite3 data/users/demo.sqlite ".backup 'demo.sqlite.backup'"
|
||
```
|
||
|
||
**PostgreSQL**:
|
||
```bash
|
||
# 备份
|
||
pg_dump -U accusys momentry > momentry_backup.sql
|
||
|
||
# 恢复
|
||
psql -U accusys momentry < momentry_backup.sql
|
||
```
|
||
|
||
---
|
||
|
||
## 🎯 总结
|
||
|
||
### 实际使用的数据库
|
||
|
||
1. **Momentry Studio**: SQLite (本地数据)
|
||
2. **MarkBase Core**: SQLite (认证)
|
||
3. **Momentry Core**: PostgreSQL + Qdrant + MongoDB
|
||
|
||
### 遗留依赖
|
||
|
||
- Momentry Studio 的 `sqlx` (PostgreSQL) - 建议移除
|
||
|
||
### 部署复杂度
|
||
|
||
- **前端**: 低 - 只需 SQLite (内置)
|
||
- **后端**: 高 - 需要 PostgreSQL + Qdrant + MongoDB
|
||
|
||
---
|
||
|
||
**文档位置**: `docs/DATABASE_DEPENDENCIES.md`
|
||
**状态**: ✅ 已确认所有数据库依赖 |