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
This commit is contained in:
Nvex
2025-10-25 21:20:32 +08:00
parent c0f81dbbe2
commit 720402ffe7
38 changed files with 5682 additions and 407 deletions

77
QUICKSTART.md Normal file
View File

@@ -0,0 +1,77 @@
# 快速启动指南
## 1. 启动后端服务
```bash
cd backend
# 启动 API 服务
python3 -m uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
# 或使用启动脚本
./start.sh
```
后端服务启动后:
- API 地址http://localhost:8000
- API 文档http://localhost:8000/docs
## 2. 启动前端服务
```bash
cd frontend
# 启动开发服务器
npm run dev
```
前端服务启动后:
- 访问地址http://localhost:5173
## 3. 爬取数据(可选)
如果数据库中没有数据,需要先爬取:
```bash
cd backend/app/crawler
# 爬取所有应用962个
python3 crawl.py
# 或只爬取前10个测试
python3 crawl.py --limit 10
```
## 常见问题
### Q: 前端显示 500 错误
A: 确保后端服务已启动http://localhost:8000
### Q: 数据库连接失败
A: 检查 `backend/.env` 文件中的数据库配置
### Q: 前端页面没有数据
A: 运行爬虫脚本爬取数据到数据库
## 完整流程
```bash
# 1. 初始化数据库
cd backend
python3 init_db.py
# 2. 爬取数据
cd app/crawler
python3 crawl.py --limit 10
# 3. 启动后端(新终端)
cd backend
python3 -m uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
# 4. 启动前端(新终端)
cd frontend
npm run dev
# 5. 访问
# 打开浏览器访问 http://localhost:5173
```