36 lines
989 B
Markdown
36 lines
989 B
Markdown
# 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"}`。
|