# sora-video

**Repository Path**: ihtry/sora-video

## Basic Information

- **Project Name**: sora-video
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-14
- **Last Updated**: 2025-11-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

该项目似乎没有专门的 README.md 文件提供项目概述和指导信息。不过，项目结构显示这是一个基于 PHP 的 Web 应用程序，使用 ThinkPHP 框架开发，包含管理后台和 API 接口，主要功能围绕视频生成、用户系统、分销、支付、模板市场等展开。

以下是基于项目结构和文件的简要分析：

---

## 🧾 项目概述

这是一个功能丰富的 Web 应用程序，主要面向视频生成与用户管理，支持分销、支付、模板市场等功能。项目采用模块化设计，包含管理后台和 API 接口，适合构建 SaaS 类型的视频生成平台。

---

## 📁 项目结构

### 核心目录
- **app/**: 主要代码目录
  - **admin/controller/**: 管理后台控制器
  - **api/controller/**: API 接口控制器
  - **common/model/**: 数据模型
  - **common/validate/**: 表单验证
  - **common/service/**: 业务逻辑服务
- **public/**: 静态资源目录
  - **assets/**: CSS、JS、字体等资源
  - **uploads/**: 用户上传文件目录
- **config/**: 配置文件
- **database/**: 数据库迁移文件
- **route/**: 路由配置
- **vendor/**: Composer 依赖包

---

## 🧩 核心功能模块

### 1. 视频生成
- 支持通过 Sora API 生成视频
- 提供视频优化、任务状态查询、视频编辑等功能
- 支持模板生成视频、批量生成等高级功能

### 2. 用户系统
- 用户注册、登录、资料管理
- 支持微信、QQ、支付宝、手机号等多种登录方式
- 用户等级（VIP）、邀请码、团队管理、佣金系统

### 3. 分销系统
- 分销关系管理
- 佣金记录、提现申请与审核

### 4. 支付系统
- 支持微信、支付宝等多种支付方式
- 支付回调处理、订单状态查询、退款处理

### 5. 模板市场
- 模板分类、热门模板、模板详情
- 用户可保存模板、点赞/取消点赞、删除模板

### 6. 管理后台
- 提供完整的后台管理界面，涵盖用户、订单、视频、模板、分销、支付等模块
- 支持权限管理、角色配置、日志记录

### 7. 配置与设置
- 系统配置、OAuth 配置、短信/邮件配置
- 支持微信小程序、DeepSeek AI、Sora 视频生成等第三方服务配置

---

## 🛠 技术栈

- **PHP**: ThinkPHP 框架
- **数据库**: MySQL
- **缓存**: Redis
- **前端**: Vue.js + Element UI
- **队列**: 使用 Redis 队列处理异步任务（如视频生成、Webhook 推送）
- **第三方服务**:
  - 微信支付、支付宝支付
  - Sora 视频生成 API
  - DeepSeek AI 优化提示词

---

## 📦 安装与部署

### 环境要求
- PHP 7.4+
- MySQL 5.6+
- Redis
- Composer
- Node.js（前端构建）

### 安装步骤
1. 克隆项目
2. 安装依赖（`composer install`）
3. 配置 `.env` 文件（数据库、Redis、JWT 等）
4. 导入数据库（`install.sql`）
5. 设置权限（确保 `runtime` 和 `public/uploads` 可写）
6. 启动服务（Nginx + PHP-FPM）
7. 启动队列 Worker（用于处理异步任务）

---

## 📝 API 文档

项目包含完整的 API 文档（`API_DOCS.md`），涵盖以下模块：
- 认证授权
- 用户管理
- 视频生成
- 模板市场
- 支付接口
- 分销系统
- 文件上传
- 管理后台接口

---

## 📌 开发指南

### 最佳实践
- 使用 `Service` 层处理业务逻辑
- 异常处理统一使用 `ExceptionHandle`
- 使用缓存优化性能（`CacheService`）
- 使用队列处理耗时任务（如视频生成、Webhook 推送）
- 数据验证使用 `Validate` 类

### 前端开发
- 使用 Vue.js + Element UI
- Markdown 编辑器使用 `EasyMDE`
- API 文档页面使用 Vue Router 和 Element UI 组件

---

## 🧪 测试与调试

- 使用 `app/admin/view/CARD_OPTIMIZATION_GUIDE.md` 进行前端卡片适配优化
- 使用 `app/admin/view/main.html` 等模板文件进行后台界面调试
- 使用 `app/api/controller/Video.php` 测试视频生成接口

---

## 📦 部署建议

- 使用 Supervisor 管理队列 Worker
- 使用 Nginx 配置静态资源缓存
- 使用 SSL 加密（推荐）
- 定期备份数据库和文件（`app/command/Cron.php` 提供定时任务）

---

## 📚 附录

- **完整指南**: `COMPLETE_GUIDE.md` 提供详细的安装、配置、开发、部署说明
- **许可证**: `LICENSE.txt`（未提供具体内容）
- **API 文档**: `API_DOCS.md` 提供完整的接口文档

---

如需进一步开发或部署，请参考 `COMPLETE_GUIDE.md` 获取详细说明。