快速开始

前置条件

• Go 1.23+
• Docker & Docker Compose（推荐）

方式一：Docker Compose（推荐）

# 克隆项目
git clone <repo-url>
cd hr

# 启动所有服务（app + postgres）
docker compose up -d

# 初始化种子数据
docker compose exec app ./server seed

服务监听 http://localhost:8080。

方式二：本地运行

# 启动 PostgreSQL
docker compose up -d db

# 安装依赖
go mod tidy

# 运行服务
go run main.go

# 另开终端，初始化种子数据
go run tools/seed.go

验证

curl http://localhost:8080/ping
# {"message":"pong"}

运行测试

# 确保 PostgreSQL 可用，然后：
go test ./...

详见测试文档。

常用操作

# 查看日志
docker compose logs -f app

# 停止服务
docker compose down

# 停止并删除数据卷
docker compose down -v

# 重新构建镜像
docker compose build --no-cache