# Momentry Studio v0.1.0

**视频分析和搜索平台** | Video Analysis and Search Platform

[![Version](https://img.shields.io/badge/version-0.1.0-blue.svg)](https://github.com/yourrepo/momentry_studio)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
[![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Linux-lightgrey.svg)](#)

---

## 🎯 简介

Momentry Studio 是一个强大的视频分析和搜索平台，提供：

- ✅ **视频搜索** - 关键词搜索 + LLM 智能搜索
- ✅ **人脸识别** - 自动人脸检测、聚类和身份管理
- ✅ **文件管理** - 上传、下载、共享文件
- ✅ **用户认证** - 安全的用户管理和权限控制
- ✅ **三层架构** - Admin/Group/User 数据隔离

---

## 🚀 快速开始

### 一键安装

```bash
# 克隆代码
git clone <repo_url> momentry_studio && cd momentry_studio

# 运行安装脚本
./scripts/install.sh

# 启动应用
./start.sh
```

**详细步骤**: [INSTALLATION_GUIDE.md](INSTALLATION_GUIDE.md)

---

## 📋 系统要求

### 必需软件

- **Node.js** v18+
- **Rust** 1.77.2+
- **PostgreSQL** 12+ (带 pgvector 扩展)
- **Qdrant** 1.7+
- **MongoDB** 5+

### 系统资源

- CPU: 4 核心
- 内存: 8GB
- 存储: 100GB

---

## 📚 文档

### 核心文档

| 文档 | 用途 |
|-----|------|
| [INSTALLATION_GUIDE.md](INSTALLATION_GUIDE.md) | 详细安装指南 |
| [QUICK_REFERENCE.md](QUICK_REFERENCE.md) | 快速参考卡片 |
| [DEPLOYMENT_CHECKLIST.md](DEPLOYMENT_CHECKLIST.md) | 部署检查清单 |

### 架构文档

| 文档 | 用途 |
|-----|------|
| [DATABASE_SUMMARY.md](DATABASE_SUMMARY.md) | 数据库架构概览 |
| [docs/MARKBASE_THREE_LAYER_ARCHITECTURE.md](docs/MARKBASE_THREE_LAYER_ARCHITECTURE.md) | 三层架构设计 |
| [docs/CLIENTVIEW_STORAGE_ARCHITECTURE.md](docs/CLIENTVIEW_STORAGE_ARCHITECTURE.md) | 文件存储架构 |

### 系统文档

| 文档 | 用途 |
|-----|------|
| [docs/DEFAULT_PASSWORD_SYSTEM.md](docs/DEFAULT_PASSWORD_SYSTEM.md) | 密码系统说明 |
| [docs/DATABASE_DEPENDENCIES.md](docs/DATABASE_DEPENDENCIES.md) | 数据库依赖关系 |

---

## 🔧 功能特性

### 1. 视频搜索

- **关键词搜索** - 基于字幕和语音转文字
- **LLM 搜索** - 自然语言查询
- **多维度过滤** - 时间、人物、场景

### 2. 人脸识别

- **自动检测** - 视频中的人脸
- **智能聚类** - 相同人脸分组
- **身份管理** - 命名和管理人脸

### 3. 文件管理

- **上传下载** - 支持 SMB/SFTP
- **文件夹管理** - 创建、移动、删除
- **文件共享** - 群组内共享

### 4. 用户认证

- **安全登录** - Argon2id 密码哈希
- **权限控制** - 多层级权限
- **审计日志** - 操作记录

---

## 🏗️ 架构设计

### 三层架构

```
Admin Layer (系统管理)
  └─ admin.sqlite
      ├─ 系统配置
      ├─ 用户管理
      ├─ 群组管理
      └─ 权限管理

Group Layer (群组管理)
  └─ group_{id}.sqlite
      ├─ 群组配置
      ├─ 群组成员
      ├─ 群组文件
      └─ 群组权限

User Layer (用户数据)
  └─ {username}.sqlite
      ├─ 用户文件
      ├─ 搜索历史
      ├─ 书签
      └─ 个人设置
```

**详细设计**: [docs/MARKBASE_THREE_LAYER_ARCHITECTURE.md](docs/MARKBASE_THREE_LAYER_ARCHITECTURE.md)

---

## 📂 目录结构

```
momentry_studio/
├── src/                    # 前端源代码 (Vue 3 + TypeScript)
├── src-tauri/              # 后端源代码 (Rust + Tauri)
├── public/                 # 静态资源
├── config/                 # 配置模板
├── scripts/                # 工具脚本
├── docs/                   # 文档
├── data/                   # 数据目录
│   ├── admin/              # Admin 数据库
│   ├── groups/             # Group 数据库
│   └── users/              # User 数据库
└── release/                # 发布包
```

---

## 🛠️ 开发指南

### 环境设置

```bash
# 安装依赖
npm install

# 开发模式
npm run dev

# 构建
npm run build

# Tauri 应用
cargo tauri dev
```

### 数据库管理

```bash
# 初始化数据库
./scripts/init_three_layer_db.sh

# 检查数据库
./scripts/check_three_layer.sh

# 用户管理
./src-tauri/target/release/user_tool list
```

---

## 📊 数据库架构

### Momentry Studio

- **SQLite** - 本地数据 (搜索历史、书签、用户认证)

### Momentry Core

- **PostgreSQL** - 核心业务数据 (文件、人脸、身份)
- **Qdrant** - 向量搜索 (语义搜索、人脸嵌入)
- **MongoDB** - 文档存储 (分析结果、大对象)

**详细说明**: [docs/DATABASE_DEPENDENCIES.md](docs/DATABASE_DEPENDENCIES.md)

---

## 🚢 部署

### 生产部署

```bash
# 1. 准备环境
./scripts/install.sh

# 2. 配置
vim .env

# 3. 构建
cargo tauri build

# 4. 部署
./start.sh
```

### 检查清单

- [ ] 所有服务运行中
- [ ] 数据库已初始化
- [ ] 默认密码已修改
- [ ] 权限已配置
- [ ] 备份已设置

**详细清单**: [DEPLOYMENT_CHECKLIST.md](DEPLOYMENT_CHECKLIST.md)

---

## 🔑 默认账号

### 管理员

- 用户名: `admin`
- 密码: `admin123`
- 角色: 系统管理员

### 普通用户

- 用户名: `demo`
- 密码: 查看安装输出或 `.env` 文件
- 角色: 普通用户

**安全建议**: 立即修改默认密码！

---

## 📖 API 文档

### Momentry Core API

- **地址**: `http://localhost:3002`
- **文档**: `docs/ADMIN_API_REFERENCE.md`

### MarkBase API

- **地址**: `http://localhost:11438`
- **文档**: `docs/MARKBASE_SERVICE_MANAGEMENT.md`

### Studio 代理

- **地址**: `http://localhost:8888`
- **路由**:
  - `/api/v1/*` → Momentry Core API
  - `/api/v2/*` → MarkBase API

---

## 🧪 测试

### 功能测试

```bash
# 启动应用
./start.sh

# 测试搜索
curl http://localhost:8888/api/v1/search-history

# 测试文件管理
curl http://localhost:11438/api/v2/myfiles/demo/files
```

### 系统检查

```bash
# 数据库检查
./scripts/check_db_dependencies.sh

# 架构检查
./scripts/check_three_layer.sh
```

---

## 🔄 版本历史

### v0.1.0 (2026-10-12)

**新功能**:
- ✅ 视频搜索和分析
- ✅ 人脸识别和管理
- ✅ 文件管理
- ✅ 用户认证
- ✅ 三层架构设计

**改进**:
- ✅ 动态路径系统
- ✅ 动态密码系统
- ✅ 用户管理工具

**已知问题**:
- ⚠️ 用户数据库隔离需要修复
- ⚠️ sqlx 遗留依赖需要移除

---

### v0.2.0 (计划中)

- [ ] 实现三层架构代码
- [ ] 修复用户数据库隔离
- [ ] Admin 管理界面
- [ ] Group 管理界面
- [ ] 完善权限系统

---

## 🤝 贡献

### 开发流程

1. Fork 仓库
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启 Pull Request

### 代码规范

- **前端**: ESLint + Prettier
- **后端**: rustfmt + clippy
- **提交**: 遵循 Conventional Commits

---

## 📞 支持

### 获取帮助

- **文档**: `docs/` 目录
- **Issues**: [GitHub Issues](https://github.com/yourrepo/momentry_studio/issues)
- **Email**: support@momentry.ai

### 报告问题

请提供以下信息:

1. 系统版本
2. 错误信息
3. 复现步骤
4. 日志文件

---

## 📄 许可证

本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件

---

## 🙏 致谢

- [Vue.js](https://vuejs.org/)
- [Tauri](https://tauri.app/)
- [Rust](https://www.rust-lang.org/)
- [PostgreSQL](https://www.postgresql.org/)
- [Qdrant](https://qdrant.tech/)
- [MongoDB](https://www.mongodb.com/)

---

**版本**: v0.1.0  
**状态**: ✅ 生产就绪  
**更新**: 2026-10-12

---

Made with ❤️ by Momentry Team