HI-VPN/hi-server
4
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
hi-server/.claude/plan/sync-features.md

6.8 KiB
Raw Blame History

功能同步计划：私有版 → 开源版

源目录：/Users/Apple/vpn/ppanel-server（私有版） 目标目录：/Users/Apple/code_vpn/vpn/ppanel-server（开源版） 模块名相同：github.com/perfect-panel/server

批次 A：新增独立包（直接复制）

A1. pkg/iap（Apple IAP）

  • 复制 pkg/iap/ 全目录

A2. pkg/kutt（短链接服务）

  • 复制 pkg/kutt/kutt.go

A3. pkg/loki（Grafana Loki）

  • 复制 pkg/loki/loki.go

A4. pkg/openinstall（渠道统计）

  • 复制 pkg/openinstall/openinstall.go

A5. internal/model/iap（IAP 数据模型）

  • 复制 internal/model/iap/ 全目录

A6. internal/model/logmessage（错误日志模型）

  • 复制 internal/model/logmessage/ 全目录

批次 B：数据库迁移

B1. 新增迁移文件（仅从私有版复制）

  • 02120_log_message.up.sql / .down.sql
  • 02121_apple_iap_transactions.up.sql / .down.sql
  • 02122_add_user_last_login_time.up.sql / .down.sql
  • 02123_update_auth_method_config.up.sql / .down.sql（auth_method MEDIUMTEXT）

B2. 修改共有迁移文件

  • 00002_init_basic_data.up.sql：VerifyCodeExpireTime 默认值 300→900
  • 02118_traffic_log_idx.up.sql：添加幂等性检查
  • 02119_node.up.sql：@sql 变量名修正（已是私有版逻辑，保留）

批次 C：配置与基础设施

C1. internal/config/config.go

  • 添加：KuttConfig、LokiConfig、OpenInstallConfig、AppleIAPConfig 结构体
  • 添加：FixedRate 浮点型汇率配置

C2. internal/config/cacheKey.go

  • 添加：UserSessionsKeyPrefix = "auth:user_sessions:"

C3. pkg/conf/default.go

  • 添加：reflect.Float64 case 处理

C4. internal/svc/serviceContext.go

  • 添加：Kutt、Loki、OpenInstall、IAPModel 字段

C5. internal/svc/devce.go

  • 修复 SQL Bug：create_at → created_at

C6. pkg/orm/mysql.go

  • 添加：SetConnMaxIdleTime(5min) + SetConnMaxLifetime(30min)

C7. pkg/exchangeRate/exchangeRate.go

  • 保持私有版的 exchangerate.host 实现

C8. initialize/config.go & init.go

  • 添加 Loki、OpenInstall 初始化逻辑

批次 D：数据模型

D1. internal/model/user/user.go

  • 添加：LastLoginTime 字段

D2. internal/model/auth/auth.go

  • config 字段 MEDIUMTEXT（Go 结构体 tag）
  • 补全 4 种邮件模板初始化

D3. internal/model/node/model.go

  • 添加：CountNodesByIdsAndTags 方法（移除 fmt.Println 调试语句）
  • 修复：ClearServerAllCache 同时清理 ServerConfig + ServerUserList
  • 修复：cursor append bug（OSS版的 append(keys, keys...)）

D4. internal/model/payment/payment.go

  • 添加：AppleIAPConfig 结构体

D5. internal/model/user/subscribe.go

  • 添加：includeExpired 参数支持（":all" cache key suffix）

批次 E：认证与登录逻辑

E1. internal/logic/auth/userLoginLogic.go

  • 添加：LastLoginTime 更新
  • 添加：邮箱登录调试日志清理

E2. internal/logic/auth/userRegisterLogic.go

  • 添加：邮箱小写/trim 处理
  • 添加：验证码过期时间使用配置值

E3. 新增：internal/logic/auth/emailLoginLogic.go

  • 从私有版复制邮箱直登逻辑

E4. 新增：apis/auth/auth.api 邮箱登录路由

  • 添加 emailLogin 接口定义

批次 F：用户功能逻辑

