diff --git a/.kiro/specs/template-system-optimization/design.md b/.kiro/specs/template-system-optimization/design.md index e69de29..2b71d56 100644 --- a/.kiro/specs/template-system-optimization/design.md +++ b/.kiro/specs/template-system-optimization/design.md @@ -0,0 +1,909 @@ +# 自定义上传模板系统优化 - 技术设计文档 + +## 概述 + +本文档描述了FLNXI素材库自定义上传模板系统的优化设计方案。该系统是整个平台的核心基础设施,负责定义素材的上传表单结构、元数据字段、分类筛选和共享展示。 + +### 设计目标 + +1. **稳定性**: 确保模板系统在各种场景下都能可靠运行,不会因为数据异常导致系统崩溃 +2. **性能**: 优化模板加载、字段同步、分类筛选等关键操作的性能 +3. **可维护性**: 提供清晰的代码结构和完善的错误处理,便于后续维护和扩展 +4. **向后兼容**: 确保优化不会破坏现有功能,支持旧数据的平滑迁移 + +## 架构设计 + +### 系统架构图 + +``` +┌─────────────────────────────────────────────────────────────┐ +│ 前端层 │ +├─────────────────────────────────────────────────────────────┤ +│ UploadModal │ TemplateManager │ CategoriesTab │ 首页 │ +│ (上传表单) │ (模板管理) │ (分类管理) │ (筛选) │ +└────────┬──────────────┬──────────────┬──────────────┬───────┘ + │ │ │ │ + ▼ ▼ ▼ ▼ +┌─────────────────────────────────────────────────────────────┐ +│ API层 │ +├─────────────────────────────────────────────────────────────┤ +│ /api/materials/upload │ +│ /api/upload-templates │ +│ /api/admin/upload-templates │ +│ /api/template-categories │ +│ /api/category-fields │ +└────────┬──────────────┬──────────────┬──────────────────────┘ + │ │ │ + ▼ ▼ ▼ +┌─────────────────────────────────────────────────────────────┐ +│ 业务逻辑层 │ +├─────────────────────────────────────────────────────────────┤ +│ template-validator.ts │ field-pool.ts │ upload-template-│ +│ (模板验证) │ (字段池管理) │ presets.ts │ +│ │ │ (内置模板) │ +└────────┬────────────────┬─────────────────┬─────────────────┘ + │ │ │ + ▼ ▼ ▼ +┌─────────────────────────────────────────────────────────────┐ +│ 数据访问层 │ +├─────────────────────────────────────────────────────────────┤ +│ Prisma ORM │ +│ - UploadTemplate │ +│ - UploadField │ +│ - FieldDefinition │ +│ - FieldOption │ +│ - Material │ +└────────┬────────────────────────────────────────────────────┘ + │ + ▼ +┌─────────────────────────────────────────────────────────────┐ +│ 数据库层 │ +├─────────────────────────────────────────────────────────────┤ +│ PostgreSQL │ +└─────────────────────────────────────────────────────────────┘ +``` + +### 核心组件 + +#### 1. 模板验证器 (template-validator.ts) + +**职责**: 统一处理内置模板和自定义模板的验证逻辑 + +**核心函数**: +```typescript +// 验证模板ID是否有效 +validateTemplateId(templateId: string | null): Promise + +// 检查是否为内置模板 +isBuiltinTemplate(templateId: string): boolean + +// 提取内置模板key +extractBuiltinTemplateKey(templateId: string): BuiltinTemplateKey | null + +// 获取模板完整信息(包括字段) +getTemplateWithFields(templateId: string): Promise