feat(backend): establish gin sqlite service skeleton

This commit is contained in:
QiuSW
2026-07-25 22:29:56 +08:00
parent 84f2da3cf7
commit ab21219a07
32 changed files with 1854 additions and 42 deletions
+19 -5
View File
@@ -22,7 +22,7 @@ MVP 不自动提交订单、不支付、不绕过验证码或平台风控。
```text
cmroubao/
├── android-buyer/ # Roubao main 固定 commit 的 Android 基线
├── backend-api/ # Go-Gin API、管理页面和任务数据,待创建
├── backend-api/ # Go-Gin API、SQLite、迁移和后续管理页面
├── docs/ # Harness Coding 项目事实和执行约束
├── AGENTS.md # AI coding agent 权威入口
├── init.ps1 # Windows 标准构建/真机启动入口
@@ -32,8 +32,9 @@ cmroubao/
管理人员使用 Web 管理端,采购人员使用 Android App;二者共享同一后端、任务数据
和权限体系。验证版先使用单管理账号和设备身份,完整 RBAC 放到验证通过后。
后端已确定采用 Go 1.23.0 + Gin 1.11.0,并用 Go Blueprint v0.10.11 生成最小
Gin + SQLite 骨架后按领域边界二次开发。
后端采用 Go 1.23.0 + Gin 1.11.0,以 Go Blueprint v0.10.11 为一次性骨架参考,
已收敛出 SQLite、Goose 迁移、健康检查和可关闭的 HTTP Server;业务 API 按 Phase 2
任务逐步加入。
Android 端已核实的 Roubao 上游环境为 Kotlin 1.9.20、JDK 17、Gradle 8.2、
AGP 8.2.0、Android SDK 34,以及 Jetpack Compose Compiler 1.5.5。最低支持
@@ -54,6 +55,19 @@ Set-Location android-buyer
普通 `.\init.ps1` 或不带 `-PprobeFixturesDir` 的 Debug 构建会清除先前注入的私有
fixture,默认 APK 不携带真实订单资料。
## 后端运行
```powershell
Set-Location backend-api
$env:GOTOOLCHAIN = "local"
go run ./cmd/migrate up
go run ./cmd/api
```
默认监听 `127.0.0.1:8080`,SQLite 位于被忽略的 `backend-api/var/`。另一个终端可
访问 `http://127.0.0.1:8080/healthz`。可配置项和独立验证命令见
[`backend-api/README.md`](backend-api/README.md)。
## 文档入口
- [AI 开发入口](docs/00-ai-start-here.md)
@@ -66,5 +80,5 @@ fixture,默认 APK 不携带真实订单资料。
- [当前实现状态](docs/current-state.md)
- [完整文档导航](docs/README.md)
Android Phase 0 已完成构建、真机设备就绪、workflow 测试和私有样本导入;Go 后端
尚未建立。真实状态以 [`docs/current-state.md`](docs/current-state.md) 为准。
Android Phase 0/1 已完成,Go 后端基础骨架已建立。真实状态以
[`docs/current-state.md`](docs/current-state.md) 为准。