22 Commits

Author	SHA1	Message	Date
wangjia	08fb915b5e	test(devices): #27 同机换账号登录注册 E2E(SQLite,服务层) ... 走 login 完全相同的路径 devices.Service.RegisterIfAbsent{MaxDevices:0}: 同一 device uuid 两账号各得一行、A 重登幂等刷新、共享 uuid 恰 2 行。 补 SQLite(生产同引擎)服务层覆盖,与既有 store 层 TestSQLite_DevicesUserScopedUUID 及 MySQL 集成 TestSameDeviceUUIDTwoAccounts 三层互证 F3 修复。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-07-05 13:11:25 +08:00
wangjia	63d1baeb01	fix(server): devices 唯一键改 (user_id,uuid) —— 同机换账号不再 403 死结(F3,#27) ... device_id 按安装持久、跨账号复用;旧全局 UNIQUE(uuid) 使同机第二账号注册永远 403 → ConnectNode 判 DEVICE_NOT_REGISTERED,提示的「重新登录」无法自救。 - migration 21(sqlite/mysql):UNIQUE(uuid)→UNIQUE(user_id,uuid);platform 放行 linux(normalizePlatform 早已接受,旧 CHECK/ENUM 会拒)。SQLite 表重建用 rename→重建→复制→drop 次序,单事务内不触发 sessions 的级联清空(FK ON)。 - 查找全部收口为按 (user,uuid) 作用域(重复 uuid 跨用户后全局查询歧义): findDeviceByUserUUIDTx / FindByUserUUID;Register 删跨用户 Forbidden 分支; Delete/ForceLogout/Rename 对他人设备返回 404(不可见);SessionActive 删 「非本人 fail-safe」分支,dev==nil→false 语义不变。 - 测试:SQLite 真迁移库 F3 回归(两账号同 uuid 各自成行/同用户重复拒/linux 入库/ sessions 重建后级联仍成立)+ MySQL 集成测试 schema 同步与双账号用例。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-07-02 13:16:40 +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	27dc59ed63	feat(server): pro 套餐设备上限 5 → 3 ... - seed(sqlite/mysql 000007)+ 001_init:pro max_devices 5→3(全新库直接对) - 新增迁移 000019(sqlite/mysql,up/down):UPDATE plans SET max_devices=3 WHERE code='pro' —— 已迁移的线上库靠它更新;down 回退 5 - 000002/001 注释同步(free 1 / pro 3 / team 10) - 测试:sqlite_migrate 期望版本 18→19;devices 集成测试 pro 断言 5→3 - free(1)/team(10)不变 注:设备上限当前仍未强制执行(登录注册 MaxDevices=0),仅数据/展示口径; 真正启用+超限 UX 见 todo #16。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-07-01 18:07:03 +08:00
wangjia	f0af3bcc94	fix(server): 强退设备立即离线 — online 须含活跃会话 + 撤销会话不刷 last_seen ... trick bug:强退后被踢设备的下一次会话轮询会先刷 last_seen 再发现 active=false,那一刷 把它顶成「在线」直到 90s 窗口过期。修:① online = last_seen 新 且 有未撤销会话 (ActiveSessionDeviceIDs);被强退设备无活跃会话 → 立即离线。② SessionActive 仅在 active 时才 TouchLastSeen,撤销会话的轮询不再刷新。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-30 08:51:10 +08:00
wangjia	0b33f12400	feat: 近实时远程下线 — 客户端轮询会话有效性(~15s),服务端 GET /v1/me/session ... 控制面无推送通道,access token 是无状态 JWT(15min),强制退出后被踢设备要等 token 过期 (≤15min)才登出。改成客户端每 15s 轮询会话是否仍有效,被强制退出即登出 → 延迟压到 ~15s。 - 服务端:sessions.HasActiveSession(user,device) + devices.SessionActive(按 UUID,fail-open) + GET /v1/me/session?device_id= 返回 {active}(恒 200,判据在 body)。无新迁移。 - 客户端:account_api.sessionActive + main.dart _RootFlowState 15s 轮询,active=false 即 logout (网络/鉴权异常不据此登出,fail-safe)。 - 测试:TestSQLite_SessionHasActiveSession(建会话=活跃→RevokeByDevice→非活跃)。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-30 07:25:16 +08:00
wangjia	315c343ed5	feat(devices): 设备默认名「平台简写·主机名」+ 支持重命名(1.0.13) ... ① 默认名:DeviceIdentity 改「平台简写(Win/Mac/Linux/iOS/Andr)·主机名」,主机名截 到 8、总长≈12(替代裸主机名,更短)。 ② 重命名:新端点 POST /v1/me/devices/{uuid}/rename(Service.RenameDevice 校验归属+ 截 64);store.UpdateName;客户端 account_api.renameDevice + provider.rename + 「我的设备」⋯ 菜单加「重命名」+ 输入弹窗;l10n(zh/en)。 ③ 版本 1.0.13。 测试:server RenameDevice(归属/空名/404)+ 客户端 rename widget;全量 go/flutter 绿。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-29 09:12:36 +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	bcc114088c	feat(devices): P3 强制退出 + 清除增强(per-device 凭证吊销) ... 后端:新端点 POST /v1/me/devices/{uuid}/logout(ForceLogout:吊销该设备会话+ 丢 Redis JTI,设备留列表)。DeleteDevice 增强:先吊销会话再删设备(FK ON DELETE CASCADE 清理会话行)+ 按 dp_uuid 吊销数据面凭证。CredentialRevoker 接口改 per-device RevokeDevice(dpUUID),由 nodes.Service 实现(查 connect_credentials 持有节点→推 CommandTypeRevoke + 删凭证行),main 注入替 NoopRevoker;devices 注入 SessionPort/JTIRevoker。修 SQLite 跨连接死锁(会话吊销移到 delete tx 之前)。 migration 000016 sessions FK 加 ON DELETE CASCADE。 客户端:account_api.forceLogout + devicesProvider.forceLogout(UI 留 P6)。 测试:ForceLogout(吊销会话+JTI+设备保留+403/404)+ DeleteDevice(级联+按 dp_uuid 吊销);NoopRevoker 改 dp_uuid;全量 server/flutter 测试绿。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-29 06:01:41 +08:00
wangjia	2f298f0a0a	feat(devices): P2 sessions 表 + 在线/最后登录/客户端版本 ... migration 000016(mysql+sqlite,含 down):新增 sessions 表(绑 device+refresh JTI) + devices 加 client_version/totp_trusted_until。devices 唯一键改 + platform CHECK 加 linux(需 SQLite 表重建)拆出后续迁移,降风险。 后端:新 internal/sessions Store(Create/Rotate/Revoke/RevokeByDevice/ LastLoginByDevice);TokenManager 外露 refresh JTI(IssueWithJTI/RefreshWithJTI/ ParseRefreshJTI);auth.Service 注入 SessionStore——登录建会话、刷新轮换、登出吊销; DeviceRegistrar 返回 deviceID;ReportUsage 心跳 touch devices.last_seen(在线判定); devices.ListDevices 经 LastLoginSource 注入返回 online(last_seen<3min)/client_version/ last_login;RegisterIfAbsent 存 client_version。 客户端:Device model 加 online/clientVersion/lastLogin(fromJson 自动解析)。 测试:sessions store 3 例 + ListDevices 在线/最后登录 + device model 2 例 + migration v16;全量 go test/flutter test 绿。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-29 00:50:24 +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	3527537c96	fix(connect): 4 处 500 记 slog.Error;加连接路径 schema 绑定测试 ... ConnectNode 四条 ErrInternal 路径(entitlement/配额/节点/配置渲染)此前只写 500 不记 err,导致「no such column: p.daily_mb」这种 SQL 错全静默 → 难排查。 改为各记 slog.Error(含 user/node/err)。 新增 store 层测试 TestSQLite_ConnectPathSchema:在跑过完整迁移(含 000015)的 真 SQLite 库上,跑连接路径依赖 015 schema 的三条查询——EntitlementForUser (断言 DailyMB 从 plans.daily_mb 取到 102400)、EnsureDeviceDpUUID(devices.dp_uuid)、 AccountDayBytes——任一引用了没有迁移建的列即 SQL 报错、测试变红,守住本次 「查询引用了未迁移列」一类回归。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-28 08:11:32 +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	3d87bffbe9	feat(server): P2 后端补字段 — 套餐价格 + 节点 host(#6 6B) ... - 迁移 000014_plan_pricing(mysql+sqlite 双套):plans 加 price_cents/currency/ period,seed pro=2500 team=9900(¥25/¥99);ListPlans 返回价格字段。 - /v1/nodes 暴露 host+port(取自 node.Endpoint,无 schema 变更),供客户端实测 真实 per-client 延迟(服务端无法代知)。 - 修复 account.go 的 GetMe/weeklyGB 残留 MySQL 专属 UTC_DATE()/INTERVAL (#1 漏网):改 Go 端算日期传 ?,否则 SQLite 节点今日/周流量恒 0。 - sqlite 迁移 up/down 测试期望版本 13→14。 go build/vet 干净;sqlite 迁移 up/down + httpapi 测试通过。节点 tag 暂不加 (无真实数据,不造空字段;客户端将不显示伪造 tag)。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-18 23:42:23 +08:00
wangjia	439c0ea5da	test(server/db): 多库(4/4)— SQLite 实库测试 + dialect SQL 断言 + 双引擎脚本 ... - internal/store SQLite 实库行为测试(免 docker、真连引擎):用量累加 upsert、 节点累加、directory_version 自增、幂等 no-op、凭据 upsert、兑换码全流程 (锁 + 标记已用 + 建订阅 + Go 端续期) - internal/db dialect SQL 逐字断言(MySQL/SQLite 两侧生成串),无需起 MySQL 即可锁定 MySQL 侧 SQL 与重构前一致 - run_sqlite_test.sh:双引擎测试矩阵的 SQLite 半边(零 docker) Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-18 00:01:43 +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	f3471ae139	feat(server/db): 数据层多库支持(1/4)— 连接分派 + 双方言迁移管线 ... - config 增 DB_DRIVER(mysql 默认 | sqlite);DSN 对 sqlite 为文件路径 - db.OpenDriver 按驱动分派:sqlite 用 modernc(纯 Go 免 CGO)+ WAL/ busy_timeout/foreign_keys/_txlock=immediate;mysql 路径不变 - store.Open 分派;mysql 保留 UTC/collation 断言,sqlite 跳过 - 迁移拆 migrations/{mysql,sqlite}/ 双套,embed 双 FS,migrate 按驱动选源 与 golang-migrate 驱动;修复 m.Close() 误关调用方 *sql.DB 的坑 - cmd/migrate 串入 DB_DRIVER;集成测试 MigrateUp 签名更新 - 新增 SQLite 时间往返 smoke 测试与端到端迁移测试(免 docker) Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-18 00:01:03 +08:00
wangjia	628440b3f9	style(pangolin): gofmt store/mysql.go(import 排序) ... Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-13 18:52:30 +08:00
wangjia	03b00b9a0f	merge: config + store(UTC DSN) + 自动迁移 [tsk_zRA6fGU1JuHj] ... 以 main 现有 config 设计为准(FromEnv/*Config/单 DSN/RS256),移植分支新增的 store 层:mysql.go 的 Open(*config.Config) 改用 cfg.DSN、结构化强制 UTC + 会话时区断言;migrate.go + migrations/embed.go 提供 golang-migrate 嵌入式迁移;cmd/migrate/main.go 实现 migrate CLI(读 DB_DSN)。未采用分支的 Load()/PANGOLIN_ 前缀/MySQL 拆分字段(与 main 设计冲突)。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-13 18:42:46 +08:00
wangjia	52857d1d55	feat(1e): config PANGOLIN_ prefix + store.Open UTC DSN + go:embed migrations (tsk_zRA6fGU1JuHj) ... - internal/config: rewrite Config with PANGOLIN_ prefix fields (HTTPAddr, AdminAddr, GRPCAddr, MySQL DSN/fields, RedisAddr, AutoMigrate, JWTSecret placeholder, WebhookSecret); Load() replaces FromEnv(); missing required MySQL vars return named-field error. - internal/store/mysql.go: single Open(cfg) entry point; uses mysql.ParseDSN to structurally override ParseTime=true, Loc=UTC, Collation=utf8mb4_unicode_ci, Params[time_zone]='+00:00'; asserts SELECT @@session.time_zone=+00:00 after Ping (startup fatal). - migrations/embed.go: //go:embed *.sql exposes var FS embed.FS. - internal/store/migrate.go: MigrateUp/MigrateDown/MigrateVersion backed by golang-migrate iofs source + mysql driver; ErrNoChange treated as success. - cmd/migrate/main.go: filled — up/down/version subcommands, reads config.Load() + store.Open. - cmd/server/main.go: startup sequence Load → store.Open (UTC assert) → MigrateUp (if PANGOLIN_AUTO_MIGRATE=true) → HTTP listen; structured slog output at each step. - internal/store/mysql_test.go: pure-function unit tests for buildDSN (empty-fields case + conflicting params overridden case); both pass. - internal/store/mysql_integration_test.go: //go:build integration; testcontainers mysql:8 — UTC assertion + MigrateUp idempotency. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-13 14:52:27 +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