pangolin

wangjia/pangolin

Fork 0

Commit Graph

Author	SHA1	Message	Date
wangjia	87ccaecddf	feat(server/devices): 设备管理 + 订阅校验中间件 (tsk_x7wrlA87orsY) 实现 server/internal/devices 模块： - handler.go: GET /v1/me/devices 列表、DELETE /v1/me/devices/{id} 移除（chi 路由，挂在 /v1/me 下；JWT 中间件之后）。 - service.go: ListDevices / RegisterIfAbsent（隐式登记，按 plan.max_devices 校验，超限返回双语 DEVICE_LIMIT_EXCEEDED 含上限数字）/ DeleteDevice（事务硬删 + audit_log → 调 CredentialRevoker.RevokeForUser 按用户回收凭证，dp_uuid 模型） / SubscriptionSummary / ResolvePlan / 纯函数 resolveEffectivePlan。 - middleware.go: 订阅校验中间件，解析最高档未过期订阅注入 context； helpers PlanFromCtx / CheckDeviceQuota / RequirePaidTier；预留 60s Redis 缓存开关。 - store.go: devices/users/subscriptions/plans/audit_log 数据访问，按用户行锁串行化登记。 - context.go: user_id / plan 的 context key 与 helper。 - CredentialRevoker 接口（消费侧定义，避免与 nodes 循环依赖）+ NoopRevoker，形状对齐 #5 的 Hub.Push(RevokeCredential)，#5 落地前注入 no-op。测试：service_test.go 15 个单测（trial→pro、过期回落 free、banned 拒绝、最高档/同档最晚到期、UTC 严格边界、设备配额、双语限额、平台/名称归一化）全过； devices_integration_test.go（testcontainers，build tag integration）覆盖注册→connect 隐式登记→list→delete 全链路 + 回收断言 + 403/404。 apierr 增加 Unauthorized/Forbidden/NotFound/AccountBanned； OpenAPI SubscriptionInfo.source 枚举补 free。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-13 12:13:09 +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

87ccaecddf

feat(server/devices): 设备管理 + 订阅校验中间件 (tsk_x7wrlA87orsY)

实现 server/internal/devices 模块：

- handler.go: GET /v1/me/devices 列表、DELETE /v1/me/devices/{id} 移除
  （chi 路由，挂在 /v1/me 下；JWT 中间件之后）。
- service.go: ListDevices / RegisterIfAbsent（隐式登记，按 plan.max_devices
  校验，超限返回双语 DEVICE_LIMIT_EXCEEDED 含上限数字）/ DeleteDevice（事务硬删
  + audit_log → 调 CredentialRevoker.RevokeForUser 按用户回收凭证，dp_uuid 模型）
  / SubscriptionSummary / ResolvePlan / 纯函数 resolveEffectivePlan。
- middleware.go: 订阅校验中间件，解析最高档未过期订阅注入 context；
  helpers PlanFromCtx / CheckDeviceQuota / RequirePaidTier；预留 60s Redis 缓存开关。
- store.go: devices/users/subscriptions/plans/audit_log 数据访问，按用户行锁串行化登记。
- context.go: user_id / plan 的 context key 与 helper。
- CredentialRevoker 接口（消费侧定义，避免与 nodes 循环依赖）+ NoopRevoker，
  形状对齐 #5 的 Hub.Push(RevokeCredential)，#5 落地前注入 no-op。

测试：service_test.go 15 个单测（trial→pro、过期回落 free、banned 拒绝、
最高档/同档最晚到期、UTC 严格边界、设备配额、双语限额、平台/名称归一化）全过；
devices_integration_test.go（testcontainers，build tag integration）覆盖
注册→connect 隐式登记→list→delete 全链路 + 回收断言 + 403/404。

apierr 增加 Unauthorized/Forbidden/NotFound/AccountBanned；
OpenAPI SubscriptionInfo.source 枚举补 free。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-06-13 12:13:09 +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