From e22fca2d289dabb3151d5248bf9ce8d05d927615 Mon Sep 17 00:00:00 2001
From: Junjie <fallin.jie@qq.com>
Date: 星期二, 24 三月 2026 16:55:20 +0800
Subject: [PATCH] refactor: add station reroute execution pipeline

---
 src/main/java/com/zy/core/utils/StationOperateProcessUtils.java |  544 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 544 insertions(+), 0 deletions(-)

diff --git a/src/main/java/com/zy/core/utils/StationOperateProcessUtils.java b/src/main/java/com/zy/core/utils/StationOperateProcessUtils.java
index 94b122b..d07ff5e 100644
--- a/src/main/java/com/zy/core/utils/StationOperateProcessUtils.java
+++ b/src/main/java/com/zy/core/utils/StationOperateProcessUtils.java
@@ -909,6 +909,197 @@
         );
     }
 
+    RerouteCommandPlan buildRerouteCommandPlan(RerouteContext context,
+                                               RerouteDecision decision) {
+        if (context == null) {
+            return RerouteCommandPlan.skip("missing-context");
+        }
+        if (decision == null) {
+            return RerouteCommandPlan.skip("missing-decision");
+        }
+        if (decision.skip()) {
+            return RerouteCommandPlan.skip(decision.skipReason());
+        }
+        if (context.stationThread() == null || context.stationProtocol() == null || context.wrkMast() == null) {
+            return RerouteCommandPlan.skip("missing-runtime-dependency");
+        }
+        Integer currentStationId = context.stationProtocol().getStationId();
+        Integer targetStationId = decision.targetStationId();
+        if (currentStationId == null || targetStationId == null) {
+            return RerouteCommandPlan.skip("missing-target-station");
+        }
+        if (Objects.equals(currentStationId, targetStationId)) {
+            return RerouteCommandPlan.skip("same-station");
+        }
+
+        StationCommand command = context.useRunBlockCommand()
+                ? context.stationThread().getRunBlockRerouteCommand(
+                context.wrkMast().getWrkNo(),
+                currentStationId,
+                targetStationId,
+                0,
+                context.pathLenFactor()
+        )
+                : buildOutboundMoveCommand(
+                context.stationThread(),
+                context.wrkMast(),
+                currentStationId,
+                targetStationId,
+                context.pathLenFactor()
+        );
+        if (command == null) {
+            return RerouteCommandPlan.skip("missing-command");
+        }
+        return RerouteCommandPlan.dispatch(command, decision, context.dispatchScene());
+    }
+
+    RerouteExecutionResult executeReroutePlan(RerouteContext context,
+                                              RerouteCommandPlan plan) {
+        if (context == null) {
+            return RerouteExecutionResult.skip("missing-context");
+        }
+        if (plan == null) {
+            return RerouteExecutionResult.skip("missing-plan");
+        }
+        if (plan.skip()) {
+            return RerouteExecutionResult.skip(plan.skipReason());
+        }
+        StationProtocol stationProtocol = context.stationProtocol();
+        if (stationProtocol == null) {
+            return RerouteExecutionResult.skip("missing-station-protocol");
+        }
+        Integer taskNo = stationProtocol.getTaskNo();
+        Integer stationId = stationProtocol.getStationId();
+        if (taskNo == null || taskNo <= 0 || stationId == null) {
+            return RerouteExecutionResult.skip("invalid-station-task");
+        }
+        if (context.checkRecentDispatch()
+                && shouldSkipIdleRecoverForRecentDispatch(taskNo, stationId)) {
+            return RerouteExecutionResult.skip("recent-dispatch");
+        }
+        if (countCurrentTaskBufferCommands(stationProtocol.getTaskBufferItems(), taskNo) > 0) {
+            return RerouteExecutionResult.skip("buffer-has-current-task");
+        }
+        if (context.checkSuppressDispatch()
+                && stationMoveCoordinator != null
+                && stationMoveCoordinator.shouldSuppressDispatch(taskNo, stationId, plan.command())) {
+            return RerouteExecutionResult.skip("dispatch-suppressed");
+        }
+        if (context.requireOutOrderDispatchLock()
+                && !tryAcquireOutOrderDispatchLock(taskNo, stationId)) {
+            return RerouteExecutionResult.skip("out-order-lock");
+        }
+
+        if (context.cancelSessionBeforeDispatch() && stationMoveCoordinator != null) {
+            stationMoveCoordinator.cancelSession(taskNo);
+        }
+        if (!isBlank(context.executionLockKey())) {
+            Object lock = redisUtil.get(context.executionLockKey());
+            if (lock != null) {
+                return RerouteExecutionResult.skip("scene-lock");
+            }
+            redisUtil.set(context.executionLockKey(), "lock", context.executionLockSeconds());
+        }
+        if (context.resetSegmentCommandsBeforeDispatch()) {
+            resetSegmentMoveCommandsBeforeReroute(taskNo);
+        }
+
+        int clearedCommandCount = 0;
+        if (context.clearIdleIssuedCommands()) {
+            clearedCommandCount = clearIssuedMoveCommandsDuringIdleStay(context.idleTrack(), taskNo, stationId);
+        }
+
+        boolean offered = offerDevpCommandWithDedup(context.dispatchDeviceNo(), plan.command(), plan.dispatchScene());
+        if (!offered) {
+            return RerouteExecutionResult.skip("dispatch-dedup");
+        }
+
+        applyRerouteDispatchEffects(context, plan, clearedCommandCount);
+        return RerouteExecutionResult.dispatched(plan.command(), clearedCommandCount);
+    }
+
+    private RerouteDecision resolveSharedRerouteDecision(RerouteContext context) {
+        if (context == null || context.wrkMast() == null || context.stationProtocol() == null) {
+            return RerouteDecision.skip("missing-runtime-dependency");
+        }
+        Integer currentStationId = context.stationProtocol().getStationId();
+        if (currentStationId == null) {
+            return RerouteDecision.skip("missing-current-station");
+        }
+
+        if (context.sceneType() == RerouteSceneType.IDLE_RECOVER
+                && !Objects.equals(context.wrkMast().getWrkSts(), WrkStsType.STATION_RUN.sts)) {
+            Integer targetStationId = context.wrkMast().getStaNo();
+            return targetStationId == null || Objects.equals(targetStationId, currentStationId)
+                    ? RerouteDecision.skip("same-station")
+                    : RerouteDecision.proceed(targetStationId);
+        }
+
+        OutOrderDispatchDecision dispatchDecision = resolveOutboundDispatchDecision(
+                currentStationId,
+                context.wrkMast(),
+                context.outOrderStationIds(),
+                context.pathLenFactor()
+        );
+        Integer targetStationId = dispatchDecision == null ? null : dispatchDecision.getTargetStationId();
+        if (targetStationId == null || Objects.equals(targetStationId, currentStationId)) {
+            return RerouteDecision.skip("same-station");
+        }
+        return RerouteDecision.proceed(targetStationId, dispatchDecision);
+    }
+
+    private RerouteExecutionResult executeSharedReroute(RerouteContext context) {
+        RerouteDecision decision = resolveSharedRerouteDecision(context);
+        if (decision.skip()) {
+            return RerouteExecutionResult.skip(decision.skipReason());
+        }
+        RerouteCommandPlan plan = buildRerouteCommandPlan(context, decision);
+        return executeReroutePlan(context, plan);
+    }
+
+    private void applyRerouteDispatchEffects(RerouteContext context,
+                                             RerouteCommandPlan plan,
+                                             int clearedCommandCount) {
+        if (context == null || plan == null || plan.command() == null || context.wrkMast() == null || context.stationProtocol() == null) {
+            return;
+        }
+        WrkMast wrkMast = context.wrkMast();
+        StationProtocol stationProtocol = context.stationProtocol();
+        OutOrderDispatchDecision dispatchDecision = plan.decision() == null ? null : plan.decision().dispatchDecision();
+
+        syncOutOrderWatchState(wrkMast, stationProtocol.getStationId(), context.outOrderStationIds(), dispatchDecision, plan.command());
+        if (stationMoveCoordinator != null) {
+            stationMoveCoordinator.recordDispatch(
+                    wrkMast.getWrkNo(),
+                    stationProtocol.getStationId(),
+                    plan.dispatchScene(),
+                    plan.command(),
+                    dispatchDecision != null && dispatchDecision.isCircle()
+            );
+        }
+        if (context.sceneType() == RerouteSceneType.IDLE_RECOVER) {
+            saveStationTaskIdleTrack(new StationTaskIdleTrack(wrkMast.getWrkNo(), stationProtocol.getStationId(), System.currentTimeMillis()));
+            News.info("杈撻�佺珯鐐逛换鍔″仠鐣檣}绉掓湭杩愯锛屽凡閲嶆柊璁$畻璺緞骞堕噸鍚繍琛岋紝绔欑偣鍙�={}锛岀洰鏍囩珯={}锛屽伐浣滃彿={}锛屾竻鐞嗘棫鍒嗘鍛戒护鏁�={}锛屽懡浠ゆ暟鎹�={}",
+                    STATION_IDLE_RECOVER_SECONDS,
+                    stationProtocol.getStationId(),
+                    plan.command().getTargetStaNo(),
+                    wrkMast.getWrkNo(),
+                    clearedCommandCount,
+                    JSON.toJSONString(plan.command()));
+            return;
+        }
+        if (context.sceneType() == RerouteSceneType.RUN_BLOCK_REROUTE) {
+            News.info("杈撻�佺珯鐐瑰牭濉炲悗閲嶆柊璁$畻璺緞鍛戒护涓嬪彂鎴愬姛锛岀珯鐐瑰彿={}锛屽伐浣滃彿={}锛屽懡浠ゆ暟鎹�={}",
+                    stationProtocol.getStationId(),
+                    wrkMast.getWrkNo(),
+                    JSON.toJSONString(plan.command()));
+            return;
+        }
+        if (context.sceneType() == RerouteSceneType.OUT_ORDER) {
+            News.info(dispatchDecision != null && dispatchDecision.isCircle() ? "{}浠诲姟杩涜缁曞湀" : "{}浠诲姟鐩存帴鍘荤洰鏍囩偣", wrkMast.getWrkNo());
+        }
+    }
+
     private List<NavigateNode> calcOutboundNavigatePath(WrkMast wrkMast,
                                                         Integer sourceStationId,
                                                         Integer targetStationId,
@@ -1434,6 +1625,9 @@
         }
 
         StationTaskIdleTrack idleTrack = touchStationTaskIdleTrack(stationProtocol.getTaskNo(), stationProtocol.getStationId());
