using QYZH.InteractiveMagazine.Models.Dto;
using QYZH.InteractiveMagazine.Models.Dto.Points;
using QYZH.InteractiveMagazine.Models.Entity;

namespace QYZH.InteractiveMagazine.IService;

public interface IUsersService : IBaseService<Users>
{
    /// <summary>
    /// 分页查询用户列表
    /// </summary>
    Task<BaseResponse<PageListModel<UsersOutput>>> GetListAsync(UsersQueryInput input);

    /// <summary>
    /// 获取用户详情（包含积分记录、签到记录、补偿任务、期刊列表）
    /// </summary>
    Task<BaseResponse<UserDetailOutput>> GetDetailAsync(long id);

    /// <summary>
    /// 更新用户状态
    /// </summary>
    Task<BaseResponse> UpdateStatusAsync(long id);

    /// <summary>
    /// 手动增加用户积分
    /// </summary>
    Task<ManualPointsOutput> ManualAddPointsAsync(long userId, ManualAddPointsInput input, long operatorId, string operatorName, string? ipAddress = null);

    /// <summary>
    /// 手动扣除用户积分
    /// </summary>
    Task<ManualPointsOutput> ManualDeductPointsAsync(long userId, ManualDeductPointsInput input, long operatorId, string operatorName, string? ipAddress = null);
}