# MonthlyReportBudgetDatabaseListener.java

    package cloud.wconnect.workperformance.messagelistener.monthlyreport;

    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.dto.PropertyDTO;
    import cloud.wconnect.commonlib.redis.PropertyI18nRedisService;
    import cloud.wconnect.commonlib.service.CommonService;
    import cloud.wconnect.commonlib.service.MailInternalService;
    import cloud.wconnect.commonlib.util.JsonUtils;
    import cloud.wconnect.commonlib.util.RateLimitUtils;
    import cloud.wconnect.workperformance.cons.BusinessEnum;
    import cloud.wconnect.workperformance.pojo.bo.modelevent.budgetdb.BudgetDatabaseBO;
    import cloud.wconnect.workperformance.service.monthlyreport.IMonthlyReportBudgetDatabaseService;
    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.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.Service;

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

    /**
     * 事件监听：Budget Database
     *
     * @author lichen
     * @date 2025/12/22
     */
    @Slf4j
    @Service
    public class MonthlyReportBudgetDatabaseListener {
        @Resource
        private IMonthlyReportBudgetDatabaseService budgetDatabaseService;
        @Resource
        private MailInternalService mailInternalService;
        @Resource
        private PropertyI18nRedisService propertyI18nRedisService;
        @Resource
        private RedisTemplate<String, Object> jsonRedisTemplate;
        @Resource
        private ObjectMapper objectMapper;
        @Resource
        private CommonService commonService;

        private static final String SUBJECT = MoudleEventSubjectEnum.BUDGET_DATABASE.getSubject();
        private static final String BUSINESS = BusinessEnum.MONTHLY_REPORT.getBusiness();

        /**
         * 异步监听事件处理
         *
         * @param event 事件体
         * @author lichen
         * @date 2025/12/22
         */
        @Async
        @EventListener
        public void handle(ModuleEvent event) {
            if (!StringUtils.equals(SUBJECT, event.getSubject())) {
                return;
            }

            log.info("MonthlyReportBudgetDatabaseListener.handle start...");

            if (!preventConcurrency(event.getMessageId())) {
                log.warn("MonthlyReportBudgetDatabaseListener.handle end... a machine has been executed.");
                return;
            }
            if (StringUtils.isBlank(event.getBody())) {
                log.warn("MonthlyReportBudgetDatabaseListener.handle end... event body is blank.");
                return;
            }

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

            // 获取有效的资产数据
            PropertyDTO propertyDTO = getEffectiveProperty(eventBO.getPropertyId());
            if (Objects.isNull(propertyDTO)) {
                return;
            }

            try {
                // 保存数据
                budgetDatabaseService.save(eventBO);

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

        /**
         * 获取有效的资产数据
         *
         * @param propertyId 资产 id
         * @return PropertyDTO
         * @author lichen
         * @date 2025/12/22
         */
        private PropertyDTO getEffectiveProperty(int propertyId) {
            PropertyDTO propertyDTO = propertyI18nRedisService.get(propertyId);
            if (Objects.isNull(propertyDTO)) {
                log.warn("MonthlyReportBudgetDatabaseListener.handle end... The property:{} is not exist", propertyId);
                return null;
            }
            if (!propertyDTO.getStatus()) {
                log.warn("MonthlyReportBudgetDatabaseListener.handle end...  The property:{} is closed", propertyId);
                return null;
            }
            if (!commonService.checkOpenFunction(propertyDTO, FunctionIdConstant.MONTHLY_REPORT)) {
                log.warn("MonthlyReportBudgetDatabaseListener.handle end... The property:{} has not opened monthly report function", propertyId);
                return null;
            }
            return propertyDTO;
        }

        /**
         * 发送预警邮件
         *
         * @param propertyAbbr     资产简称
         * @param exceptionMessage 异常信息
         * @param eventBody        事件体
         * @author lichen
         * @date 2025/12/22
         */
        private void sendAlertEmail(String propertyAbbr, String exceptionMessage, String eventBody) {
            String subject = "[Warning] - Handle [W-connect Monthly Report] 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 messageId 消息事件 id
         * @return boolean true：未并发，当前线程可以执行；false：检测到并发，当前线程应放弃执行
         * @author lichen
         * @date 2025/12/22
         */
        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);
        }
    }