+        if (shouldSkipIdleRecoverForRecentDispatch(stationProtocol.getTaskNo(), stationProtocol.getStationId())) {
+            return;
+        }
         if (idleTrack == null || !idleTrack.isTimeout(STATION_IDLE_RECOVER_SECONDS)) {
             return;
         }
@@ -1519,6 +1713,29 @@
         }
         return Objects.equals(wrkMast.getWrkSts(), WrkStsType.INBOUND_STATION_RUN.sts)
                 || Objects.equals(wrkMast.getWrkSts(), WrkStsType.STATION_RUN.sts);
+    }
+
+    private boolean shouldSkipIdleRecoverForRecentDispatch(Integer taskNo, Integer stationId) {
+        if (stationMoveCoordinator == null || taskNo == null || taskNo <= 0 || stationId == null) {
+            return false;
+        }
+        StationMoveSession session = stationMoveCoordinator.loadSession(taskNo);
+        if (session == null || !session.isActive() || session.getLastIssuedAt() == null) {
+            return false;
+        }
+        if (!Objects.equals(stationId, session.getCurrentStationId())
+                && !Objects.equals(stationId, session.getDispatchStationId())) {
+            return false;
+        }
+        long elapsedMs = System.currentTimeMillis() - session.getLastIssuedAt();
+        long thresholdMs = STATION_IDLE_RECOVER_SECONDS * 1000L;
+        if (elapsedMs >= thresholdMs) {
+            return false;
+        }
+        saveStationTaskIdleTrack(new StationTaskIdleTrack(taskNo, stationId, System.currentTimeMillis()));
+        News.info("杈撻�佺珯鐐逛换鍔″垰瀹屾垚鍛戒护涓嬪彂锛屽凡璺宠繃鍋滅暀閲嶇畻銆傜珯鐐瑰彿={}锛屽伐浣滃彿={}锛岃窛涓婃涓嬪彂={}ms锛宺outeVersion={}",
+                stationId, taskNo, elapsedMs, session.getRouteVersion());
+        return true;
     }
 
     private void resetSegmentMoveCommandsBeforeReroute(Integer taskNo) {
@@ -1914,6 +2131,333 @@
         return pathLenFactor;
     }
 
