docs: 更新架构文档,文件存储切换为七牛云对象存储
- _index.md: 技术栈加入七牛云对象存储 - api.md: 新增素材下载接口,asset URL 改为 CDN URL - backend.md: 分层结构新增 storage.go,FormatAdapter 职责增加上传 - database.md: 文件存储改为七牛云,配置表新增 GEN2D_QINIU_* 环境变量
This commit is contained in:
+20
-27
@@ -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` 中扩展字段即可,无需额外依赖。
|
||||
|
||||
|
||||
Reference in New Issue
Block a user