Merge branch 'develop' of gitee.com:hezhaohui123/gen2d into feat/async-generate-pipeline

Signed-off-by: 何朝晖 <hezhaohui0807@163.com>

docs/database.md

@@ -5,7 +5,7 @@
 | 用途 | 方案 | 说明 |
 |------|------|------|
 | 持久化存储 | SQLite 3 | 工程、任务、素材元数据、风格配置全部落库，单文件部署 |
-| 文件存储 | 本地文件系统 | 生成的图片与 spritesheet 文件保存到本地目录，通过 Gin 静态文件服务访问 |
+| 文件存储 | 七牛云对象存储 | 生成的图片与 spritesheet 文件上传到七牛云 Bucket，通过 CDN URL 访问 |
 | 认证 | JWT + Cookie | 简单注册登录，httpOnly Cookie 鉴权 |
 | 缓存 / 去重 | 应用层内存 | 请求去重通过应用层 `sync.Map` 实现短期去重窗口，无需外部依赖 |
 
@@ -133,44 +133,33 @@ task    1 ── N asset
 
 ## 文件存储
 
-生成的素材文件保存到本地文件系统，通过 Gin 静态文件服务访问。
+生成的素材文件上传到七牛云对象存储，通过 CDN URL 访问。
 
-### 目录结构
+### 存储结构
+
+对象 Key 命名规则（与原有本地路径保持一致）：
 
 ```
-{dataDir}/
-└── users/
-    └── {userId}/
-        └── projects/
-            └── {projectId}/
-                └── tasks/
-                    └── {taskId}/
-                        ├── raw/        # AssetGenerator 输出的原始图片
-                        │   ├── 0.png
-                        │   ├── 1.png
-                        │   └── ...
-                        ├── output/     # FormatAdapter 输出的最终素材
-                        │   ├── spritesheet.png
-                        │   └── metadata.json
-                        └── pipeline.log  # 管线执行日志
+users/{userId}/projects/{projectId}/tasks/{taskId}/output/{filename}
 ```
 
-`dataDir` 通过环境变量 `GEN2D_DATA_DIR` 配置，默认 `./data`。
+示例：
+```
+users/user_a1B2c3/projects/proj_abc/tasks/task_xyz/output/spritesheet.png
+```
 
 ### 访问方式
 
-Gin 静态文件服务，路由 `/files/*` 映射到 `{dataDir}/` 目录：
+素材上传后返回 CDN URL，前端直接通过该 URL 访问图片。
 
-```go
-router.Static("/files", dataDir)
-```
+下载接口 `GET /api/v1/assets/download?key=...` 返回 302 重定向到 CDN URL。
 
 ### asset 表的 url 字段
 
-存储相对路径，前端通过 `/files/{url}` 拼接访问：
+存储七牛云 CDN 完整 URL，如：
+`https://cdn.example.com/users/user_a1B2c3/projects/proj_abc/tasks/task_xyz/output/spritesheet.png`
 
-- 如 `users/user_a1B2c3/projects/proj_abc/tasks/task_xyz/output/spritesheet.png`
-- 前端拼接为 `/files/users/user_a1B2c3/projects/proj_abc/tasks/task_xyz/output/spritesheet.png`
+前端直接使用该 URL 加载图片，无需拼接路径。
 
 ---
 
@@ -194,9 +183,13 @@ router.Static("/files", dataDir)
 |----------|--------|------|
 | `GEN2D_SERVER_PORT` | `8080` | HTTP 服务监听端口 |
 | `GEN2D_DB_PATH` | `./data/gen2d.db` | SQLite 数据库文件路径 |
-| `GEN2D_DATA_DIR` | `./data` | 本地文件存储根目录 |
 | `GEN2D_JWT_SECRET` | — | JWT 签名密钥（必填） |
 | `GEN2D_JWT_EXPIRE` | `7200` | Token 过期时间（秒） |
+| `GEN2D_QINIU_ACCESS_KEY` | — | 七牛云 AccessKey |
+| `GEN2D_QINIU_SECRET_KEY` | — | 七牛云 SecretKey |
+| `GEN2D_QINIU_BUCKET` | — | 七牛云 Bucket 名称 |
+| `GEN2D_QINIU_CDN_HOST` | — | CDN 域名（如 `https://cdn.example.com`） |
+| `GEN2D_QINIU_USE_HTTPS` | `true` | 是否使用 HTTPS |
 
 在 `config.go` 中扩展字段即可，无需额外依赖。