+    enum RerouteSceneType {
+        RUN_BLOCK_REROUTE,
+        IDLE_RECOVER,
+        OUT_ORDER,
+        WATCH_CIRCLE
+    }
+
+    static final class RerouteDecision {
+        private final boolean skip;
+        private final String skipReason;
+        private final Integer targetStationId;
+        private final OutOrderDispatchDecision dispatchDecision;
+
+        private RerouteDecision(boolean skip,
+                                String skipReason,
+                                Integer targetStationId,
+                                OutOrderDispatchDecision dispatchDecision) {
+            this.skip = skip;
+            this.skipReason = skipReason;
+            this.targetStationId = targetStationId;
+            this.dispatchDecision = dispatchDecision;
+        }
+
+        static RerouteDecision skip(String reason) {
+            return new RerouteDecision(true, reason, null, null);
+        }
+
+        static RerouteDecision proceed(Integer targetStationId) {
+            return new RerouteDecision(false, null, targetStationId, null);
+        }
+
+        static RerouteDecision proceed(Integer targetStationId,
+                                       OutOrderDispatchDecision dispatchDecision) {
+            return new RerouteDecision(false, null, targetStationId, dispatchDecision);
+        }
+
+        boolean skip() {
+            return skip;
+        }
+
+        String skipReason() {
+            return skipReason;
+        }
+
+        Integer targetStationId() {
+            return targetStationId;
+        }
+
+        OutOrderDispatchDecision dispatchDecision() {
+            return dispatchDecision;
+        }
+    }
+
+    static final class RerouteContext {
+        private final RerouteSceneType sceneType;
+        private final BasDevp basDevp;
+        private final StationThread stationThread;
+        private final StationProtocol stationProtocol;
+        private final WrkMast wrkMast;
+        private final List<Integer> outOrderStationIds;
+        private final Double pathLenFactor;
+        private final String dispatchScene;
+        private Integer dispatchDeviceNo;
+        private boolean useRunBlockCommand;
+        private boolean checkSuppressDispatch;
+        private boolean requireOutOrderDispatchLock;
+        private boolean cancelSessionBeforeDispatch;
+        private boolean resetSegmentCommandsBeforeDispatch;
+        private boolean clearIdleIssuedCommands;
+        private boolean checkRecentDispatch;
+        private String executionLockKey;
+        private int executionLockSeconds;
+        private StationTaskIdleTrack idleTrack;
+
+        private RerouteContext(RerouteSceneType sceneType,
+                               BasDevp basDevp,
+                               StationThread stationThread,
+                               StationProtocol stationProtocol,
+                               WrkMast wrkMast,
+                               List<Integer> outOrderStationIds,
+                               Double pathLenFactor,
+                               String dispatchScene) {
+            this.sceneType = sceneType;
+            this.basDevp = basDevp;
+            this.stationThread = stationThread;
+            this.stationProtocol = stationProtocol;
+            this.wrkMast = wrkMast;
+            this.outOrderStationIds = outOrderStationIds == null ? Collections.emptyList() : outOrderStationIds;
+            this.pathLenFactor = pathLenFactor;
+            this.dispatchScene = dispatchScene;
+            this.dispatchDeviceNo = basDevp == null ? null : basDevp.getDevpNo();
+        }
+
+        static RerouteContext create(RerouteSceneType sceneType,
+                                     BasDevp basDevp,
+                                     StationThread stationThread,
+                                     StationProtocol stationProtocol,
+                                     WrkMast wrkMast,
+                                     List<Integer> outOrderStationIds,
+                                     Double pathLenFactor,
+                                     String dispatchScene) {
+            return new RerouteContext(sceneType, basDevp, stationThread, stationProtocol, wrkMast, outOrderStationIds, pathLenFactor, dispatchScene);
+        }
+
+        RerouteContext withDispatchDeviceNo(Integer dispatchDeviceNo) {
+            this.dispatchDeviceNo = dispatchDeviceNo;
+            return this;
+        }
+
+        RerouteContext withRunBlockCommand() {
+            this.useRunBlockCommand = true;
+            return this;
+        }
+
+        RerouteContext withSuppressDispatchGuard() {
+            this.checkSuppressDispatch = true;
+            return this;
+        }
+
+        RerouteContext withOutOrderDispatchLock() {
+            this.requireOutOrderDispatchLock = true;
+            return this;
+        }
+
+        RerouteContext withCancelSessionBeforeDispatch() {
+            this.cancelSessionBeforeDispatch = true;
+            return this;
+        }
+
+        RerouteContext withResetSegmentCommandsBeforeDispatch() {
+            this.resetSegmentCommandsBeforeDispatch = true;
+            return this;
+        }
+
+        RerouteContext clearIdleIssuedCommands(StationTaskIdleTrack idleTrack) {
+            this.clearIdleIssuedCommands = true;
+            this.idleTrack = idleTrack;
+            return this;
+        }
+
+        RerouteContext withRecentDispatchGuard() {
+            this.checkRecentDispatch = true;
+            return this;
+        }
+
+        RerouteContext withExecutionLock(String executionLockKey, int executionLockSeconds) {
+            this.executionLockKey = executionLockKey;
+            this.executionLockSeconds = executionLockSeconds;
+            return this;
+        }
+
+        RerouteSceneType sceneType() {
+            return sceneType;
+        }
+
+        BasDevp basDevp() {
+            return basDevp;
+        }
+
+        StationThread stationThread() {
+            return stationThread;
+        }
+
+        StationProtocol stationProtocol() {
+            return stationProtocol;
+        }
+
+        WrkMast wrkMast() {
+            return wrkMast;
+        }
+
+        List<Integer> outOrderStationIds() {
+            return outOrderStationIds;
+        }
+
+        Double pathLenFactor() {
+            return pathLenFactor;
+        }
+
+        String dispatchScene() {
+            return dispatchScene;
+        }
+
+        Integer dispatchDeviceNo() {
+            return dispatchDeviceNo;
+        }
+
+        boolean useRunBlockCommand() {
+            return useRunBlockCommand;
+        }
+
+        boolean checkSuppressDispatch() {
+            return checkSuppressDispatch;
+        }
+
+        boolean requireOutOrderDispatchLock() {
+            return requireOutOrderDispatchLock;
+        }
+
+        boolean cancelSessionBeforeDispatch() {
+            return cancelSessionBeforeDispatch;
+        }
+
+        boolean resetSegmentCommandsBeforeDispatch() {
+            return resetSegmentCommandsBeforeDispatch;
+        }
+
+        boolean clearIdleIssuedCommands() {
+            return clearIdleIssuedCommands;
+        }
+
+        boolean checkRecentDispatch() {
+            return checkRecentDispatch;
+        }
+
+        String executionLockKey() {
+            return executionLockKey;
+        }
+
+        int executionLockSeconds() {
+            return executionLockSeconds;
+        }
+
+        StationTaskIdleTrack idleTrack() {
+            return idleTrack;
+        }
+    }
+
+    static final class RerouteCommandPlan {
+        private final boolean skip;
+        private final String skipReason;
+        private final StationCommand command;
+        private final RerouteDecision decision;
+        private final String dispatchScene;
+
+        private RerouteCommandPlan(boolean skip,
+                                   String skipReason,
+                                   StationCommand command,
+                                   RerouteDecision decision,
+                                   String dispatchScene) {
+            this.skip = skip;
+            this.skipReason = skipReason;
+            this.command = command;
+            this.decision = decision;
+            this.dispatchScene = dispatchScene;
+        }
+
+        static RerouteCommandPlan skip(String reason) {
+            return new RerouteCommandPlan(true, reason, null, null, null);
+        }
+
+        static RerouteCommandPlan dispatch(StationCommand command,
+                                           RerouteDecision decision,
+                                           String dispatchScene) {
+            return new RerouteCommandPlan(false, null, command, decision, dispatchScene);
+        }
+
+        boolean skip() {
+            return skip;
+        }
+
+        String skipReason() {
+            return skipReason;
+        }
+
+        StationCommand command() {
+            return command;
+        }
+
+        RerouteDecision decision() {
+            return decision;
+        }
+
+        String dispatchScene() {
+            return dispatchScene;
+        }
+    }
+
+    static final class RerouteExecutionResult {
+        private final boolean skipped;
+        private final String skipReason;
+        private final boolean dispatched;
+        private final StationCommand command;
+        private final int clearedCommandCount;
+
+        private RerouteExecutionResult(boolean skipped,
+                                       String skipReason,
+                                       boolean dispatched,
+                                       StationCommand command,
+                                       int clearedCommandCount) {
+            this.skipped = skipped;
+            this.skipReason = skipReason;
+            this.dispatched = dispatched;
+            this.command = command;
+            this.clearedCommandCount = clearedCommandCount;
+        }
+
+        static RerouteExecutionResult skip(String reason) {
+            return new RerouteExecutionResult(true, reason, false, null, 0);
+        }
+
+        static RerouteExecutionResult dispatched(StationCommand command,
+                                                 int clearedCommandCount) {
+            return new RerouteExecutionResult(false, null, true, command, clearedCommandCount);
+        }
+
+        boolean skipped() {
+            return skipped;
+        }
+
+        String skipReason() {
+            return skipReason;
+        }
+
+        boolean dispatched() {
+            return dispatched;
+        }
+
+        StationCommand command() {
+            return command;
+        }
+
+        int clearedCommandCount() {
+            return clearedCommandCount;
+        }
+    }
+
     private static class OutOrderDispatchDecision {
         private final Integer targetStationId;
         private final boolean circle;

--
Gitblit v1.9.1