vault backup: 2026-06-03 10:22:41

2026-06-03 10:22:41 +08:00
parent 6f8363fd3c
commit 2e207dc8fb
16 changed files with 0 additions and 0 deletions
@@ -0,0 +1,62 @@
+# Gen2D 架构讲解 — 答辩文档索引
+
+> AI 驱动的 2D 游戏素材生成工具
+
+## 文档导航
+
+| # | 文件 | 主题 | 核心要点 |
+|---|------|------|----------|
+| 1 | [01-system-overview](01-system-overview.md) | 系统总览 | Gin → Handler → Service → 基础设施 → 外部依赖 |
+| 2 | [02-worker-pool](02-worker-pool.md) | 协程池 | 有界并发、per-user 限流、背压、优雅关闭 |
+| 3 | [03-task-queue](03-task-queue.md) | 任务队列 | 可插拔接口 + Memory / RabbitMQ 双实现 |
+| 4 | [04-rabbitmq](04-rabbitmq.md) | RabbitMQ 集成 | AMQP 连接、持久化消息、重试/死信流程 |
+| 5 | [05-generation-pipeline](05-generation-pipeline.md) | 生成管线 | Eino 4 阶段图 + 质量回退 + 降级路径 |
+| 6 | [06-sprite-processing](06-sprite-processing.md) | 精灵图处理 | 背景移除 → 投影切割 → 后处理 → GIF 预览 |
+| 7 | [07-observability](07-observability.md) | 可观测性 | 35 Prometheus 指标 + 3 Grafana 仪表盘 + 10 告警 |
+| 8 | [08-sse-push](08-sse-push.md) | SSE 实时推送 | EventBus → SSEHandler → 浏览器 EventSource |
+| 9 | [09-rate-limiting](09-rate-limiting.md) | 限流 | Redis Lua 令牌桶 + 双层限流 + Fail-Open |
+| 10 | [10-middleware-chain](10-middleware-chain.md) | 中间件链 | Logger → Recovery → Metrics → Auth → RateLimit |
+| 11 | [11-consumer-producer](11-consumer-producer.md) | Consumer-Producer 桥接 | TaskQueue → Consumer → WorkerPool 解耦 |
+| 12 | [12-three-tier-fallback](12-three-tier-fallback.md) | 三级降级策略 | Queue → Pool → Legacy 降级链 |
+| 13 | [13-prompt-engineering](13-prompt-engineering.md) | 标签驱动提示词 | 40+ 标签映射 + 风格一致性 |
+| 14 | [14-deployment](14-deployment.md) | 部署架构 | Docker Compose + Prometheus + Grafana |
+| 15 | [15-config-cascade](15-config-cascade.md) | 配置级联 | Viper 三层配置：YAML → ENV → Default |
+
+## 架构总览图
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                        浏览器 (React)                           │
+│  EventSource ← SSE ← EventBus ← Pipeline Progress              │
+└────────────────────────────┬────────────────────────────────────┘
+                             │ HTTP
+┌────────────────────────────▼────────────────────────────────────┐
+│                     Gin HTTP Server                              │
+│  Logger → Recovery → Metrics → Auth → RateLimit → Handler       │
+└────────────────────────────┬────────────────────────────────────┘
+                             │
+┌────────────────────────────▼────────────────────────────────────┐
+│                      Handler 层                                  │
+│  GenerateHandler / SSEHandler / PromptHandler                    │
+└──────┬─────────────────────┬─────────────────────┬──────────────┘
+       │                     │                     │
+┌──────▼──────┐    ┌─────────▼─────────┐    ┌─────▼──────┐
+│ TaskQueue   │    │   WorkerPool      │    │  EventBus  │
+│ Memory/RMQ  │───→│  NumCPU*4 并发    │    │  Pub/Sub   │
+└─────────────┘    │  Per-user 限流    │    └────────────┘
+                   └─────────┬─────────┘
+                             │
+                   ┌─────────▼─────────┐
+                   │  Eino Pipeline    │
+                   │  4 阶段生成管线    │
+                   └─────────┬─────────┘
+                             │
+              ┌──────────────┼──────────────┐
+              ▼              ▼              ▼
+        Image API      Quality Check    SplitSprite
+        (DALL-E 3)     (GPT-4o)        + GIF Maker
+```
+
+## 配套图表
+
+每份文档开头使用 Mermaid 流程图，可直接在 Markdown 渲染器中查看。