# 环境搭建

## 环境要求

| 组件 | 版本 | 说明 |
|------|------|------|
| Python | 3.12+ | 后端运行环境 |
| Node.js | 18+ | 前端运行环境 |
| Docker | 24+ | 容器化部署 |
| PostgreSQL | 15+ | 主数据库 |
| Redis | 7+ | 缓存和队列 |

## Docker方式（推荐）

### 1. 克隆项目

```bash
git clone http://8.153.107.96/fischer/geo.git
cd geo
```

### 2. 配置环境变量

```bash
cp .env.example .env
# 编辑.env文件，配置必要的环境变量
```

### 3. 启动服务

```bash
docker-compose up -d
```

### 4. 访问服务

- 前端: http://localhost:3000
- 后端API: http://localhost:8000
- API文档: http://localhost:8000/docs

## 本地开发

### 后端开发环境

```bash
cd backend

# 创建虚拟环境
python3 -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

# 安装依赖
pip install -r requirements.txt

# 数据库迁移
alembic upgrade head

# 启动开发服务器
uvicorn app.main:app --reload --port 8000
```

### 前端开发环境

```bash
cd frontend

# 安装依赖
npm install

# 启动开发服务器
npm run dev
```

## IDE配置

### VS Code推荐插件

- Python: Pylance, Python
- TypeScript: TypeScript Vue Plugin (Volar)
- ESLint
- Prettier

### PyCharm配置

- Python解释器: 选择backend/.venv
- 工作目录: 项目根目录
