feat: 新增签到、宠物、期刊绑定、补偿任务等业务模块,优化微信登录流程

本次提交完成了多个核心业务模块的开发与优化:
1.  宠物模块:新增宠物实体、服务接口与实现,支持创建默认宠物、激活、喂养、进化以及喂养记录查询
2.  签到模块:新增签到实体、服务接口、控制器以及相关DTO,支持用户签到和签到信息查询,新增成长值奖励字段
3.  期刊绑定模块:新增用户期刊关联实体、服务接口与控制器,支持扫码绑定期刊、解绑和查询绑定列表
4.  补偿任务模块:新增补偿任务实体、服务接口与实现,用于处理业务失败后的异步重试补偿
5.  优化微信登录流程:拆分登录与快捷登录接口,支持手机号获取,新增首次登录自动创建默认宠物逻辑
6.  调整基础路由与实体状态:修改微信控制器路由前缀,更新宠物状态枚举与默认值
This commit is contained in:
glz
2026-06-04 15:54:30 +08:00
parent 018d7e1733
commit 903ccd3073
25 changed files with 2411 additions and 32 deletions

View File

@ -0,0 +1,24 @@
using QYZH.InteractiveMagazine.Models.Dto.CheckIn;
using QYZH.InteractiveMagazine.Models.Entity;
namespace QYZH.InteractiveMagazine.IService;
/// <summary>
/// 签到服务接口
/// </summary>
public interface ICheckInService : IBaseService<CheckInRecord>
{
/// <summary>
/// 用户签到
/// </summary>
/// <param name="userId">用户Id</param>
/// <returns>签到结果</returns>
Task<CheckInOutput> CheckInAsync(long userId);
/// <summary>
/// 获取用户签到信息(今日状态 + 连续天数 + 最近记录)
/// </summary>
/// <param name="userId">用户Id</param>
/// <returns>签到信息</returns>
Task<CheckInInfoOutput> GetCheckInInfoAsync(long userId);
}

View File

@ -0,0 +1,46 @@
using QYZH.InteractiveMagazine.Models.Dto.Compensation;
using QYZH.InteractiveMagazine.Models.Entity;
namespace QYZH.InteractiveMagazine.IService;
/// <summary>
/// 补偿任务服务接口(仅负责记录和状态管理,处理逻辑由外部项目实现)
/// </summary>
public interface ICompensationTaskService : IBaseService<CompensationTask>
{
/// <summary>
/// 创建补偿任务(公共调用入口)
/// 当业务操作部分成功但某个后续步骤失败时调用,记录失败操作以便后续重试
/// </summary>
/// <param name="input">补偿任务创建参数</param>
/// <returns>补偿任务Id</returns>
Task<long> CreateTaskAsync(CreateCompensationTaskInput input);
/// <summary>
/// 获取待处理的补偿任务列表Pending + 已过 ScheduledAt 的任务)
/// </summary>
/// <param name="limit">每次获取数量上限</param>
/// <returns>待处理任务列表</returns>
Task<List<CompensationTaskOutput>> GetPendingTasksAsync(int limit = 50);
/// <summary>
/// 按条件查询补偿任务(供外部项目按类型/状态/来源拉取)
/// </summary>
/// <param name="input">查询条件</param>
/// <returns>任务列表</returns>
Task<List<CompensationTaskOutput>> GetTasksAsync(GetCompensationTasksInput input);
/// <summary>
/// 更新补偿任务状态(供外部处理项目回调更新处理结果)
/// </summary>
/// <param name="taskId">任务Id</param>
/// <param name="input">状态更新参数</param>
Task UpdateTaskStatusAsync(long taskId, UpdateCompensationStatusInput input);
/// <summary>
/// 取消补偿任务
/// </summary>
/// <param name="taskId">任务Id</param>
/// <param name="reason">取消原因</param>
Task CancelTaskAsync(long taskId, string reason);
}

View File