F1. internal/logic/public/user/queryUserInfoLogic.go

  • 添加：Kutt 短链接生成 + Redis 永久缓存
  • 添加：share_link 字段返回

F2. internal/logic/public/user/queryUserSubscribeLogic.go

  • 添加：查询 Order 判断 IsGift（amount==0）

F3. internal/handler/public/user/queryUserSubscribeHandler.go

  • 添加：includeExpired query param 注入 context

F4. internal/model/user/model.go

  • 添加：FindActiveSubscribe / FindActiveSubscribesByUserIds
  • 添加：BatchClearRelatedCache
  • 添加：DeleteUserAuthMethodByIdentifier

批次 G：订单与支付

G1. internal/logic/public/order/preCreateOrderLogic.go

  • 修复：math.Round 金额计算

G2. internal/logic/public/order/purchaseLogic.go

  • 修复：math.Round

G3. internal/logic/public/order/renewalLogic.go

  • 修复：math.Round

G4. internal/logic/public/portal/purchaseCheckoutLogic.go

  • 添加：Apple IAP checkout case
  • 添加：currency 从 DB 动态读取 + FixedRate fallback
  • 修复：math.Round for alipay

G5. internal/model/payment/model.go

  • 添加：AppleIAP payment model 支持

G6. pkg/payment/platform.go

  • 添加：AppleIAP platform entry

批次 H：订阅与节点

H1. internal/logic/public/portal/getSubscriptionLogic.go

  • 添加：CountNodesByIdsAndTags 调用，返回 node_count

H2. internal/logic/public/portal/purchaseLogic.go

  • 添加：CloseOrderTimeMinutes 超时配置

H3. internal/logic/subscribe/subscribeLogic.go

  • 保持：PanDomain 模式返回当前 Host

批次 I：队列任务

I1. queue/logic/order/activateOrderLogic.go

  • 添加：findGiftSubscription 逻辑
  • 添加：extendGiftSubscription 逻辑
  • 添加：grantGiftDaysToBothParties（双向赠礼）
  • 添加：no-retry for invalid status

I2. queue/logic/email/sendEmailLogic.go

  • 修改：主题中文化
  • 修改：动态过期分钟数
  • 修改：float64→int 类型转换
  • 添加：Smart Fallback 模板逻辑（4种类型）

I3. queue/logic/task/rateLogic.go

  • 添加：FixedRate config 支持（跳过 API 调用）

批次 J：路由与类型

J1. internal/handler/routes.go

  • 添加：IAP Apple 路由
  • 添加：email login 路由
  • 添加：error log 路由
  • 添加：contact 路由

J2. internal/types/types.go

  • 添加：Apple IAP 相关 Request/Response 类型
  • 添加：BindEmailWithVerificationRequest/Response
  • 添加：BindInviteCodeRequest
  • 添加：ProductIds in checkout

J3. internal/types/subscribe.go

  • 保持私有版（移除 Type/Params 开源版新增字段——已在批次 A 处理）

批次 K：邮件系统

K1. pkg/email/template.go

  • 添加：Maintenance、TrafficExceed、Verify 3 种邮件模板

批次 L：管理后台

L1. internal/logic/admin/user/getUserListLogic.go

  • 添加：MemberStatus + LastLoginTime 展示
  • 添加：批量获取 active subscriptions

L2. internal/logic/admin/user/updateUserBasicInfoLogic.go

  • 添加：Remark + MemberStatus 更新
  • 添加：单事务包裹所有修改

执行顺序

  1. A（新包） → B（迁移） → C（配置） → D（模型）
  2. E（认证） → F（用户） → G（订单） → H（订阅）
  3. I（队列） → J（路由） → K（邮件） → L（管理后台）

注意事项

  • 排除：App版本管理、设备绑定相关逻辑（ZSet Session、DeviceId in token）
  • 调试日志清理：不带 fmt.Println 调试语句
  • 模块名相同：import 路径无需修改
  • 开源版新功能保留：软删除、注册 IP 限流、兑换码系统、GeoIP 等开源版独有功能不回退