feat(k1): complete primary acquisition lifecycle

2026-07-17 23:03:59 +03:00
parent 9d51080d2e
commit aa3680948f
66 changed files with 6093 additions and 544 deletions
@@ -30,6 +30,10 @@ import { ObservationSessionSelect } from "./components/ObservationSessionSelect"
 import { useDevicePluginHost } from "./core/device-plugins/DevicePluginHost";
 import { useMissionRuntime } from "./core/runtime/MissionRuntimeContext";
 import type { ViewerSettings } from "./core/runtime/contracts";
+import {
+  SPATIAL_SOURCE_SWITCH_BLOCKED_REASON,
+  isSpatialSourceSwitchBlocked,
+} from "./core/runtime/acquisitionGuard";
 import {
  createLatestAsyncCommitter,
  type LatestAsyncCommitter,
@@ -144,6 +148,12 @@ export default function App() {
  const [layoutSaveNotice, setLayoutSaveNotice] = useState<string | null>(null);
  const [sceneSettings, setSceneSettings] = useState<SceneSettings>(defaultSceneSettings);
  const [displayDraft, setDisplayDraft] = useState<SceneSettings>(defaultSceneSettings);
+  const sourceSwitchBlocked = isSpatialSourceSwitchBlocked(runtime.state);
+  const sourceSwitchBlockedReason = sourceSwitchBlocked
+    ? SPATIAL_SOURCE_SWITCH_BLOCKED_REASON
+    : null;
+  const sourceSwitchBlockedRef = useRef(sourceSwitchBlocked);
+  sourceSwitchBlockedRef.current = sourceSwitchBlocked;
  const appliedProfileKeyRef = useRef<string | null>(null);
  const sceneSettingsRef = useRef<SceneSettings>(defaultSceneSettings);
  const displayDraftRef = useRef<SceneSettings>(defaultSceneSettings);
@@ -423,6 +433,9 @@ export default function App() {
  };

  const beginRecordedReplaySwitch = useCallback(async () => {
+    if (sourceSwitchBlockedRef.current) {
+      throw new Error(SPATIAL_SOURCE_SWITCH_BLOCKED_REASON);
+    }
    // useObservationSessions calls this only after backend preparation has
    // produced a validated launch descriptor. Keep the old scene mounted
    // before this point; now perform one controlled receiver teardown before
@@ -437,6 +450,9 @@ export default function App() {
  }, []);

  const acceptRecordedReplay = useCallback((launch: ObservationSessionReplayLaunch) => {
+    if (sourceSwitchBlockedRef.current) {
+      throw new Error(SPATIAL_SOURCE_SWITCH_BLOCKED_REASON);
+    }
    setRecordedReplay(launch);
    setSourceUrl(launch.sourceUrl);
    setSourceDraft(launch.sourceUrl);
@@ -447,6 +463,17 @@ export default function App() {
    if (outcome !== "accepted") setReplayTransitioning(false);
  }, []);

+  const activateAutomaticSpatialSource = useCallback(() => {
+    // A plugin-owned live/file-replay start must release any host-selected
+    // archive or manual URL before the new acquisition becomes non-terminal.
+    // This transition is an internal start boundary, not an operator source
+    // switch, so it intentionally does not consult the acquisition guard.
+    setReplayTransitioning(false);
+    setRecordedReplay(null);
+    setSourceUrl("");
+    setSourceDraft("");
+  }, []);
+
  useEffect(() => {
    // ObservationSessionSelect owns the cancellable request and unmounts when
    // the operator leaves the spatial workspace. Its unmount cannot safely
@@ -637,7 +664,8 @@ export default function App() {
                <div className="observation-header-tools">
                  <ObservationSessionSelect
                    limit={3}
-                    disabled={runtime.pendingAction !== null}
+                    disabled={runtime.pendingAction !== null || sourceSwitchBlocked}
+                    blockedReason={sourceSwitchBlockedReason}
                    onReplayBegin={beginRecordedReplaySwitch}
                    onReplayAccepted={(_session, launch) => acceptRecordedReplay(launch)}
                    onReplaySettled={(_session, outcome) => settleRecordedReplaySwitch(outcome)}
@@ -667,6 +695,7 @@ export default function App() {
            {activeDefinition.kind === "device" ? (
              <DeviceWorkspace
                onOpenSpatialScene={() => openView("spatial-scene")}
+                onActivateAutomaticSpatialSource={activateAutomaticSpatialSource}
              />
            ) : (
              <WorkspaceRenderer
@@ -682,11 +711,18 @@ export default function App() {
                  stageDisplayPatch({ accumulationSeconds })}
                onAccumulationCommit={flushDisplaySettings}
                observationLayout={observationLayout}
+                spatialControls={selection?.SpatialControlsView
+                  ? {
+                      View: selection.SpatialControlsView,
+                      model: selection.model,
+                    }
+                  : null}
                navigation={{
                  openView,
                  openSource,
                  openDisplay,
                  openLayers,
+                  activateAutomaticSpatialSource,
                }}
              />
            )}
@@ -713,7 +749,10 @@ export default function App() {
          <WindowFooterActions>
            <Button
              variant="ghost"
+              disabled={sourceSwitchBlocked}
+              title={sourceSwitchBlockedReason ?? undefined}
              onClick={() => {
+                if (sourceSwitchBlockedRef.current) return;
                setSourceDraft("");
                setSourceUrl("");
                setRecordedReplay(null);
@@ -724,8 +763,10 @@ export default function App() {
            <Button
              variant="primary"
              shape="pill"
-              disabled={!sourceDraft.trim()}
+              disabled={sourceSwitchBlocked || !sourceDraft.trim()}
+              title={sourceSwitchBlockedReason ?? undefined}
              onClick={() => {
+                if (sourceSwitchBlockedRef.current) return;
                setSourceUrl(sourceDraft.trim());
                setRecordedReplay(null);
              }}
@@ -766,9 +807,10 @@ export default function App() {
                    hint="необязательно"
                    value={sourceDraft}
                    onChange={(event) => setSourceDraft(event.target.value)}
+                    disabled={sourceSwitchBlocked}
                    spellCheck={false}
                    placeholder="rerun+http://127.0.0.1:9876/proxy"
-                    description="Пустое значение использует автоматический локальный источник. Ручной адрес нужен для другого gRPC-потока или записи RRD."
+                    description={sourceSwitchBlockedReason ?? "Пустое значение использует автоматический локальный источник. Ручной адрес нужен для другого gRPC-потока или записи RRD."}
                  />
                </div>
              ),