feat: NEXT Store 2.0 重大更新 - 完整重构前后端

🎉 主要更新: 后端: - 全新华为应用市场爬虫系统 - 三表分离数据库设计 (app_info, app_metrics, app_rating) - 完整的API接口 (搜索、分类、热门、上新等) - 元服务自动识别和分类 - 智能Token管理和数据处理 - 修复热门应用重复显示问题前端: - 全新首页设计 (今日上架、热门应用) - 应用页面 (彩色分类磁贴、智能图标匹配) - 今日上新页面 (日期切换) - 热门应用页面 (卡片布局) - 应用详情页面 (完整信息展示) - Apple风格搜索栏 - Footer组件 - 底部导航栏优化 (4个导航项) - 骨架屏加载效果 - FontAwesome图标集成 UI/UX: - 统一浅色背景 (#F5F5F7) - 流畅的过渡动画 - 响应式设计 - 毛玻璃效果文档: - CHANGELOG.md - 完整更新日志 - QUICKSTART.md - 快速开始 - 多个技术文档和使用指南版本: v2.0.0
2025-10-25 21:20:32 +08:00
parent c0f81dbbe2
commit 720402ffe7
38 changed files with 5682 additions and 407 deletions
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -0,0 +1,217 @@
+# 更新日志 (CHANGELOG)
+
+本文档记录 NEXT Store 2.0 的所有版本更新和功能变更。
+
+---
+
+## [v2.0.0] - 2024-12-XX
+
+### 🎉 重大更新
+
+#### 后端架构重构
+- **全新爬虫系统**
+  - 实现华为应用市场API爬虫
+  - 支持应用信息、指标数据、评分数据的完整抓取
+  - 智能Token管理系统，自动刷新和重试
+  - 数据处理器，自动去重和更新
+  - 支持批量爬取和单个应用爬取
+
+- **数据库优化**
+  - 新增 `app_info`、`app_metrics`、`app_rating` 三表分离设计
+  - 支持历史数据追踪
+  - 优化索引，提升查询性能
+  - 新增数据库迁移工具
+
+- **API增强**
+  - `/api/apps/search` - 应用搜索
+  - `/api/apps/categories` - 分类统计
+  - `/api/apps/category/{category}` - 按分类查询
+  - `/api/apps/today` - 今日上架应用（根据 listed_at 判断）
+  - `/api/apps/by-date` - 按日期查询应用
+  - `/api/apps/top-downloads` - 热门应用Top100（修复重复问题）
+  - `/api/apps/top-ratings` - 评分Top100
+  - `/api/apps/{app_id}` - 应用详情
+
+#### 前端全面升级
+
+##### 🏠 首页 (Home)
+- 全新探索页面设计
+- 今日上架应用展示（横向滚动）
+- 热门应用Top5快速访问
+- 鸿蒙系统推广卡片
+- 骨架屏加载效果，优化用户体验
+- 数据预加载，减少闪烁
+
+##### 📱 应用页面 (Apps)
+- 参考 Apple 风格的搜索栏
+  - 圆角胶囊设计（border-radius: 22px）
+  - 实时清除按钮
+  - 取消按钮
+  - 白色背景 + 阴影效果
+- 彩色分类磁贴网格
+  - 16种渐变色循环
+  - 智能图标匹配（150+分类图标）
+  - 图标作为背景装饰（右下角半透明）
+  - 悬停动画效果
+- 搜索结果网格展示
+- 分页功能
+- 骨架屏加载
+
+##### 🆕 今日上新页面 (NewApps)
+- 日期切换（今日/昨日/前日）
+- 根据 `listed_at` 字段精确判断
+- 网格布局展示应用图标
+- 空状态提示
+- 骨架屏加载
+
+##### 🔥 热门应用页面 (HotApps)
+- 卡片式布局
+- 显示应用图标、名称、分类、版本、下载量
+- 按下载量排序
+- 骨架屏加载
+
+##### 📄 应用详情页面 (AppDetail)
+- 参考模板设计的详情页
+- 应用基本信息展示
+- 统计卡片（评分、下载量、大小）
+- 评分分布图表
+- 详细信息列表
+- 平台支持标签（带图标和颜色）
+- 下载按钮（跳转华为应用市场）
+- 浅色背景 (#F5F5F7)
+- 移除SDK和API信息
+
+##### 🧭 导航优化
+- 底部导航栏
+  - 探索、应用、上新、我的
+  - 简洁的线条图标
+  - 毛玻璃效果背景
+  - 激活状态高亮
+- 响应式设计，适配各种屏幕
+
+##### 🦶 页脚组件 (Footer)
+- 三列布局（关于、快速链接、法律信息）
+- CC BY-NC-SA 4.0 许可协议
+- 版权信息
+- 响应式设计
+- Profile 页面不显示
+
+#### 🎨 UI/UX 改进
+- 统一使用 #F5F5F7 浅色背景
+- FontAwesome 6.4.0 图标库集成
+- 流畅的过渡动画
+- 骨架屏加载状态
+- 响应式设计，完美适配移动端和桌面端
+- 毛玻璃效果（backdrop-filter）
+
+#### 🔧 功能特性
+
+##### 元服务分类
+- 自动识别元服务（packing_type = 1）
+- 单独"元服务"分类
+- 元服务不在其他分类中重复出现
+- 元服务分类显示在首位
+
+##### 搜索功能
+- 支持应用名称、包名、开发者搜索
+- 实时搜索建议
+- 搜索结果分页
+
+##### 数据展示
+- 下载量格式化（亿、万）
+- 文件大小格式化（GB、MB、KB）
+- 日期格式化
+- 评分星级显示
+
+#### 📚 文档完善
+- `QUICKSTART.md` - 快速开始指南
+- `backend/START_GUIDE.md` - 后端启动指南
+- `backend/USAGE_UPDATED.md` - 爬虫使用文档
+- `backend/ATOMIC_SERVICE.md` - 元服务分类说明
+- `backend/PERFORMANCE.md` - 性能优化文档
+- `backend/FIXED.md` - 问题修复记录
+- `backend/app/crawler/README.md` - 爬虫系统文档
+- `frontend/DEBUG.md` - 前端调试指南
+
+#### 🐛 Bug 修复
+- 修复热门应用重复显示问题（交管12123）
+- 修复搜索栏样式问题
+- 修复图标不显示问题
+- 修复首页加载闪烁问题
+- 优化数据库查询性能
+
+#### 🔒 安全性
+- 环境变量配置
+- 数据库连接池优化
+- API错误处理
+- 数据验证
+
+#### 📦 依赖更新
+- FastAPI
+- SQLAlchemy 2.0
+- Vue 3
+- Vue Router 4
+- Axios
+- FontAwesome 6.4.0
+
+---
+
+## 技术栈
+
+### 后端
+- Python 3.9+
+- FastAPI
+- SQLAlchemy 2.0 (异步)
+- MySQL/MariaDB
+- aiomysql
+- httpx (异步HTTP客户端)
+
+### 前端
+- Vue 3 (Composition API)
+- TypeScript
+- Vue Router 4
+- Axios
+- Vite
+- FontAwesome 6.4.0
+
+---
+
+## 安装和使用
+
+请参考以下文档：
+- [快速开始](QUICKSTART.md)
+- [后端启动指南](backend/START_GUIDE.md)
+- [爬虫使用文档](backend/USAGE_UPDATED.md)
+
+---
+
+## 贡献者
+
+感谢所有为本项目做出贡献的开发者！
+
+---
+
+## 许可证
+
+本项目采用 CC BY-NC-SA 4.0 许可协议
+
+---
+
+## 下一步计划
+
+### v2.1.0 (计划中)
+- [ ] 用户系统
+- [ ] 收藏功能
+- [ ] 评论系统
+- [ ] 应用推荐算法
+- [ ] 数据统计图表
+- [ ] 管理后台
+- [ ] 暗色模式
+- [ ] 多语言支持
+- [ ] PWA支持
+- [ ] 性能监控
+
+---
+
+**最后更新**: 2024-12-XX  
+**当前版本**: v2.0.0