# zhao_shipin_backend

**Repository Path**: godprogrammer/zhao_shipin_back

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-23
- **Last Updated**: 2026-05-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Video Converter — Backend

FastAPI 后端服务，提供视频转码、存储、用户管理等 API。

> 完整文档请查看项目根目录 [README.md](../README.md)。

## 快速命令

```bash
# 安装依赖
python -m venv venv
venv\Scripts\activate      # Windows
pip install -r requirements.txt

# 启动服务
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000

# 启动 Celery Worker（可选）
celery -A app.celery_worker.celery_app worker --loglevel=info
```

## 项目结构

```
backend/
├── app/
│   ├── api/
│   │   ├── deps.py              # 依赖注入
│   │   └── v1/
│   │       ├── api.py            # 路由汇总
│   │       └── endpoints/
│   │           ├── auth.py       # 认证
│   │           ├── videos.py     # 视频
│   │           ├── upload.py     # 上传
│   │           ├── tasks.py      # 转码任务
│   │           ├── storage.py    # 存储
│   │           ├── config.py     # 系统配置
│   │           └── users.py      # 用户管理
│   ├── celery_worker/            # Celery 任务
│   ├── core/                     # 配置 / 安全 / 日志
│   ├── db/                       # 数据库
│   ├── models/                   # ORM 模型
│   ├── schemas/                  # Pydantic 模型
│   ├── services/                 # 业务服务
│   └── main.py                   # 入口
├── Dockerfile
├── docker-compose.yml
├── requirements.txt
└── .env.example
```

## API 端点

| 前缀 | 说明 | 权限 |
|------|------|------|
| `/api/v1/auth` | 认证 | 公开 / 登录用户 |
| `/api/v1/users` | 用户管理 | 超级管理员 |
| `/api/v1/videos` | 视频 CRUD | 登录用户 |
| `/api/v1/upload` | 上传 | 登录用户 |
| `/api/v1/tasks` | 转码任务 | 登录用户 |
| `/api/v1/storage` | 文件夹 | 登录用户 |
| `/api/v1/config` | 系统配置 | 超级管理员 |

> 详细 API 文档：启动后端后访问 http://localhost:8000/api/docs