ERP/oa-backend/src/main/java/com/kaidi/oa/common/MoneyParser.java

package com.kaidi.oa.common;

import java.math.BigDecimal;
import java.math.RoundingMode;

/**
 * 金额文本解析收口（BigDecimal-native）。
 *
 * <p>历史上 {@code TriggerRuleEngine.parseNumber} / {@code WorkflowService.parseNumber} /
 * {@code MobileApprovalController.parseNumber} 三处各自手写了一份"剥噪声→{@code Double.parseDouble}"
 * 的金额解析，返回裸 {@code double}：自动联动据此生成付款单/发票，金额下游与台账留痕里就会冒出
 * {@code 5.07}、{@code 9.9999999997} 这类二进制浮点伪值（如 5000万经 JSON 序列化为 "5.0E7"，或
 * 表单 "10.00" 累加后抖动）。本工具把"解析"这一步直接落到 {@link BigDecimal}，杜绝中途经过 double：
 * 用 {@link BigDecimal#BigDecimal(String)}（字符串构造，精确）而非 {@code Double.parseDouble}，
 * 再统一 {@code setScale(2, HALF_UP)} 规整成"分"标度，使解析结果与 {@link Money} 完全同口径。</p>
 *
 * <p>容噪规则与原三处保持一致：剥掉 ¥/￥/元/逗号/空白等装饰字符，<b>保留</b> 数字、小数点、正负号
 * 与科学计数标记 {@code e/E}（大额金额经 JSON 常序列化为 "5.0E7"，剥掉 E 会把它错解析成 5.07，
 * 量级灾难）；末尾带「万」整体 ×10000。无法解析时返回 {@code null}（业务侧据此走"未解析到金额→跳过"）。</p>
 */
public final class MoneyParser {

    private static final BigDecimal TEN_THOUSAND = new BigDecimal("10000");

    private MoneyParser() {
    }

    /**
     * 解析金额文本 → 标度 2、HALF_UP 的 {@link BigDecimal}；解析失败返回 {@code null}。
     *
     * <p>关键：用 {@code new BigDecimal(cleaned)}（字符串精确构造，支持科学计数法），<b>绝不</b>
     * 走 {@code Double.parseDouble}，故 "5.0E7"→50000000.00、"10.00"→10.00 全程无浮点抖动。</p>
     */
    public static BigDecimal parse(String raw) {
        if (raw == null) {
            return null;
        }
        String s = raw.trim();
        if (s.isEmpty()) {
            return null;
        }
        boolean wan = s.contains("万");
        // 保留 0-9 . e E + - ，剥掉其余（¥ 元 万 千分位逗号 空白…）。务必保留 e/E：科学计数法大额。
        String cleaned = s.replaceAll("[^0-9.eE+-]", "");
        if (cleaned.isEmpty() || "+".equals(cleaned) || "-".equals(cleaned) || ".".equals(cleaned)) {
            return null;
        }
        try {
            BigDecimal v = new BigDecimal(cleaned);
            if (wan) {
                v = v.multiply(TEN_THOUSAND);
            }
            return v.setScale(Money.SCALE, RoundingMode.HALF_UP);
        } catch (NumberFormatException e) {
            return null;
        }
    }

    /**
     * 同 {@link #parse(String)}，但解析失败回退为 {@link Money#ZERO}（标度 2 的 0.00）。
     * 适合"展示/排序用金额，缺失即按 0 处理且不抛错"的场景（如移动待办列表金额列）。
     */
    public static BigDecimal parseOrZero(String raw) {
        BigDecimal v = parse(raw);
        return v == null ? Money.ZERO : v;
    }
}