Add PCP architecture docs and TGU ops updates

Capture current PCP architecture notes, service-map prototypes, TGU operations UI/map work, local configuration updates, database helper scripts, and request/sample JSON artifacts.

services/pcp-tgu-ops-ui/src/features/tgu-planning/TguPlanningPage.tsx

@@ -2,6 +2,7 @@ import { useCallback, useEffect, useMemo, useState } from "react";
 import { fetchPlans, fetchPlatforms, sendPlanDecision } from "../../api/tguApi";
 import type { TguPlanDecision, TguPlatform } from "../../model/tguTypes";
 import type { TguPlanUi, TimelineRange } from "../../model/timelineTypes";
+import { Tgu2DMapTab } from "../tgu-map-2d/Tgu2DMapTab";
 import { TguPlanDetails } from "./TguPlanDetails";
 import { TguPlanningLayout } from "./TguPlanningLayout";
 import { TguSidebar } from "./TguSidebar";
@@ -24,6 +25,7 @@ export function TguPlanningPage() {
   const [search, setSearch] = useState("");
   const [selectedSpacecraftId, setSelectedSpacecraftId] = useState<string>();
   const [selectedPlanId, setSelectedPlanId] = useState<string>();
+  const [activeTab, setActiveTab] = useState<"timeline" | "map">("timeline");
   const [decisionInFlight, setDecisionInFlight] = useState(false);
   const [decisionNotice, setDecisionNotice] = useState<string>();
   const [decisionError, setDecisionError] = useState<string>();
@@ -146,7 +148,9 @@ export function TguPlanningPage() {
           fromValue={fromValue}
           toValue={toValue}
           loading={loading}
+          activeTab={activeTab}
           error={pageError}
+          onTabChange={setActiveTab}
           onFromChange={setFromValue}
           onToChange={setToValue}
           onApply={applyRange}
@@ -154,40 +158,60 @@ export function TguPlanningPage() {
           onRefresh={refresh}
         />
       }
-      sidebar={
-        <TguSidebar
-          platforms={platforms}
+    >
+      {activeTab === "timeline" ? (
+        <main className="tgu-workspace">
+          <TguSidebar
+            platforms={platforms}
+            selectedSpacecraftId={selectedSpacecraftId}
+            search={search}
+            platformLoadFailed={platformLoadFailed}
+            onSearchChange={setSearch}
+            onSelectSpacecraft={(spacecraftId) => {
+              setSelectedSpacecraftId(spacecraftId);
+              setSelectedPlanId(undefined);
+              setDecisionNotice(undefined);
+            }}
+          />
+          <section className="tgu-center">
+            <TguTimeline
+              rows={rows}
+              range={appliedRange}
+              invalidRange={invalidRange}
+              selectedPlanId={selectedPlanId}
+              onSelectPlan={(planId) => {
+                setSelectedPlanId(planId);
+                const plan = plans.find((item) => item.planId === planId);
+                if (plan) {
+                  setSelectedSpacecraftId(plan.spacecraftId);
+                }
+              }}
+            />
+          </section>
+          <TguPlanDetails
+            plan={selectedPlan}
+            decisionInFlight={decisionInFlight}
+            notice={decisionNotice}
+            error={decisionError}
+            onDecision={handleDecision}
+            onClose={() => setSelectedPlanId(undefined)}
+          />
+        </main>
+      ) : (
+        <Tgu2DMapTab
+          range={appliedRange}
+          invalidRange={invalidRange}
           selectedSpacecraftId={selectedSpacecraftId}
-          search={search}
-          platformLoadFailed={platformLoadFailed}
-          onSearchChange={setSearch}
+          selectedPlan={selectedPlan}
+          platforms={platforms}
           onSelectSpacecraft={(spacecraftId) => {
             setSelectedSpacecraftId(spacecraftId);
             setSelectedPlanId(undefined);
             setDecisionNotice(undefined);
           }}
         />
-      }
-      timeline={
-        <TguTimeline
-          rows={rows}
-          range={appliedRange}
-          invalidRange={invalidRange}
-          selectedPlanId={selectedPlanId}
-          onSelectPlan={setSelectedPlanId}
-        />
-      }
-      details={
-        <TguPlanDetails
-          plan={selectedPlan}
-          decisionInFlight={decisionInFlight}
-          notice={decisionNotice}
-          error={decisionError}
-          onDecision={handleDecision}
-          onClose={() => setSelectedPlanId(undefined)}
-        />
-      }
-    />
+      )}
+    </TguPlanningLayout>
   );
 }