feat(backend): establish gin sqlite service skeleton

2026-07-25 22:29:56 +08:00
parent 84f2da3cf7
commit ab21219a07
32 changed files with 1854 additions and 42 deletions
@@ -0,0 +1,35 @@
+# 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/` 运行数据不得提交。
+
+## 命令
+
+```powershell
+$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"}`。