package jnpf.bizcommon.audit.service.title;

import java.util.ArrayList;
import java.util.Collections;
import java.util.List;

/** 一次操作的记录标题：主表一行 + 子表每条记录一行。 */
public final class AuditRecordTitle {

    /** {@link #subScope()} 的取值：输入侧没看全——还有子表行（甚至整张子表）根本没读。 */
    public static final String SCOPE_SCAN_TRUNCATED = "scanTruncated";

    /** {@link #subScope()} 的取值：扫描完整，但产出的标题条数撞了上限被截。 */
    public static final String SCOPE_ROWS_TRUNCATED = "rowsTruncated";

    public static final AuditRecordTitle EMPTY =
            new AuditRecordTitle(null, Collections.<String>emptyList(), null, false, null);

    private final String mainTitle;
    private final List<String> subTitles;
    private final String subTable;
    private final boolean subDataUnavailable;
    private final String subScope;

    public AuditRecordTitle(String mainTitle, List<String> subTitles,
                            String subTable, boolean subDataUnavailable, String subScope) {
        this.mainTitle = mainTitle == null || mainTitle.trim().isEmpty() ? null : mainTitle;
        this.subTitles = subTitles == null || subTitles.isEmpty()
                ? Collections.<String>emptyList()
                : Collections.unmodifiableList(new ArrayList<String>(subTitles));
        this.subTable = subTable;
        this.subDataUnavailable = subDataUnavailable;
        this.subScope = subScope;
    }

    /** 主表标题行；一个字段都没勾、或勾了但全为空时返回 null（调用方回落 bizCode）。 */
    public String mainTitle() {
        return mainTitle;
    }

    /** 子表标题行，一条子记录一行。**未必是全量**，看 {@link #subScope()}。 */
    public List<String> subTitles() {
        return subTitles;
    }

    /**
     * 子表标题的完整性。{@code null} = 完整；否则是 {@link #SCOPE_SCAN_TRUNCATED}
     * 或 {@link #SCOPE_ROWS_TRUNCATED}。
     *
     * <p><b>为什么必须有这个</b>（2026-08-05 Codex 复审 Low）：两道上限一直是**悄悄**截的，
     * 读的人看到 200 条会以为那就是全部。资源上界下推之后又多了一种截法——额度耗尽时
     * 后面整张子表都不碰，连「事件里没带这批数据」（{@link #subDataUnavailable()}）都测不出来，
     * 于是「判不了」被伪装成了「没发生」（L075，本批反复在防的同一个形状）。
     *
     * <p><b>为什么不是「把没看的补看完」</b>：那要为每张剩余子表整份反序列化一遍，
     * 正是资源上界刚拆掉的那笔开销。诚实地说「我没看全」比花大价钱看全更划算——
     * 真要全量，读的人可以去查那条记录本身。
     *
     * <p>{@code scanTruncated} 优先于 {@code rowsTruncated}：输入侧就没看全时，
     * 产出侧截没截已经不是最重要的信息了。
     */
    public String subScope() {
        return subScope;
    }

    public String subTable() {
        return subTable;
    }

    /** 表单配了子表标题字段，但事件里取不到子表数据——如实留痕，不能当成"没有子表"。 */
    public boolean subDataUnavailable() {
        return subDataUnavailable;
    }

    public boolean isEmpty() {
        return mainTitle == null && subTitles.isEmpty() && !subDataUnavailable;
    }
}