# easy-edit

**Repository Path**: no-oars/easy-edit

## Basic Information

- **Project Name**: easy-edit
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-01
- **Last Updated**: 2025-11-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 视频剪辑平台

基于Flask的云视频剪辑平台，提供视频上传、处理、剪辑和导出功能。

## 功能特性

- 🎥 视频上传和管理
- ✂️ 基础视频剪辑功能（API优先）
- 📁 项目管理和保存
- 📤 视频导出和分享
- 🔗 HTTP API集成（供Java服务调用）
- 👥 用户账户和权限管理

## 技术栈

- **后端**: Flask 3.x + SQLAlchemy 2.x + Celery + Redis + PostgreSQL
- **前端**: React 18+ + TypeScript + Ant Design 5.x
- **视频处理**: FFmpeg 4.4+
- **容器化**: Docker + Docker Compose
- **数据库**: PostgreSQL + Redis

## 快速开始

### 环境要求

- Python 3.11+
- Node.js 16+
- PostgreSQL 14+
- Redis 6+
- FFmpeg 4.4+
- Docker 20.10+ (可选)

### 安装步骤

1. **克隆项目**
```bash
git clone <repository-url>
cd video-editing-platform
```

2. **后端设置**
```bash
cd backend
python -m venv venv
source venv/bin/activate  # Linux/macOS
# 或 venv\Scripts\activate  # Windows

pip install -r requirements/dev.txt
```

3. **前端设置**
```bash
cd frontend
npm install
```

4. **配置环境变量**
```bash
cp .env.example .env
# 编辑 .env 文件，配置数据库等信息
```

5. **数据库设置**
```bash
# 创建数据库
createdb video_platform

# 运行迁移
cd backend
python manage.py db upgrade
```

### 运行应用

#### 使用Docker Compose (推荐)
```bash
docker-compose up -d
```

#### 本地开发
```bash
# 启动后端
cd backend
python -m flask run --host=0.0.0.0 --port=5000

# 启动Celery Worker
celery -A app.celery worker --loglevel=info

# 启动前端
cd frontend
npm run dev
```

### 访问地址

- **后端API**: http://localhost:5000
- **API文档**: http://localhost:5000/docs
- **前端界面**: http://localhost:3000
- **Flower监控**: http://localhost:5555

## 项目结构

```
video-editing-platform/
├── backend/                    # Flask后端服务
│   ├── app/
│   │   ├── config/            # 配置模块
│   │   ├── core/              # 核心业务逻辑
│   │   │   ├── models/        # 数据模型
│   │   │   ├── services/      # 业务服务
│   │   │   ├── api/           # API路由
│   │   │   └── utils/         # 工具类
│   │   └── tasks/             # Celery任务
│   └── tests/                 # 测试代码
├── frontend/                   # React前端
│   ├── src/
│   │   ├── components/        # React组件
│   │   ├── pages/             # 页面组件
│   │   ├── services/          # API服务
│   │   └── utils/             # 工具函数
├── docs/                      # 项目文档
├── scripts/                   # 部署脚本
└── docker-compose.yml         # 服务编排
```

## API文档

详细的API文档请参考：
- [OpenAPI规范](specs/002-/contracts/openapi.yaml)
- [Postman集合](specs/002-/contracts/postman.json)

## 开发指南

### 代码规范

- Python: 遵循PEP 8规范，使用black格式化
- TypeScript: 遵循ESLint规则，使用Prettier格式化
- 提交信息: 遵循Conventional Commits规范

### 测试

```bash
# 后端测试
cd backend
pytest

# 前端测试
cd frontend
npm test
```

### 部署

详见 [部署指南](docs/deployment.md)

## 贡献

欢迎提交Issue和Pull Request！

## 许可证

MIT License