feat: close overseas wallet and pallet cost flow

2026-09-05 22:26:25 +08:00
parent f62283fb7f
commit 5fbd2bbd04
69 changed files with 1598 additions and 53 deletions
@@ -21,6 +21,9 @@ import org.springframework.web.bind.annotation.RequestBody;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RequestParam;
 import org.springframework.web.bind.annotation.RestController;
+import org.springframework.web.bind.annotation.RequestPart;
+import org.springframework.http.MediaType;
+import org.springframework.web.multipart.MultipartFile;
 import org.springframework.web.server.ResponseStatusException;

 import java.util.List;
@@ -91,6 +94,25 @@ public class PlatformOverseasProcurementController {
        return ApiResponse.success(service.update(requiredCustomer(customerId), orderNo, operator(user), request));
    }

+    @PostMapping(value = "/{orderNo}/files/{category}", consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
+    @PreAuthorize("hasAuthority('" + OverseasPermissions.PURCHASE_EDIT + "')")
+    public ApiResponse<OverseasProcurementResponses.FileInfo> uploadFile(
+        @AuthenticationPrincipal AuthenticatedUser user, @RequestParam String customerId,
+        @PathVariable String orderNo, @PathVariable String category, @RequestPart("file") MultipartFile file) {
+        requirePermission(user, OverseasProcurementService.MANAGE_PERMISSION);
+        return ApiResponse.success(service.uploadFile(requiredCustomer(customerId), orderNo,
+            String.valueOf(user.userId()), category.trim().toUpperCase(), file));
+    }
+
+    @PostMapping("/{orderNo}/fees")
+    @PreAuthorize("hasAuthority('" + OverseasPermissions.PURCHASE_EDIT + "')")
+    public ApiResponse<OverseasProcurementResponses.Fee> createFee(
+        @AuthenticationPrincipal AuthenticatedUser user, @RequestParam String customerId,
+        @PathVariable String orderNo, @Valid @RequestBody OverseasProcurementRequests.CreateFee request) {
+        requirePermission(user, OverseasProcurementService.MANAGE_PERMISSION);
+        return ApiResponse.success(service.createFee(requiredCustomer(customerId), orderNo, operator(user), request));
+    }
+
    private void requirePlatform(AuthenticatedUser user) {
        if (user == null || user.tenantId() == null) throw new ResponseStatusException(HttpStatus.UNAUTHORIZED);
        if (!"PLATFORM".equals(user.appCode()) || user.tenantId() != 0L) {
@@ -53,6 +53,13 @@ public final class OverseasProcurementRequests {
        @NotBlank @Size(max = 255) String idempotencyKey,
        @Size(max = 1000) String remark) {}

+    public record CreateFee(
+        @NotBlank @Size(max = 32) String feeItemCode,
+        @NotBlank @Size(max = 128) String feeItemName,
+        @NotNull @DecimalMin(value = "0.01") BigDecimal amount,
+        @NotNull @Positive Long voucherFileId,
+        @Size(max = 500) String remark) {}
+
    public record Update(
        @NotNull @Min(0) Long version,
        @Size(max = 128) String purchaseCategory,
@@ -27,6 +27,14 @@ public final class OverseasProcurementResponses {
        String idempotencyKey, String changeDetail, String remark,
        LocalDateTime createdAt) {}

+    public record FileInfo(Long id, String category, Long fileId, String fileName,
+                           String contentType, long sizeBytes, LocalDateTime createdAt) {}
+
+    public record Fee(Long id, String feeNo, String feeItemCode, String feeItemName,
+                      BigDecimal amount, String currency, Long voucherFileId,
+                      String voucherFileName, String remark, String walletStatus,
+                      String walletErrorMessage, LocalDateTime createdAt) {}
+
    public record Detail(
        Summary summary, String productUrl, String receivingAddress,
        String contactName, String contactPhone,
@@ -34,5 +42,6 @@ public final class OverseasProcurementResponses {
        String overseasCarrier, String overseasTrackingNo,
        LocalDateTime estimatedArrivalAt, String remark,
        String createdBy, String reviewedBy, String reviewRemark, LocalDateTime reviewedAt,
-        List<History> histories, List<OutboundDetail> outboundDetails) {}
+        List<History> histories, List<OutboundDetail> outboundDetails,
+        List<FileInfo> files, List<Fee> fees) {}
 }
@@ -0,0 +1,31 @@
+package com.baiyue.lastleg.procurement.entity;
+
+import com.baomidou.mybatisplus.annotation.IdType;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.Data;
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+@Data
+@TableName("ll_overseas_procurement_fee")
+public class OverseasProcurementFee {
+    @TableId(type = IdType.INPUT) private Long id;
+    private Long orderId;
+    private String customerId;
+    private String feeNo;
+    private String feeItemCode;
+    private String feeItemName;
+    private BigDecimal amount;
+    private String currency;
+    private Long voucherFileId;
+    private String voucherFileName;
+    private String remark;
+    private String walletStatus;
+    private String walletErrorCode;
+    private String walletErrorMessage;
+    private String walletCommandEventId;
+    private String createdBy;
+    private LocalDateTime createdAt;
+    private LocalDateTime updatedAt;
+}
@@ -0,0 +1,22 @@
+package com.baiyue.lastleg.procurement.entity;
+
+import com.baomidou.mybatisplus.annotation.IdType;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.Data;
+import java.time.LocalDateTime;
+
+@Data
+@TableName("ll_overseas_procurement_file")
+public class OverseasProcurementFile {
+    @TableId(type = IdType.INPUT) private Long id;
+    private Long orderId;
+    private String customerId;
+    private String category;
+    private Long fileId;
+    private String fileName;
+    private String contentType;
+    private Long sizeBytes;
+    private String createdBy;
+    private LocalDateTime createdAt;
+}
@@ -0,0 +1,53 @@
+package com.baiyue.lastleg.procurement.gateway;
+
+import com.baiyue.lastleg.config.LastlegRestClientFactory;
+import com.baiyue.lastleg.config.LastlegRestClientProperties;
+import jakarta.annotation.PostConstruct;
+import lombok.RequiredArgsConstructor;
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.core.io.ByteArrayResource;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.HttpStatusCode;
+import org.springframework.http.MediaType;
+import org.springframework.http.client.MultipartBodyBuilder;
+import org.springframework.stereotype.Component;
+import org.springframework.web.client.RestClient;
+import org.springframework.web.multipart.MultipartFile;
+import org.springframework.web.server.ResponseStatusException;
+
+@Component
+@RequiredArgsConstructor
+public class HttpProcurementFileGateway implements ProcurementFileGateway {
+    private final RestClient.Builder builder;
+    private final LastlegRestClientFactory factory;
+    private final LastlegRestClientProperties properties;
+    @Value("${baiyue.clients.file.url:http://127.0.0.1:9205}") private String baseUrl;
+    @Value("${baiyue.security.internal-service-token:}") private String token;
+    private RestClient client;
+    @PostConstruct void initialize() { client = factory.build(builder, baseUrl, properties.getProcurementFile()); }
+
+    @Override
+    public UploadedFile upload(String customerId, long orderId, long operatorId, String category, MultipartFile file) {
+        if (file == null || file.isEmpty()) throw new ResponseStatusException(HttpStatus.BAD_REQUEST, "请选择文件");
+        MultipartBodyBuilder body = new MultipartBodyBuilder();
+        try {
+            body.part("file", new ByteArrayResource(file.getBytes()) {
+                @Override public String getFilename() { return file.getOriginalFilename(); }
+            }).contentType(file.getContentType() == null ? MediaType.APPLICATION_OCTET_STREAM : MediaType.parseMediaType(file.getContentType()));
+        } catch (Exception exception) { throw new ResponseStatusException(HttpStatus.BAD_REQUEST, "采购文件无法读取", exception); }
+        String businessType = "RECEIPT".equals(category) ? "OVERSEAS_PROCUREMENT_RECEIPT" : "OVERSEAS_PROCUREMENT_VOUCHER";
+        Envelope response = client.post().uri("/internal/file/v1/business-files/{tenantId}/{businessType}/{businessId}",
+                Long.parseLong(customerId), businessType, orderId)
+            .header("X-Internal-Service-Token", token).header("X-Operator-Id", String.valueOf(operatorId))
+            .contentType(MediaType.MULTIPART_FORM_DATA).body(body.build()).retrieve()
+            .onStatus(HttpStatusCode::isError, (request, result) -> { throw new ResponseStatusException(
+                result.getStatusCode().is4xxClientError() ? HttpStatus.BAD_REQUEST : HttpStatus.SERVICE_UNAVAILABLE,
+                "采购文件上传失败"); }).body(Envelope.class);
+        if (response == null || !"200".equals(response.code()) || response.data() == null || response.data().fileId() == null)
+            throw new ResponseStatusException(HttpStatus.SERVICE_UNAVAILABLE, "文件服务未返回采购文件元数据");
+        Metadata data = response.data();
+        return new UploadedFile(data.fileId(), data.fileName(), data.contentType(), data.sizeBytes() == null ? 0 : data.sizeBytes());
+    }
+    private record Envelope(String code, String message, Metadata data) { }
+    private record Metadata(Long fileId, String fileName, String contentType, Long sizeBytes) { }
+}
@@ -0,0 +1,6 @@
+package com.baiyue.lastleg.procurement.gateway;
+import org.springframework.web.multipart.MultipartFile;
+public interface ProcurementFileGateway {
+    UploadedFile upload(String customerId, long orderId, long operatorId, String category, MultipartFile file);
+    record UploadedFile(long fileId, String fileName, String contentType, long sizeBytes) { }
+}
@@ -0,0 +1,5 @@
+package com.baiyue.lastleg.procurement.mapper;
+import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import com.baiyue.lastleg.procurement.entity.OverseasProcurementFee;
+import org.apache.ibatis.annotations.Mapper;
+@Mapper public interface OverseasProcurementFeeMapper extends BaseMapper<OverseasProcurementFee> { }
@@ -0,0 +1,5 @@
+package com.baiyue.lastleg.procurement.mapper;
+import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import com.baiyue.lastleg.procurement.entity.OverseasProcurementFile;
+import org.apache.ibatis.annotations.Mapper;
+@Mapper public interface OverseasProcurementFileMapper extends BaseMapper<OverseasProcurementFile> { }
@@ -9,6 +9,14 @@ import com.baiyue.lastleg.procurement.dto.OverseasProcurementRequests;
 import com.baiyue.lastleg.procurement.dto.OverseasProcurementResponses;
 import com.baiyue.lastleg.procurement.entity.OverseasProcurementOrder;
 import com.baiyue.lastleg.procurement.entity.OverseasProcurementStatusHistory;
+import com.baiyue.lastleg.procurement.entity.OverseasProcurementFile;
+import com.baiyue.lastleg.procurement.entity.OverseasProcurementFee;
+import com.baiyue.lastleg.procurement.mapper.OverseasProcurementFileMapper;
+import com.baiyue.lastleg.procurement.mapper.OverseasProcurementFeeMapper;
+import com.baiyue.lastleg.procurement.gateway.ProcurementFileGateway;
+import com.baiyue.lastleg.wallet.WalletCommandOutboxService;
+import com.baiyue.lastleg.wallet.WalletResultHandler;
+import com.baiyue.common.event.WalletCommandCompletedV1;
 import com.baiyue.lastleg.procurement.mapper.OverseasProcurementOrderMapper;
 import com.baiyue.lastleg.procurement.mapper.OverseasProcurementStatusHistoryMapper;
 import com.baiyue.lastleg.security.OverseasPermissions;
@@ -34,10 +42,11 @@ import java.util.Map;
 import java.util.HexFormat;
 import java.util.Objects;
 import java.util.Set;
+import org.springframework.web.multipart.MultipartFile;

@Service
-public class OverseasProcurementService {
-    @Resource private com.baiyue.lastleg.service.LastlegOrderNoGenerator orderNoGenerator;
+public class OverseasProcurementService implements WalletResultHandler {
+    @Resource private ProcurementOrderNumberGenerator orderNoGenerator;
    public static final String REVIEW_PERMISSION = OverseasPermissions.PURCHASE_REVIEW;
    public static final String MANAGE_PERMISSION = OverseasPermissions.PURCHASE_EDIT;
    public static final String PENDING_REVIEW = "PENDING_REVIEW";
@@ -49,6 +58,10 @@ public class OverseasProcurementService {
    @Resource private OverseasProcurementStatusHistoryMapper histories;
    @Resource private PartnerWarehouseDirectory warehouseDirectory;
    @Resource private ObjectMapper objectMapper;
+    @Resource private OverseasProcurementFileMapper procurementFiles;
+    @Resource private OverseasProcurementFeeMapper procurementFees;
+    @Resource private ProcurementFileGateway fileGateway;
+    @Resource private WalletCommandOutboxService walletCommands;

    @Transactional
    public OverseasProcurementResponses.Detail create(String customerId, String operatorId,
@@ -63,7 +76,7 @@ public class OverseasProcurementService {
        order.setId(IdWorker.getId());
        order.setCustomerId(customerId);
        order.setCustomerName(trim(request.customerName()));
-        order.setOrderNo(orderNoGenerator.next("PROCUREMENT", request.receivingAddress(), order.getId()));
+        order.setOrderNo(orderNoGenerator.next(customerId, request.customerName()));
        order.setPurchaseCategory(request.purchaseCategory().trim());
        order.setProductName(request.productName().trim());
        order.setProductSpecification(trim(request.productSpecification()));
@@ -148,7 +161,90 @@ public class OverseasProcurementService {
                new OverseasProcurementResponses.History(value.getOperationType(), value.getFromStatus(),
                    value.getToStatus(), value.getOperatorId(), value.getIdempotencyKey(),
                    value.getChangeDetail(), value.getRemark(),
-                    value.getCreatedAt())).toList(), outboundDetails(order));
+                    value.getCreatedAt())).toList(), outboundDetails(order), files(order), fees(order));
+    }
+
+    @Transactional
+    public OverseasProcurementResponses.FileInfo uploadFile(String customerId, String orderNo, String operatorId,
+                                                             String category, MultipartFile file) {
+        OverseasProcurementOrder order = lock(customerId, orderNo);
+        if (!Set.of("RECEIPT", "VOUCHER").contains(category)) throw badRequest("File category must be RECEIPT or VOUCHER");
+        ProcurementFileGateway.UploadedFile uploaded = fileGateway.upload(customerId, order.getId(), Long.parseLong(operatorId), category, file);
+        OverseasProcurementFile row = new OverseasProcurementFile();
+        row.setId(IdWorker.getId()); row.setOrderId(order.getId()); row.setCustomerId(customerId); row.setCategory(category);
+        row.setFileId(uploaded.fileId()); row.setFileName(uploaded.fileName()); row.setContentType(uploaded.contentType());
+        row.setSizeBytes(uploaded.sizeBytes()); row.setCreatedBy(operatorId); row.setCreatedAt(LocalDateTime.now());
+        procurementFiles.insert(row);
+        return file(row);
+    }
+
+    @Transactional
+    public OverseasProcurementResponses.Fee createFee(String customerId, String orderNo, String operatorId,
+                                                       OverseasProcurementRequests.CreateFee request) {
+        OverseasProcurementOrder order = lock(customerId, orderNo);
+        if (!APPROVED.equals(order.getStatus())) throw conflict("Only an approved procurement order can add fees");
+        OverseasProcurementFile voucher = procurementFiles.selectOne(new LambdaQueryWrapper<OverseasProcurementFile>()
+            .eq(OverseasProcurementFile::getOrderId, order.getId()).eq(OverseasProcurementFile::getCustomerId, customerId)
+            .eq(OverseasProcurementFile::getCategory, "VOUCHER").eq(OverseasProcurementFile::getFileId, request.voucherFileId()));
+        if (voucher == null) throw badRequest("Fee voucher does not belong to this procurement order");
+        LocalDateTime now = LocalDateTime.now();
+        OverseasProcurementFee row = new OverseasProcurementFee();
+        row.setId(IdWorker.getId()); row.setOrderId(order.getId()); row.setCustomerId(customerId);
+        row.setFeeNo("PF" + row.getId()); row.setFeeItemCode(request.feeItemCode().trim().toUpperCase());
+        row.setFeeItemName(request.feeItemName().trim()); row.setAmount(request.amount()); row.setCurrency("CNY");
+        row.setVoucherFileId(voucher.getFileId()); row.setVoucherFileName(voucher.getFileName()); row.setRemark(trim(request.remark()));
+        row.setWalletStatus("FREEZE_PENDING"); row.setCreatedBy(operatorId); row.setCreatedAt(now); row.setUpdatedAt(now);
+        procurementFees.insert(row);
+        String eventId = walletCommands.publish("FREEZE", Long.parseLong(customerId), "PROCUREMENT_FEE", row.getFeeNo(),
+            row.getAmount(), "海外采购费用冻结：" + orderNo, 1L);
+        row.setWalletCommandEventId(eventId); procurementFees.updateById(row);
+        return fee(row);
+    }
+
+    @Override public boolean supports(String businessType) { return "PROCUREMENT_FEE".equals(businessType); }
+
+    @Override
+    @Transactional
+    public void handle(WalletCommandCompletedV1 result) {
+        OverseasProcurementFee row = procurementFees.selectOne(new LambdaQueryWrapper<OverseasProcurementFee>()
+            .eq(OverseasProcurementFee::getCustomerId, String.valueOf(result.customerId()))
+            .eq(OverseasProcurementFee::getFeeNo, result.businessNo()));
+        if (row == null) throw notFound("Procurement fee not found for wallet result");
+        if ("SUCCEEDED".equals(result.result())) {
+            row.setWalletStatus(switch (result.operation()) { case "FREEZE" -> "FROZEN"; case "SETTLE" -> "SETTLED"; case "RELEASE" -> "RELEASED"; default -> result.holdStatus(); });
+            row.setWalletErrorCode(null); row.setWalletErrorMessage(null);
+        } else {
+            row.setWalletStatus(result.operation() + "_FAILED"); row.setWalletErrorCode(result.errorCode()); row.setWalletErrorMessage(result.errorMessage());
+        }
+        row.setUpdatedAt(LocalDateTime.now()); procurementFees.updateById(row);
+        if ("FREEZE".equals(result.operation()) && "SUCCEEDED".equals(result.result())) {
+            OverseasProcurementOrder order = orders.selectById(row.getOrderId());
+            if (order != null && order.getInboundQuantity() >= order.getPurchaseQuantity()) {
+                walletCommands.publish("SETTLE", result.customerId(), "PROCUREMENT_FEE", row.getFeeNo(), null,
+                    "海外采购完成入库，结算费用", 2L);
+                row.setWalletStatus("SETTLE_PENDING"); procurementFees.updateById(row);
+            }
+        }
+    }
+
+    private List<OverseasProcurementResponses.FileInfo> files(OverseasProcurementOrder order) {
+        return procurementFiles.selectList(new LambdaQueryWrapper<OverseasProcurementFile>()
+            .eq(OverseasProcurementFile::getOrderId, order.getId()).orderByAsc(OverseasProcurementFile::getCreatedAt))
+            .stream().map(this::file).toList();
+    }
+    private OverseasProcurementResponses.FileInfo file(OverseasProcurementFile value) {
+        return new OverseasProcurementResponses.FileInfo(value.getId(), value.getCategory(), value.getFileId(), value.getFileName(),
+            value.getContentType(), Objects.requireNonNullElse(value.getSizeBytes(), 0L), value.getCreatedAt());
+    }
+    private List<OverseasProcurementResponses.Fee> fees(OverseasProcurementOrder order) {
+        return procurementFees.selectList(new LambdaQueryWrapper<OverseasProcurementFee>()
+            .eq(OverseasProcurementFee::getOrderId, order.getId()).orderByAsc(OverseasProcurementFee::getCreatedAt))
+            .stream().map(this::fee).toList();
+    }
+    private OverseasProcurementResponses.Fee fee(OverseasProcurementFee value) {
+        return new OverseasProcurementResponses.Fee(value.getId(), value.getFeeNo(), value.getFeeItemCode(), value.getFeeItemName(),
+            value.getAmount(), value.getCurrency(), value.getVoucherFileId(), value.getVoucherFileName(), value.getRemark(),
+            value.getWalletStatus(), value.getWalletErrorMessage(), value.getCreatedAt());
    }

    @Transactional
@@ -192,6 +288,7 @@ public class OverseasProcurementService {
        Map<String, Object> before = editableSnapshot(order);
        if (request.inboundQuantity() != null) {
            if (!APPROVED.equals(order.getStatus())) throw conflict("Only an approved procurement order can receive stock");
+            if (request.inboundQuantity() > order.getPurchaseQuantity()) throw badRequest("Inbound quantity cannot exceed purchase quantity");
            order.setInboundQuantity(request.inboundQuantity());
        }
        setIfText(request.purchaseCategory(), order::setPurchaseCategory);
@@ -213,6 +310,14 @@ public class OverseasProcurementService {
        orders.updateById(order);
        history(order, "UPDATE", order.getStatus(), order.getStatus(), operatorId,
            null, changeDetail(before, after), null, now);
+        if (order.getInboundQuantity() >= order.getPurchaseQuantity()) {
+            for (OverseasProcurementFee fee : procurementFees.selectList(new LambdaQueryWrapper<OverseasProcurementFee>()
+                .eq(OverseasProcurementFee::getOrderId, order.getId()).eq(OverseasProcurementFee::getWalletStatus, "FROZEN"))) {
+                walletCommands.publish("SETTLE", Long.parseLong(customerId), "PROCUREMENT_FEE", fee.getFeeNo(), null,
+                    "海外采购完成入库，结算费用", 2L);
+                fee.setWalletStatus("SETTLE_PENDING"); fee.setUpdatedAt(now); procurementFees.updateById(fee);
+            }
+        }
        return detail(customerId, orderNo);
    }

@@ -0,0 +1,48 @@
+package com.baiyue.lastleg.procurement.service;
+
+import net.sourceforge.pinyin4j.PinyinHelper;
+import org.springframework.jdbc.core.JdbcTemplate;
+import org.springframework.stereotype.Component;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.util.StringUtils;
+
+import java.time.LocalDate;
+import java.time.format.DateTimeFormatter;
+import java.util.Locale;
+
+@Component
+public class ProcurementOrderNumberGenerator {
+    private final JdbcTemplate jdbc;
+    public ProcurementOrderNumberGenerator(JdbcTemplate jdbc) { this.jdbc = jdbc; }
+
+    @Transactional
+    public String next(String customerId, String customerName) {
+        LocalDate date = LocalDate.now();
+        jdbc.update("INSERT INTO ll_procurement_daily_sequence(customer_id,business_date,sequence_value) VALUES(?,?,LAST_INSERT_ID(1)) ON DUPLICATE KEY UPDATE sequence_value=LAST_INSERT_ID(sequence_value+1)",
+            customerId, date);
+        Integer value = jdbc.queryForObject("SELECT LAST_INSERT_ID()", Integer.class);
+        if (value == null || value < 1 || value > 9999) throw new IllegalStateException("客户采购订单当日序号已耗尽");
+        return initials(customerName) + date.format(DateTimeFormatter.BASIC_ISO_DATE) + String.format("%04d", value);
+    }
+
+    static String initials(String customerName) {
+        if (!StringUtils.hasText(customerName)) return "KH";
+        StringBuilder result = new StringBuilder();
+        boolean latinWord = false;
+        for (char value : customerName.trim().toCharArray()) {
+            if (result.length() >= 8) break;
+            if (Character.UnicodeScript.of(value) == Character.UnicodeScript.HAN) {
+                String[] pinyin = PinyinHelper.toHanyuPinyinStringArray(value);
+                if (pinyin != null && pinyin.length > 0 && !pinyin[0].isBlank()) result.append(Character.toUpperCase(pinyin[0].charAt(0)));
+                latinWord = false;
+            } else if (Character.isLetterOrDigit(value)) {
+                if (!latinWord) result.append(Character.toUpperCase(value));
+                latinWord = true;
+            } else {
+                latinWord = false;
+            }
+        }
+        String normalized = result.toString().replaceAll("[^A-Z0-9]", "").toUpperCase(Locale.ROOT);
+        return normalized.isBlank() ? "KH" : normalized.substring(0, Math.min(normalized.length(), 8));
+    }
+}