QYZH.InteractiveMagazine/QYZH.InteractiveMagazine.IService/IPetService.cs

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<UserPet>
{
    /// <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);
}