# 实施计划 - [x] 1. 初始化项目结构 - 创建后端.NET 9.0解决方案，包含API、Core、Infrastructure和Application四个项目层 - 创建前端Vite+Vue 3项目，配置路由、状态管理和UI组件库 - 配置MySQL数据库连接和Entity Framework Core - 设置开发环境配置文件（appsettings.json和.env） - _需求: 1.1, 6.1_ - [x] 2. 实现数据库层和核心实体 - [x] 2.1 创建实体类和DbContext - 实现Category、Product、PerformanceScore、Specification、DataSource和RankingHistory实体类 - 配置AppDbContext和实体关系映射 - 配置数据库索引（Name, Model, CategoryId, PerformanceScore字段） - _需求: 7.1, 7.2_ - [x] 2.2 创建和执行数据库迁移 - 生成初始数据库迁移文件 - 执行迁移创建数据库表结构 - 添加种子数据（初始产品类别：手机CPU、手机GPU、电脑CPU、电脑GPU） - _需求: 1.1, 1.2, 7.1_ - [ ] 2.3 编写实体验证单元测试 - 测试实体属性验证规则 - 测试实体关系配置 - _需求: 7.1_ - [x] 3. 实现Repository层数据访问 - [ ] 3.1 创建Repository接口和实现 - 实现ICategoryRepository和CategoryRepository - 实现IProductRepository和ProductRepository，包含分页、搜索和筛选方法 - 实现通用Repository基类 - _需求: 2.2, 4.2, 7.2_ - [ ] 3.2 实现产品查询方法 - 实现按类别获取产品列表（支持分页和排序） - 实现产品搜索方法（按名称、型号、品牌） - 实现产品筛选方法（按性能分数区间、发布年份） - _需求: 2.1, 4.2, 4.3, 4.4_ - [ ] 3.3 编写Repository层单元测试 - 使用InMemory数据库测试CRUD操作 - 测试查询和筛选逻辑 - _需求: 7.2_ - [x] 4. 实现Service层业务逻辑 - [x] 4.1 创建CategoryService - 实现获取所有类别方法 - 实现获取单个类别详情方法 - 使用AutoMapper配置DTO映射 - _需求: 1.3, 1.4, 6.1_ - [x] 4.2 创建ProductService - 实现获取产品排名列表方法（支持分页、排序） - 实现获取产品详情方法（包含规格参数和性能分数） - 实现产品搜索方法 - 实现产品筛选方法 - _需求: 2.1, 2.2, 2.3, 2.4, 4.2, 4.3, 4.4_ - [x] 4.3 创建ComparisonService - 实现产品对比方法（接受2-4个产品ID） - 实现对比数据处理逻辑（标识最优和最差指标） - 生成对比矩阵数据结构 - _需求: 5.1, 5.2, 5.3, 5.4_ - [ ] 4.4 编写Service层单元测试 - 测试业务逻辑正确性 - 使用Mock测试Repository依赖 - _需求: 2.1, 4.2, 5.1_ - [x] 5. 实现API Controllers - [x] 5.1 创建CategoriesController - 实现GET /api/categories端点 - 实现GET /api/categories/{id}端点 - 配置响应格式和状态码 - _需求: 6.1, 6.6_ - [x] 5.2 创建ProductsController - 实现GET /api/products端点（支持查询参数：categoryId, page, pageSize, sortBy, order） - 实现GET /api/products/{id}端点 - 实现GET /api/products/search端点（支持查询参数：q, categoryId, manufacturer, minScore, maxScore） - 配置FluentValidation验证查询参数 - _需求: 2.1, 2.2, 2.3, 4.2, 4.4, 6.2, 6.3, 6.4, 6.6_ - [x] 5.3 创建ComparisonController - 实现POST /api/comparison端点 - 验证请求体（productIds数组长度2-4） - 配置响应格式 - _需求: 5.1, 5.2, 6.5, 6.6_ - [x] 5.4 配置全局异常处理中间件 - 实现GlobalExceptionMiddleware - 处理ValidationException、NotFoundException和通用Exception - 返回标准化错误响应 - _需求: 6.7_ - [ ] 5.5 编写API集成测试 - 使用WebApplicationFactory测试API端点 - 测试各种查询参数组合 - 测试错误处理 - _需求: 6.1, 6.2, 6.3, 6.4, 6.5_ - [x] 6. 实现数据采集服务 - [x] 6.1 创建DataCollectionService基础结构 - 实现IDataCollectionService接口 - 配置HttpClientFactory - 实现数据验证和转换逻辑 - _需求: 3.1, 3.2, 3.3, 3.4_ - [x] 6.2 实现GeekBench数据采集 - 实现CollectFromGeekBenchAsync方法 - 解析GeekBench API响应或爬取排行榜页面 - 提取CPU性能数据（Single-Core和Multi-Core分数） - 更新或插入Product和PerformanceScore数据 - _需求: 3.1, 3.4_ - [x] 6.3 实现GPU数据采集 - 实现CollectGpuDataAsync方法 - 集成3DMark或GFXBench数据源 - 提取GPU性能数据 - _需求: 3.2, 3.4_ - [x] 6.4 实现AnTuTu数据采集 - 实现CollectFromAnTuTuAsync方法 - 爬取AnTuTu排行榜数据 - 提取移动设备综合性能数据 - _需求: 3.3, 3.4_ - [x] 6.5 实现排名计算服务 - 实现RecalculateRankingsAsync方法 - 按类别和性能分数计算排名 - 更新Product的CurrentRank字段 - 记录RankingHistory历史数据 - _需求: 2.5, 7.3_ - [x] 6.6 配置错误处理和重试机制 - 实现API调用失败重试逻辑（最多3次） - 记录详细错误日志（使用Serilog） - 实现告警通知机制 - _需求: 3.6_ - [x] 6.7 编写数据采集服务测试 - 使用Mock测试外部API调用 - 测试数据验证逻辑 - 测试排名计算准确性 - _需求: 3.4, 3.6_ - [ ] 7. 配置后台任务调度 - [x] 7.1 集成Hangfire - 安装Hangfire NuGet包 - 配置Hangfire使用MySQL存储 - 配置Hangfire Dashboard - _需求: 3.5_ - [x] 7.2 创建DataSyncJob - 实现定时数据同步任务 - 配置每24小时执行一次 - 调用DataCollectionService的各个采集方法 - 记录任务执行结果 - _需求: 3.5_ - [x] 7.3 配置数据库备份任务 - 创建DatabaseBackupJob - 配置每周执行一次 - 实现MySQL数据库备份逻辑 - _需求: 7.5_ - [x] 8. 实现前端基础架构 - [x] 8.1 配置Vue Router - 创建路由配置文件 - 定义路由：首页、类别排名、产品详情、产品对比 - 配置路由懒加载 - _需求: 2.1, 8.1_ - [x] 8.2 配置Pinia状态管理 - 创建categoryStore（管理产品类别状态） - 创建productStore（管理产品列表和详情状态） - 创建comparisonStore（管理对比产品状态） - _需求: 2.1, 4.1, 5.1_ - [x] 8.3 配置Axios和API服务层 - 创建Axios实例，配置baseURL和拦截器 - 实现请求拦截器（添加通用headers） - 实现响应拦截器（统一错误处理） - 创建categoryService、productService和comparisonService - _需求: 6.1, 6.2, 6.3, 6.4, 6.5_ - [ ] 8.4 集成Element Plus和TailwindCSS - 安装和配置Element Plus组件库 - 配置TailwindCSS - 创建全局样式文件 - _需求: 8.1, 8.2_ - [x] 9. 实现前端布局组件 - [x] 9.1 创建Header组件 - 实现顶部导航栏 - 添加Logo和应用名称 - 添加产品类别导航菜单 - 实现响应式布局 - _需求: 1.4, 8.1, 8.2_ - [x] 9.2 创建Footer组件 - 显示数据来源说明 - 显示最后更新时间 - 添加数据源链接 - _需求: 10.1, 10.2, 10.4_ - [x] 9.3 创建主布局组件 - 组合Header和Footer - 配置router-view - 实现响应式容器 - _需求: 8.1, 8.2_ - [x] 10. 实现首页和类别选择 - [x] 10.1 创建Home视图 - 显示产品类别卡片网格 - 调用categoryStore获取类别列表 - 实现类别卡片点击跳转 - 显示每个类别的产品数量 - _需求: 1.1, 1.4_ - [x] 10.2 实现响应式布局 - 桌面端：4列网格 - 平板端：2列网格 - 手机端：1列网格 - _需求: 8.1, 8.2, 8.3_ - [x] 11. 实现产品排名列表页面 - [x] 11.1 创建CategoryRanking视图 - 根据路由参数获取categoryId - 调用productStore获取产品列表 - 显示产品排名列表 - 实现分页组件 - _需求: 2.1, 2.5_ - [x] 11.2 创建ProductCard组件 - 显示产品缩略图、名称、型号 - 显示性能分数和排名 - 显示制造商和发布日期 - 实现点击跳转到详情页 - _需求: 2.2_ - [x] 11.3 创建ProductFilter组件 - 实现品牌筛选下拉框 - 实现性能分数区间滑块 - 实现发布年份筛选 - 实现筛选条件重置按钮 - _需求: 4.3, 4.5_ - [x] 11.4 创建ProductSearch组件 - 实现搜索输入框 - 实现搜索建议（防抖） - 实现搜索结果高亮 - _需求: 4.1, 4.2_ - [x] 11.5 实现排序功能 - 添加排序下拉框（按性能分数、发布日期、价格） - 实现升序/降序切换 - 调用API重新获取排序后的数据 - _需求: 2.4_ - [x] 11.6 实现产品对比选择 - 添加产品选择复选框 - 显示已选产品数量（最多4个） - 添加"对比"按钮，跳转到对比页面 - _需求: 5.1_ - [x] 12. 实现产品详情页面 - [x] 12.1 创建ProductDetail视图 - 根据路由参数获取productId - 调用productStore获取产品详情 - 显示产品基本信息（名称、型号、制造商、发布日期） - 显示性能分数和当前排名 - _需求: 2.2, 2.3_ - [x] 12.2 显示规格参数 - 以表格形式展示Specifications - 分组显示（如：处理器规格、图形规格） - _需求: 2.2_ - [x] 12.3 显示性能测试分数 - 以卡片形式展示各项Benchmark分数 - 使用进度条可视化分数 - _需求: 2.2_ - [x] 12.4 显示数据来源信息 - 显示数据来源名称和链接 - 显示最后更新时间 - _需求: 10.2, 10.3, 10.4_ - [ ] 12.5 集成ECharts图表 - 安装vue-echarts - 创建性能历史趋势折线图 - 创建性能指标雷达图 - 实现图表响应式 - _需求: 9.1, 9.3_ - [ ] 13. 实现产品对比页面 - [ ] 13.1 创建ProductComparison视图 - 从路由查询参数获取productIds - 调用comparisonStore获取对比数据 - 显示对比产品的基本信息 - _需求: 5.1, 5.2_ - [ ] 13.2 创建ComparisonTable组件 - 以表格形式展示产品参数对比 - 高亮显示最优值（绿色）和最差值（红色） - 支持横向滚动（移动端） - _需求: 5.2, 5.4_ - [ ] 13.3 创建ComparisonChart组件 - 使用ECharts创建柱状图对比性能分数 - 使用雷达图对比多维度性能指标 - 实现图表交互（悬停显示详细数据） - _需求: 5.3, 9.2_ - [ ] 14. 实现前端错误处理和加载状态 - [ ] 14.1 创建全局错误处理 - 在Axios拦截器中处理网络错误 - 显示Toast错误提示（使用Element Plus） - 处理401/403/404/500等HTTP错误 - _需求: 8.4_ - [ ] 14.2 实现加载状态 - 在各个视图中添加Loading组件 - 使用Skeleton屏幕优化加载体验 - 实现数据加载失败重试按钮 - _需求: 8.4_ - [ ] 14.3 实现空状态处理 - 创建EmptyState组件 - 在无数据时显示友好提示 - 提供返回首页或重新加载按钮 - _需求: 8.4_ - [x] 15. 实现性能优化 - [x] 15.1 配置前端代码分割 - 配置Vite的代码分割策略 - 实现路由级别的懒加载 - 分离第三方库（vendor chunk） - _需求: 8.4_ - [x] 15.2 实现图片优化 - 配置图片懒加载（使用Intersection Observer） - 使用WebP格式图片（带降级方案） - 实现图片占位符 - _需求: 8.4_ - [x] 15.3 配置后端缓存 - 安装StackExchange.Redis NuGet包 - 配置Redis连接 - 实现排名列表缓存（5分钟过期） - 实现产品详情缓存（15分钟过期） - _需求: 2.1, 2.3_ - [ ] 15.4 实现API响应压缩 - 配置Response Compression中间件 - 启用Gzip压缩 - _需求: 6.6_ - [ ] 15.5 配置数据库查询优化 - 使用AsNoTracking优化只读查询 - 实现Include预加载关联数据 - 避免N+1查询问题 - _需求: 7.2_ - [x] 16. 配置CORS和安全设置 - [x] 16.1 配置CORS策略 - 在Program.cs中配置CORS - 允许前端域名访问 - 配置允许的HTTP方法和Headers - _需求: 6.6_ - [ ] 16.2 配置API限流 - 安装AspNetCoreRateLimit NuGet包 - 配置IP限流规则（每分钟最多100请求） - 配置端点级别限流 - _需求: 6.6_ - [ ] 16.3 配置输入验证 - 使用FluentValidation验证所有API输入 - 防止SQL注入（使用参数化查询） - 清理和转义用户输入 - _需求: 6.7_ - [ ] 17. 配置日志和监控 - [ ] 17.1 配置Serilog - 安装Serilog NuGet包 - 配置日志输出到文件和控制台 - 配置结构化日志格式 - 配置日志级别（Development: Debug, Production: Information） - _需求: 3.6_ - [ ] 17.2 实现关键操作日志 - 记录数据采集任务执行日志 - 记录API错误日志 - 记录数据库操作异常日志 - _需求: 3.6_ - [ ] 17.3 配置Hangfire Dashboard监控 - 启用Hangfire Dashboard - 配置Dashboard访问权限 - 监控后台任务执行状态 - _需求: 3.5_ - [ ] 18. 编写部署文档和配置 - [ ] 18.1 创建Docker配置 - 编写后端Dockerfile - 编写前端Dockerfile - 创建docker-compose.yml（包含API、前端、MySQL、Redis） - _需求: 1.1_ - [ ] 18.2 创建环境配置文件 - 创建appsettings.Production.json - 创建前端.env.production - 配置生产环境数据库连接字符串 - 配置API密钥和外部服务配置 - _需求: 3.1, 3.2, 3.3_ - [ ] 18.3 编写部署文档 - 编写README.md（项目介绍、技术栈、功能特性） - 编写DEPLOYMENT.md（部署步骤、环境要求、配置说明） - 编写API文档（使用Swagger/OpenAPI） - _需求: 1.1, 6.1, 6.2, 6.3, 6.4, 6.5_