feat: 新增签到、宠物、期刊绑定、补偿任务等业务模块,优化微信登录流程
本次提交完成了多个核心业务模块的开发与优化: 1. 宠物模块:新增宠物实体、服务接口与实现,支持创建默认宠物、激活、喂养、进化以及喂养记录查询 2. 签到模块:新增签到实体、服务接口、控制器以及相关DTO,支持用户签到和签到信息查询,新增成长值奖励字段 3. 期刊绑定模块:新增用户期刊关联实体、服务接口与控制器,支持扫码绑定期刊、解绑和查询绑定列表 4. 补偿任务模块:新增补偿任务实体、服务接口与实现,用于处理业务失败后的异步重试补偿 5. 优化微信登录流程:拆分登录与快捷登录接口,支持手机号获取,新增首次登录自动创建默认宠物逻辑 6. 调整基础路由与实体状态:修改微信控制器路由前缀,更新宠物状态枚举与默认值
This commit is contained in:
24
QYZH.InteractiveMagazine.IService/ICheckInService.cs
Normal file
24
QYZH.InteractiveMagazine.IService/ICheckInService.cs
Normal 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);
|
||||
}
|
||||
@ -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);
|
||||
}
|
||||
47
QYZH.InteractiveMagazine.IService/IPetService.cs
Normal file
47
QYZH.InteractiveMagazine.IService/IPetService.cs
Normal 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);
|
||||
}
|
||||
33
QYZH.InteractiveMagazine.IService/IUserJournalService.cs
Normal file
33
QYZH.InteractiveMagazine.IService/IUserJournalService.cs
Normal 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);
|
||||
}
|
||||
@ -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>
|
||||
|
||||
Reference in New Issue
Block a user