feat(架构): 完善基础架构设计

docs/开始指南/环境搭建指南.md

@@ -0,0 +1,127 @@
+# 🔧 环境搭建指南
+
+## 开发环境配置
+
+### 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
+```