cmroubao/backend-api/README.md

cmroubao backend API

Go 1.23.0、Gin 1.11.0 和 SQLite 构成的最小后端骨架。当前只提供健康检查和数据库 迁移生命周期，不包含任务、鉴权或管理页面业务。

环境

• Go 1.23.0
• CGO_ENABLED=1
• PATH 中可用的 GCC

可选环境变量：

变量	默认值	说明
CMROUBAO_HTTP_ADDR	127.0.0.1:8080	HTTP 监听地址；局域网监听必须显式配置
CMROUBAO_DATABASE_PATH	var/cmroubao.db	SQLite 文件路径

不会自动读取 .env。本地配置和 var/ 运行数据不得提交。

命令

$env:GOTOOLCHAIN = "local"
go test ./...
go vet ./...
go build -o bin/cmroubao-api.exe ./cmd/api
go build -o bin/cmroubao-migrate.exe ./cmd/migrate
go run ./cmd/migrate up
go run ./cmd/migrate status
go run ./cmd/api

服务启动后，GET /healthz 在数据库可用时返回 200 和 {"status":"ok"}，不可用时返回 503 和 {"status":"unavailable"}。