# 快速启动指南

## 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
```