init: 通用库抽离——httpx/logger/wsc/wscclient/jwtx(合并分叉副本); 顶层包布局; module path git.zeroonesoft.cn/golib/zogo

2026-09-19 19:04:01 +08:00
commit f0f5421262
17 changed files with 2336 additions and 0 deletions
@@ -0,0 +1,28 @@
+# zogo
+
+zeroone Go 通用库（单仓多包）。被各后端服务以 Go module 依赖引用：
+`go get git.zeroonesoft.cn/golib/zogo/xxx`
+
+## 包清单
+
+| 包 | 用途 | 主要依赖 |
+|---|---|---|
+| `httpx` | Gin 统一出入参：OkJson/ErrorJson（CodeMsg 错误码透传）、Handle/HandleResult、Parse（uri→query→header→json 顺序绑定 + binding 校验收口） | gin, validator |
+| `logger` | logrus 日志初始化（文件轮转） | logrus, rotatelogs |
+| `wsc` | WebSocket 服务框架（会话/房间/路由/反射绑定） | gin, gorilla/websocket, uuid, logrus |
+| `wscclient` | WebSocket 客户端（自动重连） | gorilla/websocket |
+| `jwtx` | 轻量 HMAC-SHA256 JWT 签发与校验 | 无 |
+
+## 约定
+
+- 通用性准入：被 ≥2 个服务复制使用过的包才进入本仓库；仅单服务使用的留在服务内。
+- 改动流程：在本仓库修复/演进 → 打 tag（如 v0.1.1）→ 各服务 `go get -u git.zeroonesoft.cn/golib/zogo@v0.1.1`。
+- 本地联动开发：在 `D:\zomaintain\backend\go.work` 中 `use D:/golib/zogo`（go.work 不提交）。
+- go.mod 声明 go 1.24（不高于最低版本消费方），不要随意上调。
+
+## 私有模块拉取配置（每台开发机/CI 一次）
+
+```
+go env -w GOPRIVATE=git.zeroonesoft.cn/*
+```
+git 凭据需能访问 git.zeroonesoft.cn（Git Credential Manager 存 PAT）。