# nest-video

**Repository Path**: liuyong-byte/nest-video

## Basic Information

- **Project Name**: nest-video
- **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-04-27
- **Last Updated**: 2026-04-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI漫剧智能体商业化平台（起步版）

本仓库提供一个可持续迭代的商业化工程骨架：

- 前端：Vite + Vue3（用户首页、创作中心、后台管理）
- 后端：NestJS（认证、RBAC、设置中心、模型路由、资产、创作任务、监控、定时任务）
- 数据：MySQL + Redis
- 运维：Docker Compose、本地 dev/prod 环境变量模板

当前已实现的“落库模块”：

- 设置中心（`sys_config`）
- 模型供应商与路由（`ai_provider` / `ai_route`）
- 创作项目与渲染任务（`story_project` / `render_task`）

## 目录结构

```text
backend/                 NestJS API
frontend/                Vite + Vue3 页面
database/schema.sql      MySQL 建表脚本
database/seed.sql        初始化数据
docs/ai-comic-platform-blueprint.md   商业化全功能蓝图
docker-compose.yml       本地一键启动
```

## 快速开始（本地）

1. 启动 MySQL + Redis：

```bash
docker compose up -d mysql redis
```

2. 初始化数据库：

```bash
mysql -h 127.0.0.1 -uroot -proot < database/schema.sql
mysql -h 127.0.0.1 -uroot -proot < database/seed.sql
```

3. 启动后端：

```bash
cd backend
cp .env.example .env
npm install
npm run start:dev
```

4. 启动前端：

```bash
cd frontend
cp .env.example .env
npm install
npm run dev
```

## 关键接口（当前骨架）

- `GET /api/v1/health`
- `POST /api/v1/auth/login`
- `POST /api/v1/auth/refresh`
- `POST /api/v1/auth/me`
- `GET /api/v1/rbac/roles|menus|permissions`
- `GET|POST /api/v1/system-config`
- `GET|POST /api/v1/ai-provider/providers`
- `GET|POST /api/v1/ai-provider/routes`
- `POST /api/v1/ai-provider/test-connection`
- `GET|POST /api/v1/asset/files`
- `GET|POST /api/v1/asset/characters`
- `GET|POST /api/v1/studio/projects`
- `POST /api/v1/studio/generate`
- `GET /api/v1/studio/tasks`
- `GET /api/v1/monitor/overview`
- `GET /api/v1/scheduler/runs`
- `GET|POST|PUT /api/v1/admin/users`
- `POST /api/v1/admin/users/:id/reset-password`
- `GET|POST /api/v1/admin/roles`
- `GET|PUT /api/v1/admin/roles/:id/permissions`
- `GET|POST /api/v1/admin/permissions`
- `GET|POST /api/v1/admin/menus`
- `GET /api/v1/admin/options`

登录测试账号（seed）：

- 用户名：`root`
- 密码：`123456`

除 `health`、`auth/login`、`auth/refresh` 外，其余接口默认需要 Bearer Token。

当前鉴权模型：

- 第1层：`JWT` 认证（全局 Guard）
- 第2层：`@Roles(...)` 角色控制
- 第3层：`@Permissions(...)` 权限点控制（从 `sys_permission + sys_role_permission + sys_user_role` 动态加载）

前端双系统页面：

- 应用端：`/`、`/studio`
- 管理端（若依风格单壳体）：`/admin/dashboard`、`/admin/users`、`/admin/roles`、`/admin/permissions`、`/admin/menus`、`/admin/settings`

## 下一步建议

1. 运行 `database/seed.sql` 重新加载权限点、后台菜单与角色授权  
2. 接入 BullMQ Worker，把 `render_task` 从“入队记录”升级为“真实执行”  
3. 资产模块落地本地/MinIO 文件上传与预览  
4. 补充审计日志（登录日志、操作日志）后台查询页  
5. 增加计费、配额与订阅套餐