From 6756d5e72cb6bcc6be0f95aedb15ebc35364ee8c Mon Sep 17 00:00:00 2001 From: WuYongJie Date: Sat, 13 Dec 2025 14:48:03 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20=E5=AE=8C=E6=88=90=E9=98=B6=E6=AE=B51?= =?UTF-8?q?=E6=A0=B8=E5=BF=83=E5=9F=BA=E7=A1=80=E8=AE=BE=E6=96=BD=E4=BC=98?= =?UTF-8?q?=E5=8C=96?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ✅ 任务1: 完善模板验证工具 - 添加详细的错误代码和错误信息 - 添加性能监控(记录验证耗时) - 添加模板状态检查 - 添加批量验证功能 - 添加结构化日志记录 ✅ 任务2: 优化上传API的模板验证 - 集成增强的validateTemplateId函数 - 添加详细的验证日志 - 返回错误代码便于前端处理 ✅ 任务3: 增强字段池同步机制 - 添加增量同步支持 - 添加同步失败重试机制(指数退避) - 添加详细的同步统计信息 - 添加同步日志和监控 - 优化错误处理 相关需求: 1.1-1.4, 3.1-3.4, 6.1-6.4, 24.1-24.5 --- .../template-system-optimization/design.md | 909 ++++++++++++++++++ .../template-system-optimization/tasks.md | 245 +++++ app/api/materials/upload/route.ts | 19 +- lib/field-pool.ts | 372 +++++++ lib/template-validator.ts | 372 ++++++- 5 files changed, 1884 insertions(+), 33 deletions(-) create mode 100644 .kiro/specs/template-system-optimization/tasks.md 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