feat: 小程序阅读记录与资料链路、管理端用户规则、API/VIP/推荐与运营脚本

- miniprogram: reading-records、imageUrl/mpNavigate、多页资料与 VIP 展示调整
- soul-admin: Users/Settings/UserDetailModal、dist 构建产物更新
- soul-api: user/vip/referral/ckb/db、MBTI 头像管理、user_rule_completion、迁移 SQL
- .cursor: karuo-party 与飞书文档；.gitignore 忽略 .tmp_skill_bundle

Made-with: Cursor

soul-api/internal/handler/admin_user_rules.go

@@ -37,7 +37,8 @@ func DBUserRulesList(c *gin.Context) {
 	c.JSON(http.StatusOK, gin.H{"success": true, "rules": rules})
 }
 
-// MiniprogramUserRulesGet GET /api/miniprogram/user-rules 小程序规则引擎：返回启用的规则，无需鉴权
+// MiniprogramUserRulesGet GET /api/miniprogram/user-rules?userId=xxx
+// 返回启用的规则，并标记当前用户已完成的规则
 func MiniprogramUserRulesGet(c *gin.Context) {
 	db := database.DB()
 	var rules []model.UserRule
@@ -45,7 +46,43 @@ func MiniprogramUserRulesGet(c *gin.Context) {
 		c.JSON(http.StatusOK, gin.H{"success": false, "error": err.Error()})
 		return
 	}
-	c.JSON(http.StatusOK, gin.H{"success": true, "rules": rules})
+	userId := c.Query("userId")
+	completedSet := make(map[uint]bool)
+	if userId != "" {
+		var completions []model.UserRuleCompletion
+		db.Where("user_id = ?", userId).Find(&completions)
+		for _, comp := range completions {
+			completedSet[comp.RuleID] = true
+		}
+	}
+	out := make([]gin.H, 0, len(rules))
+	for _, r := range rules {
+		out = append(out, gin.H{
+			"id": r.ID, "title": r.Title, "description": r.Description,
+			"trigger": r.Trigger, "sort": r.Sort, "completed": completedSet[r.ID],
+		})
+	}
+	c.JSON(http.StatusOK, gin.H{"success": true, "rules": out})
+}
+
+// MiniprogramUserRuleComplete POST /api/miniprogram/user-rules/complete
+func MiniprogramUserRuleComplete(c *gin.Context) {
+	var body struct {
+		UserID string `json:"userId" binding:"required"`
+		RuleID uint   `json:"ruleId" binding:"required"`
+	}
+	if err := c.ShouldBindJSON(&body); err != nil {
+		c.JSON(http.StatusBadRequest, gin.H{"success": false, "error": "参数错误"})
+		return
+	}
+	db := database.DB()
+	comp := model.UserRuleCompletion{UserID: body.UserID, RuleID: body.RuleID}
+	result := db.Where("user_id = ? AND rule_id = ?", body.UserID, body.RuleID).FirstOrCreate(&comp)
+	if result.Error != nil {
+		c.JSON(http.StatusOK, gin.H{"success": false, "error": result.Error.Error()})
+		return
+	}
+	c.JSON(http.StatusOK, gin.H{"success": true, "alreadyCompleted": result.RowsAffected == 0})
 }
 
 // DBUserRulesAction POST/PUT/DELETE /api/db/user-rules