新功能(#3): 抽奖 Stage 1 收官 — 用户 API + 后台 CRUD + 集成

Closes HIF-3

Stage 1 完整闭环 PR C：用户 API + 后台 CRUD + 抽奖事务服务 + 审计 + QA curl。合并后 Stage 1 可交测试。

架构师 review R1（rulecaps depth≤8/nodes≤64/bytes≤8KB）+ R2（InviteHook source_ref 加 order: 前缀）已全部落地。

- 迁移 02158_admin_action_log：后台写操作审计
- xerr 100xxx 段：抽奖错误码（NotEligible/NoChances/ActivityEnded/RateLimited/NotClaimable/InternalError/RuleTooDeep/RuleTooMany/RuleTooLarge）
- feature flag config.Lottery.Enable 默认 false，合并后线上零副作用
- draw service：feature flag → rate limit → pre-tx reads → nonce dedupe → Consume → Pick → 乐观扣库存 → 双快照 → Dispatch → finalize
- 用户 API 4 个：GET /config、POST /draw、GET /records、POST /claim（Stage 1 返回 100010）
- 后台 CRUD：活动 / 奖品 / rules PUT（rulecaps gate）/ chances/grant
- audit.WriteAdminAction：与调用方 tx 同生共死，SHA1 body 摘要
- QA 脚本：qa/lottery/stage1_curl.sh 全链路 curl

测试覆盖：model 76.5% / draw 69% / handler 68.3% / hook 91.9% / rulecaps 87.8% / audit 100%
100 并发抢库存 + 10000 次概率分布 e2e 推 QA 环境（sqlmock 无法忠实模拟 InnoDB 行锁）
CI 全绿：构建/Vet/测试 + golangci-lint

internal/logic/lottery/handler/commission_log.go

@@ -0,0 +1,32 @@
+package handler
+
+import (
+	"time"
+
+	logmodel "github.com/perfect-panel/server/internal/model/log"
+	"gorm.io/gorm"
+)
+
+// WriteCommissionLog 是 internal/logic/common.WriteCommissionLog 的镜像。
+// 抽到 handler 包避免 internal/svc → internal/logic/common 的 import cycle
+// （internal/logic/common 里有别的文件反向 import 了 svc）。函数体保持一致，
+// 未来若 common 侧调整了签名或者行为要同步到这里。
+func WriteCommissionLog(tx *gorm.DB, objectID int64, logType uint16, amount int64, orderNo string) error {
+	logInfo := logmodel.Commission{
+		Type:      logType,
+		Amount:    amount,
+		OrderNo:   orderNo,
+		Timestamp: time.Now().UnixMilli(),
+	}
+	content, err := logInfo.Marshal()
+	if err != nil {
+		return err
+	}
+	return tx.Model(logmodel.SystemLog{}).Create(&logmodel.SystemLog{
+		Type:      logmodel.TypeCommission.Uint8(),
+		Date:      time.Now().Format(time.DateOnly),
+		ObjectID:  objectID,
+		Content:   string(content),
+		CreatedAt: time.Now(),
+	}).Error
+}

internal/logic/lottery/handler/vpn_duration.go

@@ -16,7 +16,6 @@ import (
 	"fmt"
 	"time"
 
-	commonLogic "github.com/perfect-panel/server/internal/logic/common"
 	"github.com/perfect-panel/server/internal/model/lottery"
 	usermodel "github.com/perfect-panel/server/internal/model/user"
 	"gorm.io/gorm"
@@ -45,19 +44,33 @@ type VPNDurationDeps struct {
 	ResolveEffectiveUser func(ctx context.Context, userID int64) (int64, error)
 }
 
-// DefaultResolveEffectiveUser 是生产环境的家庭组归位实现：走
-// commonLogic.ResolveEntitlementUser。用 struct 依赖注入避免 handler 直接依赖
-// 具体 SQL —— 测试里 stub 掉。
+// DefaultResolveEffectiveUser 是生产环境的家庭组归位实现。语义与
+// internal/logic/common.ResolveEntitlementUser 一致（活跃家庭成员 → owner），
+// 但直接在 handler 包内做 JOIN 查询以避免 internal/svc → internal/logic/common
+// 的 import cycle（common 包里有别的文件反向 import 了 svc）。
 func DefaultResolveEffectiveUser(db *gorm.DB) func(ctx context.Context, userID int64) (int64, error) {
 	return func(ctx context.Context, userID int64) (int64, error) {
-		entitlement, err := commonLogic.ResolveEntitlementUser(ctx, db, userID)
-		if err != nil {
-			return 0, err
-		}
-		if entitlement == nil || entitlement.EffectiveUserID <= 0 {
+		if userID <= 0 {
 			return userID, nil
 		}
-		return entitlement.EffectiveUserID, nil
+		var row struct {
+			OwnerUserID int64 `gorm:"column:owner_user_id"`
+		}
+		q := db.WithContext(ctx).
+			Table("user_family_member").
+			Select("user_family.owner_user_id AS owner_user_id").
+			Joins("JOIN user_family ON user_family.id = user_family_member.family_id AND user_family.deleted_at IS NULL").
+			Where("user_family_member.user_id = ? AND user_family_member.deleted_at IS NULL AND user_family_member.status = ?", userID, usermodel.FamilyMemberActive).
+			Order("user_family_member.role").
+			Limit(1).
+			Scan(&row)
+		if q.Error != nil {
+			return 0, q.Error
+		}
+		if q.RowsAffected == 0 || row.OwnerUserID <= 0 {
+			return userID, nil
+		}
+		return row.OwnerUserID, nil
 	}
 }