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:
77
QUICKSTART.md
Normal file
77
QUICKSTART.md
Normal 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
|
||||
```
|
||||
Reference in New Issue
Block a user