# ActualHourParseServiceByOther.java

    package cloud.wconnect.workperformance.service.sva.actualschedulehour.actualhour;

    import cloud.wconnect.commonlib.cons.BaseConstant;
    import cloud.wconnect.commonlib.cons.BaseErrorCodeEnum;
    import cloud.wconnect.commonlib.cons.CommonErrorI18nConstant;
    import cloud.wconnect.commonlib.cons.SystemPlatformEnum;
    import cloud.wconnect.commonlib.exception.BadRequestException;
    import cloud.wconnect.commonlib.exception.InternalServerErrorException;
    import cloud.wconnect.commonlib.exception.ParseReportException;
    import cloud.wconnect.commonlib.pojo.dto.PropertyDTO;
    import cloud.wconnect.commonlib.pojo.dto.internationalization.InternationalizationNumberDTO;
    import cloud.wconnect.commonlib.util.*;
    import cloud.wconnect.workperformance.cons.S3BucketFunctionCons;
    import cloud.wconnect.workperformance.pojo.bo.sva.actualschedulehour.SvaActualHoursBO;
    import cloud.wconnect.workperformance.service.AmazonS3Service;
    import cloud.wconnect.workperformance.service.sva.actualschedulehour.IAttendanceActualScheduleHourImportLogService;
    import cloud.wconnect.workperformance.service.sva.actualschedulehour.ISvaActualHourService;
    import com.baomidou.dynamic.datasource.annotation.DS;
    import com.google.common.collect.Lists;
    import jakarta.annotation.Resource;
    import org.apache.commons.collections.CollectionUtils;
    import org.apache.commons.lang3.StringUtils;
    import org.apache.poi.ss.usermodel.Row;
    import org.apache.poi.ss.usermodel.Sheet;
    import org.apache.poi.ss.usermodel.Workbook;
    import org.apache.poi.ss.usermodel.WorkbookFactory;
    import org.springframework.beans.factory.annotation.Value;
    import org.springframework.stereotype.Component;
    import org.springframework.web.multipart.MultipartFile;

    import java.io.IOException;
    import java.io.InputStream;
    import java.math.BigDecimal;
    import java.math.RoundingMode;
    import java.time.LocalDate;
    import java.time.LocalDateTime;
    import java.time.format.DateTimeFormatter;
    import java.time.format.DateTimeParseException;
    import java.util.*;
    import java.util.function.Function;
    import java.util.stream.Collectors;

    /**
     * 服务实现类：Other Actual Hour 报告处理
     *
     * @author zc
     * @date 2025/4/21
     */
    @Component
    @DS("work_performance")
    public class ActualHourParseServiceByOther implements IActualHourParseService {
        @Resource
        private ISvaActualHourService actualHourService;
        @Resource
        private IAttendanceActualScheduleHourImportLogService importLogService;
        @Resource
        private I18nMessageUtils i18nMessageUtils;
        @Resource
        private AmazonS3Service amazonS3Service;

        @Value("${aws-s3.third-party.key.schedule-vs-actual.actual-hours}")
        private String s3FilePath;
        @Value("${file-max-size.import-report.sva}")
        private long fileMaxSize;

        /**
         * 判断是否支持
         *
         * @param source 数据源
         * @return boolean
         * @author zc
         * @date 2025/4/21
         */
        @Override
        public boolean supports(String source) {
            return SystemPlatformEnum.OTHER.getDesc().equals(source);
        }

        /**
         * 校验文件内容是否合法
         *
         * @param propertyDTOList 资产集合
         * @param file            文件
         * @author zc
         * @date 2025/4/21
         */
        @Override
        public void checkFile(List<PropertyDTO> propertyDTOList, MultipartFile file) {
            // 限制文件大小
            FileCheckUtils.checkFileSize(file, fileMaxSize);
            // 校验文件格式
            UploadUtils.checkFileFormat(file, Lists.newArrayList("xls", "xlsx"));
            Map<String, PropertyDTO> name2PropertyDTO = propertyDTOList.stream()
                    .collect(Collectors.toMap(item -> item.getName().toLowerCase(), Function.identity()));
            try (InputStream in = file.getInputStream(); Workbook workbook = WorkbookFactory.create(in)) {
                Sheet sheet = workbook.getSheetAt(0);
                // 获取最大行数
                int lastRowNum = sheet.getLastRowNum();
                // 若只包含标题，直接返回
                if (lastRowNum < 1) {
                    return;
                }

                // 提取标题
                List<String> titleList = Lists.newArrayList();
                Row titleRow = sheet.getRow(0);
                for (int i = 0; i <= 10; i++) {
                    titleList.add(CellUtils.convertCellStr(titleRow.getCell(i)));
                }

                for (int i = 1; i <= lastRowNum; i++) {
                    Row row = sheet.getRow(i);

                    // Property Name
                    String propertyNameStr = CellUtils.convertCellStr(row.getCell(0));
                    if (StringUtils.isBlank(propertyNameStr)) {
                        throw new BadRequestException(CommonErrorI18nConstant.CANNOT_EMPTY,
                                i18nMessageUtils.getErrorParamMapNotNeedTranslate(titleList.get(0)),
                                BaseErrorCodeEnum.DATA_VALIDATION_ERROR.getCode(),
                                "The Property Name cannot be blank");
                    }
                    // 若资产不存在，则跳过校验
                    PropertyDTO propertyDTO = name2PropertyDTO.get(propertyNameStr.toLowerCase());
                    if (Objects.isNull(propertyDTO)) {
                        continue;
                    }

                    // Position ID
                    String positionIdStr = CellUtils.convertCellStr(row.getCell(1));
                    if (StringUtils.isBlank(positionIdStr)) {
                        throw new BadRequestException(CommonErrorI18nConstant.CANNOT_EMPTY,
                                i18nMessageUtils.getErrorParamMapNotNeedTranslate(titleList.get(1)),
                                BaseErrorCodeEnum.DATA_VALIDATION_ERROR.getCode(),
                                "The Position ID cannot be blank");
                    } else {
                        if (positionIdStr.length() > 20) {
                            throw new BadRequestException(CommonErrorI18nConstant.OVERLENGTH,
                                    i18nMessageUtils.getErrorParamMapNotNeedTranslate(titleList.get(1), 20),
                                    BaseErrorCodeEnum.DATA_VALIDATION_ERROR.getCode(),
                                    "The Position ID cannot be more than 20 characters");
                        }
                    }

                    // Department Code
                    String departmentCode = CellUtils.convertCellStr(row.getCell(2));
                    if (StringUtils.isBlank(departmentCode)) {
                        throw new BadRequestException(CommonErrorI18nConstant.CANNOT_EMPTY,
                                i18nMessageUtils.getErrorParamMapNotNeedTranslate(titleList.get(2)),
                                BaseErrorCodeEnum.DATA_VALIDATION_ERROR.getCode(),
                                "The Department Code cannot be blank");
                    } else {
                        if (departmentCode.length() > 20) {
                            throw new BadRequestException(CommonErrorI18nConstant.OVERLENGTH,
                                    i18nMessageUtils.getErrorParamMapNotNeedTranslate(titleList.get(2), 20),
                                    BaseErrorCodeEnum.DATA_VALIDATION_ERROR.getCode(),
                                    "The Department Code cannot be more than 20 characters");
                        }
                    }

                    // Department Desc
                    String departmentDesc = CellUtils.convertCellStr(row.getCell(3));
                    if (StringUtils.isBlank(departmentDesc)) {
                        throw new BadRequestException(CommonErrorI18nConstant.CANNOT_EMPTY,
                                i18nMessageUtils.getErrorParamMapNotNeedTranslate(titleList.get(3)),
                                BaseErrorCodeEnum.DATA_VALIDATION_ERROR.getCode(),
                                "The Department Description cannot be blank");
                    } else {
                        if (departmentDesc.length() > 60) {
                            throw new BadRequestException(CommonErrorI18nConstant.OVERLENGTH,
                                    i18nMessageUtils.getErrorParamMapNotNeedTranslate(titleList.get(3), 60),
                                    BaseErrorCodeEnum.DATA_VALIDATION_ERROR.getCode(),
                                    "The Department Description cannot be more than 20 characters");
                        }
                    }

                    // Pay Date
                    String payDateStr = CellUtils.convertCellStr(row.getCell(4));
                    if (StringUtils.isBlank(payDateStr)) {
                        throw new BadRequestException(CommonErrorI18nConstant.CANNOT_EMPTY,
                                i18nMessageUtils.getErrorParamMapNotNeedTranslate(titleList.get(4)),
                                BaseErrorCodeEnum.DATA_VALIDATION_ERROR.getCode(),
                                "The Pay Date cannot be blank");
                    } else {
                        try {
                            DateTimeFormatter formatter = DateTimeFormatter.ofPattern(BaseConstant.DATE_FORMAT_YYYY_MM_DD, Locale.ENGLISH);
                            LocalDate.parse(payDateStr, formatter);
                        } catch (DateTimeParseException e) {
                            throw new BadRequestException(CommonErrorI18nConstant.FORMAT_INCORRECT,
                                    i18nMessageUtils.getErrorParamMapNotNeedTranslate(titleList.get(4), BaseConstant.DATE_FORMAT_YYYY_MM_DD),
                                    BaseErrorCodeEnum.DATA_VALIDATION_ERROR.getCode(),
                                    "The Pay Date format is incorrect, Pay Date = " + payDateStr);
                        }
                    }

                    // Actual Hours
                    String actualHoursStr = CellUtils.convertCellStr(row.getCell(5));
                    if (StringUtils.isBlank(actualHoursStr)) {
                        throw new BadRequestException(CommonErrorI18nConstant.CANNOT_EMPTY,
                                i18nMessageUtils.getErrorParamMapNotNeedTranslate(titleList.get(5)),
                                BaseErrorCodeEnum.DATA_VALIDATION_ERROR.getCode(),
                                "The Actual Hours cannot be blank");
                    } else {
                        BigDecimal actualHours;
                        try {
                            actualHours = new BigDecimal(actualHoursStr);
                            if (actualHours.compareTo(BigDecimal.ZERO) < 0) {
                                throw new BadRequestException(CommonErrorI18nConstant.CANNOT_LESS_THAN_ZERO,
                                        i18nMessageUtils.getErrorParamMapNotNeedTranslate(titleList.get(5)),
                                        BaseErrorCodeEnum.DATA_VALIDATION_ERROR.getCode(),
                                        "The Actual Hours cannot be less than 0, Actual Hours = " + actualHoursStr);
                            }
                        } catch (NumberFormatException e) {
                            throw new BadRequestException(CommonErrorI18nConstant.MUST_NUMBER,
                                    i18nMessageUtils.getErrorParamMapNotNeedTranslate(titleList.get(5)),
                                    BaseErrorCodeEnum.DATA_VALIDATION_ERROR.getCode(),
                                    "The Actual Hours format is incorrect, Actual Hours = " + actualHoursStr);
                        }
                        // 校验整数位是否超过限制
                        int intLength = actualHours.abs().toBigInteger().toString().length();
                        if (intLength > 4) {
                            throw new BadRequestException(CommonErrorI18nConstant.NUMBER_INTEGER_OVERLENGTH,
                                    i18nMessageUtils.getErrorParamMapNotNeedTranslate(titleList.get(5), 4),
                                    BaseErrorCodeEnum.DATA_VALIDATION_ERROR.getCode(),
                                    "The integer of Actual Hours exceeds the limit, Actual Hours = " + actualHoursStr);
                        }
                    }

                    // Pay Rate
                    String payRateStr = CellUtils.convertCellStr(row.getCell(6));
                    if (StringUtils.isNotBlank(payRateStr)) {
                        BigDecimal payRate;
                        try {
                            payRate = new BigDecimal(payRateStr);
                            if (payRate.compareTo(BigDecimal.ZERO) < 0) {
                                throw new BadRequestException(CommonErrorI18nConstant.CANNOT_LESS_THAN_ZERO,
                                        i18nMessageUtils.getErrorParamMapNotNeedTranslate(titleList.get(6)),
                                        BaseErrorCodeEnum.DATA_VALIDATION_ERROR.getCode(),
                                        "The Pay Rate cannot be less than 0, Pay Rate = " + payRateStr);
                            }
                        } catch (NumberFormatException e) {
                            throw new BadRequestException(CommonErrorI18nConstant.MUST_NUMBER,
                                    i18nMessageUtils.getErrorParamMapNotNeedTranslate(titleList.get(6)),
                                    BaseErrorCodeEnum.DATA_VALIDATION_ERROR.getCode(),
                                    "The Pay Rate format is incorrect, Pay Rate = " + payRateStr);
                        }
                        // 校验整数位是否超过限制
                        int intLength = payRate.abs().toBigInteger().toString().length();
                        if (intLength > 8) {
                            throw new BadRequestException(CommonErrorI18nConstant.NUMBER_INTEGER_OVERLENGTH,
                                    i18nMessageUtils.getErrorParamMapNotNeedTranslate(titleList.get(6), 8),
                                    BaseErrorCodeEnum.DATA_VALIDATION_ERROR.getCode(),
                                    "The integer of Pay Rate exceeds the limit, Pay Rate = " + payRateStr);
                        }
                    }

                    // Actual Hours Pay Code
                    String payCode = CellUtils.convertCellStr(row.getCell(7));
                    if (StringUtils.isNotBlank(payCode)) {
                        if (payCode.length() > 20) {
                            throw new BadRequestException(CommonErrorI18nConstant.OVERLENGTH,
                                    i18nMessageUtils.getErrorParamMapNotNeedTranslate(titleList.get(7), 20),
                                    BaseErrorCodeEnum.DATA_VALIDATION_ERROR.getCode(),
                                    "The Actual Hours Pay Code cannot be more than 20 characters, Actual Hours Pay Code = " + payCode);
                        }
                    }

                    // Time In
                    String timeInStr = CellUtils.convertCellStr(row.getCell(8));
                    if (StringUtils.isBlank(timeInStr)) {
                        throw new BadRequestException(CommonErrorI18nConstant.CANNOT_EMPTY,
                                i18nMessageUtils.getErrorParamMapNotNeedTranslate(titleList.get(8)),
                                BaseErrorCodeEnum.DATA_VALIDATION_ERROR.getCode(),
                                "The Time In cannot be blank");
                    } else {
                        try {
                            DateTimeFormatter formatter = DateTimeFormatter.ofPattern(BaseConstant.DATE_TIME_FORMAT_YYYY_MM_DD_HH_MM);
                            LocalDateTime.parse(timeInStr, formatter);
                        } catch (DateTimeParseException e) {
                            throw new BadRequestException(CommonErrorI18nConstant.FORMAT_INCORRECT,
                                    i18nMessageUtils.getErrorParamMapNotNeedTranslate(titleList.get(8), BaseConstant.DATE_TIME_FORMAT_YYYY_MM_DD_HH_MM),
                                    BaseErrorCodeEnum.DATA_VALIDATION_ERROR.getCode(),
                                    "The Time In format is incorrect, Time In = " + timeInStr);
                        }
                    }

                    // Time Out
                    String timeOutStr = CellUtils.convertCellStr(row.getCell(9));
                    if (StringUtils.isBlank(timeOutStr)) {
                        throw new BadRequestException(CommonErrorI18nConstant.CANNOT_EMPTY,
                                i18nMessageUtils.getErrorParamMapNotNeedTranslate(titleList.get(9)),
                                BaseErrorCodeEnum.DATA_VALIDATION_ERROR.getCode(),
                                "The Time Out cannot be blank");
                    } else {
                        try {
                            DateTimeFormatter formatter = DateTimeFormatter.ofPattern(BaseConstant.DATE_TIME_FORMAT_YYYY_MM_DD_HH_MM);
                            LocalDateTime.parse(timeOutStr, formatter);
                        } catch (DateTimeParseException e) {
                            throw new BadRequestException(CommonErrorI18nConstant.FORMAT_INCORRECT,
                                    i18nMessageUtils.getErrorParamMapNotNeedTranslate(titleList.get(9), BaseConstant.DATE_TIME_FORMAT_YYYY_MM_DD_HH_MM),
                                    BaseErrorCodeEnum.DATA_VALIDATION_ERROR.getCode(),
                                    "The Time Out format is incorrect, Time Out = " + timeOutStr);
                        }
                    }
                }
            } catch (IOException e) {
                throw new InternalServerErrorException(BaseErrorCodeEnum.SYSTEM_ERROR.getI18nCode(),
                        BaseErrorCodeEnum.SYSTEM_ERROR.getCode(),
                        "Handle check Sva Actual Hour Other report error.", e);
            }
        }

        /**
         * 处理数据
         *
         * @param propertyDTOList      资产集合
         * @param file                 文件
         * @param propertyId2DateRange 报告数据日期范围(yyyyMMdd)
         * @param logIds               日志 id 集合
         * @param operatorId           操作人 id
         * @author zc
         * @date 2025/4/21
         */
        @Override
        public void handleData(List<PropertyDTO> propertyDTOList, MultipartFile file,
                               Map<Integer, List<Long>> propertyId2DateRange, List<Long> logIds, int operatorId) {
            // 处理是否成功
            boolean handleResult = true;
            String tenantSymbol = propertyDTOList.get(0).getTenantSymbol();
            List<String> propertyAbbrList = propertyDTOList.stream().map(PropertyDTO::getAbbr).toList();
            String s3Key = tenantSymbol + "/" + StringUtils.join(propertyAbbrList, "_") + "/" + s3FilePath
                    + UploadUtils.getRandomFileName(file.getOriginalFilename());

            try (InputStream in = file.getInputStream()) {
                // 上传报告到 S3，用于导入记录下载报告
                amazonS3Service.uploadFile(S3BucketFunctionCons.SVA_AV_HOURS_IMPORT_RECORD, file, s3Key);

                // 解析报告
                List<SvaActualHoursBO> actualHoursBOList = parse(propertyDTOList, in, propertyId2DateRange);
                // 处理报告数据
                actualHourService.handleActualHours(propertyDTOList, actualHoursBOList, operatorId, propertyId2DateRange);
            } catch (IOException e) {
                handleResult = false;
                throw new InternalServerErrorException(BaseErrorCodeEnum.SYSTEM_ERROR.getI18nCode(),
                        BaseErrorCodeEnum.SYSTEM_ERROR.getCode(),
                        "Handle import Sva Actual Hour Other report error.", e);
            } finally {
                // 更新日志导入状态
                importLogService.updateBatch(logIds, handleResult, operatorId, s3Key);
            }
        }

        /**
         * 解析报告
         *
         * @param propertyDTOList      资产集合
         * @param in                   文件流
         * @param propertyId2DateRange 报告数据日期范围(yyyyMMdd)
         * @return SvaActualHoursBO 集合
         * @author zc
         * @date 2025/4/21
         */
        @Override
        public List<SvaActualHoursBO> parse(List<PropertyDTO> propertyDTOList, InputStream in,
                                            Map<Integer, List<Long>> propertyId2DateRange) throws ParseReportException {
            Map<String, PropertyDTO> name2PropertyDTO = propertyDTOList.stream()
                    .collect(Collectors.toMap(item -> item.getName().toLowerCase(), Function.identity()));

            try (Workbook workbook = WorkbookFactory.create(in)) {
                Sheet sheet = workbook.getSheetAt(0);

                List<SvaActualHoursBO> avHoursListBOList = Lists.newArrayList();
                // 跳过第 0 行标题
                for (int i = 1; i <= sheet.getLastRowNum(); i++) {
                    Row row = sheet.getRow(i);

                    String propertyName = CellUtils.convertCellStr(row.getCell(0));
                    PropertyDTO propertyDTO = name2PropertyDTO.get(propertyName.toLowerCase());
                    if (Objects.isNull(propertyDTO)) {
                        continue;
                    }

                    // 数据日期范围配置为空的不处理
                    List<Long> dateRangeList = propertyId2DateRange.getOrDefault(propertyDTO.getId(), Collections.emptyList());
                    if (CollectionUtils.isEmpty(dateRangeList)) {
                        continue;
                    }

                    String payDateStr = CellUtils.convertCellStr(row.getCell(4));
                    LocalDate payDateLocalDate = DateTimeUtils.strToLocalDate(payDateStr, BaseConstant.DATE_FORMAT_YYYY_MM_DD);

                    // 只提取指定日期范围的数据
                    long targetDate = Long.parseLong(DateTimeUtils.localDateToStr(payDateLocalDate, BaseConstant.DATE_FORMAT_YYYYMMDD));
                    if (targetDate < dateRangeList.get(0) || targetDate > dateRangeList.get(1)) {
                        continue;
                    }

                    avHoursListBOList.add(convert2HoursBo(propertyDTO, row));
                }
                return avHoursListBOList;
            } catch (IOException e) {
                throw new InternalServerErrorException(BaseErrorCodeEnum.SYSTEM_ERROR.getI18nCode(),
                        BaseErrorCodeEnum.SYSTEM_ERROR.getCode(),
                        "Handle parse Sva Actual Hour Other report error.", e);
            }
        }

        /**
         * 将报告中的信息转换为实体类
         *
         * @param propertyDTO 资产
         * @param row         信息记录
         * @return SvaActualHoursBO
         * @author zc
         * @date 2025/4/21
         */
        private SvaActualHoursBO convert2HoursBo(PropertyDTO propertyDTO, Row row) {
            // 获取国际化配置
            InternationalizationNumberDTO numberDTO = propertyDTO.getInternationalization().getNumber();
            RoundingMode roundingMode = InternationalizationUtils.getRoundingMode(numberDTO.getCalculationRule());

            SvaActualHoursBO actualHoursBO = new SvaActualHoursBO();
            actualHoursBO.setProperty(propertyDTO.getAbbr());
            // Position ID
            actualHoursBO.setPositionId(CellUtils.convertCellStr(row.getCell(1)));
            // Department Code
            actualHoursBO.setDepartmentCode(CellUtils.convertCellStr(row.getCell(2)));
            // Department Desc
            actualHoursBO.setDepartmentDesc(CellUtils.convertCellStr(row.getCell(3)));
            // Pay Date
            actualHoursBO.setPayDateStr(CellUtils.convertCellStr(row.getCell(4)));
            // Actual Hours
            String hoursStr = CellUtils.convertCellStr(row.getCell(5));
            BigDecimal hours = new BigDecimal(hoursStr).setScale(BaseConstant.DATA_PRECISION, roundingMode);
            actualHoursBO.setHours(hours);
            // Pay Rate
            String payRateStr = CellUtils.convertCellStr(row.getCell(6));
            BigDecimal payRate = StringUtils.isBlank(payRateStr) ?
                    null : new BigDecimal(payRateStr).setScale(BaseConstant.DATA_PRECISION, roundingMode);
            actualHoursBO.setPayRate(payRate);
            // Payroll
            if (Objects.nonNull(payRate)) {
                actualHoursBO.setPayroll(payRate.multiply(hours).setScale(BaseConstant.DATA_PRECISION, roundingMode));
            }
            // Pay Code
            actualHoursBO.setPayCode(CellUtils.convertCellStr(row.getCell(7)));
            // Time In
            actualHoursBO.setTimeInStr(CellUtils.convertCellStr(row.getCell(8)));
            // Time Out
            actualHoursBO.setTimeOutStr(CellUtils.convertCellStr(row.getCell(9)));

            return actualHoursBO;
        }
    }