@ -0,0 +1,47 @@
using QYZH.InteractiveMagazine.Models.Common;
using QYZH.InteractiveMagazine.Models.Dto;
using QYZH.InteractiveMagazine.Models.Dto.Pet;
using QYZH.InteractiveMagazine.Models.Entity;
namespace QYZH.InteractiveMagazine.IService;
/// <summary>
/// 宠物服务接口
/// </summary>
public interface IPetService : IBaseService<Pet>
{
/// <summary>
/// 获取用户宠物信息
/// </summary>
/// <param name="userId">用户Id</param>
/// <returns>宠物信息</returns>
Task<PetOutput?> GetPetByUserIdAsync(long userId);
/// <summary>
/// 为用户创建默认宠物最低形态、成长值为0、未激活状态
/// </summary>
/// <param name="userId">用户Id</param>
Task CreateDefaultPetAsync(long userId);
/// <summary>
/// 激活宠物(将状态从 Inactive 改为 Active
/// </summary>
/// <param name="userId">用户Id</param>
Task ActivatePetAsync(long userId);
/// <summary>
/// 喂养宠物(增加成长值 + 记录喂养记录 + 触发进化检查)
/// </summary>
/// <param name="userId">用户Id</param>
/// <param name="input">喂养输入</param>
/// <returns>喂养结果</returns>
Task<FeedPetOutput> FeedPetAsync(long userId, FeedPetInput input);
/// <summary>
/// 获取宠物喂养记录列表
/// </summary>
/// <param name="userId">用户Id</param>
/// <param name="petId">宠物Id</param>
/// <returns>喂养记录列表</returns>
Task<PageListModel<FeedingRecordOutput>> GetFeedingRecordsAsync(long userId, long petId, PageQueryModel pageQuery);
}

View File

@ -0,0 +1,33 @@
using QYZH.InteractiveMagazine.Models.Dto;
using QYZH.InteractiveMagazine.Models.Entity;
namespace QYZH.InteractiveMagazine.IService;
/// <summary>
/// 用户期刊关联服务接口
/// </summary>
public interface IUserJournalService : IBaseService<UserJournal>
{
/// <summary>
/// 用户绑定期刊(扫码绑定)
/// </summary>
/// <param name="userId">当前用户Id</param>
/// <param name="input">绑定输入</param>
/// <returns>绑定结果</returns>
Task<BindJournalOutput> BindJournalAsync(long userId, BindJournalInput input);
/// <summary>
/// 获取用户的期刊绑定列表
/// </summary>
/// <param name="userId">用户Id</param>
/// <param name="input">查询条件</param>
/// <returns>分页结果</returns>
Task<PageListModel<BindJournalOutput>> GetUserJournalsAsync(long userId, UserJournalQueryInput input);
/// <summary>
/// 取消期刊绑定
/// </summary>
/// <param name="userId">用户Id</param>
/// <param name="id">绑定记录Id</param>
Task UnbindJournalAsync(long userId, long id);
}

View File

@ -9,12 +9,19 @@ namespace QYZH.InteractiveMagazine.IService;
public interface IWeChatAuthService : IBaseService<Users>
{
/// <summary>
/// 微信小程序一键登录
/// 微信小程序登录(首次创建用户,非首次直接登录)
/// </summary>
/// <param name="input">登录输入(含微信 code</param>
/// <param name="input">登录输入(含微信 code 和可选的手机号 code</param>
/// <returns>登录结果(含 Token 和用户信息)</returns>
Task<WeChatLoginOutput> LoginAsync(WeChatLoginInput input);
/// <summary>
/// 微信小程序快捷登录(通过 OpenId 直接登录,用户需已存在)
/// </summary>
/// <param name="input">快捷登录输入(含 OpenId</param>
/// <returns>登录结果(含 Token 和用户列表)</returns>
Task<WeChatLoginOutput> QuickLoginAsync(WeChatQuickLoginInput input);
/// <summary>
/// 切换用户(同一 OpenId 下切换身份)
/// </summary>