package cn.lihu.jh.module.ecg.enums; import cn.lihu.jh.framework.common.core.IntArrayValuable; import lombok.AllArgsConstructor; import lombok.Getter; import java.util.Arrays; /** * 排队序号规则枚举 —— 在「检查类型管理」(system/check-type) 的 {@code check_type.seq_rule} 上配置。 * *
* 仅 {@link #TIMESLOT} 需要 —— 它受 {@code queue_sequence.queue_full} 限制; * 另两种规则号值是连续递增的,不设上限。 */ public boolean isCapacityLimited() { return this == TIMESLOT; } /** * 按规则值解析枚举;无法识别或为 null 时返回 {@link #DEFAULT}。 *
* 之所以不抛异常:该值来自数据库配置,存量行可能为 null; * 取默认值可保证升级后**行为与改造前一致**,不因未配置而阻断签到。 */ public static SeqRuleEnum parse(Integer rule) { if (rule == null) { return DEFAULT; } for (SeqRuleEnum item : values()) { if (item.rule.equals(rule)) { return item; } } return DEFAULT; } /** * 判断给定号是否为「预留号」(留给加急患者)。 *
* 规则:每 {@link #ROUND_SIZE} 个号留 {@link #RESERVED_PER_ROUND} 个。 * 以 1 为起点时,每轮的第 10 个(10、20、30…)为预留号。 * * @param seq 候选号(从 1 开始) * @return true 表示该号需跳过(除非是加急患者) */ public static boolean isReservedSeq(int seq) { return seq > 0 && seq % ROUND_SIZE == 0; } /** * 取 {@code from} 及之后第一个「非预留号」。 * *
用于普通患者:若计数器算出的号恰好是预留号(10 的倍数), * 则改用下一个号,把预留号留给加急患者。 * *
注意与调用方 {@code advanceNormalSeq} 的配合:计数器在同一事务内 * 也要跳过该预留号(多 +1),否则下一次会把同一个号再发一次。 * 详见 {@code QueueSequenceMapper#advanceNormalSeq} 的说明。 * * @param from 起始号(含) * @return 第一个非预留号 */ public static int nextNormalSeq(int from) { int seq = Math.max(1, from); while (isReservedSeq(seq)) { seq++; } return seq; } /** * 取下一个预留号(给加急患者)。 *
* 若 {@code from} 本身已是预留号则直接返回;否则跳到本轮的预留号。 * 例:from=1 → 10;from=10 → 10;from=11 → 20。 * * @param from 起始号(含) * @return 不小于 {@code from} 的第一个预留号 */ public static int nextReservedSeq(int from) { int seq = Math.max(1, from); int rem = seq % ROUND_SIZE; if (rem == 0) { return seq; } return seq + (ROUND_SIZE - rem); } }