12 Commits

Author	SHA1	Message	Date
wangjia	c9e266b89a	fix(server+ci): 修 go-integration 真 bug + e2e 免疫代理(CI 收尾) ... DinD 修复后暴露的两个 CI job,诊断: Go integration(真 test-drift bug,早前会话改动遗留): - auth/integration_test:Register/Login 补 ip + DeviceMeta 参数(sessions/ device-meta 改动后陈旧调用,构建失败)。 - usage/usage_integration_test:手写测试 schema 补 ad_bonus_minutes 列 (migration 000020 加的);重写 TestIntAdsUnlockAccumulates 断言对齐 ad-unlock 转累加式(UnlockAd→AddAdBonusMinutes,不再 stamp ad_unlocked_at)。 - devices/devices_integration_test:套餐种子 pro=5→3(migration 000019 改的)。 - devices/context.go(生产 1 行):CtxKeyUserID 别名到 codes.CtxKeyUserID——原为 独立 devices.ctxKey 类型,与 auth 注入的 codes.ctxKey 类型不同→context 取键 失配(休眠 bug,中间件目前仅测试接线)。go build 通过。 E2E(环境问题,非脚本):删 ci.yml 里多余的 apt-get(openssl/curl/python3 已在 golang:1.25 镜像内;原 apt 走 Docker Desktop 代理→本机死口,徒增脆性)。脚本 本身本机直跑通过。 验证:go test -tags integration -count=1 -p 1 ./... 全 ok;go build ./... clean。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-07-08 09:04:10 +08:00
wangjia	e023fb6579	feat(server): 免费版账户级分钟卡控 + 累加式看广告加时(#21 后端) ... 免费版此前形同虚设:ConnectNode 每次连接发固定 daily_minutes×1min TTL、 从不扣减已用,重连即崭新 10 分钟,日额度从未强制。改为账户级(全设备共享) 真卡控 + 累加式看广告加时: - migration 000020: usage_daily 加 ad_bonus_minutes(sqlite+mysql)。 当日额度 = plans.daily_minutes + ad_bonus_minutes;剩余 = 额度 − minutes_used。 - usage.store.AddAdBonusMinutes: 事务内累加封顶(替代布尔 MarkAdUnlocked), 返回新总额+本次实际加时;GetDay/GetUsageRange 补读 ad_bonus_minutes。 - usage.service.UnlockAd: verify+nonce 后 +adBonusPerAd(10) 封顶 adDailyBonusCeiling(120), 返回 granted+remaining;TodaySummary 加 MinutesCap/AdBonusMinutes。 - usage.ads DevVerifier: 放行式占位校验(nonce 防重放仍生效),接真 AdMob 前 让看广告加时流程可端到端跑通;main.go 按 ADS_DEV_MODE/默认装配。 - ads/unlock: 204 → 200 返回 {granted_minutes, minutes_remaining}。 - ConnectNode 免费门: 读 AccountDayMinutes(used,bonus) → remaining≤0 拒 QUOTA_EXHAUSTED, 否则 TTL=remaining(凭证到点硬切断兜底)。nodes.store 加 AccountDayMinutes。 - /me: 补 ad_bonus_minutes,quota_today_min 分母改 daily+bonus,加 quota_cap_min。 - quota.CheckFreeConnect 同步累加语义(免费基础 10 分钟不再需先看广告)。 - openapi + 契约/迁移版本/集成测试同步;新增 SQLite AddAdBonusMinutes 单测。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-07-01 23:44:10 +08:00
wangjia	e333f59cb3	feat(stats): #10 第②层 —— 统计页按设备过滤(per-device 本地日曲线) ... 镜像账户级时区曲线到「按设备」: - migration 000018 `usage_device_hourly`(每设备 UTC 小时桶,稀疏)。 - ReportUsage deviceID>0 时加 AccumulateDeviceHourly;NodeStore 接口+impl+mock。 - usage.Store.DeviceHourlyRange(JOIN devices 校验归属+解析 uuid→id);UsageCurve 增 deviceUUID 形参:空=账户级,非空=该设备本地日曲线(分桶逻辑复用)。 - /v1/usage?device=<uuid>;客户端 account_api.usage(device)、usageProvider key 改 记录 (days,device)、stats_page 接 statsDeviceProvider → 选设备即重取该设备曲线。 测试:per-device 曲线隔离+归属校验(A的设备不进B)、UsageCurve(deviceUUID)、 migration v18、客户端 widget(选设备→/v1/usage 带 device=)。全量 go/flutter 绿。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-29 08:04:33 +08:00
wangjia	f2499a64e1	fix(usage): 统计按客户端本地日聚合 —— 修「29号却显示28号数据」时区 bug ... 根因:服务端用量全按 UTC 预切天,UTC+8 用户在中国 0-8 点时 UTC 还是前一天, 「今天」就显示前一天数据。 改法(用户拍板:小时桶+查询带时区偏移): - migration 000017 `usage_hourly`(UTC 纪元小时整数桶,稀疏存储,空小时不落行)。 - ReportUsage 同时累加 usage_hourly(按 windowEnd 的 UTC 小时);usage_daily 保留作配额/今日。 - `UsageCurve(days, offsetMin)`:读 UTC 小时桶,按客户端时区偏移**重新聚合成本地日**曲线。 - `/v1/usage?tz_offset=分钟`;客户端 `usage()` 带 `DateTime.now().timeZoneOffset.inMinutes`。 - 客户端早已「取曲线最后一点当今日」,故只改服务端聚合 + 带偏移即可。 测试:store 时区分桶证明（UTC 18:00 在 UTC vs UTC+8 落不同本地日,锁住 bug 修复）+ migration v17 + usage_hourly 表;集成测试改喂 hourly;全量 go/flutter test 绿。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-29 07:02:04 +08:00
wangjia	636a3bbf2f	feat(server/stats): stats-overhaul Phase2 — 每设备归因 + GB 综合配额 ... 服务端记账从「账户」细到「每设备」(每设备独立 dp_uuid),配额单位分钟→GB 按账户综合卡控。000015_per_device_usage 迁移(mysql+sqlite 双份):devices.dp_uuid + usage_device_daily 表 + plans.daily_mb。handler_grpc 按 dp_uuid 回映射 (user_id,device_id) 双写账户+每设备;usage 服务/handler 暴露 /v1/usage(/devices)。 含 sqlite_per_device / usage handler 测试。 注:此迁移 prod 已 migrate up 运行、部署二进制已内嵌;本次补提交使 git 与线上一致。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-28 18:12:00 +08:00
wangjia	0fd3bce7a5	fix(server): 修复腐烂的集成测试套件 + devices 注册回填 last_seen ... 这批 -tags integration 测试(usage/auth/codes/devices/store)因依赖冲突 长期编译不过、从未进 CI 跑过,代码静默腐烂。本次逐层修复: - 依赖:testcontainers-go v0.34→v0.43(原 v0.34 配 docker v28.3.3 编译失败: archive.Compression/sockets.DialPipe undefined)。 - auth: LoginOutcome 重构成 Tokens 嵌套后,测试仍引用扁平 RefreshToken; users 测试 schema 缺 totp_enabled 列 → GetUserByEmail 报错 → SendCode 500。 - usage/auth/codes/devices: DSN 里 time_zone='+00:00' 作 URL query 透传时 '+' 被解码成空格 → MySQL Error 1298 ' 00:00';改百分号编码。 - store: 测试 DSN 缺 multiStatements=true → 多语句迁移 Error 1064; WithConfigFile("") 在 v0.43 被拒,改写真 my.cnf 设 +08:00 真正考验 UTC 覆盖。 - devices(产品 bug):insertDeviceTx 把 last_seen 写进库却没回填返回值, 刚注册的设备 API 响应 last_seen=null 与库不一致;TestFullChain 据此把关。 修复后完整 integration 套件 -p 1 串行全绿(25 包 + 5 testcontainers 包)。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-25 21:19:10 +08:00
wangjia	eb1bd11439	fix(test): 契约测试解耦 stats-overhaul WIP(CI 抓到的真问题) ... CI 暴露:我的契约测试引用了未提交的 stats-overhaul 文件,本地能过(文件在工作区)、 CI checkout 已提交代码就崩: - api_contract_test.dart import device_usage.dart(?? 未提交)→ flutter analyze 报 'Target of URI doesn't exist' - usage/contract_test.go 引用 DeviceUsagePoint/deviceUsageResponse(HEAD service.go/ handler.go 均无)→ go-server 编译失败 摘掉 /v1/usage/devices(DeviceUsage)契约,保留 /v1/me + /v1/usage(已提交)。 待 stats-overhaul 合并后再补 DeviceUsage 契约。 验证:flutter analyze test/contract 'No issues';go vet usage 无错。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-25 18:13:27 +08:00
wangjia	747ceb06f0	test(contract): 第2刀c Go 契约快照(/v1/me·usage·UsageEntry)+ Go CI job ... 支柱 2(契约单源)后端守门 + 两端对账: - httpapi/contract_test.go：冻结 /v1/me 字段面(12 key,与 Dart _frozenMeKeys 对账, 注明后端多发 uuid/dp_uuid + expire_at 别名) - usage/contract_test.go：冻结 /v1/usage(UsagePoint)、/v1/usage/devices (DeviceUsagePoint + envelope)字段面 - pb/agentv1/contract_test.go：冻结 agent↔控制面 UsageEntry 字段面 - ci.yml：新增 go-server job(golang:1.25 build+test)——此前 server 测试未进 CI - 本地:5 契约用例 + 全量 go test ./...(25 包)绿 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-24 23:35:23 +08:00
wangjia	03e268edc5	fix: /v1/usage 401(统计页全0真因) + 连接页速度改动态字节单位 ... - /v1/usage 一直 401:usage 包自定义了 ctxKey("user_id") 读 user id,但 auth.RequireAuth 把 user id 存在 codes.CtxKeyUserID 下;Go context key 按 「类型+值」比较,命名类型不同 → 取到 nil → 401 → 统计页本月流量/时长恒 0 (而 /v1/me weekly 走 account.go 直查,有数,故只半边为 0)。改 usage 读 codes.CtxKeyUserID(与 auth.UserIDFromContext 同键,/v1/me 已验证可用)。 同时修好 /v1/ads/unlock(同一函数)。 - 连接页速度:Mb/s(兆比特,小流量显示 0.0)→ 动态字节单位 B/s·KB/s·MB/s·GB/s, 小数据也看得清。 go build/test 通过;flutter analyze 0 error;114 tests passed。server 已部署。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-19 07:17:58 +08:00
wangjia	86b67c557b	feat(server/db): 多库(3/4)— Dialect 抽象(upsert/锁)+ 合并 directory_version ... - db.Dialect:LockForUpdate(mysql "FOR UPDATE" / sqlite "")、Upsert(中性 EXCLUDED.col → mysql VALUES()/ sqlite excluded.);DialectForDB 从连接驱动推导 - 9 处 ON DUPLICATE KEY、11 处 FOR UPDATE 全走 dialect;sqlite 靠 _txlock= immediate 取得 BEGIN IMMEDIATE 悲观锁等价语义 - directory_version 三处重复合并为 store.BumpDirectoryVersion(dialect 感知) - 这些文件同时含(2/4)的 UTC→Go 改动(与 upsert/锁同语句交错,无法拆分) - 顺带:usage 的 FIELD()、codes 的 DATE_ADD/GREATEST 续期、nodes 的 UNIX_TIMESTAMP、NULLIF 等 MySQL 专属构造一并退回 Go/可移植写法 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-18 00:01:26 +08:00
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	1629385c70	feat(server): Go 模块骨架 + 工具链 [tsk_L2k2VrEujof8] ... 新建 server/ Go 模块： - go.mod: module github.com/wangjia/pangolin/server, Go 1.22 依赖: go-chi/chi/v5, google/uuid - tools.go: //go:build tools 锁定 oapi-codegen / golang-migrate 版本 - cmd/server/main.go: chi router + GET /healthz → {"status":"ok"}，监听 :8080 - cmd/migrate/main.go: 占位入口（实逻辑归 1e） - internal/{config,store,apierr,idgen,auth,codes,devices,nodes,usage,admin}/doc.go 各包职责说明 - Makefile: build/test/vet/lint/generate/migrate-up/migrate-down - .golangci.yml: govet/errcheck/staticcheck/revive/gofmt 基线 - README.md: 定位 + 目录树 + make 入口说明 - setup.sh: 首次 go mod tidy 引导脚本（go.sum 需运行后生成） Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-13 01:28:37 +08:00