package com.heyu.api.controller.certificate;


import com.heyu.api.baidu.handle.certificate.BSocialSecurityCardHandle;
import com.heyu.api.baidu.request.certificate.BSocialSecurityCardRequest;
import com.heyu.api.baidu.response.certificate.BSocialSecurityCardResp;
import com.heyu.api.controller.BaseController;
import com.heyu.api.data.annotation.CacheResult;
import com.heyu.api.data.annotation.NotIntercept;
import com.heyu.api.data.utils.ApiR;
import com.heyu.api.data.utils.R;
import com.heyu.api.resp.certificate.SocialSecurityCardResp;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

/**
 * 社保卡识别控制器
 * <p>
 * 基于百度 OCR API，对中国大陆社会保障卡进行结构化识别。
 * 支持识别全国各地社保卡，提取卡面关键信息用于身份验证和业务办理。
 * </p>
 * <p>
 * 识别字段包括（8 个关键字段）：
 * <ul>
 *   <li>基本信息：姓名、性别、出生日期</li>
 *   <li>卡号信息：卡号、社会保障卡号、银行卡号</li>
 *   <li>时效信息：签发日期、有效期限</li>
 * </ul>
 * </p>
 * <p>
 * 注意事项：
 * <ul>
 *   <li>支持全国各地社保卡识别</li>
 *   <li>需保证社保卡清晰、完整、无反光</li>
 *   <li>支持图片 URL 或 Base64 编码输入</li>
 *   <li>启用结果缓存以提升响应速度</li>
 * </ul>
 * </p>
 * <p>
 * 适用场景：
 * <ul>
 *   <li>医疗报销：社保卡信息快速录入</li>
 *   <li>药店购药：持卡人身份验证</li>
 *   <li>社保办理：社保卡信息数字化</li>
 *   <li>身份认证：社保卡真伪辅助识别</li>
 * </ul>
 * </p>
 * <p>
 * 接口路径：/socialSecurityCard/recognize
 * </p>
 *
 * @author heyu
 * @since 1.0.0
 */
@Slf4j
@RestController
@RequestMapping("/socialSecurityCard")
@NotIntercept
public class SocialSecurityCardController extends BaseController {


    @Autowired
    private BSocialSecurityCardHandle bsocialSecurityCardHandle;

    /**
     * 社保卡识别接口
     * <p>
     * 接收社保卡图片（URL 或 Base64），调用百度 OCR API 进行结构化识别。
     * 返回社保卡上的姓名、卡号、性别等 8 个关键字段。
     * </p>
     *
     * @param request 社保卡识别请求参数，包含以下字段（任选其一）：
     *                - imageBase64：图片 Base64 编码
     *                - imageUrl：图片 URL
     * @return 社保卡识别结果，包含姓名、性别、出生日期、卡号、社会保障卡号、银行卡号、签发日期、有效期限等字段
     */
    @RequestMapping("/recognize")
    @CacheResult
    public R recognize(BSocialSecurityCardRequest request) {


        SocialSecurityCardResp resp = new SocialSecurityCardResp();

        ApiR<BSocialSecurityCardResp> bR = bsocialSecurityCardHandle.handle(request);

        if (bR.isSuccess()) {


            BSocialSecurityCardResp bSocialSecurityCardResp = bR.getData();

            BSocialSecurityCardResp.WordsResultDTO wordsResultDTO = bSocialSecurityCardResp.getWordsResult();

            resp.setCardNumber(wordsResultDTO.getCardNumber().getWord());    //string	是	卡号
            resp.setName(wordsResultDTO.getName().getWord());//string	是	姓名
            resp.setSex(wordsResultDTO.getSex().getWord());//	string	是	性别
            resp.setSocialSecurityNumber(wordsResultDTO.getSocialSecurityNumber().getWord());//	string	是	社会保障卡号
            resp.setBirthDate(wordsResultDTO.getBirthDate().getWord());//	string	是	出生日期
            resp.setIssueDate(wordsResultDTO.getIssueDate().getWord());//	string	是	签发日期
            resp.setBankCardNumber(wordsResultDTO.getBankCardNumber().getWord());//	string	是	银行卡号
            resp.setExpiryDate(wordsResultDTO.getExpiryDate().getWord());//	string	是	有效期限
            return R.ok().setData(resp);
        }

        return R.error(bR.getErrorMsg());
    }


}
