package cn.iocoder.yudao.framework.common.util.number;

import java.util.concurrent.ThreadLocalRandom;

/**
 * 业务编码（单据号 / 主数据编码）生成的公共约定。
 *
 * <p>需求：系统中所有自动生成的业务编码统一为「16 位纯数字」，且**随机生成、不使用自增/顺序**，
 * 同时保证全系统唯一（任意两条编码都不重复）。
 *
 * <p>实现约定：
 * <ul>
 *     <li>编码 = 随机 16 位数字（范围 0 ~ 10^16-1，左侧补 '0'）；</li>
 *     <li>唯一性由 Redis 集合 {@link #USED_SET_KEY} 查重保证：随机生成后写入集合，
 *         写成功（返回 1）说明没用过才采用，否则重试；</li>
 *     <li>各生成点：见 {@link #randomCode()} 与 {@link #MAX_RETRY}。</li>
 * </ul>
 *
 * <p>注意：Redis 集合丢失后，历史编码可能被重新随机命中；应用启动时会将库内已有编码
 * 重新载入集合（见 yudao-server 的启动兜底）。
 */
public class BizNoUtils {

    /**
     * 已使用业务编码的 Redis 集合 KEY，用于随机编码查重，保证全系统唯一。
     */
    public static final String USED_SET_KEY = "biz:code:used";

    /**
     * 业务编码的总长度：16 位
     */
    public static final int CODE_LENGTH = 16;

    /**
     * 随机编码的空间上限（不含）：10^16
     */
    private static final long CODE_SPACE = 10_000_000_000_000_000L;

    /**
     * 生成随机编码时的最大重试次数（命中已用编码时重试）
     */
    public static final int MAX_RETRY = 10;

    /**
     * 生成一个随机 16 位纯数字编码（左侧补 '0'），**不做查重**。
     *
     * <p>调用方需自行用 {@link #USED_SET_KEY} 查重，命中则重试。
     *
     * @return 随机 16 位纯数字编码
     */
    public static String randomCode() {
        return String.format("%0" + CODE_LENGTH + "d", ThreadLocalRandom.current().nextLong(CODE_SPACE));
    }

}