720402ffe7
🎉 主要更新:
后端:
- 全新华为应用市场爬虫系统
- 三表分离数据库设计 (app_info, app_metrics, app_rating)
- 完整的API接口 (搜索、分类、热门、上新等)
- 元服务自动识别和分类
- 智能Token管理和数据处理
- 修复热门应用重复显示问题
前端:
- 全新首页设计 (今日上架、热门应用)
- 应用页面 (彩色分类磁贴、智能图标匹配)
- 今日上新页面 (日期切换)
- 热门应用页面 (卡片布局)
- 应用详情页面 (完整信息展示)
- Apple风格搜索栏
- Footer组件
- 底部导航栏优化 (4个导航项)
- 骨架屏加载效果
- FontAwesome图标集成
UI/UX:
- 统一浅色背景 (#F5F5F7)
- 流畅的过渡动画
- 响应式设计
- 毛玻璃效果
文档:
- CHANGELOG.md - 完整更新日志
- QUICKSTART.md - 快速开始
- 多个技术文档和使用指南
版本: v2.0.0
78 lines
1.3 KiB
Markdown
78 lines
1.3 KiB
Markdown
# 快速启动指南
|
||
|
||
## 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
|
||
```
|