57 lines
1.3 KiB
Markdown
57 lines
1.3 KiB
Markdown
# 🚀 快速开始指南
|
|
|
|
## 前置要求
|
|
|
|
确保您的开发环境中安装了以下工具：
|
|
|
|
- **Go 1.23.4+** - 编程语言环境
|
|
- **Docker & Docker Compose** - 容器化环境
|
|
- **Git** - 版本控制工具
|
|
- **Make** - 构建工具（可选，推荐）
|
|
|
|
## 一键启动
|
|
|
|
```bash
|
|
# 1. 克隆项目
|
|
git clone <your-repo-url>
|
|
cd tyapi-server-gin
|
|
|
|
# 2. 启动开发环境
|
|
make dev-up
|
|
|
|
# 3. 运行应用
|
|
make run
|
|
```
|
|
|
|
访问 http://localhost:8080/api/v1/health 验证启动成功。
|
|
|
|
## 验证安装
|
|
|
|
### 检查服务状态
|
|
|
|
```bash
|
|
# 检查所有容器是否正常运行
|
|
docker-compose -f docker-compose.dev.yml ps
|
|
|
|
# 检查应用健康状态
|
|
curl http://localhost:8080/api/v1/health
|
|
```
|
|
|
|
### 访问管理界面
|
|
|
|
启动成功后，您可以访问以下管理界面：
|
|
|
|
- **API 文档**: http://localhost:8080/swagger/
|
|
- **数据库管理**: http://localhost:5050 (pgAdmin)
|
|
- **监控面板**: http://localhost:3000 (Grafana)
|
|
- **链路追踪**: http://localhost:16686 (Jaeger)
|
|
- **邮件测试**: http://localhost:8025 (MailHog)
|
|
|
|
## 下一步
|
|
|
|
快速启动完成后，建议您：
|
|
|
|
1. 阅读 [环境搭建指南](./环境搭建指南.md) 了解详细配置
|
|
2. 查看 [开发指南](./开发指南.md) 开始开发
|
|
3. 参考 [API 使用指南](./API使用指南.md) 了解 API 用法
|