using LiveForum.Model.Dto.RealName;

namespace LiveForum.IService.RealName
{
    /// <summary>
    /// 实名认证业务服务接口
    /// </summary>
    public interface IRealNameService
    {
        /// <summary>
        /// 检查实名认证状态
        /// </summary>
        Task<RealNameStatusDto> CheckStatusAsync(long userId);

        /// <summary>
        /// 执行实名认证（含限流检查）
        /// </summary>
        Task<string> VerifyAsync(long userId, string realName, string idCardNumber, string? clientIp);

        /// <summary>
        /// 检查用户是否需要实名认证才能进行互动操作
        /// </summary>
        Task<bool> RequiresRealNameAsync(long userId);
    }
}