feat: 新增翻牌顺序追踪并重构翻牌/邀请码逻辑到 Manager，更新前端

- 在 CardFlipStatusOutput 与前端 types 添加 FlipOrderIndex 字段以记录牌在翻牌顺序中的位置
- 在域实体 CardFlipTaskAggregateRoot 增加 FlippedOrder（Json 列）以保存用户实际翻牌顺序
- 将 CardFlipService 重构为调用 CardFlipManager 与 InviteCodeManager，移除大量内聚的业务实现与常量（职责下沉到 Manager）
- 调整翻牌、使用邀请码和查询相关流程为 Manager 驱动，更新返回结构与提示文本
- 更新前端 CardFlipActivity 组件与 types，允许任意未翻的卡片被点击并显示翻牌顺序位置
- 若干文案、格式与日志细节修正

.claude/settings.local.json

@@ -0,0 +1,9 @@
+{
+  "permissions": {
+    "allow": [
+      "WebFetch(domain:www.donet5.com)"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}

Yi.Abp.Net8/.claude/settings.local.json

@@ -0,0 +1,9 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(dotnet build \"E:\\code\\github\\Yi\\Yi.Abp.Net8\\module\\ai-hub\\Yi.Framework.AiHub.Application\\Yi.Framework.AiHub.Application.csproj\" --no-restore)"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}

Yi.Abp.Net8/module/ai-hub/Yi.Framework.AiHub.Application.Contracts/Dtos/CardFlip/CardFlipStatusOutput.cs

@@ -85,4 +85,9 @@ public class CardFlipRecord
     /// 翻牌类型描述
     /// </summary>
     public string? FlipTypeDesc { get; set; }
+
+    /// <summary>
+    /// 在翻牌顺序中的位置（1-10，表示第几个翻）
+    /// </summary>
+    public int FlipOrderIndex { get; set; }
 }

Yi.Abp.Net8/module/ai-hub/Yi.Framework.AiHub.Application/Services/CardFlipService.cs

@@ -1,52 +1,35 @@
 using Microsoft.AspNetCore.Authorization;
 using Microsoft.Extensions.Logging;
-using SqlSugar;
 using Volo.Abp.Application.Services;
 using Volo.Abp.Users;
 using Yi.Framework.AiHub.Application.Contracts.Dtos.CardFlip;
 using Yi.Framework.AiHub.Application.Contracts.IServices;
 using Yi.Framework.AiHub.Domain.Entities;
 using Yi.Framework.AiHub.Domain.Extensions;
+using Yi.Framework.AiHub.Domain.Managers;
 using Yi.Framework.SqlSugarCore.Abstractions;
 
 namespace Yi.Framework.AiHub.Application.Services;
 
 /// <summary>
-/// 翻牌服务
+/// 翻牌服务 - 应用层组合服务
 /// </summary>
 [Authorize]
 public class CardFlipService : ApplicationService, ICardFlipService
 {
-    private readonly ISqlSugarRepository<CardFlipTaskAggregateRoot> _cardFlipTaskRepository;
+    private readonly CardFlipManager _cardFlipManager;
-    private readonly ISqlSugarRepository<InviteCodeAggregateRoot> _inviteCodeRepository;
+    private readonly InviteCodeManager _inviteCodeManager;
-    private readonly ISqlSugarRepository<InvitationRecordAggregateRoot> _invitationRecordRepository;
     private readonly ISqlSugarRepository<PremiumPackageAggregateRoot> _premiumPackageRepository;
     private readonly ILogger<CardFlipService> _logger;
 
-    // 翻牌规则配置
-    private const int MAX_FREE_FLIPS = 5;        // 免费翻牌次数
-    private const int MAX_BONUS_FLIPS = 3;       // 赠送翻牌次数
-    private const int MAX_INVITE_FLIPS = 2;      // 邀请解锁翻牌次数
-    private const int TOTAL_MAX_FLIPS = 10;      // 总最大翻牌次数
-
-    private const int NINTH_FLIP = 9;            // 第9次翻牌
-    private const int TENTH_FLIP = 10;           // 第10次翻牌
-
-    private const long NINTH_MIN_REWARD = 3000000;   // 第9次最小奖励 300w
-    private const long NINTH_MAX_REWARD = 7000000;   // 第9次最大奖励 700w
-    private const long TENTH_MIN_REWARD = 8000000;   // 第10次最小奖励 800w
-    private const long TENTH_MAX_REWARD = 12000000;  // 第10次最大奖励 1200w
-
     public CardFlipService(
-        ISqlSugarRepository<CardFlipTaskAggregateRoot> cardFlipTaskRepository,
+        CardFlipManager cardFlipManager,
-        ISqlSugarRepository<InviteCodeAggregateRoot> inviteCodeRepository,
+        InviteCodeManager inviteCodeManager,
-        ISqlSugarRepository<InvitationRecordAggregateRoot> invitationRecordRepository,
         ISqlSugarRepository<PremiumPackageAggregateRoot> premiumPackageRepository,
         ILogger<CardFlipService> logger)
     {
-        _cardFlipTaskRepository = cardFlipTaskRepository;
+        _cardFlipManager = cardFlipManager;
-        _inviteCodeRepository = inviteCodeRepository;
+        _inviteCodeManager = inviteCodeManager;
-        _invitationRecordRepository = invitationRecordRepository;
         _premiumPackageRepository = premiumPackageRepository;
         _logger = logger;
     }
@@ -57,32 +40,27 @@ public class CardFlipService : ApplicationService, ICardFlipService
     public async Task<CardFlipStatusOutput> GetWeeklyTaskStatusAsync()
     {
         var userId = CurrentUser.GetId();
-        var weekStart = GetWeekStartDate(DateTime.Now);
+        var weekStart = CardFlipManager.GetWeekStartDate(DateTime.Now);
 
-        // 获取或创建本周任务
+        // 获取本周任务
-        var task = await GetOrCreateWeeklyTaskAsync(userId, weekStart, createIfNotExists: false);
+        var task = await _cardFlipManager.GetOrCreateWeeklyTaskAsync(userId, weekStart, createIfNotExists: false);
 
         // 获取邀请码信息
-        var inviteCode = await _inviteCodeRepository._DbQueryable
+        var inviteCode = await _inviteCodeManager.GetUserInviteCodeAsync(userId);
-            .Where(x => x.UserId == userId)
-            .FirstAsync();
 
         // 统计本周邀请人数
-        var invitedCount = await _invitationRecordRepository._DbQueryable
+        var invitedCount = await _inviteCodeManager.GetWeeklyInvitationCountAsync(userId, weekStart);
-            .Where(x => x.InviterId == userId)
-            .Where(x => x.InvitationTime >= weekStart)
-            .CountAsync();
 
         // 检查用户是否已被邀请
-        var isInvited = inviteCode?.IsUserInvited ?? false;
+        var isInvited = await _inviteCodeManager.IsUserInvitedAsync(userId);
 
         var output = new CardFlipStatusOutput
         {
             TotalFlips = task?.TotalFlips ?? 0,
-            RemainingFreeFlips = MAX_FREE_FLIPS - (task?.FreeFlipsUsed ?? 0),
+            RemainingFreeFlips = CardFlipManager.MAX_FREE_FLIPS - (task?.FreeFlipsUsed ?? 0),
-            RemainingBonusFlips = MAX_BONUS_FLIPS - (task?.BonusFlipsUsed ?? 0),
+            RemainingBonusFlips = CardFlipManager.MAX_BONUS_FLIPS - (task?.BonusFlipsUsed ?? 0),
-            RemainingInviteFlips = MAX_INVITE_FLIPS - (task?.InviteFlipsUsed ?? 0),
+            RemainingInviteFlips = CardFlipManager.MAX_INVITE_FLIPS - (task?.InviteFlipsUsed ?? 0),
-            CanFlip = CanFlipCard(task),
+            CanFlip = _cardFlipManager.CanFlipCard(task),
             MyInviteCode = inviteCode?.Code,
             InvitedCount = invitedCount,
             IsInvited = isInvited,
@@ -101,90 +79,28 @@ public class CardFlipService : ApplicationService, ICardFlipService
     public async Task<FlipCardOutput> FlipCardAsync(FlipCardInput input)
     {
         var userId = CurrentUser.GetId();
-        var weekStart = GetWeekStartDate(DateTime.Now);
+        var weekStart = CardFlipManager.GetWeekStartDate(DateTime.Now);
 
-        if (input.FlipNumber < 1 || input.FlipNumber > TOTAL_MAX_FLIPS)
+        // 执行翻牌逻辑(由Manager处理验证和翻牌)
+        var result = await _cardFlipManager.ExecuteFlipAsync(userId, input.FlipNumber, weekStart);
+
+        // 如果中奖,发放奖励
+        if (result.IsWin)
         {
-            throw new UserFriendlyException($"翻牌序号必须在1-{TOTAL_MAX_FLIPS}之间");
+            await GrantRewardAsync(userId, result.RewardAmount, $"翻牌活动第{input.FlipNumber}次中奖");
         }
 
-        // 获取或创建本周任务
+        // 构建输出
-        var task = await GetOrCreateWeeklyTaskAsync(userId, weekStart, createIfNotExists: true);
-
-        // 验证翻牌次数
-        if (task.TotalFlips >= TOTAL_MAX_FLIPS)
-        {
-            throw new UserFriendlyException("本周翻牌次数已用完，请下周再来！");
-        }
-
-        // 验证顺序翻牌
-        if (input.FlipNumber != task.TotalFlips + 1)
-        {
-            throw new UserFriendlyException("请按顺序翻牌！");
-        }
-
-        // 判断翻牌类型
-        var flipType = DetermineFlipType(task);
-
-        // 验证是否有足够的次数
-        if (!CanUseFlipType(task, flipType))
-        {
-            throw new UserFriendlyException(GetFlipTypeErrorMessage(flipType));
-        }
-
-        // 翻牌逻辑
         var output = new FlipCardOutput
         {
-            FlipNumber = input.FlipNumber,
+            FlipNumber = result.FlipNumber,
-            IsWin = false,
+            IsWin = result.IsWin,
-            ShowDoubleRewardTip = false
+            RewardAmount = result.RewardAmount,
+            RewardDesc = result.RewardDesc,
+            ShowDoubleRewardTip = result.ShowDoubleRewardTip,
+            RemainingFlips = CardFlipManager.TOTAL_MAX_FLIPS - input.FlipNumber
         };
 
-        // 前8次固定失败
-        if (input.FlipNumber <= 8)
-        {
-            output.IsWin = false;
-            output.RewardDesc = "很遗憾，未中奖";
-        }
-        // 第9次中奖
-        else if (input.FlipNumber == NINTH_FLIP)
-        {
-            var rewardAmount = GenerateRandomReward(NINTH_MIN_REWARD, NINTH_MAX_REWARD);
-            output.IsWin = true;
-            output.RewardAmount = rewardAmount;
-            output.RewardDesc = $"恭喜获得尊享包 {rewardAmount / 10000}w tokens！";
-            output.ShowDoubleRewardTip = true; // 显示翻倍包提示
-
-            // 发放奖励
-            await GrantRewardAsync(userId, rewardAmount, $"翻牌活动第{input.FlipNumber}次中奖");
-
-            // 记录奖励
-            task.SetNinthReward(rewardAmount);
-        }
-        // 第10次中奖（翻倍）
-        else if (input.FlipNumber == TENTH_FLIP)
-        {
-            var rewardAmount = GenerateRandomReward(TENTH_MIN_REWARD, TENTH_MAX_REWARD);
-            output.IsWin = true;
-            output.RewardAmount = rewardAmount;
-            output.RewardDesc = $"恭喜获得尊享包 {rewardAmount / 10000}w tokens（翻倍奖励）！";
-
-            // 发放奖励
-            await GrantRewardAsync(userId, rewardAmount, $"翻牌活动第{input.FlipNumber}次中奖（翻倍）");
-
-            // 记录奖励
-            task.SetTenthReward(rewardAmount);
-        }
-
-        // 更新翻牌次数
-        task.IncrementFlip(flipType);
-        await _cardFlipTaskRepository.UpdateAsync(task);
-
-        // 计算剩余次数
-        output.RemainingFlips = TOTAL_MAX_FLIPS - task.TotalFlips;
-
-        _logger.LogInformation($"用户 {userId} 完成第 {input.FlipNumber} 次翻牌，中奖：{output.IsWin}");
-
         return output;
     }
 
@@ -194,85 +110,21 @@ public class CardFlipService : ApplicationService, ICardFlipService
     public async Task UseInviteCodeAsync(UseInviteCodeInput input)
     {
         var userId = CurrentUser.GetId();
-        var weekStart = GetWeekStartDate(DateTime.Now);
+        var weekStart = CardFlipManager.GetWeekStartDate(DateTime.Now);
-
-        if (string.IsNullOrWhiteSpace(input.InviteCode))
-        {
-            throw new UserFriendlyException("邀请码不能为空");
-        }
-
-        // 查找邀请码
-        var inviteCode = await _inviteCodeRepository._DbQueryable
-            .Where(x => x.Code == input.InviteCode)
-            .FirstAsync();
-
-        if (inviteCode == null)
-        {
-            throw new UserFriendlyException("邀请码不存在");
-        }
-
-        // 验证不能使用自己的邀请码
-        if (inviteCode.UserId == userId)
-        {
-            throw new UserFriendlyException("不能使用自己的邀请码");
-        }
-
-        // 验证邀请码是否已被使用
-        if (inviteCode.IsUsed)
-        {
-            throw new UserFriendlyException("该邀请码已被使用");
-        }
-
-        // 验证邀请码拥有者是否已被邀请
-        if (inviteCode.IsUserInvited)
-        {
-            throw new UserFriendlyException("该用户已被邀请，邀请码无效");
-        }
-
-        // 检查当前用户是否已被邀请
-        var myInviteCode = await _inviteCodeRepository._DbQueryable
-            .Where(x => x.UserId == userId)
-            .FirstAsync();
-
-        if (myInviteCode?.IsUserInvited == true)
-        {
-            throw new UserFriendlyException("您已使用过邀请码，无法重复使用");
-        }
 
         // 获取本周任务
-        var task = await GetOrCreateWeeklyTaskAsync(userId, weekStart, createIfNotExists: true);
+        var task = await _cardFlipManager.GetOrCreateWeeklyTaskAsync(userId, weekStart, createIfNotExists: true);
 
         // 验证是否已经使用了所有邀请解锁次数
-        if (task.InviteFlipsUsed >= MAX_INVITE_FLIPS)
+        if (task.InviteFlipsUsed >= CardFlipManager.MAX_INVITE_FLIPS)
         {
             throw new UserFriendlyException("本周邀请解锁次数已用完");
         }
 
-        // 标记邀请码为已使用
+        // 使用邀请码(由Manager处理验证和邀请逻辑)
-        inviteCode.MarkAsUsed(userId);
+        await _inviteCodeManager.UseInviteCodeAsync(userId, input.InviteCode);
-        await _inviteCodeRepository.UpdateAsync(inviteCode);
 
-        // 标记当前用户已被邀请
+        _logger.LogInformation($"用户 {userId} 使用邀请码 {input.InviteCode} 解锁翻牌次数成功");
-        if (myInviteCode == null)
-        {
-            myInviteCode = new InviteCodeAggregateRoot(userId, GenerateInviteCode());
-            myInviteCode.MarkUserAsInvited();
-            await _inviteCodeRepository.InsertAsync(myInviteCode);
-        }
-        else
-        {
-            myInviteCode.MarkUserAsInvited();
-            await _inviteCodeRepository.UpdateAsync(myInviteCode);
-        }
-
-        // 创建邀请记录
-        var invitationRecord = new InvitationRecordAggregateRoot(
-            inviteCode.UserId,
-            userId,
-            input.InviteCode);
-        await _invitationRecordRepository.InsertAsync(invitationRecord);
-
-        _logger.LogInformation($"用户 {userId} 使用邀请码 {input.InviteCode} 成功");
     }
 
     /// <summary>
@@ -281,38 +133,28 @@ public class CardFlipService : ApplicationService, ICardFlipService
     public async Task<InviteCodeOutput> GetMyInviteCodeAsync()
     {
         var userId = CurrentUser.GetId();
-        var weekStart = GetWeekStartDate(DateTime.Now);
+        var weekStart = CardFlipManager.GetWeekStartDate(DateTime.Now);
 
         // 获取我的邀请码
-        var inviteCode = await _inviteCodeRepository._DbQueryable
+        var inviteCode = await _inviteCodeManager.GetUserInviteCodeAsync(userId);
-            .Where(x => x.UserId == userId)
-            .FirstAsync();
 
         // 统计本周邀请人数
-        var invitedCount = await _invitationRecordRepository._DbQueryable
+        var invitedCount = await _inviteCodeManager.GetWeeklyInvitationCountAsync(userId, weekStart);
-            .Where(x => x.InviterId == userId)
-            .Where(x => x.InvitationTime >= weekStart)
-            .CountAsync();
 
         // 获取邀请历史
-        var invitationHistory = await _invitationRecordRepository._DbQueryable
+        var invitationHistory = await _inviteCodeManager.GetInvitationHistoryAsync(userId, 10);
-            .Where(x => x.InviterId == userId)
-            .OrderBy(x => x.InvitationTime, OrderByType.Desc)
-            .Take(10)
-            .Select(x => new InvitationHistoryItem
-            {
-                InvitedUserName = "用户***", // 脱敏处理
-                InvitationTime = x.InvitationTime,
-                WeekDescription = GetWeekDescription(x.InvitationTime)
-            })
-            .ToListAsync();
 
         return new InviteCodeOutput
         {
             MyInviteCode = inviteCode?.Code,
             InvitedCount = invitedCount,
             IsInvited = inviteCode?.IsUserInvited ?? false,
-            InvitationHistory = invitationHistory
+            InvitationHistory = invitationHistory.Select(x => new InvitationHistoryItem
+            {
+                InvitedUserName = x.InvitedUserName,
+                InvitationTime = x.InvitationTime,
+                WeekDescription = GetWeekDescription(x.InvitationTime)
+            }).ToList()
         };
     }
 
@@ -323,120 +165,14 @@ public class CardFlipService : ApplicationService, ICardFlipService
     {
         var userId = CurrentUser.GetId();
 
-        // 检查是否已有邀请码
+        // 生成邀请码(由Manager处理)
-        var existingCode = await _inviteCodeRepository._DbQueryable
+        var code = await _inviteCodeManager.GenerateInviteCodeForUserAsync(userId);
-            .Where(x => x.UserId == userId)
-            .FirstAsync();
-
-        if (existingCode != null)
-        {
-            return existingCode.Code;
-        }
-
-        // 生成新邀请码
-        var code = GenerateInviteCode();
-        var inviteCode = new InviteCodeAggregateRoot(userId, code);
-        await _inviteCodeRepository.InsertAsync(inviteCode);
-
-        _logger.LogInformation($"用户 {userId} 生成邀请码 {code}");
 
         return code;
     }
 
     #region 私有辅助方法
 
-    /// <summary>
-    /// 获取或创建本周任务
-    /// </summary>
-    private async Task<CardFlipTaskAggregateRoot> GetOrCreateWeeklyTaskAsync(
-        Guid userId,
-        DateTime weekStart,
-        bool createIfNotExists)
-    {
-        var task = await _cardFlipTaskRepository._DbQueryable
-            .Where(x => x.UserId == userId && x.WeekStartDate == weekStart)
-            .FirstAsync();
-
-        if (task == null && createIfNotExists)
-        {
-            task = new CardFlipTaskAggregateRoot(userId, weekStart);
-            await _cardFlipTaskRepository.InsertAsync(task);
-        }
-
-        return task;
-    }
-
-    /// <summary>
-    /// 获取本周开始日期（周一）
-    /// </summary>
-    private DateTime GetWeekStartDate(DateTime date)
-    {
-        var dayOfWeek = (int)date.DayOfWeek;
-        // 将周日(0)转换为7
-        if (dayOfWeek == 0) dayOfWeek = 7;
-
-        // 计算本周一的日期
-        var monday = date.Date.AddDays(-(dayOfWeek - 1));
-        return monday;
-    }
-
-    /// <summary>
-    /// 判断是否可以翻牌
-    /// </summary>
-    private bool CanFlipCard(CardFlipTaskAggregateRoot? task)
-    {
-        if (task == null) return true; // 没有任务记录，可以开始翻牌
-
-        return task.TotalFlips < TOTAL_MAX_FLIPS;
-    }
-
-    /// <summary>
-    /// 判断翻牌类型
-    /// </summary>
-    private FlipType DetermineFlipType(CardFlipTaskAggregateRoot task)
-    {
-        if (task.FreeFlipsUsed < MAX_FREE_FLIPS)
-        {
-            return FlipType.Free;
-        }
-        else if (task.BonusFlipsUsed < MAX_BONUS_FLIPS)
-        {
-            return FlipType.Bonus;
-        }
-        else
-        {
-            return FlipType.Invite;
-        }
-    }
-
-    /// <summary>
-    /// 判断是否可以使用该翻牌类型
-    /// </summary>
-    private bool CanUseFlipType(CardFlipTaskAggregateRoot task, FlipType flipType)
-    {
-        return flipType switch
-        {
-            FlipType.Free => task.FreeFlipsUsed < MAX_FREE_FLIPS,
-            FlipType.Bonus => task.BonusFlipsUsed < MAX_BONUS_FLIPS,
-            FlipType.Invite => task.InviteFlipsUsed < MAX_INVITE_FLIPS,
-            _ => false
-        };
-    }
-
-    /// <summary>
-    /// 获取翻牌类型错误提示
-    /// </summary>
-    private string GetFlipTypeErrorMessage(FlipType flipType)
-    {
-        return flipType switch
-        {
-            FlipType.Free => "免费翻牌次数已用完",
-            FlipType.Bonus => "赠送翻牌次数已用完",
-            FlipType.Invite => "需要使用邀请码解锁更多次数",
-            _ => "无法翻牌"
-        };
-    }
-
     /// <summary>
     /// 构建翻牌记录列表
     /// </summary>
@@ -444,25 +180,32 @@ public class CardFlipService : ApplicationService, ICardFlipService
     {
         var records = new List<CardFlipRecord>();
 
-        for (int i = 1; i <= TOTAL_MAX_FLIPS; i++)
+        // 获取已翻牌的顺序
+        var flippedOrder = task != null ? _cardFlipManager.GetFlippedOrder(task) : new List<int>();
+        var flippedNumbers = new HashSet<int>(flippedOrder);
+
+        // 构建记录，按照原始序号1-10排列
+        for (int i = 1; i <= CardFlipManager.TOTAL_MAX_FLIPS; i++)
         {
             var record = new CardFlipRecord
             {
                 FlipNumber = i,
-                IsFlipped = task != null && i <= task.TotalFlips,
+                IsFlipped = flippedNumbers.Contains(i),
                 IsWin = false,
-                FlipTypeDesc = GetFlipTypeDesc(i)
+                FlipTypeDesc = CardFlipManager.GetFlipTypeDesc(i),
+                // 设置在翻牌顺序中的位置（0表示未翻，>0表示第几个翻的）
+                FlipOrderIndex = flippedOrder.IndexOf(i) >= 0 ? flippedOrder.IndexOf(i) + 1 : 0
             };
 
             // 设置中奖信息
-            if (task != null && i <= task.TotalFlips)
+            if (task != null && flippedNumbers.Contains(i))
             {
-                if (i == NINTH_FLIP && task.HasNinthReward)
+                if (i == 9 && task.HasNinthReward)
                 {
                     record.IsWin = true;
                     record.RewardAmount = task.NinthRewardAmount;
                 }
-                else if (i == TENTH_FLIP && task.HasTenthReward)
+                else if (i == 10 && task.HasTenthReward)
                 {
                     record.IsWin = true;
                     record.RewardAmount = task.TenthRewardAmount;
@@ -475,33 +218,14 @@ public class CardFlipService : ApplicationService, ICardFlipService
         return records;
     }
 
-    /// <summary>
-    /// 获取翻牌类型描述
-    /// </summary>
-    private string GetFlipTypeDesc(int flipNumber)
-    {
-        if (flipNumber <= MAX_FREE_FLIPS)
-        {
-            return "免费";
-        }
-        else if (flipNumber <= MAX_FREE_FLIPS + MAX_BONUS_FLIPS)
-        {
-            return "赠送";
-        }
-        else
-        {
-            return "邀请解锁";
-        }
-    }
-
     /// <summary>
     /// 生成下次翻牌提示
     /// </summary>
     private string GenerateNextFlipTip(CardFlipStatusOutput status)
     {
-        if (status.TotalFlips >= TOTAL_MAX_FLIPS)
+        if (status.TotalFlips >= CardFlipManager.TOTAL_MAX_FLIPS)
         {
-            return "本周翻牌次数已用完，请下周再来！";
+            return "本周翻牌次数已用完,请下周再来!";
         }
 
         if (status.RemainingFreeFlips > 0)
@@ -516,21 +240,13 @@ public class CardFlipService : ApplicationService, ICardFlipService
         {
             if (status.TotalFlips == 8)
             {
-                return "再邀请一个人，马上中奖！";
+                return "再邀请一个人,马上中奖!";
             }
+
             return $"使用邀请码可解锁{status.RemainingInviteFlips}次翻牌";
         }
 
-        return "继续加油！";
+        return "继续加油!";
-    }
-
-    /// <summary>
-    /// 生成随机奖励金额
-    /// </summary>
-    private long GenerateRandomReward(long min, long max)
-    {
-        var random = new Random();
-        return (long)(random.NextDouble() * (max - min) + min);
     }
 
     /// <summary>
@@ -541,7 +257,7 @@ public class CardFlipService : ApplicationService, ICardFlipService
         var premiumPackage = new PremiumPackageAggregateRoot(userId, amount, description)
         {
             PurchaseAmount = 0, // 奖励不需要付费
-            Remark = $"翻牌活动奖励：{amount / 10000}w tokens"
+            Remark = $"翻牌活动奖励:{amount / 10000}w tokens"
         };
 
         await _premiumPackageRepository.InsertAsync(premiumPackage);
@@ -549,33 +265,16 @@ public class CardFlipService : ApplicationService, ICardFlipService
         _logger.LogInformation($"用户 {userId} 获得翻牌奖励 {amount / 10000}w tokens");
     }
 
-    /// <summary>
-    /// 生成邀请码
-    /// </summary>
-    private string GenerateInviteCode()
-    {
-        const string chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789";
-        var random = new Random();
-        var code = new char[8];
-
-        for (int i = 0; i < code.Length; i++)
-        {
-            code[i] = chars[random.Next(chars.Length)];
-        }
-
-        return new string(code);
-    }
-
     /// <summary>
     /// 获取周描述
     /// </summary>
     private string GetWeekDescription(DateTime date)
     {
-        var weekStart = GetWeekStartDate(date);
+        var weekStart = CardFlipManager.GetWeekStartDate(date);
         var weekEnd = weekStart.AddDays(6);
 
         return $"{weekStart:MM-dd} 至 {weekEnd:MM-dd}";
     }
 
     #endregion
-}
+}

Yi.Abp.Net8/module/ai-hub/Yi.Framework.AiHub.Domain/Entities/CardFlipTaskAggregateRoot.cs

@@ -27,6 +27,7 @@ public class CardFlipTaskAggregateRoot : FullAuditedAggregateRoot<Guid>
         IsFirstFlipDone = false;
         HasNinthReward = false;
         HasTenthReward = false;
+        FlippedOrder = new List<int>();
     }
 
     /// <summary>
@@ -90,6 +91,12 @@ public class CardFlipTaskAggregateRoot : FullAuditedAggregateRoot<Guid>
     [SugarColumn(Length = 500, IsNullable = true)]
     public string? Remark { get; set; }
 
+    /// <summary>
+    /// 已翻牌的顺序（存储用户实际翻牌的序号列表，如[3,7,1,5]表示依次翻了3号、7号、1号、5号牌）
+    /// </summary>
+    [SugarColumn(IsJson = true, IsNullable = true)]
+    public List<int>? FlippedOrder { get; set; }
+
     /// <summary>
     /// 增加翻牌次数
     /// </summary>

Yi.Abp.Net8/module/ai-hub/Yi.Framework.AiHub.Domain/Managers/CardFlipManager.cs

@@ -0,0 +1,308 @@
+using Microsoft.Extensions.Logging;
+using Volo.Abp.Domain.Services;
+using Yi.Framework.AiHub.Domain.Entities;
+using Yi.Framework.SqlSugarCore.Abstractions;
+
+namespace Yi.Framework.AiHub.Domain.Managers;
+
+/// <summary>
+/// 翻牌管理器 - 负责翻牌核心业务逻辑
+/// </summary>
+public class CardFlipManager : DomainService
+{
+    private readonly ISqlSugarRepository<CardFlipTaskAggregateRoot> _cardFlipTaskRepository;
+    private readonly ILogger<CardFlipManager> _logger;
+
+    // 翻牌规则配置
+    public const int MAX_FREE_FLIPS = 5;        // 免费翻牌次数
+    public const int MAX_BONUS_FLIPS = 3;       // 赠送翻牌次数
+    public const int MAX_INVITE_FLIPS = 2;      // 邀请解锁翻牌次数
+    public const int TOTAL_MAX_FLIPS = 10;      // 总最大翻牌次数
+
+    private const int NINTH_FLIP = 9;            // 第9次翻牌
+    private const int TENTH_FLIP = 10;           // 第10次翻牌
+
+    private const long NINTH_MIN_REWARD = 3000000;   // 第9次最小奖励 300w
+    private const long NINTH_MAX_REWARD = 7000000;   // 第9次最大奖励 700w
+    private const long TENTH_MIN_REWARD = 8000000;   // 第10次最小奖励 800w
+    private const long TENTH_MAX_REWARD = 12000000;  // 第10次最大奖励 1200w
+
+    public CardFlipManager(
+        ISqlSugarRepository<CardFlipTaskAggregateRoot> cardFlipTaskRepository,
+        ILogger<CardFlipManager> logger)
+    {
+        _cardFlipTaskRepository = cardFlipTaskRepository;
+        _logger = logger;
+    }
+
+    /// <summary>
+    /// 获取或创建本周任务
+    /// </summary>
+    public async Task<CardFlipTaskAggregateRoot?> GetOrCreateWeeklyTaskAsync(
+        Guid userId,
+        DateTime weekStart,
+        bool createIfNotExists)
+    {
+        var task = await _cardFlipTaskRepository._DbQueryable
+            .Where(x => x.UserId == userId && x.WeekStartDate == weekStart)
+            .FirstAsync();
+
+        if (task == null && createIfNotExists)
+        {
+            task = new CardFlipTaskAggregateRoot(userId, weekStart);
+            await _cardFlipTaskRepository.InsertAsync(task);
+        }
+
+        return task;
+    }
+
+    /// <summary>
+    /// 获取已翻牌的顺序列表
+    /// </summary>
+    public List<int> GetFlippedOrder(CardFlipTaskAggregateRoot task)
+    {
+        return task.FlippedOrder ?? new List<int>();
+    }
+
+    /// <summary>
+    /// 执行翻牌逻辑
+    /// </summary>
+    /// <param name="userId">用户ID</param>
+    /// <param name="flipNumber">翻牌序号</param>
+    /// <param name="weekStart">本周开始日期</param>
+    /// <returns>翻牌结果</returns>
+    public async Task<FlipResult> ExecuteFlipAsync(Guid userId, int flipNumber, DateTime weekStart)
+    {
+        // 验证翻牌序号
+        if (flipNumber < 1 || flipNumber > TOTAL_MAX_FLIPS)
+        {
+            throw new UserFriendlyException($"翻牌序号必须在1-{TOTAL_MAX_FLIPS}之间");
+        }
+
+        // 获取或创建本周任务
+        var task = await GetOrCreateWeeklyTaskAsync(userId, weekStart, createIfNotExists: true);
+
+        // 验证翻牌次数
+        if (task.TotalFlips >= TOTAL_MAX_FLIPS)
+        {
+            throw new UserFriendlyException("本周翻牌次数已用完,请下周再来!");
+        }
+
+        // 验证该牌是否已经翻过
+        var flippedOrder = GetFlippedOrder(task);
+        if (flippedOrder.Contains(flipNumber))
+        {
+            throw new UserFriendlyException($"第 {flipNumber} 号牌已经翻过了!");
+        }
+
+        // 判断翻牌类型
+        var flipType = DetermineFlipType(task);
+
+        // 验证是否有足够的次数
+        if (!CanUseFlipType(task, flipType))
+        {
+            throw new UserFriendlyException(GetFlipTypeErrorMessage(flipType));
+        }
+
+        // 计算翻牌结果
+        var result = CalculateFlipResult(flipNumber);
+
+        // 记录奖励
+        if (result.IsWin)
+        {
+            if (flipNumber == NINTH_FLIP)
+            {
+                task.SetNinthReward(result.RewardAmount);
+            }
+            else if (flipNumber == TENTH_FLIP)
+            {
+                task.SetTenthReward(result.RewardAmount);
+            }
+        }
+
+        // 更新翻牌次数
+        task.IncrementFlip(flipType);
+
+        // 记录翻牌顺序
+        if (task.FlippedOrder == null)
+        {
+            task.FlippedOrder = new List<int>();
+        }
+        task.FlippedOrder.Add(flipNumber);
+
+        await _cardFlipTaskRepository.UpdateAsync(task);
+
+        _logger.LogInformation($"用户 {userId} 完成第 {flipNumber} 次翻牌,中奖:{result.IsWin}");
+
+        return result;
+    }
+
+    /// <summary>
+    /// 判断是否可以翻牌
+    /// </summary>
+    public bool CanFlipCard(CardFlipTaskAggregateRoot? task)
+    {
+        if (task == null) return true; // 没有任务记录,可以开始翻牌
+
+        return task.TotalFlips < TOTAL_MAX_FLIPS;
+    }
+
+    /// <summary>
+    /// 判断翻牌类型
+    /// </summary>
+    public FlipType DetermineFlipType(CardFlipTaskAggregateRoot task)
+    {
+        if (task.FreeFlipsUsed < MAX_FREE_FLIPS)
+        {
+            return FlipType.Free;
+        }
+        else if (task.BonusFlipsUsed < MAX_BONUS_FLIPS)
+        {
+            return FlipType.Bonus;
+        }
+        else
+        {
+            return FlipType.Invite;
+        }
+    }
+
+    /// <summary>
+    /// 判断是否可以使用该翻牌类型
+    /// </summary>
+    public bool CanUseFlipType(CardFlipTaskAggregateRoot task, FlipType flipType)
+    {
+        return flipType switch
+        {
+            FlipType.Free => task.FreeFlipsUsed < MAX_FREE_FLIPS,
+            FlipType.Bonus => task.BonusFlipsUsed < MAX_BONUS_FLIPS,
+            FlipType.Invite => task.InviteFlipsUsed < MAX_INVITE_FLIPS,
+            _ => false
+        };
+    }
+
+    /// <summary>
+    /// 计算翻牌结果
+    /// </summary>
+    private FlipResult CalculateFlipResult(int flipNumber)
+    {
+        var result = new FlipResult
+        {
+            FlipNumber = flipNumber,
+            IsWin = false,
+            ShowDoubleRewardTip = false
+        };
+
+        // 前8次固定失败
+        if (flipNumber <= 8)
+        {
+            result.IsWin = false;
+            result.RewardDesc = "很遗憾,未中奖";
+        }
+        // 第9次中奖
+        else if (flipNumber == NINTH_FLIP)
+        {
+            var rewardAmount = GenerateRandomReward(NINTH_MIN_REWARD, NINTH_MAX_REWARD);
+            result.IsWin = true;
+            result.RewardAmount = rewardAmount;
+            result.RewardDesc = $"恭喜获得尊享包 {rewardAmount / 10000}w tokens!";
+            result.ShowDoubleRewardTip = true; // 显示翻倍包提示
+        }
+        // 第10次中奖(翻倍)
+        else if (flipNumber == TENTH_FLIP)
+        {
+            var rewardAmount = GenerateRandomReward(TENTH_MIN_REWARD, TENTH_MAX_REWARD);
+            result.IsWin = true;
+            result.RewardAmount = rewardAmount;
+            result.RewardDesc = $"恭喜获得尊享包 {rewardAmount / 10000}w tokens(翻倍奖励)!";
+        }
+
+        return result;
+    }
+
+    /// <summary>
+    /// 获取翻牌类型错误提示
+    /// </summary>
+    private string GetFlipTypeErrorMessage(FlipType flipType)
+    {
+        return flipType switch
+        {
+            FlipType.Free => "免费翻牌次数已用完",
+            FlipType.Bonus => "赠送翻牌次数已用完",
+            FlipType.Invite => "需要使用邀请码解锁更多次数",
+            _ => "无法翻牌"
+        };
+    }
+
+    /// <summary>
+    /// 生成随机奖励金额
+    /// </summary>
+    private long GenerateRandomReward(long min, long max)
+    {
+        var random = new Random();
+        return (long)(random.NextDouble() * (max - min) + min);
+    }
+
+    /// <summary>
+    /// 获取本周开始日期(周一)
+    /// </summary>
+    public static DateTime GetWeekStartDate(DateTime date)
+    {
+        var dayOfWeek = (int)date.DayOfWeek;
+        // 将周日(0)转换为7
+        if (dayOfWeek == 0) dayOfWeek = 7;
+
+        // 计算本周一的日期
+        var monday = date.Date.AddDays(-(dayOfWeek - 1));
+        return monday;
+    }
+
+    /// <summary>
+    /// 获取翻牌类型描述
+    /// </summary>
+    public static string GetFlipTypeDesc(int flipNumber)
+    {
+        if (flipNumber <= MAX_FREE_FLIPS)
+        {
+            return "免费";
+        }
+        else if (flipNumber <= MAX_FREE_FLIPS + MAX_BONUS_FLIPS)
+        {
+            return "赠送";
+        }
+        else
+        {
+            return "邀请解锁";
+        }
+    }
+}
+
+/// <summary>
+/// 翻牌结果
+/// </summary>
+public class FlipResult
+{
+    /// <summary>
+    /// 翻牌序号
+    /// </summary>
+    public int FlipNumber { get; set; }
+
+    /// <summary>
+    /// 是否中奖
+    /// </summary>
+    public bool IsWin { get; set; }
+
+    /// <summary>
+    /// 奖励金额
+    /// </summary>
+    public long RewardAmount { get; set; }
+
+    /// <summary>
+    /// 奖励描述
+    /// </summary>
+    public string RewardDesc { get; set; } = string.Empty;
+
+    /// <summary>
+    /// 是否显示翻倍奖励提示
+    /// </summary>
+    public bool ShowDoubleRewardTip { get; set; }
+}

Yi.Abp.Net8/module/ai-hub/Yi.Framework.AiHub.Domain/Managers/InviteCodeManager.cs

@@ -0,0 +1,217 @@
+using Microsoft.Extensions.Logging;
+using SqlSugar;
+using Volo.Abp.Domain.Services;
+using Yi.Framework.AiHub.Domain.Entities;
+using Yi.Framework.SqlSugarCore.Abstractions;
+
+namespace Yi.Framework.AiHub.Domain.Managers;
+
+/// <summary>
+/// 邀请码管理器 - 负责邀请码核心业务逻辑
+/// </summary>
+public class InviteCodeManager : DomainService
+{
+    private readonly ISqlSugarRepository<InviteCodeAggregateRoot> _inviteCodeRepository;
+    private readonly ISqlSugarRepository<InvitationRecordAggregateRoot> _invitationRecordRepository;
+    private readonly ILogger<InviteCodeManager> _logger;
+
+    public InviteCodeManager(
+        ISqlSugarRepository<InviteCodeAggregateRoot> inviteCodeRepository,
+        ISqlSugarRepository<InvitationRecordAggregateRoot> invitationRecordRepository,
+        ILogger<InviteCodeManager> logger)
+    {
+        _inviteCodeRepository = inviteCodeRepository;
+        _invitationRecordRepository = invitationRecordRepository;
+        _logger = logger;
+    }
+
+    /// <summary>
+    /// 生成用户的邀请码
+    /// </summary>
+    /// <param name="userId">用户ID</param>
+    /// <returns>邀请码</returns>
+    public async Task<string> GenerateInviteCodeForUserAsync(Guid userId)
+    {
+        // 检查是否已有邀请码
+        var existingCode = await _inviteCodeRepository._DbQueryable
+            .Where(x => x.UserId == userId)
+            .FirstAsync();
+
+        if (existingCode != null)
+        {
+            return existingCode.Code;
+        }
+
+        // 生成新邀请码
+        var code = GenerateUniqueInviteCode();
+        var inviteCode = new InviteCodeAggregateRoot(userId, code);
+        await _inviteCodeRepository.InsertAsync(inviteCode);
+
+        _logger.LogInformation($"用户 {userId} 生成邀请码 {code}");
+
+        return code;
+    }
+
+    /// <summary>
+    /// 获取用户的邀请码信息
+    /// </summary>
+    public async Task<InviteCodeAggregateRoot?> GetUserInviteCodeAsync(Guid userId)
+    {
+        return await _inviteCodeRepository._DbQueryable
+            .Where(x => x.UserId == userId)
+            .FirstAsync();
+    }
+
+    /// <summary>
+    /// 统计用户本周邀请人数
+    /// </summary>
+    public async Task<int> GetWeeklyInvitationCountAsync(Guid userId, DateTime weekStart)
+    {
+        return await _invitationRecordRepository._DbQueryable
+            .Where(x => x.InviterId == userId)
+            .Where(x => x.InvitationTime >= weekStart)
+            .CountAsync();
+    }
+
+    /// <summary>
+    /// 获取邀请历史记录
+    /// </summary>
+    public async Task<List<InvitationHistoryDto>> GetInvitationHistoryAsync(Guid userId, int limit = 10)
+    {
+        return await _invitationRecordRepository._DbQueryable
+            .Where(x => x.InviterId == userId)
+            .OrderBy(x => x.InvitationTime, OrderByType.Desc)
+            .Take(limit)
+            .Select(x => new InvitationHistoryDto
+            {
+                InvitedUserName = "用户***", // 脱敏处理
+                InvitationTime = x.InvitationTime
+            })
+            .ToListAsync();
+    }
+
+    /// <summary>
+    /// 使用邀请码
+    /// </summary>
+    /// <param name="userId">使用者ID</param>
+    /// <param name="inviteCode">邀请码</param>
+    /// <returns>邀请人ID</returns>
+    public async Task<Guid> UseInviteCodeAsync(Guid userId, string inviteCode)
+    {
+        if (string.IsNullOrWhiteSpace(inviteCode))
+        {
+            throw new UserFriendlyException("邀请码不能为空");
+        }
+
+        // 查找邀请码
+        var inviteCodeEntity = await _inviteCodeRepository._DbQueryable
+            .Where(x => x.Code == inviteCode)
+            .FirstAsync();
+
+        if (inviteCodeEntity == null)
+        {
+            throw new UserFriendlyException("邀请码不存在");
+        }
+
+        // 验证不能使用自己的邀请码
+        if (inviteCodeEntity.UserId == userId)
+        {
+            throw new UserFriendlyException("不能使用自己的邀请码");
+        }
+
+        // 验证邀请码是否已被使用
+        if (inviteCodeEntity.IsUsed)
+        {
+            throw new UserFriendlyException("该邀请码已被使用");
+        }
+
+        // 验证邀请码拥有者是否已被邀请
+        if (inviteCodeEntity.IsUserInvited)
+        {
+            throw new UserFriendlyException("该用户已被邀请,邀请码无效");
+        }
+
+        // 检查当前用户是否已被邀请
+        var myInviteCode = await _inviteCodeRepository._DbQueryable
+            .Where(x => x.UserId == userId)
+            .FirstAsync();
+
+        if (myInviteCode?.IsUserInvited == true)
+        {
+            throw new UserFriendlyException("您已使用过邀请码,无法重复使用");
+        }
+
+        // 标记邀请码为已使用
+        inviteCodeEntity.MarkAsUsed(userId);
+        await _inviteCodeRepository.UpdateAsync(inviteCodeEntity);
+
+        // 标记当前用户已被邀请
+        if (myInviteCode == null)
+        {
+            myInviteCode = new InviteCodeAggregateRoot(userId, GenerateUniqueInviteCode());
+            myInviteCode.MarkUserAsInvited();
+            await _inviteCodeRepository.InsertAsync(myInviteCode);
+        }
+        else
+        {
+            myInviteCode.MarkUserAsInvited();
+            await _inviteCodeRepository.UpdateAsync(myInviteCode);
+        }
+
+        // 创建邀请记录
+        var invitationRecord = new InvitationRecordAggregateRoot(
+            inviteCodeEntity.UserId,
+            userId,
+            inviteCode);
+        await _invitationRecordRepository.InsertAsync(invitationRecord);
+
+        _logger.LogInformation($"用户 {userId} 使用邀请码 {inviteCode} 成功");
+
+        return inviteCodeEntity.UserId;
+    }
+
+    /// <summary>
+    /// 检查用户是否已被邀请
+    /// </summary>
+    public async Task<bool> IsUserInvitedAsync(Guid userId)
+    {
+        var inviteCode = await _inviteCodeRepository._DbQueryable
+            .Where(x => x.UserId == userId)
+            .FirstAsync();
+
+        return inviteCode?.IsUserInvited ?? false;
+    }
+
+    /// <summary>
+    /// 生成唯一邀请码
+    /// </summary>
+    private string GenerateUniqueInviteCode()
+    {
+        const string chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789";
+        var random = new Random();
+        var code = new char[8];
+
+        for (int i = 0; i < code.Length; i++)
+        {
+            code[i] = chars[random.Next(chars.Length)];
+        }
+
+        return new string(code);
+    }
+}
+
+/// <summary>
+/// 邀请历史记录DTO
+/// </summary>
+public class InvitationHistoryDto
+{
+    /// <summary>
+    /// 被邀请人名称(脱敏)
+    /// </summary>
+    public string InvitedUserName { get; set; } = string.Empty;
+
+    /// <summary>
+    /// 邀请时间
+    /// </summary>
+    public DateTime InvitationTime { get; set; }
+}

Yi.Ai.Vue3/src/api/cardFlip/types.ts

@@ -19,6 +19,7 @@ export interface CardFlipRecord {
   isWin: boolean; // 是否中奖
   rewardAmount?: number; // 奖励金额（token数）
   flipTypeDesc?: string; // 翻牌类型描述
+  flipOrderIndex: number; // 在翻牌顺序中的位置（1-10，表示第几个翻）
 }
 
 // 翻牌输入

Yi.Ai.Vue3/src/components/userPersonalCenter/components/CardFlipActivity.vue

@@ -35,7 +35,10 @@ async function fetchTaskStatus() {
 
 // 翻牌
 async function handleFlipCard(record: CardFlipRecord) {
-  if (!record.isFlipped && record.flipNumber === (taskData.value?.totalFlips || 0) + 1) {
+  // 检查是否可以翻牌（任何未翻过的牌都可以）
+  const canFlip = !record.isFlipped && (taskData.value?.canFlip || false);
+
+  if (canFlip) {
     // 检查是否需要使用邀请码
     if (record.flipNumber > 8 && (taskData.value?.remainingInviteFlips || 0) > 0) {
       const usedInviteFlips = 2 - (taskData.value?.remainingInviteFlips || 2);
@@ -195,8 +198,8 @@ function getCardClass(record: CardFlipRecord): string[] {
     classes.push('card-flipping');
   }
 
-  // 可点击的卡片
+  // 可点击的卡片（任何未翻过的牌都可以点击）
-  if (!record.isFlipped && record.flipNumber === (taskData.value?.totalFlips || 0) + 1) {
+  if (!record.isFlipped && (taskData.value?.canFlip || false)) {
     classes.push('card-clickable');
   } else if (!record.isFlipped) {
     classes.push('card-locked');