package cn.iocoder.yudao.module.qcreport.engine.rule;

import java.util.Map;

/**
 * 判定规则定义。
 * <p>
 * 与前端 {@code engine/report-evaluator.ts} 的 QualityRuleDefinition 一一对应，
 * 也就是模板 Schema 的 {@code rules} 数组里每一项的契约：
 * {@code { id, name, scope: 'item' | 'report', expression, enabled }}。
 *
 * @param id         规则标识，用于出错时定位
 * @param name       规则名称
 * @param scope      作用域：逐项判定 / 报告级汇总
 * @param expression 判定表达式，求值为真视为合格
 * @param enabled    是否参与判定，null 等同 true
 */
public record QualityRuleDefinition(String id, String name, RuleScope scope,
                                    String expression, Boolean enabled) {

    /** 是否参与判定，与前端 {@code rule.enabled !== false} 同语义 */
    public boolean active() {
        return enabled == null || enabled;
    }

    /** 出错提示里用的原始名，两者都缺时为空串（与前端 {@code rule.name ?? rule.id ?? ''} 一致） */
    public String rawLabel() {
        if (name != null) {
            return name;
        }
        return id == null ? "" : id;
    }

    /** 出错提示里用的规则名 */
    public String label() {
        String trimmed = name == null ? "" : name.trim();
        if (!trimmed.isEmpty()) {
            return trimmed;
        }
        return id == null || id.isEmpty() ? "未命名规则" : id;
    }

    /**
     * 从 Schema 的 rules 项解析，缺字段的按默认值兜底。
     * <p>
     * 只做取值不做校验：Schema 是设计器存的，格式问题会在执行时报出来，
     * 读的时候再抛一次异常只会把「一处坏数据」放大成「整份模板打不开」。
     */
    public static QualityRuleDefinition from(Map<?, ?> raw) {
        if (raw == null) {
            return null;
        }
        return new QualityRuleDefinition(
                text(raw.get("id")),
                text(raw.get("name")),
                RuleScope.of(text(raw.get("scope"))),
                text(raw.get("expression")),
                flag(raw.get("enabled")));
    }

    private static String text(Object value) {
        return value == null ? null : String.valueOf(value);
    }

    /** 只把明确的 false / "false" / 0 当作停用，缺省视为启用 */
    private static Boolean flag(Object value) {
        if (value instanceof Boolean bool) {
            return bool;
        }
        if (value instanceof Number number) {
            return number.intValue() != 0;
        }
        if (value instanceof String text) {
            return !"false".equalsIgnoreCase(text.trim());
        }
        return null;
    }

}