digimon
/
template-monorepo
3
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
template-monorepo/generate/api
History
王性驊 713a81f70b feat(auth): add unified registration/login module with Zitadel + lint cleanup 
- Introduce auth module: handlers, logic, domain/repository/usecase, JWT
  middleware, and Zitadel OIDC client (password + authorization code +
  userinfo + JWKS verification)
- Wire member rate-limit, structured errors, and refactored member/
  notification usecases (introduce shared errors, drop repo_errors.go)
- Bring the codebase to zero golangci-lint issues:
  * goimports formatting
  * errcheck on io.ReadAll/Unlock cleanup paths
  * contextcheck: HandlerContext now takes (ctx, *http.Request)
  * gocritic: rename shadowed `max`, use http.NoBody
  * goconst: extract test fixtures and bsonOpSet
  * testifylint: switch to assert inside httptest handlers

Co-authored-by: Cursor <cursoragent@cursor.com>
 		2026-05-21 14:45:35 +08:00
..
README.md feat(auth): add unified registration/login module with Zitadel + lint cleanup 2026-05-21 14:45:35 +08:00
auth.api feat(auth): add unified registration/login module with Zitadel + lint cleanup 2026-05-21 14:45:35 +08:00
common.api feat(auth): add unified registration/login module with Zitadel + lint cleanup 2026-05-21 14:45:35 +08:00
gateway.api feat(auth): add unified registration/login module with Zitadel + lint cleanup 2026-05-21 14:45:35 +08:00
member.api feat(auth): add unified registration/login module with Zitadel + lint cleanup 2026-05-21 14:45:35 +08:00
normal.api feat(auth): add unified registration/login module with Zitadel + lint cleanup 2026-05-21 14:45:35 +08:00

README.md

API 定義（goctl + go-doc 共用）

檔案

檔案 用途
gateway.api 入口：info() + import
common.api 共用文件型別（APIErrorStatus、ErrorDetail）
auth.api Auth 路由（scope 28）
member.api Member 路由（scope 29）
normal.api 路由與業務 data 型別

指令

make gen-api   # 生成 handler / logic / types
make gen-doc   # 生成 docs/openapi/gateway.yaml（OpenAPI 3.0）

註解約定

  • Logic returns：只寫業務 data（如 PingData）
  • 文件 @respdoc：寫實際 HTTP JSON（如 PingOKStatus、APIErrorStatus）
  • @doc：單一 API 的 summary / description
  • 多狀態碼用 /* @respdoc-200 ... */ 區塊，放在 @handler 前
  • Request 驗證：欄位可加 validate:"required,email" 等 tag；make gen-api 後 handler 會自動 ValidateAll（見 generate/goctl/api/handler.tpl）

與 runtime 對齊

Handler 使用 response.Write 輸出：

{ "code": 102000, "message": "SUCCESS", "data": { ... } }

失敗時含 error.biz_code / error.scope 等欄位。Handler parse 錯誤為 Facade scope（10101000）；各模組 logic/usecase 使用對應 scope（Auth=28、Member=29）。