pangolin

wangjia/pangolin

Fork 0

Commit Graph

Author	SHA1	Message	Date
wangjia	dd060fd34a	feat(1d): wire oapi-codegen, generate types/server/client, add 501 stubs — tsk_Kp80nvHV2yLc - Fix openapi.yaml: quote bearerAuth description that contained unquoted `: ` plain-scalar YAML - Add server/api/cfg-{types,server,client}.yaml — oapi-codegen v2 config for three split outputs - Add server/api/gen/gen.go — three //go:generate directives; run `make generate` - Generate server/api/gen/{types,server,client}.gen.go from the contract (all 15 operations) - Add github.com/oapi-codegen/runtime v1.4.1 to go.mod (runtime types needed by generated code) - Add server/internal/httpapi/unimplemented.go — UnimplementedServer satisfies gen.ServerInterface; every method writes HTTP 501 + {code,message_zh,message_en} JSON body (no dep on task-1f apierr) - Update server/cmd/server/main.go — mount /v1 API via gen.HandlerFromMuxWithBaseURL; keep /healthz - Update server/Makefile — `generate` target now runs `go generate ./...`; add `check-generate` CI guard (regenerate + git diff --exit-code) - Add server/internal/httpapi/unimplemented_test.go — 19 httptest cases covering all 15 API routes (501+body), undefined routes (404), and /healthz isolation Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-13 14:36:21 +08:00
wangjia	58c6eb721e	feat: 新增 server/api/openapi.yaml — v1 API 完整契约(tsk_A1HkEdRbXLGY) OpenAPI 3.0.3，覆盖 doc/02 §2 全部 15 个操作： - 认证 4（sendVerificationCode/register/login/refreshToken，security:[]） - 账户 3（getMe/listDevices/deleteDevice） - 商业 3（redeemCode/adsUnlock/listPlans） - 节点 3（listNodes 含 304/connectNode/disconnectNode） - 用量 1（getUsage）、公告 1（listNotices）全量 schema：Error·TokenPair·Me·UserInfo·SubscriptionInfo·TodayUsageSummary· Device·Plan·RedeemResult·NodeDirectory·Node·ConnectCredential· RealityParams·Hysteria2Params·UsagePoint·Notice 安全约定：bearerAuth(JWT RS256) 全局；auth 四操作 security:[]； components/responses 统一 Error 引用；429 TooManyRequests 带 Retry-After；节点目录不含密钥，密钥仅由 connect 端点下发；对外 ID 全部 uuid 格式。 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-13 01:29:31 +08:00

Author

SHA1

Message

Date

wangjia

dd060fd34a

feat(1d): wire oapi-codegen, generate types/server/client, add 501 stubs — tsk_Kp80nvHV2yLc

- Fix openapi.yaml: quote bearerAuth description that contained unquoted `: ` plain-scalar YAML
- Add server/api/cfg-{types,server,client}.yaml — oapi-codegen v2 config for three split outputs
- Add server/api/gen/gen.go — three //go:generate directives; run `make generate`
- Generate server/api/gen/{types,server,client}.gen.go from the contract (all 15 operations)
- Add github.com/oapi-codegen/runtime v1.4.1 to go.mod (runtime types needed by generated code)
- Add server/internal/httpapi/unimplemented.go — UnimplementedServer satisfies gen.ServerInterface;
  every method writes HTTP 501 + {code,message_zh,message_en} JSON body (no dep on task-1f apierr)
- Update server/cmd/server/main.go — mount /v1 API via gen.HandlerFromMuxWithBaseURL; keep /healthz
- Update server/Makefile — `generate` target now runs `go generate ./...`;
  add `check-generate` CI guard (regenerate + git diff --exit-code)
- Add server/internal/httpapi/unimplemented_test.go — 19 httptest cases covering all 15 API routes
  (501+body), undefined routes (404), and /healthz isolation

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-06-13 14:36:21 +08:00

wangjia

58c6eb721e

feat: 新增 server/api/openapi.yaml — v1 API 完整契约(tsk_A1HkEdRbXLGY)

OpenAPI 3.0.3，覆盖 doc/02 §2 全部 15 个操作：
  - 认证 4（sendVerificationCode/register/login/refreshToken，security:[]）
  - 账户 3（getMe/listDevices/deleteDevice）
  - 商业 3（redeemCode/adsUnlock/listPlans）
  - 节点 3（listNodes 含 304/connectNode/disconnectNode）
  - 用量 1（getUsage）、公告 1（listNotices）

全量 schema：Error·TokenPair·Me·UserInfo·SubscriptionInfo·TodayUsageSummary·
Device·Plan·RedeemResult·NodeDirectory·Node·ConnectCredential·
RealityParams·Hysteria2Params·UsagePoint·Notice

安全约定：bearerAuth(JWT RS256) 全局；auth 四操作 security:[]；
components/responses 统一 Error 引用；429 TooManyRequests 带 Retry-After；
节点目录不含密钥，密钥仅由 connect 端点下发；对外 ID 全部 uuid 格式。

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-06-13 01:29:31 +08:00

2 Commits