pangolin

wangjia/pangolin

Fork 0

Commit Graph

Author	SHA1	Message	Date
wangjia	ece8ea3b57	feat(usage): usage_daily 聚合 + 广告解锁 + free 额度校验 (tsk_1taxhtV2k3RP) server/internal/usage 模块实现（仅字节/分钟，无目的地，符合无日志口径）： - aggregator.go：实现 #5 的 ReportUsage 回调接口（UsageReporter）， dp_uuid→user_id 走内存+Redis 短缓存，按上报批次 id Redis 去重防重放，按 At 的 UTC 日期 INSERT ... ON DUPLICATE KEY UPDATE 累加，并发安全。 - store.go：usage_daily 累加/区间查询/当日查询、MarkAdUnlocked（事务+FOR UPDATE 幂等）、EffectivePlan（活跃订阅取最高 tier，无则回落 free）。 - ads.go：AdVerifier 接口 + AdMob SSV 实现（拉取并缓存 Google ECDSA 公钥， ECDSA-SHA256 验签 + custom_data/ad_unit 匹配），Unity 留接口占位。 - service.go：UsageCurve（空日补零、仅当前用户）、TodaySummary（/v1/me）、 UnlockAd（验签→ad_token 一次性 nonce 去重→写 ad_unlocked_at，当日二次幂等）。 - quota.go：CheckFreeConnect 供 #5 connect 使用：ad_gate=true 校验当日 ad_unlocked_at + minutes_used<daily_minutes(free=10)，返回剩余分钟； pro/team 不受 ad_gate 限制（返回 Unlimited）；带双语 code 错误。 - handler.go：GET /v1/usage?days=7、POST /v1/ads/unlock(204)。 - apierr：新增 AD_NOT_UNLOCKED/QUOTA_EXHAUSTED/AD_VERIFY_FAILED/AD_TOKEN_REPLAY。 - openapi：/ads/unlock 补 409 Conflict（重放）。测试：ads_test.go 单测覆盖 AdMob 验签全链路（合法/伪造/custom_data 不符/ ad_unit 不允许/畸形 token）+ Unity 未实现；usage_integration_test.go (testcontainers, build tag integration) 覆盖并发多节点累加、批次重放去重、跨 UTC 日界分桶、未知 dp_uuid 丢弃、free 额度四态、ads 解锁伪造/重放/幂等、曲线补零/隔离、/me 摘要。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-13 12:16:50 +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

ece8ea3b57

feat(usage): usage_daily 聚合 + 广告解锁 + free 额度校验 (tsk_1taxhtV2k3RP)

server/internal/usage 模块实现（仅字节/分钟，无目的地，符合无日志口径）：

- aggregator.go：实现 #5 的 ReportUsage 回调接口（UsageReporter），
  dp_uuid→user_id 走内存+Redis 短缓存，按上报批次 id Redis 去重防重放，
  按 At 的 UTC 日期 INSERT ... ON DUPLICATE KEY UPDATE 累加，并发安全。
- store.go：usage_daily 累加/区间查询/当日查询、MarkAdUnlocked（事务+FOR
  UPDATE 幂等）、EffectivePlan（活跃订阅取最高 tier，无则回落 free）。
- ads.go：AdVerifier 接口 + AdMob SSV 实现（拉取并缓存 Google ECDSA 公钥，
  ECDSA-SHA256 验签 + custom_data/ad_unit 匹配），Unity 留接口占位。
- service.go：UsageCurve（空日补零、仅当前用户）、TodaySummary（/v1/me）、
  UnlockAd（验签→ad_token 一次性 nonce 去重→写 ad_unlocked_at，当日二次幂等）。
- quota.go：CheckFreeConnect 供 #5 connect 使用：ad_gate=true 校验当日
  ad_unlocked_at + minutes_used<daily_minutes(free=10)，返回剩余分钟；
  pro/team 不受 ad_gate 限制（返回 Unlimited）；带双语 code 错误。
- handler.go：GET /v1/usage?days=7、POST /v1/ads/unlock(204)。
- apierr：新增 AD_NOT_UNLOCKED/QUOTA_EXHAUSTED/AD_VERIFY_FAILED/AD_TOKEN_REPLAY。
- openapi：/ads/unlock 补 409 Conflict（重放）。

测试：ads_test.go 单测覆盖 AdMob 验签全链路（合法/伪造/custom_data 不符/
ad_unit 不允许/畸形 token）+ Unity 未实现；usage_integration_test.go
(testcontainers, build tag integration) 覆盖并发多节点累加、批次重放去重、
跨 UTC 日界分桶、未知 dp_uuid 丢弃、free 额度四态、ads 解锁伪造/重放/幂等、
曲线补零/隔离、/me 摘要。

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

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