# SalesKpiMonthlyBySalesContractAdHocListener.java

    package cloud.wconnect.workperformance.messagelistener.saleskpi;

    import cloud.wconnect.commonlib.component.BeanMapper;
    import cloud.wconnect.commonlib.cons.EventRedisKeyPrefixEnum;
    import cloud.wconnect.commonlib.cons.FunctionIdConstant;
    import cloud.wconnect.commonlib.cons.MoudleEventSubjectEnum;
    import cloud.wconnect.commonlib.pojo.ModuleEvent;
    import cloud.wconnect.commonlib.pojo.bo.salescontract.SalesContractEventBO;
    import cloud.wconnect.commonlib.pojo.bo.salescontract.SalesContractUserMonthlyBO;
    import cloud.wconnect.commonlib.pojo.dto.PropertyDTO;
    import cloud.wconnect.commonlib.service.CommonService;
    import cloud.wconnect.commonlib.service.MailInternalService;
    import cloud.wconnect.commonlib.service.PropertyInternalService;
    import cloud.wconnect.commonlib.util.JsonUtils;
    import cloud.wconnect.commonlib.util.RateLimitUtils;
    import cloud.wconnect.workperformance.cons.BusinessEnum;
    import cloud.wconnect.workperformance.cons.saleskpi.SalesKpiMonthlyDataSourceCons;
    import cloud.wconnect.workperformance.pojo.dto.saleskpi.monthly.trans.SalesKpiTransMonthlyDTO;
    import cloud.wconnect.workperformance.pojo.dto.saleskpi.monthly.trans.SalesKpiTransMonthlyDataDTO;
    import cloud.wconnect.workperformance.pojo.dto.saleskpi.monthly.trans.SalesKpiTransUserMonthlyDTO;
    import cloud.wconnect.workperformance.service.saleskpi.ISalesKpiMonthlyService;
    import com.fasterxml.jackson.databind.ObjectMapper;
    import com.google.common.collect.Lists;
    import jakarta.annotation.Resource;
    import lombok.extern.slf4j.Slf4j;
    import org.apache.commons.collections4.CollectionUtils;
    import org.apache.commons.lang3.StringUtils;
    import org.springframework.context.event.EventListener;
    import org.springframework.data.redis.core.RedisTemplate;
    import org.springframework.scheduling.annotation.Async;
    import org.springframework.stereotype.Component;

    import java.text.MessageFormat;
    import java.util.List;
    import java.util.concurrent.TimeUnit;

    /**
     * 事件处理：Sales KPI Monthly By Sales Contract Ad Hoc
     *
     * @author zc
     * @date 2023/09/13
     */
    @Slf4j
    @Component
    public class SalesKpiMonthlyBySalesContractAdHocListener {
        @Resource
        private ISalesKpiMonthlyService salesKpiMonthlyService;
        @Resource
        private MailInternalService mailInternalService;
        @Resource
        private PropertyInternalService propertyInternalService;
        @Resource
        private RedisTemplate<String, Object> jsonRedisTemplate;
        @Resource
        private ObjectMapper objectMapper;
        @Resource
        private BeanMapper beanMapper;
        @Resource
        private CommonService commonService;

        private static final String SUBJECT = MoudleEventSubjectEnum.SALES_CONTRACT_AD_HOC.getSubject();
        private static final String BUSINESS = BusinessEnum.SALES_KPI.getBusiness();

        /**
         * 异步监听事件处理
         *
         * @param event 事件体
         * @author zc
         * @date 2023/9/13
         */
        @Async
        @EventListener
        public void handle(ModuleEvent event) {
            if (!StringUtils.equals(SUBJECT, event.getSubject())) {
                return;
            }
            log.info("SalesKpiMonthlyBySalesContractAdHocListener.handle start...");
            if (!preventConcurrency(event.getMessageId())) {
                log.warn("SalesKpiMonthlyBySalesContractAdHocListener.handle end... a machine has been executed.");
                return;
            }
            if (StringUtils.isBlank(event.getBody())) {
                log.warn("SalesKpiMonthlyBySalesContractAdHocListener.handle end... event body is blank.");
                return;
            }

            // body 转换为对象
            SalesContractEventBO salesContractEventBO = JsonUtils.convertStringToObject(objectMapper,
                    event.getBody(), SalesContractEventBO.class);

            PropertyDTO propertyDTO = propertyInternalService.getOne(salesContractEventBO.getPropertyId());
            if (!propertyDTO.getStatus()) {
                log.warn("SalesKpiMonthlyBySalesContractAdHocListener.handle end... property is closed.");
                return;
            }
            if(!commonService.checkOpenFunction(propertyDTO, FunctionIdConstant.SALES_KPI)){
                log.warn("SalesKpiMonthlyBySalesContractAdHocListener.handle end...property not open sales kpi function.");
                return;
            }

            try {
                // 处理 adj 指标数据
                List<SalesKpiTransUserMonthlyDTO> transUserMonthlyDTOList = extractTransMonthlyDataByUser(salesContractEventBO.getUserMonthlyList());
                // 处理发生变化的指标数据
                transUserMonthlyDTOList.forEach(item ->
                        salesKpiMonthlyService.handleSalesKpiTransData(propertyDTO.getId(), item.getUserId(), item.getTransMonthlyList()));

                log.info("SalesKpiMonthlyBySalesContractAdHocListener.handle end...");
            } catch (Exception e) {
                String propertyAbbr = propertyDTO.getAbbr();
                if (RateLimitUtils.tryAcquire(this, propertyAbbr)) {
                    sendAlertEmail(propertyAbbr, e.getMessage(), event.getBody());
                }

                log.error("SalesKpiMonthlyBySalesContractAdHocListener.handle end... Process error.", e);
            }
        }

        /**
         * 发送预警邮件
         *
         * @param propertyAbbr     资产标识
         * @param exceptionMessage 异常信息
         * @param eventBody        事件体
         * @author zc
         * @date 2025/8/12
         */
        private void sendAlertEmail(String propertyAbbr, String exceptionMessage, String eventBody) {
            String subject = "[Warning] - Handle the [W-connect Sales Contract (Ad-Hoc)] data error.";
            String content = "Process error: " + exceptionMessage;
            String mailContent = MessageFormat.format("Module SNS Subject:{0}<br/>Business:{1}<br/>Property:{2}<br/>Content:{3}<br/>EventBody:{4}",
                    SUBJECT, BUSINESS, propertyAbbr, content, eventBody);
            mailInternalService.sendAlertEmail(subject, mailContent);
        }

        /**
         * 提取指标数据
         *
         * @param salesContractUserMonthlyList Sales Contract Static 指标数据
         * @return 指标数据
         * @author zc
         * @date 2023/9/13
         */
        private List<SalesKpiTransUserMonthlyDTO> extractTransMonthlyDataByUser(List<SalesContractUserMonthlyBO> salesContractUserMonthlyList) {
            List<SalesKpiTransUserMonthlyDTO> resultList = Lists.newArrayList();
            salesContractUserMonthlyList.forEach(item -> {
                if (CollectionUtils.isEmpty(item.getMonthlyValueList())) {
                    return;
                }

                List<SalesKpiTransMonthlyDTO> transMonthlyList = beanMapper.mapList(item.getMonthlyValueList(),
                        SalesKpiTransMonthlyDTO.class, (boMonthly, dtoMonthly) ->
                                dtoMonthly.setData(Lists.newArrayList(SalesKpiTransMonthlyDataDTO.builder()
                                        .dataSource(SalesKpiMonthlyDataSourceCons.DATA_SOURCE_CONTRACT_SALES_CONTRACT_AD_HOC)
                                        .actual(boMonthly.getActual())
                                        .build())));
                resultList.add(SalesKpiTransUserMonthlyDTO.builder()
                        .userId(item.getUserId())
                        .transMonthlyList(transMonthlyList)
                        .build());
            });

            return resultList;
        }

        /**
         * 防止并发操作
         *
         * @param messageId 消息事件 id
         * @return boolean true：未并发，当前线程可以执行；false：检测到并发，当前线程应放弃执行
         * @author zc
         * @date 2023/9/13
         */
        private Boolean preventConcurrency(String messageId) {
            String key = EventRedisKeyPrefixEnum.KEY_PREFIX_FOR_MESSAGE.getDesc() +
                    StringUtils.join(Lists.newArrayList(SUBJECT, BUSINESS, messageId), ".");
            return jsonRedisTemplate.opsForValue().setIfAbsent(key, 0L, 1, TimeUnit.DAYS);
        }
    }