package com.dora.service;

import com.dora.dto.IdentityVerifyRequestDto;
import com.dora.dto.IdentityVerifyResponseDto;

/**
 * 实名认证服务接口
 *
 * @author Dora
 */
public interface IdentityVerifyService {

    /**
     * 执行实名认证
     * 调用阿里云Id2MetaVerify接口验证身份证号和姓名的匹配性
     *
     * @param request 认证请求参数
     * @param userId 用户ID
     * @return 认证结果
     */
    IdentityVerifyResponseDto verifyIdentity(IdentityVerifyRequestDto request, Long userId);

    /**
     * 检查用户是否已完成实名认证
     *
     * @param userId 用户ID
     * @return 是否已认证
     */
    boolean isUserVerified(Long userId);

    /**
     * 获取用户实名认证信息
     *
     * @param userId 用户ID
     * @return 用户认证信息(脱敏后)
     */
    IdentityVerifyResponseDto getUserVerifyInfo(Long userId);
}
