# 🔧 环境搭建指南

## 开发环境配置

### 1. 配置环境变量

```bash
# 复制环境变量模板
cp env.example .env

# 编辑环境变量（根据需要修改）
vim .env
```

### 2. 启动基础服务

```bash
# 启动 PostgreSQL 和 Redis
docker-compose -f docker-compose.dev.yml up -d postgres redis

# 查看服务状态
docker-compose -f docker-compose.dev.yml ps
```

### 3. 数据库初始化

```bash
# 创建数据库表
make migrate

# 或手动执行SQL
psql -h localhost -U postgres -d tyapi_dev -f scripts/init.sql
```

### 4. 依赖安装

```bash
# 安装Go依赖
go mod download

# 验证依赖
go mod verify
```

## 生产环境配置

### 1. 配置文件准备

```bash
# 复制生产配置模板
cp config.prod.yaml config.yaml

# 修改生产配置
vim config.yaml
```

### 2. 环境变量设置

```bash
export APP_ENV=production
export DB_HOST=your-db-host
export DB_PASSWORD=your-secure-password
export JWT_SECRET=your-jwt-secret
export REDIS_HOST=your-redis-host
```

## 服务配置说明

### PostgreSQL 配置

默认配置：

-   端口：5432
-   数据库：tyapi_dev
-   用户名：postgres
-   密码：Pg9mX4kL8nW2rT5y（开发环境）

### Redis 配置

默认配置：

-   端口：6379
-   无密码（开发环境）
-   数据库：0

### 监控服务配置

-   **Prometheus**: http://localhost:9090
-   **Grafana**: http://localhost:3000 (admin/Gf7nB3xM9cV6pQ2w)
-   **Jaeger**: http://localhost:16686

### 存储服务配置

-   **MinIO**: http://localhost:9000 (minioadmin/Mn5oH8yK3bR7vX1z)
-   **对象存储控制台**: http://localhost:9001

## 常见配置问题

### 端口冲突

如果遇到端口冲突，可以修改 `docker-compose.dev.yml` 中的端口映射：

```yaml
ports:
    - "15432:5432" # 将 PostgreSQL 映射到本地 15432 端口
```

### 权限问题

在 Linux/macOS 系统中，可能需要调整文件权限：

```bash
# 给予脚本执行权限
chmod +x scripts/*.sh

# 修复数据目录权限
sudo chown -R $(whoami) ./data/
```

### 内存不足

如果系统内存不足，可以减少启动的服务：

```bash
# 只启动核心服务
docker-compose -f docker-compose.dev.yml up -d postgres redis
```