From d3a03f2c6e56798a98cdb44cd5fce8ee0320fc55 Mon Sep 17 00:00:00 2001
From: ishitaahelleya <ishita.ahelleya825@gmail.com>
Date: Tue, 28 Jul 2026 19:04:25 -0700
Subject: [PATCH 1/6] Fix report walkthrough, PDF generation with per-organ
 gallery, autoRotate mesh prop

---
 PanTS-Demo/package-lock.json                  |  49 ++
 PanTS-Demo/package.json                       |   1 +
 PanTS-Demo/src/components/MeshViewer.tsx      |  13 +-
 .../components/ReportScreen/ReportScreen.tsx  |  46 +-
 PanTS-Demo/src/routes/VisualizationPage.tsx   |  13 +
 flask-server/api/api_blueprint.py             | 570 +++++++++++++++---
 6 files changed, 595 insertions(+), 97 deletions(-)

diff --git a/PanTS-Demo/package-lock.json b/PanTS-Demo/package-lock.json
index 381e0263..7b2911db 100644
--- a/PanTS-Demo/package-lock.json
+++ b/PanTS-Demo/package-lock.json
@@ -20,6 +20,7 @@
         "@tabler/icons-react": "^3.34.1",
         "@tailwindcss/vite": "^4.1.12",
         "esbuild": "^0.25.9",
+        "framer-motion": "^12.42.2",
         "jszip": "^3.10.1",
         "pako": "^3.0.1",
         "react": "^19.1.1",
@@ -7891,6 +7892,33 @@
         "url": "https://github.com/sponsors/rawify"
       }
     },
+    "node_modules/framer-motion": {
+      "version": "12.42.2",
+      "resolved": "https://registry.npmjs.org/framer-motion/-/framer-motion-12.42.2.tgz",
+      "integrity": "sha512-5XY9luDiu0oHfHBjpDthFMh0ES+122w6p/papSJBweMkO8Sn+PW2QaEgRblQBpWFnuvZS5qvarpt/hO2pjGmnw==",
+      "license": "MIT",
+      "dependencies": {
+        "motion-dom": "^12.42.2",
+        "motion-utils": "^12.39.0",
+        "tslib": "^2.4.0"
+      },
+      "peerDependencies": {
+        "@emotion/is-prop-valid": "*",
+        "react": "^18.0.0 || ^19.0.0",
+        "react-dom": "^18.0.0 || ^19.0.0"
+      },
+      "peerDependenciesMeta": {
+        "@emotion/is-prop-valid": {
+          "optional": true
+        },
+        "react": {
+          "optional": true
+        },
+        "react-dom": {
+          "optional": true
+        }
+      }
+    },
     "node_modules/fs.realpath": {
       "version": "1.0.0",
       "resolved": "https://registry.npmjs.org/fs.realpath/-/fs.realpath-1.0.0.tgz",
@@ -9166,6 +9194,21 @@
         "url": "https://github.com/sponsors/ljharb"
       }
     },
+    "node_modules/motion-dom": {
+      "version": "12.42.2",
+      "resolved": "https://registry.npmjs.org/motion-dom/-/motion-dom-12.42.2.tgz",
+      "integrity": "sha512-5gIMWLp/PycBtJRJWRgjxke5n8dlvkSn2DrYW+tr3XcqAZY1xZh6BJyooJXCM8wdfM7wfMjkBJNLge1CKPUIRA==",
+      "license": "MIT",
+      "dependencies": {
+        "motion-utils": "^12.39.0"
+      }
+    },
+    "node_modules/motion-utils": {
+      "version": "12.39.0",
+      "resolved": "https://registry.npmjs.org/motion-utils/-/motion-utils-12.39.0.tgz",
+      "integrity": "sha512-8nadJAJjTtqRkmRF36FoJTrywK9nnFmnPwnSMyxaOCU7GDjN9RTMJIxx9De8ErM+vpPhMccr/6fo5WciyQLnMQ==",
+      "license": "MIT"
+    },
     "node_modules/ms": {
       "version": "2.1.3",
       "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
@@ -10651,6 +10694,12 @@
         "typescript": ">=4.8.4"
       }
     },
+    "node_modules/tslib": {
+      "version": "2.8.1",
+      "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz",
+      "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==",
+      "license": "0BSD"
+    },
     "node_modules/tunnel-rat": {
       "version": "0.1.2",
       "resolved": "https://registry.npmjs.org/tunnel-rat/-/tunnel-rat-0.1.2.tgz",
diff --git a/PanTS-Demo/package.json b/PanTS-Demo/package.json
index afbdcf28..288736f0 100644
--- a/PanTS-Demo/package.json
+++ b/PanTS-Demo/package.json
@@ -25,6 +25,7 @@
     "@tabler/icons-react": "^3.34.1",
     "@tailwindcss/vite": "^4.1.12",
     "esbuild": "^0.25.9",
+    "framer-motion": "^12.42.2",
     "jszip": "^3.10.1",
     "pako": "^3.0.1",
     "react": "^19.1.1",
diff --git a/PanTS-Demo/src/components/MeshViewer.tsx b/PanTS-Demo/src/components/MeshViewer.tsx
index 948721be..d1de7afa 100644
--- a/PanTS-Demo/src/components/MeshViewer.tsx
+++ b/PanTS-Demo/src/components/MeshViewer.tsx
@@ -18,6 +18,7 @@ type SegmentationMeshViewerProps = {
   crosshairMm: Vec3 | null
   customOrgans?: CheckBoxData[];
   labelColorMap?: { [key: number]: Color };
+  autoRotate?: boolean;
 };
 
 
@@ -31,8 +32,7 @@ export async function fetchMeshManifest(caseId: string): Promise<MeshManifest> {
   return res.json();
 }
 
-export function SegmentationMeshViewer({ caseId, checkState, loading, opacity, crosshairMm, customOrgans = [], labelColorMap = {}}: SegmentationMeshViewerProps) {
-  const [manifest, setManifest] = useState<MeshManifest | null>(null);
+export function SegmentationMeshViewer({ caseId, checkState, loading, opacity, crosshairMm, customOrgans = [], labelColorMap = {}, autoRotate = false}: SegmentationMeshViewerProps) {  const [manifest, setManifest] = useState<MeshManifest | null>(null);
   const [loaded, setLoaded] = useState<Record<number, boolean>>({});
 
   const crosshairPosition = useMemo(() => {
@@ -92,16 +92,15 @@ export function SegmentationMeshViewer({ caseId, checkState, loading, opacity, c
           <directionalLight position={[300, 500, 300]} intensity={1.2} />
 
           <Suspense fallback={null}>
-            <Bounds fit clip observe margin={1.2}>
+            <Bounds key={checkState.join(",")} fit clip observe margin={1.2}>
               <group>
                 {organs.map((organ) => {
-                  if (!loaded[organ.id]) return null;
-
+                  if (!loaded[organ.id] || !checkState[organ.id]) return null;
                   return (
                     <OrganMesh
                       key={organ.id}
                       organ={organ}
-                      visible={!!checkState[organ.id]}
+                      visible={true}
                       opacity={opacity/100}
                     />
                   );
@@ -126,7 +125,7 @@ export function SegmentationMeshViewer({ caseId, checkState, loading, opacity, c
               )}
           </Suspense>
 
-          <OrbitControls makeDefault />
+          <OrbitControls makeDefault autoRotate={autoRotate} autoRotateSpeed={2.2} />
         </Canvas>
       </main>
     </div>
diff --git a/PanTS-Demo/src/components/ReportScreen/ReportScreen.tsx b/PanTS-Demo/src/components/ReportScreen/ReportScreen.tsx
index 530488cd..c74215cb 100644
--- a/PanTS-Demo/src/components/ReportScreen/ReportScreen.tsx
+++ b/PanTS-Demo/src/components/ReportScreen/ReportScreen.tsx
@@ -34,7 +34,7 @@ interface ReportData {
 type Lang = 'patient' | 'clinical';
 type Step = number;
 
-const cache: { [k: string]: ReportData } = {};
+export const cache: { [key: string]: ReportData } = {};
 
 // ─── Styles ───────────────────────────────────────────────────────────────────
 
@@ -403,6 +403,7 @@ export default function ReportScreen({ id, onClose, onViewChange, onOrganHighlig
   const [modePromptOpen, setModePromptOpen] = useState(false);
   const [plain2, setPlain2] = useState<string[]>([]);
   const [pLoad, setPLoad] = useState(false);
+  const [pdfLoading, setPdfLoading] = useState(false);
   const startRef = useRef(Date.now());
 
   useEffect(() => {
@@ -419,6 +420,28 @@ export default function ReportScreen({ id, onClose, onViewChange, onOrganHighlig
       .catch(() => setLoading(false));
   }, [id]);
 
+
+  const handleDownloadPdf = async () => {
+    setPdfLoading(true);
+    try {
+        const res = await fetch(`${APP_CONSTANTS.API_ORIGIN}/api/generate-report-pdf/${id}`);
+        if (!res.ok) throw new Error('PDF generation failed');
+        const blob = await res.blob();
+        const url = window.URL.createObjectURL(blob);
+        const a = document.createElement('a');
+        a.href = url;
+        a.download = `case_${id}_report.pdf`;
+        document.body.appendChild(a);
+        a.click();
+        a.remove();
+        window.URL.revokeObjectURL(url);
+    } catch (e) {
+        console.error('PDF download failed:', e);
+    } finally {
+        setPdfLoading(false);
+    }
+  };
+
   const fetchPlain = useCallback(async () => {
     if (plain2.length || !data) return;
     setPLoad(true);
@@ -638,6 +661,27 @@ export default function ReportScreen({ id, onClose, onViewChange, onOrganHighlig
                   <button className="rs-toggle" onClick={() => { setLang('clinical'); setModePromptOpen(false); }} style={{ padding: '8px 14px', borderRadius: 999, border: 'none', cursor: 'pointer', fontFamily: 'inherit', fontSize: 13, fontWeight: 720, color: lang === 'clinical' ? '#08090b' : 'rgba(255,255,255,0.58)', background: lang === 'clinical' ? 'rgba(255,255,255,0.86)' : 'transparent', transition: 'all 0.2s' }}>Doctor</button>
                 </div>
               )}
+              <button
+                onClick={handleDownloadPdf}
+                disabled={pdfLoading}
+                style={{
+                  display: 'flex',
+                  alignItems: 'center',
+                  gap: 8,
+                  background: 'transparent',
+                  border: '1px solid rgba(255,255,255,0.16)',
+                  borderRadius: 12,
+                  padding: '9px 13px',
+                  cursor: pdfLoading ? 'default' : 'pointer',
+                  fontFamily: 'inherit',
+                  color: 'rgba(255,255,255,0.78)',
+                  opacity: pdfLoading ? 0.5 : 1,
+                  transition: 'all 0.2s',
+                }}
+              >
+                <span style={{ fontSize: 14, lineHeight: 1 }}>{pdfLoading ? '⏳' : '⇩'}</span>
+                <span style={{ fontSize: 11, letterSpacing: '0.04em' }}>{pdfLoading ? 'Preparing' : 'Share PDF'}</span>
+              </button>
               <button className="rs-exit" onClick={onClose} style={{ display: 'flex', alignItems: 'center', gap: 8, background: 'transparent', border: '1px solid rgba(239,68,68,0.24)', borderRadius: 12, padding: '9px 13px', cursor: 'pointer', fontFamily: 'inherit', color: 'rgba(239,68,68,0.78)', transition: 'all 0.2s' }}>
                 <span style={{ fontSize: 14, lineHeight: 1, fontWeight: 300 }}>✕</span>
                 <span style={{ fontSize: 11, letterSpacing: '0.04em' }}>Exit</span>
diff --git a/PanTS-Demo/src/routes/VisualizationPage.tsx b/PanTS-Demo/src/routes/VisualizationPage.tsx
index 1f41672a..ae295b14 100644
--- a/PanTS-Demo/src/routes/VisualizationPage.tsx
+++ b/PanTS-Demo/src/routes/VisualizationPage.tsx
@@ -42,11 +42,13 @@ import { buildViewerActions } from "../components/AIAssistant/assistantActions";
 import MaskEditPanel, { type MaskEditMode } from "../components/MaskEditPanel/MaskEditPanel";
 import MeasurementPanel from "../components/MeasurementPanel/MeasurementPanel";
 import { SegmentationMeshViewer } from "../components/MeshViewer";
+import { cache as reportDataCache } from '../components/ReportScreen/ReportScreen';
 import OrganCheckbox from "../components/OrganCheckbox";
 import PercentileBar from "../components/PercentileBar";
 import SessionHUD from "../components/ReadingSession/SessionHUD";
 import SessionSummary from "../components/ReadingSession/SessionSummary";
 import ReportScreen from "../components/ReportScreen/ReportScreen";
+
 import {
     API_BASE,
     APP_CONSTANTS,
@@ -294,6 +296,8 @@ function useToolbarFlyout() {
 		};
 	}, [open]);
 
+	
+
 	return { open, pos, groupRef, btnRef, menuRef, toggle, close };
 }
 
@@ -322,6 +326,15 @@ function VisualizationPage() {
 	const isHd =
 		typeof window !== "undefined" &&
 		new URLSearchParams(window.location.search).get("hd") === "1";
+	
+	useEffect(() => {
+		if (!isDicom && caseId && !reportDataCache[caseId]) {
+			fetch(`${API_BASE}/api/get-report-data/${caseId}`)
+				.then(r => r.json())
+				.then(j => { if (!j.error) reportDataCache[caseId] = j; })
+				.catch(() => {});
+		}
+	}, [caseId, isDicom]);
 
 	useEffect(() => {
 		let cancelled = false;
diff --git a/flask-server/api/api_blueprint.py b/flask-server/api/api_blueprint.py
index 158e5cfa..845d6353 100644
--- a/flask-server/api/api_blueprint.py
+++ b/flask-server/api/api_blueprint.py
@@ -1,6 +1,5 @@
-from flask import Blueprint, send_file, make_response, request, jsonify, Response
+from flask import Blueprint, send_file, make_response, request, jsonify, Response, current_app
 from werkzeug.utils import secure_filename
-from services.nifti_processor import NiftiProcessor
 from services.session_manager import SessionManager, generate_uuid
 from services.auto_segmentor import run_auto_segmentation, cancel_all_inference
 from services.mesh_generation import generate_mesh_manifest, generate_organ_glb_bytes
@@ -73,6 +72,9 @@ def _load_metadata_cache():
         return {}
 
 _METADATA_CACHE = _load_metadata_cache()
+_REPORT_DATA_CACHE = {}  # {case_id: report_data_dict} — avoids reloading/recomputing
+                          # the full CT+mask volume on every report/PDF request
+progress_tracker = {}  # {session_id: (start_time, expected_total_seconds)}
 
 progress_tracker = {}  # {session_id: (start_time, expected_total_seconds)}
 
@@ -452,18 +454,19 @@ def define_term():
     }), 200
  
  
-@api_blueprint.route('/get-report-data/<id>', methods=['GET'])
-def get_report_data(id):
+def _build_report_data(id):
+    """Gathers everything the report needs (RadGPT text, organ volumes/status/
+    centroid/dimensions, lesions) into a plain dict. Shared by the JSON
+    endpoint and the PDF-generation endpoint so both show identical data."""
     if id is None or not str(id).isdigit():
-        return jsonify({"error": "Invalid id parameter"}), 400
+        return {"error": "Invalid id parameter"}
     case_id = int(id)
+    id = str(case_id)
+
+    if id in _REPORT_DATA_CACHE:
+        return _REPORT_DATA_CACHE[id]
+    
     try:
-        if id is None or not str(id).isdigit():
-            return jsonify({"error": "Invalid id parameter"}), 400
-        id = str(int(id))
-        # ── Try RadGPT structured report from metadata.xlsx first ─────────────
-        # This uses Zongwei Zhou's own RadGPT model output — more accurate
-        # than Ollama-generated impressions. Falls back to Ollama if not found.
         radgpt_comments = None
         radgpt_impression = None
         try:
@@ -481,9 +484,7 @@ def get_report_data(id):
                         row_id = str(row[id_col] or '').strip()
                         if row_id == pants_id:
                             raw = str(row[report_col] or '')
-                            # Clean Windows carriage return artifacts
                             raw = raw.replace('_x000D_', '\n').replace('\r\n', '\n').replace('\r', '\n')
-                            # Collapse multiple blank lines
                             import re as _re
                             raw = _re.sub(r'\n{3,}', '\n\n', raw)
                             findings_match = re.search(r'FINDINGS:(.*?)(?=IMPRESSION:|$)', raw, re.DOTALL)
@@ -492,7 +493,6 @@ def get_report_data(id):
                                 radgpt_comments = findings_match.group(1).strip()
                             if impression_match:
                                 imp_text = impression_match.group(1).strip()
-                                # Keep full impression, split into sentences
                                 sentences = [s.strip() for s in re.split(r'(?<=[.!?])\s+', imp_text) if s.strip()]
                                 radgpt_impression = sentences if sentences else [imp_text]
                             print(f"[RadGPT] Found report for case {id}: {radgpt_impression}")
@@ -500,24 +500,21 @@ def get_report_data(id):
                 wb.close()
         except Exception as e:
             print(f"[RadGPT] metadata lookup failed: {e}")
-        # ─────────────────────────────────────────────────────────────────────
+
         subfolder = "ImageTr" if case_id < 9000 else "ImageTe"
         label_subfolder = "LabelTr" if case_id < 9000 else "LabelTe"
-        # Check image_only first (new structure), fall back to data/ImageTr
         image_only_path = f"{Constants.PANTS_PATH}/image_only/{get_panTS_id(case_id)}/{Constants.MAIN_NIFTI_FILENAME}"
         data_ct_path = f"{Constants.PANTS_PATH}/data/{subfolder}/{get_panTS_id(case_id)}/{Constants.MAIN_NIFTI_FILENAME}"
         ct_path = image_only_path if os.path.exists(image_only_path) else data_ct_path
-        # Check mask_only first (new structure), fall back to data/LabelTe
         mask_only_path = f"{Constants.PANTS_PATH}/mask_only/{get_panTS_id(case_id)}/{Constants.COMBINED_LABELS_NIFTI_FILENAME}"
         data_mask_path = f"{Constants.PANTS_PATH}/data/{label_subfolder}/{get_panTS_id(case_id)}/{Constants.COMBINED_LABELS_NIFTI_FILENAME}"
         mask_path = mask_only_path if os.path.exists(mask_only_path) else data_mask_path
-        seg_dir = f"{Constants.PANTS_PATH}/data/{label_subfolder}/{get_panTS_id(case_id)}/segmentations"
- 
+        seg_dir = f"{Constants.PANTS_PATH}/mask_only/{get_panTS_id(case_id)}/segmentations"        
         pid = get_panTS_id(case_id)
         meta = _METADATA_CACHE.get(pid, {})
         age = meta.get("age", "N/A")
         sex = meta.get("sex", "N/A")
- 
+
         wb = load_workbook(os.path.join(Constants.PANTS_PATH, "data", "metadata.xlsx"))
         sheet = wb["PanTS_metadata"]
         contrast = ""
@@ -527,8 +524,7 @@ def get_report_data(id):
                 contrast = row[3]
                 study_detail = row[8]
                 break
- 
-        # If local files don't exist, download from HuggingFace
+
         if not os.path.exists(ct_path) or not os.path.exists(mask_path):
             import requests, tempfile
             pants_id = get_panTS_id(id)
@@ -550,46 +546,27 @@ def get_report_data(id):
                 with open(mask_path, 'wb') as f:
                     for chunk in r.iter_content(chunk_size=8192):
                         f.write(chunk)
- 
+
         ct_nii = nib.load(ct_path)
         spacing = ct_nii.header.get_zooms()
         shape = ct_nii.shape
         ct_array = ct_nii.get_fdata()
         mask_nii = nib.load(mask_path)
         mask_array = mask_nii.get_fdata().astype(np.uint8)
-        # Crop both arrays to the minimum shape along each axis
-        # to handle slight size mismatches between CT and mask
         min_shape = tuple(min(c, m) for c, m in zip(ct_array.shape, mask_array.shape))
         ct_array = ct_array[:min_shape[0], :min_shape[1], :min_shape[2]]
         mask_array = mask_array[:min_shape[0], :min_shape[1], :min_shape[2]]
         voxel_volume = np.prod(mask_nii.header.get_zooms()) / 1000
-        # World-space affine - converts a voxel index (i, j, k) to real
-        # millimeter coordinates. This is what makes the centroid below a
-        # REAL position usable by moveCornerstoneCrosshairToMm, rather
-        # than a placeholder.
         affine = mask_nii.affine
- 
+
         LABELS = {v: k for k, v in Constants.PREDEFINED_LABELS.items()}
- 
-        # Soft physiological sanity ranges per organ type, used only to
-        # flag "this needs review" vs "looks normal" internally. NOT
-        # shown to the user as raw numbers - the frontend only ever sees
-        # the `status` field. This is a stopgap for a known upstream
-        # segmentation/data issue where some organs read in the air range;
-        # rather than silently showing a wrong number as fact, or trying
-        # to "correct" the data here, we flag it so the UI can say
-        # "needs review" instead of presenting a confident wrong reading.
-        SOLID_ORGAN_HU_RANGE = (-20, 150)      # liver, spleen, kidney, pancreas, etc.
-        GI_HOLLOW_ORGAN_HU_RANGE = (-300, 200)  # colon, stomach, intestine, duodenum - tightened from
-                                                 # -1000 so a mean this close to pure air (e.g. -756 for
-                                                 # colon) correctly flags "check" instead of "normal" -
-                                                 # a real colon has enough wall/stool tissue that a mean
-                                                 # in the deep-air range usually signals a segmentation
-                                                 # issue, not a genuinely normal reading.
-        LUNG_HU_RANGE = (-1000, -200)            # lungs are genuinely air-filled - this range is correct as-is
+
+        SOLID_ORGAN_HU_RANGE = (-20, 150)
+        GI_HOLLOW_ORGAN_HU_RANGE = (-300, 200)
+        LUNG_HU_RANGE = (-1000, -200)
         GI_HOLLOW_ORGANS = {"colon", "stomach", "intestine", "duodenum"}
         LUNG_ORGANS = {"lung_left", "lung_right"}
- 
+
         organ_volumes = {}
         NO_FLAG_ORGANS = {
             "femur_left", "femur_right", "aorta", "postcava", "veins",
@@ -604,7 +581,7 @@ def get_report_data(id):
                 continue
             volume = float(np.sum(mask) * voxel_volume)
             mean_hu = float(np.mean(ct_array[mask]))
- 
+
             if organ in LUNG_ORGANS:
                 lo, hi = LUNG_HU_RANGE
             elif organ in GI_HOLLOW_ORGANS:
@@ -612,61 +589,50 @@ def get_report_data(id):
             else:
                 lo, hi = SOLID_ORGAN_HU_RANGE
             status = "normal" if organ in NO_FLAG_ORGANS else ("check" if (mean_hu < lo or mean_hu > hi) else "normal")
- 
-            # Real centroid: voxel-space center of mass, converted to mm
-            # via the affine. This is genuine anatomical position - not a
-            # placeholder - and feeds the same crosshair-navigation
-            # plumbing already used elsewhere (moveCornerstoneCrosshairToMm
-            # / moveNiiVueCrosshairToMm) for click-to-jump.
+
             voxel_coords = np.argwhere(mask)
-            centroid_voxel = voxel_coords.mean(axis=0)  # (i, j, k) in voxel space
+            centroid_voxel = voxel_coords.mean(axis=0)
             centroid_world = nib.affines.apply_affine(affine, centroid_voxel)
- 
-            # Bounding box dimensions in cm (real physical size of the organ)
+
             bbox_min = voxel_coords.min(axis=0)
             bbox_max = voxel_coords.max(axis=0)
             bbox_voxels = bbox_max - bbox_min + 1
-            # Convert voxel counts to mm using spacing, then to cm
             spacing_mm = np.abs([affine[0,0], affine[1,1], affine[2,2]])
             dims_mm = bbox_voxels * spacing_mm
             dims_cm = [round(float(d)/10, 1) for d in dims_mm]
- 
+
             organ_volumes[organ] = {
-                "volume": round(volume, 2),
-                "mean_hu": round(mean_hu, 1),
+                "volume": round(float(volume), 2),
+                "mean_hu": round(float(mean_hu), 1),
                 "status": status,
                 "centroid_mm": [round(float(c), 2) for c in centroid_world],
                 "dimensions": dims_cm,
             }
- 
+
         lesions = {}
         lesion_files = {
-            "pancreas": "pancreatic_lesion.npz",
-            "liver": "liver_lesion.npz",
-            "kidney": "kidney_lesion.npz",
+            "pancreas": "pancreatic_lesion.nii.gz",
+            "liver": "liver_lesion.nii.gz",
+            "kidney": "kidney_lesion.nii.gz",
         }
         for organ, filename in lesion_files.items():
             path = os.path.join(seg_dir, filename)
             if os.path.exists(path):
-                data = np.load(path)["data"]
-                voxels = int(np.sum(data > 0))
+                lesion_data = nib.load(path).get_fdata()
+                voxels = int(np.sum(lesion_data > 0))
                 if voxels > 0:
                     lesion_volume = round(voxels * voxel_volume, 2)
-                    lesions[organ] = {"voxels": voxels, "volume": lesion_volume}
- 
-        organ_data_str = ""
-        for organ, vals in organ_volumes.items():
-            organ_data_str += f"{organ.replace('_', ' ')}: volume={vals['volume']}cc, mean HU={vals['mean_hu']}\n"
- 
-        # If we have a RadGPT report, it is the authoritative source for organ status.
-        # Reset everything to normal first, then flag only what RadGPT calls abnormal.
+                    lesions[organ] = {"voxels": voxels, "volume": round(float(lesion_volume), 2)}
+
+        print(f"[DEBUG] seg_dir={seg_dir}")
+        print(f"[DEBUG] lesions found: {lesions}")
+
         if radgpt_comments:
             for organ in list(organ_volumes.keys()):
                 organ_volumes[organ]['status'] = 'normal'
             abnormal_keywords = ['enlarged', 'mass', 'lesion', 'tumor', 'abnormal',
                                  'dilated', 'obstruction', 'isoattenuating', 'hypodense',
                                  'hyperdense', 'cyst', 'nodule', 'atrophy', 'bilateral']
-            # Build stripped root for flexible matching
             organ_roots = {}
             for organ in organ_volumes.keys():
                 root = organ.replace('_left','').replace('_right','').replace('_body','') \
@@ -677,20 +643,17 @@ def get_report_data(id):
                 line_stripped = line.lower().replace(' ','').replace('_','')
                 if any(kw in line.lower() for kw in abnormal_keywords):
                     for organ, root in organ_roots.items():
-                        # Skip subtypes unless explicitly mentioned
-                        # e.g. "pancreas enlarged" shouldn't flag pancreas_body/head/tail
                         if '_body' in organ or '_head' in organ or '_tail' in organ or '_duct' in organ:
-                            # Only flag subtype if the subtype word is in the line
                             subtype = organ.split('_')[-1]
                             if root in line_stripped and subtype in line.lower():
                                 organ_volumes[organ]['status'] = 'check'
                         else:
                             if root in line_stripped:
                                 organ_volumes[organ]['status'] = 'check'
+
         comments = radgpt_comments or "Clinical comments unavailable."
         impression_items = radgpt_impression or ["No impression available for this case."]
- 
-        return jsonify({
+        result = {
             "case_id": id,
             "patient": {"age": age, "sex": sex},
             "imaging": {
@@ -703,14 +666,443 @@ def get_report_data(id):
             "lesions": lesions,
             "comments": comments,
             "impression": impression_items,
-        })
- 
-    except Exception as e:
-        import traceback
-        traceback.print_exc()
-        return jsonify({"error": "An internal error occurred."}), 500
- 
+        }
+        _REPORT_DATA_CACHE[id] = result
+        return result
+    except Exception:
+        return {"error": "Failed to build report data for the given id."}
+
+
+@api_blueprint.route('/get-report-data/<id>', methods=['GET'])
+def get_report_data(id):
+    data = _build_report_data(id)
+    if "error" in data:
+        status = 400 if data["error"] == "Invalid id parameter" else 500
+        return jsonify(data), status
+    return jsonify(data)
  
+
+def _draw_report_pdf(report_data, temp_pdf_path, output_pdf_path):
+    """Lays out report_data onto the report_template_3.pdf template using reportlab."""
+    from reportlab.pdfgen import canvas as _canvas
+    from reportlab.lib.pagesizes import letter
+    from reportlab.lib.colors import HexColor
+    from PyPDF2 import PdfReader, PdfWriter
+    from PyPDF2._page import PageObject
+
+    # ---- Palette (matches the web app's teal/amber accents) ----
+    INK = HexColor("#1a1a1f")
+    MUTED = HexColor("#6b7280")
+    LINE = HexColor("#e5e7eb")
+    TEAL = HexColor("#0d9488")
+    TEAL_BG = HexColor("#f0fdfa")
+    AMBER = HexColor("#b45309")
+    AMBER_BG = HexColor("#fffbeb")
+    ROW_ALT = HexColor("#f9fafb")
+
+    pdf = _canvas.Canvas(temp_pdf_path, pagesize=letter)
+    width, height = letter
+    left_margin, right_margin, top_margin = 50, 50, 100
+    content_width = width - left_margin - right_margin
+    line_height, section_spacing = 13, 26
+    y_position = height - top_margin
+
+    def reset_page():
+        nonlocal y_position
+        pdf.showPage()
+        y_position = height - 120
+        pdf.setFont("Helvetica", 10)
+        pdf.setFillColor(INK)
+
+    def check_and_reset_page(space_needed):
+        nonlocal y_position
+        if y_position - space_needed < 60:
+            reset_page()
+
+    def section_header(label):
+        nonlocal y_position
+        check_and_reset_page(40)
+        pdf.setFillColor(TEAL)
+        pdf.rect(left_margin, y_position - 3, 3, 14, fill=1, stroke=0)
+        pdf.setFont("Helvetica-Bold", 12)
+        pdf.setFillColor(INK)
+        pdf.drawString(left_margin + 10, y_position, label)
+        y_position -= line_height + 6
+
+    def write_wrapped_text(x, y, content, font_size=10, max_width=None, color=INK):
+        pdf.setFillColor(color)
+        pdf.setFont("Helvetica", font_size)
+        words = str(content).split()
+        current_line = ""
+        max_width = max_width or content_width
+        for word in words:
+            if pdf.stringWidth(current_line + word + " ", "Helvetica", font_size) > max_width:
+                pdf.drawString(x, y, current_line.strip())
+                y -= line_height
+                current_line = f"{word} "
+                if y < 60:
+                    reset_page()
+                    y = height - top_margin
+            else:
+                current_line += f"{word} "
+        if current_line:
+            pdf.drawString(x, y, current_line.strip())
+            y -= line_height
+        pdf.setFillColor(INK)
+        return y
+
+    def draw_status_badge(x, y, status, w=58, h=15):
+        is_check = status == "check"
+        bg = AMBER_BG if is_check else TEAL_BG
+        fg = AMBER if is_check else TEAL
+        pdf.setFillColor(bg)
+        pdf.roundRect(x, y, w, h, 4, fill=1, stroke=0)
+        pdf.setFillColor(fg)
+        pdf.setFont("Helvetica-Bold", 8)
+        label = "REVIEW" if is_check else "NORMAL"
+        text_w = pdf.stringWidth(label, "Helvetica-Bold", 8)
+        pdf.drawString(x + (w - text_w) / 2, y + 4.5, label)
+        pdf.setFillColor(INK)
+
+    def draw_organ_grid(organ_rows, x, y, total_width):
+        """2-column grid: organ name + status icon. Green check for normal,
+        amber flag for organs RadGPT flagged as needing review."""
+        col_width = total_width / 2
+        row_h = 24
+        for i, (name, status) in enumerate(organ_rows):
+            col = i % 2
+            row = i // 2
+            cx = x + col * col_width
+            cy = y - row * row_h
+            is_flagged = status == "check"
+            badge_bg = AMBER_BG if is_flagged else TEAL_BG
+            badge_fg = AMBER if is_flagged else TEAL
+            icon = "!" if is_flagged else "✓"
+            pdf.setFillColor(badge_bg)
+            pdf.roundRect(cx, cy - row_h + 6, 18, 18, 4, fill=1, stroke=0)
+            pdf.setFillColor(badge_fg)
+            pdf.setFont("Helvetica-Bold", 11)
+            pdf.drawString(cx + 6, cy - row_h + 10, icon)
+            pdf.setFillColor(INK)
+            pdf.setFont("Helvetica-Bold" if is_flagged else "Helvetica", 10)
+            pdf.drawString(cx + 26, cy - row_h + 11, name)
+        rows_used = (len(organ_rows) + 1) // 2
+        return y - rows_used * row_h
+    
+    def draw_measurements_table(rows, x, y, total_width):
+        col_organ = total_width * 0.42
+        col_volume = total_width * 0.20
+        col_hu = total_width * 0.20
+        col_status = total_width * 0.18
+        row_h = 22
+
+        # Header row
+        pdf.setFillColor(HexColor("#111827"))
+        pdf.rect(x, y - row_h, total_width, row_h, fill=1, stroke=0)
+        pdf.setFillColor(HexColor("#ffffff"))
+        pdf.setFont("Helvetica-Bold", 9)
+        headers = ["ORGAN", "VOLUME (CC)", "MEAN HU", "STATUS"]
+        col_x = [x + 10, x + col_organ + 5, x + col_organ + col_volume + 5, x + col_organ + col_volume + col_hu + 5]
+        for h_text, hx in zip(headers, col_x):
+            pdf.drawString(hx, y - row_h + 7, h_text)
+        y -= row_h
+
+        for i, row in enumerate(rows):
+            organ, volume, mean_hu, status = row
+            if y - row_h < 60:
+                pdf.showPage()
+                y = height - 120
+                pdf.setFillColor(HexColor("#111827"))
+                pdf.rect(x, y - row_h, total_width, row_h, fill=1, stroke=0)
+                pdf.setFillColor(HexColor("#ffffff"))
+                pdf.setFont("Helvetica-Bold", 9)
+                for h_text, hx in zip(headers, col_x):
+                    pdf.drawString(hx, y - row_h + 7, h_text)
+                y -= row_h
+
+            if i % 2 == 1:
+                pdf.setFillColor(ROW_ALT)
+                pdf.rect(x, y - row_h, total_width, row_h, fill=1, stroke=0)
+
+            pdf.setFillColor(INK)
+            pdf.setFont("Helvetica", 9)
+            pdf.drawString(x + 10, y - row_h + 7, organ)
+            pdf.drawString(x + col_organ + 5, y - row_h + 7, f"{volume:.1f}")
+            pdf.drawString(x + col_organ + col_volume + 5, y - row_h + 7, f"{mean_hu:.1f}")
+            draw_status_badge(x + col_organ + col_volume + col_hu + 5, y - row_h + 4, status)
+
+            pdf.setStrokeColor(LINE)
+            pdf.line(x, y - row_h, x + total_width, y - row_h)
+            y -= row_h
+        return y
+
+    # ==================== TITLE ====================
+    pdf.setFillColor(TEAL)
+    pdf.rect(left_margin, height - 95, content_width, 3, fill=1, stroke=0)
+    pdf.setFillColor(INK)
+    pdf.setFont("Helvetica-Bold", 22)
+    pdf.drawString(left_margin, height - 125, "CT Scan Report")
+    pdf.setFont("Helvetica", 10)
+    pdf.setFillColor(MUTED)
+    pdf.drawString(left_margin, height - 142, "Generated by BodyMaps")
+    pdf.setFillColor(INK)
+    y_position = height - 172
+
+    # ==================== PATIENT / IMAGING (2-column) ====================
+    section_header("PATIENT & IMAGING")
+    patient = report_data.get("patient", {})
+    imaging = report_data.get("imaging", {})
+    col2_x = left_margin + content_width / 2 + 10
+    row_start = y_position
+
+    left_y = write_wrapped_text(left_margin, row_start, f"Case ID:  {report_data.get('case_id', 'N/A')}", color=MUTED, max_width=content_width/2 - 15)
+    left_y = write_wrapped_text(left_margin, left_y, f"Age:  {patient.get('age', 'N/A')}", color=MUTED, max_width=content_width/2 - 15)
+    left_y = write_wrapped_text(left_margin, left_y, f"Sex:  {patient.get('sex', 'N/A')}", color=MUTED, max_width=content_width/2 - 15)
+
+    right_y = write_wrapped_text(col2_x, row_start, f"Study:  {imaging.get('study_type', 'N/A')}", color=MUTED, max_width=content_width/2 - 15)
+    right_y = write_wrapped_text(col2_x, right_y, f"Contrast:  {imaging.get('contrast', 'N/A')}", color=MUTED, max_width=content_width/2 - 15)
+    spacing = imaging.get("spacing") or []
+    right_y = write_wrapped_text(col2_x, right_y, f"Spacing:  {', '.join(str(s) for s in spacing)} mm", color=MUTED, max_width=content_width/2 - 15)
+
+    y_position = min(left_y, right_y) - section_spacing
+
+    # ==================== ORGANS REVIEWED ====================
+    check_and_reset_page(160)
+    section_header("ORGANS REVIEWED")
+    organ_volumes = report_data.get("organ_volumes", {})
+    organ_rows = sorted(
+        (organ.replace("_", " ").title(), vals.get("status", "normal"))
+        for organ, vals in organ_volumes.items()
+    )
+    y_position = draw_organ_grid(organ_rows, left_margin, y_position, content_width)
+    y_position -= section_spacing
+
+    # ==================== COMMENTS ====================
+    check_and_reset_page(100)
+    section_header("COMMENTS")
+    for line in str(report_data.get("comments", "")).split("\n"):
+        if line.strip():
+            y_position = write_wrapped_text(left_margin, y_position, line.strip())
+    y_position -= section_spacing
+
+    # ==================== IMPRESSION ====================
+    check_and_reset_page(120)  # give it more breathing room so it doesn't
+                                 # get stranded with a big gap above it
+    section_header("IMPRESSION")
+    impression_items = report_data.get("impression", [])
+    for i, item in enumerate(impression_items, 1):
+        text = str(item).strip()
+        if text:
+            y_position = write_wrapped_text(left_margin, y_position, f"{i}.  {text}")
+    y_position -= section_spacing
+
+    # ==================== KEY IMAGES ====================
+    lesions = report_data.get("lesions", {})
+    case_id = report_data.get("case_id")
+    pants_id = get_panTS_id(case_id)
+    ct_path = f"{Constants.PANTS_PATH}/image_only/{pants_id}/{Constants.MAIN_NIFTI_FILENAME}"
+    mask_path_combined = f"{Constants.PANTS_PATH}/mask_only/{pants_id}/{Constants.COMBINED_LABELS_NIFTI_FILENAME}"
+    seg_dir = f"{Constants.PANTS_PATH}/mask_only/{pants_id}/segmentations"
+
+    if os.path.exists(ct_path) and os.path.exists(mask_path_combined):
+        pdf.showPage()
+        y_position = height - top_margin
+        pdf.setFillColor(TEAL)
+        pdf.rect(left_margin, y_position - 3, content_width, 3, fill=1, stroke=0)
+        pdf.setFillColor(INK)
+        pdf.setFont("Helvetica-Bold", 16)
+        pdf.drawString(left_margin, y_position - 25, "Key Images")
+        y_position -= 55
+
+        lesion_files = {
+            "pancreas": "pancreatic_lesion.nii.gz",
+            "liver": "liver_lesion.nii.gz",
+            "kidney": "kidney_lesion.nii.gz",
+        }
+        for organ in lesions.keys():
+            mask_filename = lesion_files.get(organ)
+            if not mask_filename:
+                continue
+            lesion_mask_path = os.path.join(seg_dir, mask_filename)
+            if not os.path.exists(lesion_mask_path):
+                continue
+            check_and_reset_page(230)
+            pdf.setFont("Helvetica-Bold", 12)
+            pdf.setFillColor(AMBER)
+            pdf.drawString(left_margin, y_position, f"{organ.title()} - Lesion")
+            y_position -= 18
+            overlay_path = f"/tmp/report_{case_id}_{organ}_lesion.png"
+            if _create_lesion_overlay_image(ct_path, lesion_mask_path, overlay_path):
+                pdf.drawImage(overlay_path, left_margin, y_position - 200, width=200, height=200)
+                if os.path.exists(overlay_path):
+                    os.remove(overlay_path)
+            y_position -= 220
+
+        check_and_reset_page(40)
+        pdf.setFont("Helvetica-Bold", 12)
+        pdf.setFillColor(INK)
+        pdf.drawString(left_margin, y_position, "All Organs Reviewed")
+        y_position -= 22
+
+        ct_nii = nib.load(ct_path)
+        mask_nii = nib.load(mask_path_combined)
+        ct_array = ct_nii.get_fdata()
+        mask_array = mask_nii.get_fdata().astype(np.uint8)
+        min_shape = tuple(min(c, m) for c, m in zip(ct_array.shape, mask_array.shape))
+        ct_array = ct_array[:min_shape[0], :min_shape[1], :min_shape[2]]
+        mask_array = mask_array[:min_shape[0], :min_shape[1], :min_shape[2]]
+
+        num_cols = 5
+        col_gap, row_gap = 14, 26
+        img_w = (content_width - col_gap * (num_cols - 1)) / num_cols
+        img_h = img_w
+        col_x = [left_margin + i * (img_w + col_gap) for i in range(num_cols)]
+        col_i = 0
+
+        organ_label_map = {v: k for k, v in Constants.PREDEFINED_LABELS.items()}
+        for organ, label_id in organ_label_map.items():
+            if label_id == 0:
+                continue
+            check_and_reset_page(img_h + row_gap + 20)
+            x = col_x[col_i]
+            overlay_path = f"/tmp/report_{case_id}_{organ}_overview.png"
+            if _create_organ_overview_image(ct_array, mask_array, label_id, overlay_path):
+                pdf.drawImage(overlay_path, x, y_position - img_h, width=img_w, height=img_h)
+                if os.path.exists(overlay_path):
+                    os.remove(overlay_path)
+                pdf.setFont("Helvetica", 8)
+                pdf.setFillColor(MUTED)
+                pdf.drawString(x, y_position - img_h - 12, organ.replace("_", " ").title())
+                col_i += 1
+                if col_i >= 2:
+                    col_i = 0
+                    y_position -= (img_h + row_gap)
+
+    pdf.save()
+
+    # ---- Merge onto branded template ----
+    template_pdf_path = os.getenv("TEMPLATE_PATH", "report_template_3.pdf")
+    template_reader = PdfReader(template_pdf_path)
+    content_reader = PdfReader(temp_pdf_path)
+    writer = PdfWriter()
+    for page in content_reader.pages:
+        template_page = template_reader.pages[0]
+        merged_page = PageObject.create_blank_page(
+            width=template_page.mediabox.width,
+            height=template_page.mediabox.height,
+        )
+        merged_page.merge_page(template_page)
+        merged_page.merge_page(page)
+        writer.add_page(merged_page)
+    with open(output_pdf_path, "wb") as f:
+        writer.write(f)
+
+
+def _create_lesion_overlay_image(ct_path, mask_path, output_path):
+    """Finds the most-labeled slice and saves a red-contour overlay PNG.
+    Same technique as Zongwei\'s get_most_labeled_slice, using SimpleITK
+    for consistent RAS reorientation. Returns False (never raises) on
+    any failure so a bad/missing lesion file just skips that image."""
+    try:
+        import SimpleITK as sitk
+        import matplotlib
+        matplotlib.use("Agg")
+        import matplotlib.pyplot as plt
+
+        ct_img = sitk.ReadImage(ct_path)
+        mask_img = sitk.ReadImage(mask_path)
+        ct_img = sitk.DICOMOrient(ct_img, "RAS")
+        mask_img = sitk.DICOMOrient(mask_img, "RAS")
+
+        ct_array = sitk.GetArrayFromImage(ct_img)
+        mask_array = sitk.GetArrayFromImage(mask_img)
+        if ct_array.shape != mask_array.shape:
+            return False
+
+        slice_sums = np.sum(mask_array, axis=(1, 2))
+        idx = int(np.argmax(slice_sums))
+        if slice_sums[idx] == 0:
+            return False
+
+        ct_slice = np.fliplr(ct_array[idx])
+        mask_slice = np.fliplr(mask_array[idx])
+        ct_slice = np.clip(ct_slice, -150, 250)
+        ct_slice = ((ct_slice + 150) / 400 * 255).astype(np.uint8)
+
+        plt.figure(figsize=(6, 6))
+        plt.imshow(ct_slice, cmap="gray", origin="lower")
+        plt.contour(mask_slice, colors="red", linewidths=1)
+        plt.axis("off")
+        plt.savefig(output_path, bbox_inches="tight", pad_inches=0)
+        plt.close()
+        return True
+    except Exception:
+        return False
+
+
+def _create_organ_overview_image(ct_array, mask_array, label_id, output_path, contour_color="cyan"):
+    """Same slice-finding + contour-overlay technique as the lesion function,
+    but works from already-loaded ct/mask numpy arrays and a single label id
+    from combined_labels.nii.gz -- so it does not need a separate per-organ
+    file. Used to build a full per-organ Key Images gallery, matching
+    Zongwei\'s oncokit report generator."""
+    try:
+        import matplotlib
+        matplotlib.use("Agg")
+        import matplotlib.pyplot as plt
+
+        organ_mask = (mask_array == label_id)
+        if not np.any(organ_mask):
+            return False
+
+        slice_sums = np.sum(organ_mask, axis=(1, 2))
+        idx = int(np.argmax(slice_sums))
+        if slice_sums[idx] == 0:
+            return False
+
+        ct_slice = np.fliplr(ct_array[idx])
+        mask_slice = np.fliplr(organ_mask[idx])
+        ct_slice = np.clip(ct_slice, -150, 250)
+        ct_slice = ((ct_slice + 150) / 400 * 255).astype(np.uint8)
+
+        plt.figure(figsize=(4, 4))
+        plt.imshow(ct_slice, cmap="gray", origin="lower")
+        plt.contour(mask_slice, colors=contour_color, linewidths=1)
+        plt.axis("off")
+        plt.savefig(output_path, bbox_inches="tight", pad_inches=0)
+        plt.close()
+        return True
+    except Exception:
+        return False
+
+
+@api_blueprint.route('/generate-report-pdf/<id>', methods=['GET'])
+def generate_report_pdf(id):
+    if not _is_safe_id(id):
+        return jsonify({"error": "Invalid id"}), 400
+    temp_pdf_path = f"{PDF_DIR}/temp_report_{id}.pdf"
+    output_pdf_path = f"{PDF_DIR}/report_{id}.pdf"
+    try:
+        report_data = _build_report_data(id)
+        if "error" in report_data:
+            status = 400 if report_data["error"] == "Invalid id parameter" else 500
+            return jsonify(report_data), status
+
+        _draw_report_pdf(report_data, temp_pdf_path, output_pdf_path)
+
+        return send_file(
+            output_pdf_path,
+            mimetype="application/pdf",
+            as_attachment=True,
+            download_name=f"case_{id}_report.pdf",
+        )
+    except Exception:
+        current_app.logger.exception("Error generating report PDF for case_id=%s", id)
+        return jsonify({"error": "An internal error has occurred."}), 500
+    finally:
+        if os.path.exists(temp_pdf_path):
+            os.remove(temp_pdf_path)
+
 @api_blueprint.route('/get-specific-segmentations/<combined_labels_id>', methods=['POST'])
 async def get_specific_segmentations(combined_labels_id):
     combined_labels_id = combined_labels_id.replace("PanTS_", "")

From 6ad8397d97eaa299e24a9610bfec037887dc273a Mon Sep 17 00:00:00 2001
From: ishitaahelleya <ishita.ahelleya825@gmail.com>
Date: Mon, 3 Aug 2026 16:09:17 -0700
Subject: [PATCH 2/6] Debug cleanup and disclaimer wrap fix

---
 .../components/ReportScreen/ReportScreen.tsx  |  2 -
 flask-server/api/api_blueprint.py             | 83 +++++++++++++------
 2 files changed, 59 insertions(+), 26 deletions(-)

diff --git a/PanTS-Demo/src/components/ReportScreen/ReportScreen.tsx b/PanTS-Demo/src/components/ReportScreen/ReportScreen.tsx
index 26ed2bb9..74f79e5b 100644
--- a/PanTS-Demo/src/components/ReportScreen/ReportScreen.tsx
+++ b/PanTS-Demo/src/components/ReportScreen/ReportScreen.tsx
@@ -248,7 +248,6 @@ function patientFindingText(organ: string, measurements: ReportMeasurements): st
     loc?.type === 'lateral' ? `your ${loc.word} ${organLabel}`
     : loc?.type === 'subregion' ? `the ${loc.word} of your ${organLabel}`
     : `your ${organLabel}`;
-  console.log("DEBUG patientFindingText:", { organ, section: measurements.section, detail });
   const detail = measurements.section || '';
 
   if (!detail) {
@@ -421,7 +420,6 @@ function OrganMetricsCard({
   report: ReportMeasurements;
   needsReview: boolean;
 }) {
-  console.log("DEBUG OrganMetrics:", { report, curData, organMeanHu: report.organMeanHu, computedHu: curData.mean_hu });
   const meanHu = report.organMeanHu ?? curData.mean_hu;
   const organVolume = report.organVolumeCc ?? curData.volume;
   return (
diff --git a/flask-server/api/api_blueprint.py b/flask-server/api/api_blueprint.py
index b748c266..73213e17 100644
--- a/flask-server/api/api_blueprint.py
+++ b/flask-server/api/api_blueprint.py
@@ -1156,12 +1156,20 @@ def _row_html(name, status):
 </html>"""
 
 
+# ============================================================
+# DROP-IN REPLACEMENT for _REPORT_CSS in api_blueprint.py
+# ============================================================
+
 _REPORT_CSS = """
   :root {
-    --ink: #0b0b0b; --muted: #6b6f76; --faint: #9599a1;
-    --surface: #f6f6f8; --card: #ffffff; --line: #e6e6ea;
-    --accent: #c2410c; --accent-bg: #fff4ec;
-    --green: #16a34a; --green-bg: #eefbf1;
+    --jhu-heritage: #002D72;
+    --jhu-spirit:   #68ACE5;
+    --jhu-white:    #FFFFFF;
+
+    --ink: #071C3C; --muted: #4C6584; --faint: #7C93AE;
+    --surface: #F2F6FB; --card: #ffffff; --line: #D6E4F2;
+    --accent: var(--jhu-heritage); --accent-bg: #E7EFFA;
+    --green: #1C7C4F; --green-bg: #EAF7EF;
   }
   * { box-sizing: border-box; }
   body { margin: 0; font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif; background: var(--surface); color: var(--ink); }
@@ -1176,42 +1184,69 @@ def _row_html(name, status):
     .wrap { max-width: 1080px; }
     .clean-grid { grid-template-columns: repeat(4, 1fr); }
   }
-  .toggle { display: flex; background: var(--card); border: 1px solid var(--line); border-radius: 999px; padding: 4px; margin-bottom: 18px; position: sticky; top: 12px; z-index: 10; box-shadow: 0 2px 10px rgba(0,0,0,0.04); }
+  .toggle { display: flex; background: var(--card); border: 1px solid var(--line); border-radius: 999px; padding: 4px; margin-bottom: 18px; position: sticky; top: 12px; z-index: 10; box-shadow: 0 2px 10px rgba(0,45,114,0.08); }
   .toggle button { flex: 1; border: none; background: transparent; border-radius: 999px; padding: 10px; font-size: 14px; font-weight: 600; color: var(--muted); cursor: pointer; }
-  .toggle button.active { background: var(--ink); color: #fff; }
+  .toggle button.active { background: var(--jhu-heritage); color: var(--jhu-white); }
   .disclaimer { font-size: 11.5px; color: var(--faint); font-style: italic; margin: 0 2px 18px; line-height: 1.5; }
-  .header { margin-bottom: 18px; }
-  .header h1 { font-size: 22px; font-weight: 700; margin: 0 0 2px; }
+  .header { margin-bottom: 18px; border-bottom: 3px solid var(--jhu-spirit); padding-bottom: 14px; }
+  .header h1 { font-size: 22px; font-weight: 700; margin: 0 0 2px; color: var(--jhu-heritage); }
   .header .sub { font-size: 13px; color: var(--muted); }
-  .download-btn { display: inline-flex; align-items: center; gap: 8px; background: var(--ink); color: #fff; text-decoration: none; font-size: 14px; font-weight: 600; padding: 10px 16px; border-radius: 10px; }
-  .card { background: var(--card); border-radius: 16px; padding: 16px 18px; margin-bottom: 12px; border: 1px solid var(--line); }
-  .card.flag { background: var(--accent-bg); border-color: #fbd8bf; }
-  .flag-label { display: flex; align-items: center; gap: 6px; font-size: 12.5px; font-weight: 700; color: var(--accent); text-transform: uppercase; letter-spacing: 0.02em; margin-bottom: 8px; }
-  .flag-label .dot { width: 7px; height: 7px; border-radius: 50%; background: var(--accent); }
-  .organ-title { font-size: 17px; font-weight: 700; margin-bottom: 6px; }
-  .body-text { font-size: 15.5px; line-height: 1.55; color: #1c1c1e; }
+  .download-btn { display: inline-flex; align-items: center; gap: 8px; background: var(--jhu-heritage); color: var(--jhu-white); text-decoration: none; font-size: 14px; font-weight: 600; padding: 10px 16px; border-radius: 10px; }
+  .download-btn:hover { background: #001F52; }
+  .card { background: var(--card); border-radius: 16px; padding: 16px 18px; margin-bottom: 12px; border: 1px solid var(--line); box-shadow: 0 2px 8px rgba(0,45,114,0.05); }
+  .card.flag { background: var(--accent-bg); border-color: var(--jhu-spirit); border-left: 4px solid var(--jhu-heritage); }
+  .flag-label { display: flex; align-items: center; gap: 6px; font-size: 12.5px; font-weight: 700; color: var(--jhu-heritage); text-transform: uppercase; letter-spacing: 0.02em; margin-bottom: 8px; }
+  .flag-label .dot { width: 7px; height: 7px; border-radius: 50%; background: var(--jhu-heritage); }
+  .organ-title { font-size: 17px; font-weight: 700; margin-bottom: 6px; color: var(--jhu-heritage); }
+  .body-text { font-size: 15.5px; line-height: 1.55; color: var(--ink); }
   .metrics-grid { display: grid; grid-template-columns: 1fr 1fr; gap: 8px; margin-top: 10px; }
-  .metric { background: rgba(255,255,255,0.6); border-radius: 10px; padding: 10px 12px; }
-  .metric .label { font-size: 11.5px; color: var(--accent); font-weight: 600; text-transform: uppercase; }
-  .metric .value { font-size: 17px; font-weight: 700; margin-top: 2px; }
-  .badge { display: inline-flex; align-items: center; gap: 6px; background: var(--accent); color: #fff; font-size: 11px; font-weight: 700; letter-spacing: 0.03em; padding: 4px 10px; border-radius: 999px; margin-top: 10px; }
-  .section-label { font-size: 12.5px; font-weight: 700; color: var(--muted); text-transform: uppercase; letter-spacing: 0.03em; margin: 20px 4px 10px; }
+  .metric { background: var(--jhu-white); border: 1px solid var(--line); border-radius: 10px; padding: 10px 12px; }
+  .metric .label { font-size: 11.5px; color: var(--jhu-heritage); font-weight: 600; text-transform: uppercase; }
+  .metric .value { font-size: 17px; font-weight: 700; margin-top: 2px; color: var(--ink); }
+  .badge { display: inline-flex; align-items: center; gap: 6px; background: var(--jhu-heritage); color: var(--jhu-white); font-size: 11px; font-weight: 700; letter-spacing: 0.03em; padding: 4px 10px; border-radius: 999px; margin-top: 10px; }
+  .section-label { font-size: 12.5px; font-weight: 700; color: var(--jhu-heritage); text-transform: uppercase; letter-spacing: 0.03em; margin: 20px 4px 10px; }
   .clean-grid { display: grid; grid-template-columns: 1fr 1fr; gap: 8px; margin-bottom: 8px; }
   .clean-card { background: var(--card); border: 1px solid var(--line); border-radius: 12px; padding: 12px 14px; }
   .clean-card .name { font-size: 13px; color: var(--muted); }
-  .clean-card .num { font-size: 19px; font-weight: 700; margin-top: 2px; }
+  .clean-card .num { font-size: 19px; font-weight: 700; margin-top: 2px; color: var(--jhu-heritage); }
   .clean-card .num .unit { font-size: 12px; font-weight: 500; color: var(--muted); }
   .clean-card .hu { font-size: 11.5px; color: var(--faint); margin-top: 2px; }
   .checklist { background: var(--card); border: 1px solid var(--line); border-radius: 14px; overflow: hidden; }
   .row { display: flex; align-items: center; justify-content: space-between; padding: 12px 16px; border-bottom: 1px solid var(--line); font-size: 14.5px; }
   .row:last-child { border-bottom: none; }
   .row.flagged { background: var(--accent-bg); }
-  .row.flagged span.name { color: var(--accent); font-weight: 600; }
+  .row.flagged span.name { color: var(--jhu-heritage); font-weight: 600; }
   .check { color: var(--green); font-weight: 700; }
-  .exclaim { color: var(--accent); font-weight: 700; }
-  .show-more { width: 100%; background: var(--card); border: 1px solid var(--line); border-radius: 12px; padding: 12px; font-size: 14px; font-weight: 600; color: var(--ink); margin-top: 8px; cursor: pointer; }
+  .exclaim { color: var(--jhu-heritage); font-weight: 700; }
+  .show-more { width: 100%; background: var(--card); border: 1px solid var(--line); border-radius: 12px; padding: 12px; font-size: 14px; font-weight: 600; color: var(--jhu-heritage); margin-top: 8px; cursor: pointer; }
   #more-organs { display: none; }
   #more-organs.open { display: block; }
+
+  .bm-footer { margin-top: 32px; padding: 22px 24px; border-radius: 16px; background: var(--jhu-heritage); display: flex; align-items: center; justify-content: space-between; gap: 20px; flex-wrap: wrap; }
+  .bm-footer__text { color: var(--jhu-white); }
+  .bm-footer__title { font-size: 15px; font-weight: 700; margin: 0 0 4px; }
+  .bm-footer__sub { font-size: 12.5px; color: var(--jhu-spirit); margin: 0; }
+  .bm-footer__cta { display: inline-flex; align-items: center; gap: 8px; background: var(--jhu-white); color: var(--jhu-heritage); text-decoration: none; font-size: 13.5px; font-weight: 700; padding: 10px 18px; border-radius: 999px; white-space: nowrap; }
+  .bm-footer__cta:hover { background: var(--jhu-spirit); }
+"""
+
+
+# ============================================================
+# In _build_report_html, add this block right before the
+# closing "</div>" of <div class="wrap"> (i.e. right after the
+# checklist / #more-organs block, before the final </div>\n\n<script>)
+# ============================================================
+
+BODYMAPS_FOOTER_HTML = """
+  <div class="bm-footer">
+    <div class="bm-footer__text">
+      <p class="bm-footer__title">Generated by BodyMaps &middot; Johns Hopkins University</p>
+      <p class="bm-footer__sub">AI-powered CT segmentation and tumor detection. Explore your own scans.</p>
+    </div>
+    <a href="https://bodymaps.wse.jhu.edu/dashboard" class="bm-footer__cta" target="_blank" rel="noopener">
+      Visit BodyMaps &rarr;
+    </a>
+  </div>
 """
 
 

From cf6d2fe926b1e2c6fd54f861329bbf2ac5c5af00 Mon Sep 17 00:00:00 2001
From: ishitaahelleya <ishita.ahelleya825@gmail.com>
Date: Mon, 10 Aug 2026 10:54:12 -0700
Subject: [PATCH 3/6] Add shareable de-identified patient BodyMap card with
 opaque share tokens

---
 PanTS-Demo/src/App.tsx                        |   4 +-
 .../components/ReportScreen/ReportScreen.tsx  |  47 +-
 PanTS-Demo/src/helpers/reportFindings.ts      | 235 ++++++++++
 PanTS-Demo/src/routes/SharePatientCard.tsx    | 408 ++++++++++++++++++
 flask-server/api/api_blueprint.py             |  58 ++-
 5 files changed, 741 insertions(+), 11 deletions(-)
 create mode 100644 PanTS-Demo/src/helpers/reportFindings.ts
 create mode 100644 PanTS-Demo/src/routes/SharePatientCard.tsx

diff --git a/PanTS-Demo/src/App.tsx b/PanTS-Demo/src/App.tsx
index 4e08e1b6..e9cf04cf 100644
--- a/PanTS-Demo/src/App.tsx
+++ b/PanTS-Demo/src/App.tsx
@@ -24,6 +24,7 @@ const HistorySettings = lazy(() => import("./routes/Settings/HistorySettings"));
 const PrivacySettings = lazy(() => import("./routes/Settings/PrivacySettings"));
 const SignupRedirect = lazy(() => import("./routes/SignupRedirect"));
 const LegalPage = lazy(() => import("./routes/LegalPage"));
+const SharePatientCard = lazy(() => import("./routes/SharePatientCard"));
 const RotatingHeartLoader = lazy(() => import("./components/Loading"));
 
 const BASENAME = import.meta.env.VITE_BASENAME;
@@ -72,6 +73,7 @@ function App() {
                   />
                   <Route path="/dashboard" element={<Homepage />} />
                   <Route path="/case/:caseId" element={<VisualizationPage />} />
+                  <Route path="/share/:shareId" element={<SharePatientCard />} />
                   <Route
                     path="/session/:sessionId"
                     element={<VisualizationPage />}
@@ -123,4 +125,4 @@ function App() {
   );
 }
 
-export default App;
+export default App;
\ No newline at end of file
diff --git a/PanTS-Demo/src/components/ReportScreen/ReportScreen.tsx b/PanTS-Demo/src/components/ReportScreen/ReportScreen.tsx
index 74f79e5b..0c732f5a 100644
--- a/PanTS-Demo/src/components/ReportScreen/ReportScreen.tsx
+++ b/PanTS-Demo/src/components/ReportScreen/ReportScreen.tsx
@@ -576,6 +576,12 @@ export default function ReportScreen({ id, onClose, onViewChange, onOrganHighlig
   const [pLoad, setPLoad] = useState(false);
   const [shareOpen, setShareOpen] = useState(false);
   const [copied, setCopied] = useState(false);
+  // De-identified share link, minted on demand (see mintShareLink below) —
+  // this used to be a raw `${API_ORIGIN}/api/report/${id}` string built
+  // straight from the real case id. That exposed the real id in the URL and
+  // skipped the token system the rest of the app now uses for sharing.
+  const [shareUrl, setShareUrl] = useState<string | null>(null);
+  const [shareLoading, setShareLoading] = useState(false);
   const startRef = useRef(Date.now());
 
   useEffect(() => {
@@ -592,8 +598,30 @@ export default function ReportScreen({ id, onClose, onViewChange, onOrganHighlig
       .catch(() => setLoading(false));
   }, [id]);
 
+  // Reset any previously-minted link when the case changes, so a stale
+  // token for a different case can never be shown/copied.
+  useEffect(() => {
+    setShareUrl(null);
+  }, [id]);
 
-  const shareUrl = `${APP_CONSTANTS.API_ORIGIN}/api/report/${id}`;
+  // Mints (or re-derives — the backend token is deterministic per case id)
+  // an opaque share token and builds the link to the new de-identified
+  // /share/:token card. Safe to call repeatedly; no-ops if already minted
+  // or in flight.
+  const mintShareLink = useCallback(async () => {
+    if (shareUrl || shareLoading) return;
+    setShareLoading(true);
+    try {
+      const r = await fetch(`${APP_CONSTANTS.API_ORIGIN}/api/share/${id}/token`, { method: 'POST' });
+      const j = await r.json();
+      const token = typeof j.url === 'string' ? j.url.split('/').pop() : null;
+      if (token) setShareUrl(`${window.location.origin}/share/${token}`);
+    } catch (e) {
+      console.error('Failed to create share link:', e);
+    } finally {
+      setShareLoading(false);
+    }
+  }, [id, shareUrl, shareLoading]);
 
   useEffect(() => {
     if (!shareOpen) return;
@@ -610,6 +638,7 @@ export default function ReportScreen({ id, onClose, onViewChange, onOrganHighlig
   }, [shareOpen]);
 
   const handleCopyShareLink = async () => {
+    if (!shareUrl) return;
     try {
       await navigator.clipboard.writeText(shareUrl);
       setCopied(true);
@@ -841,7 +870,7 @@ export default function ReportScreen({ id, onClose, onViewChange, onOrganHighlig
               )}
               <div style={{ position: 'relative' }}>
                 <button
-                  onClick={() => setShareOpen((v) => !v)}
+                  onClick={() => { setShareOpen((v) => !v); mintShareLink(); }}
                   style={{
                     display: 'flex',
                     alignItems: 'center',
@@ -870,7 +899,7 @@ export default function ReportScreen({ id, onClose, onViewChange, onOrganHighlig
                   }}>
                     <div style={{ fontSize: 12.5, color: 'rgba(255,255,255,0.86)', lineHeight: 1.5, marginBottom: 12 }}>
                       Share this link with anyone — a family member, your doctor, whoever needs it. It opens a
-                      readable summary of this scan, with plain-language and clinical views built in.
+                      de-identified, readable summary of this scan.
                     </div>
                     <div style={{ display: 'flex', gap: 8 }}>
                       <div style={{
@@ -878,14 +907,18 @@ export default function ReportScreen({ id, onClose, onViewChange, onOrganHighlig
                         borderRadius: 10, padding: '8px 10px', fontSize: 12, color: 'rgba(255,255,255,0.65)',
                         overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap',
                       }}>
-                        {shareUrl}
+                        {shareLoading ? 'Generating link…' : (shareUrl || 'Link unavailable')}
                       </div>
                       <button
                         onClick={handleCopyShareLink}
+                        disabled={!shareUrl}
                         style={{
-                          flexShrink: 0, background: copied ? 'rgba(52,199,89,0.18)' : 'rgba(255,255,255,0.10)',
+                          flexShrink: 0,
+                          background: copied ? 'rgba(52,199,89,0.18)' : 'rgba(255,255,255,0.10)',
                           border: `1px solid ${copied ? 'rgba(52,199,89,0.4)' : 'rgba(255,255,255,0.16)'}`,
-                          borderRadius: 10, padding: '8px 12px', cursor: 'pointer', fontFamily: 'inherit',
+                          borderRadius: 10, padding: '8px 12px', cursor: shareUrl ? 'pointer' : 'not-allowed',
+                          opacity: shareUrl ? 1 : 0.5,
+                          fontFamily: 'inherit',
                           fontSize: 12, fontWeight: 700, color: copied ? '#34c759' : 'rgba(255,255,255,0.86)',
                           transition: 'all 0.2s',
                         }}
@@ -1100,4 +1133,4 @@ export default function ReportScreen({ id, onClose, onViewChange, onOrganHighlig
       )}
     </div>
   );
-}
\ No newline at end of file
+}
diff --git a/PanTS-Demo/src/helpers/reportFindings.ts b/PanTS-Demo/src/helpers/reportFindings.ts
new file mode 100644
index 00000000..43333a6e
--- /dev/null
+++ b/PanTS-Demo/src/helpers/reportFindings.ts
@@ -0,0 +1,235 @@
+// ─────────────────────────────────────────────────────────────────────────
+// Shared report-text parsing + plain-language finding logic.
+//
+// This is a straight extraction of the pure helper functions that already
+// live in ReportScreen.tsx (organRoot, getReportSection, getReportMeasurements,
+// patientFindingText, etc). Nothing about their behavior has changed — same
+// regexes, same bug-fix comments preserved — they've just been moved here so
+// a second surface (the shareable patient card) can reuse the identical
+// logic instead of re-implementing it and risking the two drifting apart.
+//
+// ReportScreen.tsx can optionally switch to importing from here instead of
+// keeping its own copies; that's a one-line import swap per function and is
+// left as a follow-up so it doesn't touch the verified report-walkthrough
+// flow in this change.
+// ─────────────────────────────────────────────────────────────────────────
+
+export interface OrganData {
+  volume: number;
+  mean_hu: number;
+  status?: 'normal' | 'check';
+  centroid_mm?: [number, number, number];
+  dimensions?: [number, number, number];
+}
+
+export interface ReportData {
+  case_id: string;
+  patient: { age: number; sex: string };
+  imaging: { study_type: string; contrast: string; spacing: number[]; shape: number[] };
+  organ_volumes: { [k: string]: OrganData };
+  lesions: { [k: string]: { voxels: number; volume: number } };
+  comments: string;
+  impression: string[];
+}
+
+export type ReportMeasurements = {
+  section: string | null;
+  volumeCc: number | null;
+  lesionVolumeCc: number | null;
+  organVolumeCc: number | null;
+  meanHu: number | null;
+  organMeanHu: number | null;
+  huSd: number | null;
+  sizeCm: string | null;
+  lesionCount: number;
+};
+
+export function labelize(organ: string): string {
+  return organ
+    .replace(/_/g, ' ')
+    .replace(/\b\w/g, c => c.toUpperCase());
+}
+
+export function getDetail(organ: string, comments: string): string | null {
+  if (!comments) return null;
+  const sentences = comments.split(/(?<=[.!?])\s+/).filter(s => s.trim());
+  const root = organ.replace(/_(gland|body|tail|head|left|right)$/, '').replace(/_/g, ' ').split(' ')[0];
+  const match = sentences.find(s => s.toLowerCase().includes(root.toLowerCase()));
+  if (!match) return null;
+  let d = match.trim().replace(/^(however|notably|additionally|furthermore|moreover|in addition),?\s+/i, '');
+  if (d.length) d = d[0].toUpperCase() + d.slice(1);
+  if (d.length > 210) d = d.slice(0, d.lastIndexOf(' ', 207)).trim() + '...';
+  return d.endsWith('.') || d.endsWith('...') ? d : d + '.';
+}
+
+export function organRoot(organ: string): string {
+  if (organ.startsWith('pancreas')) return 'pancreas';
+  if (organ.startsWith('kidney')) return 'kidney';
+  return organ
+    .replace(/_(gland|body|tail|head|left|right)$/, '')
+    .replace(/_/g, ' ')
+    .toLowerCase();
+}
+
+export function getReportSection(organ: string, comments: string): string | null {
+  if (!comments) return null;
+  const root = organRoot(organ);
+  const lines = comments.split(/\r?\n/);
+  const start = lines.findIndex(line => {
+    const cleaned = line.trim().replace(/:$/, '').toLowerCase();
+    return cleaned === root || cleaned === `${root}s` || cleaned.startsWith(`${root}:`);
+  });
+  if (start === -1) return getDetail(organ, comments);
+  const collected: string[] = [];
+  let lesionsHeadingSeen = false;
+  for (let i = start; i < lines.length; i++) {
+    const line = lines[i];
+    const trimmed = line.trim();
+    const cleanedHeading = trimmed.replace(/:$/, '').toLowerCase();
+    if (i > start && cleanedHeading === `${root} lesions`) {
+      lesionsHeadingSeen = true;
+      continue;
+    }
+    if (i > start && !lesionsHeadingSeen && /^[A-Za-z][A-Za-z\s_/-]*:\s*$/.test(trimmed)) break;
+    if (i > start && lesionsHeadingSeen && /^[A-Za-z][A-Za-z\s_/-]*:\s*$/.test(trimmed) && !cleanedHeading.startsWith(root)) break;
+    if (i > start && /^IMPRESSION:\s*$/i.test(trimmed)) break;
+    if (trimmed) collected.push(trimmed);
+  }
+  return collected.join(' ').replace(/\s+/g, ' ').trim() || null;
+}
+
+export function getReportMeasurements(organ: string, comments: string): ReportMeasurements {
+  const section = getReportSection(organ, comments);
+  const lesionVolumeMatch = section?.match(/lesion[\s\S]*?volume:\s*([\d.]+)\s*cc/i);
+  const lesionHuMatch = section?.match(/hu\s*value\s*is\s*(-?[\d.]+)(?:\s*\+\/\-\s*([\d.]+))?/i);
+  const volumeMatch = lesionVolumeMatch ?? section?.match(/volume:\s*([\d.]+)\s*cc/i);
+  const huMatch = lesionHuMatch ?? section?.match(/Mean HU value:\s*([\d.]+)(?:\s*\+\/\-\s*([\d.]+))?/i);
+  const sizeMatch = section?.match(/Size:\s*([^()]+?)\s*cm/i);
+
+  const organVolumeMatch = section?.match(/volume:\s*([\d.]+)\s*cc/i);
+  const organHuMatch = section?.match(/Mean HU value:\s*([\d.]+)/i);
+
+  const sizeMatches = section?.match(/Size:\s*[^()]+?cm/gi) ?? [];
+  const lesionCount = sizeMatches.length || (lesionVolumeMatch ? 1 : 0);
+
+  return {
+    section,
+    volumeCc: volumeMatch ? Number(volumeMatch[1]) : null,
+    lesionVolumeCc: lesionVolumeMatch ? Number(lesionVolumeMatch[1]) : null,
+    organVolumeCc: organVolumeMatch ? Number(organVolumeMatch[1]) : null,
+    meanHu: huMatch ? Number(huMatch[1]) : null,
+    organMeanHu: organHuMatch ? Number(organHuMatch[1]) : null,
+    huSd: huMatch?.[2] ? Number(huMatch[2]) : null,
+    sizeCm: sizeMatch ? sizeMatch[1].trim() : null,
+    lesionCount,
+  };
+}
+
+export function organLocation(organ: string): { type: 'lateral' | 'subregion'; word: string } | null {
+  const suffix = organ.split('_').pop() ?? '';
+  if (suffix === 'left' || suffix === 'right') return { type: 'lateral', word: suffix };
+  if (suffix === 'tail' || suffix === 'head' || suffix === 'body') return { type: 'subregion', word: suffix };
+  return null;
+}
+
+export function sizeDescriptor(volumeCc: number | null, sizeCm: string | null): string {
+  let maxDim: number | null = null;
+  if (sizeCm) {
+    const nums = sizeCm.match(/[\d.]+/g)?.map(Number) ?? [];
+    if (nums.length) maxDim = Math.max(...nums);
+  }
+  if (maxDim !== null) {
+    if (maxDim < 1) return 'tiny';
+    if (maxDim < 2) return 'small';
+    if (maxDim < 5) return 'noticeable';
+    return 'sizable';
+  }
+  if (volumeCc !== null) {
+    if (volumeCc < 1) return 'tiny';
+    if (volumeCc < 5) return 'small';
+    if (volumeCc < 20) return 'noticeable';
+    return 'sizable';
+  }
+  return '';
+}
+
+// Definitions, not interpretations — these describe what each clinical
+// word means in plain English without implying severity, urgency, or a
+// diagnosis (never "benign," "concerning," "normal," etc. — only what the
+// source report actually supports). `kind` picks the sentence grammar:
+// 'noun' terms slot into "a small <term>"; 'descriptor' terms (enlarged,
+// dilated) describe a state of the organ itself, so they get their own
+// sentence shape rather than being forced into "a small enlarged."
+type FindingTerm = { term: string; kind: 'noun' | 'descriptor'; definition: string };
+
+function detectFindingTerm(detail: string): FindingTerm | null {
+  const d = detail.toLowerCase();
+  if (d.includes('cyst')) return { term: 'cyst', kind: 'noun', definition: 'A cyst is a fluid-filled sac.' };
+  if (d.includes('nodule')) return { term: 'nodule', kind: 'noun', definition: 'A nodule is a small rounded area.' };
+  if (d.includes('mass')) return { term: 'mass', kind: 'noun', definition: 'A mass is an area of tissue that appears different from the surrounding tissue.' };
+  if (d.includes('tumor')) return { term: 'tumor', kind: 'noun', definition: 'A tumor is a growth made up of abnormal cells.' };
+  if (d.includes('enlarged')) return { term: 'enlarged', kind: 'descriptor', definition: 'Enlarged means larger than expected.' };
+  if (d.includes('dilated') || d.includes('widened')) return { term: 'dilated', kind: 'descriptor', definition: 'Dilated means wider than expected.' };
+  if (d.includes('lesion')) return { term: 'lesion', kind: 'noun', definition: 'A lesion is an area that looks different from the surrounding tissue.' };
+  return null;
+}
+
+export function getImpressionText(data: ReportData | null): string {
+  if (!data?.impression?.length) return '';
+  return data.impression
+    .map(t => t.replace(/^\d+\.\s*/, '').replace(/^\[([^\]]+)\]:\s*/, '$1: '))
+    .join(' ');
+}
+
+export function capFirst(s: string): string {
+  return s.length ? s[0].toUpperCase() + s.slice(1) : s;
+}
+
+// Single job now: explain the finding. What to do about it (see your
+// doctor) is a separate, persistent card element rendered once — not
+// repeated in every sentence, which read as alarming and discharge-
+// paperwork-like when it was baked into every branch here.
+export function patientFindingText(organ: string, measurements: ReportMeasurements): string {
+  const organLabel = labelize(organRoot(organ)).toLowerCase();
+  const loc = organLocation(organ);
+  const subject =
+    loc?.type === 'lateral' ? `your ${loc.word} ${organLabel}`
+    : loc?.type === 'subregion' ? `the ${loc.word} of your ${organLabel}`
+    : `your ${organLabel}`;
+  const detail = measurements.section || '';
+
+  if (!detail) {
+    return `The scan flagged ${subject} for review — the report text wasn't specific enough to describe here.`;
+  }
+
+  const found = detectFindingTerm(detail);
+  if (!found) {
+    return `${capFirst(subject)} was flagged for review, but the report doesn't describe a specific spot or growth.`;
+  }
+
+  const sizeWord = sizeDescriptor(measurements.lesionVolumeCc ?? measurements.volumeCc, measurements.sizeCm);
+  const sizePart = measurements.sizeCm ? ` measuring ${measurements.sizeCm} cm` : '';
+
+  if (found.kind === 'descriptor') {
+    return `The scan found that ${subject} is ${found.term}. ${found.definition}`;
+  }
+
+  const article = sizeWord ? `a ${sizeWord} ${found.term}` : `a ${found.term}`;
+  const countPart = measurements.lesionCount > 1 ? `${measurements.lesionCount} ${found.term}s` : article;
+
+  return `The scan found ${countPart}${sizePart} in ${subject}. ${found.definition}`;
+}
+
+/** Same >5cc-or-flagged filter ReportScreen uses to build its organ list. */
+export function splitOrgans(data: ReportData | null): {
+  all: [string, OrganData][];
+  flagged: [string, OrganData][];
+  normal: [string, OrganData][];
+} {
+  const all = data
+    ? Object.entries(data.organ_volumes).filter(([, v]) => v.volume > 5 || v.status === 'check')
+    : [];
+  const flagged = all.filter(([, v]) => v.status === 'check');
+  const normal = all.filter(([, v]) => v.status !== 'check');
+  return { all, flagged, normal };
+}
diff --git a/PanTS-Demo/src/routes/SharePatientCard.tsx b/PanTS-Demo/src/routes/SharePatientCard.tsx
new file mode 100644
index 00000000..ab38a35c
--- /dev/null
+++ b/PanTS-Demo/src/routes/SharePatientCard.tsx
@@ -0,0 +1,408 @@
+import React, { useEffect, useMemo, useState } from 'react';
+import { useParams } from 'react-router';
+import { APP_CONSTANTS } from '../helpers/constants';
+import type { ReportData, OrganData } from '../helpers/reportFindings';
+import {
+  splitOrgans,
+  labelize,
+  organRoot,
+  getReportMeasurements,
+  patientFindingText,
+} from '../helpers/reportFindings';
+
+const NAVY = '#14265C';
+const NAVY_DEEP = '#0D1B47';
+const SPIRIT_TEXT = '#3E6FB5';
+const AMBER = '#B8720A';
+const AMBER_BG = '#FBF1E1';
+const GREEN = '#0E7C4A';
+const INK = '#141A26';
+const MUTED = '#5A6B85';
+const HAIRLINE = '#E7EAF0';
+const PANEL = '#F7F9FC';
+
+// Save the JHU shield you provided into your repo at this exact path
+// (e.g. PanTS-Demo/public/jhu-shield-white.png) — Vite serves anything in
+// public/ from the site root, so this path resolves automatically once
+// the file's there. If it's missing, the <img> just quietly hides itself.
+const JHU_SHIELD_SRC = '/jhu-shield-white.png';
+
+const STYLES = `
+@import url('https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700;800&family=Poppins:wght@600;700;800&display=swap');
+@keyframes fadeUp { from { opacity: 0; transform: translateY(14px); } to { opacity: 1; transform: translateY(0); } }
+@keyframes spin { from { transform: rotate(0); } to { transform: rotate(360deg); } }
+@keyframes shareGlow { 0%,100% { box-shadow: 0 6px 20px rgba(20,38,92,0.28); } 50% { box-shadow: 0 8px 26px rgba(20,38,92,0.4); } }
+
+.spc-share {
+  position: relative;
+  overflow: hidden;
+  background: linear-gradient(135deg, #14265C 0%, #1E3573 60%, #2A4590 100%);
+  animation: shareGlow 2.8s ease-in-out infinite;
+  transition: transform 0.28s cubic-bezier(0.34,1.56,0.64,1), box-shadow 0.28s ease;
+}
+.spc-share::before {
+  content: '';
+  position: absolute;
+  top: 0; left: -60%;
+  width: 40%; height: 100%;
+  background: linear-gradient(120deg, transparent, rgba(255,255,255,0.4), transparent);
+  transform: skewX(-20deg);
+  transition: left 0.65s cubic-bezier(0.16,1,0.3,1);
+}
+.spc-share:hover {
+  transform: translateY(-2px) scale(1.035);
+  animation-play-state: paused;
+  box-shadow: 0 12px 28px rgba(20,38,92,0.42);
+}
+.spc-share:hover::before { left: 140%; }
+.spc-share:active { transform: translateY(0) scale(0.97); }
+.spc-share .spc-share-icon { transition: transform 0.3s cubic-bezier(0.34,1.56,0.64,1); }
+.spc-share:hover .spc-share-icon { transform: translateY(-2px) rotate(-8deg); }
+
+.spc-chip { transition: background 0.2s, color 0.2s; cursor: pointer; }
+.spc-ad:hover { background: ${NAVY_DEEP} !important; }
+.spc-qr-wrap { transition: transform 0.25s cubic-bezier(0.34,1.5,0.64,1); }
+.spc-qr-wrap:hover { transform: scale(1.05); }
+`;
+
+const CARD_MAX = 640;
+
+// Dedupe by organ root — pancreas + pancreas_tail are the same underlying
+// finding; without this a case can wrongly claim "2 findings" for one organ.
+function dedupeFindingsByRoot(flagged: [string, OrganData][]): { root: string; organ: string; data: OrganData }[] {
+  const byRoot = new Map<string, { root: string; organ: string; data: OrganData }>();
+  for (const [organ, data] of flagged) {
+    const root = organRoot(organ);
+    const existing = byRoot.get(root);
+    if (!existing || organ === root) byRoot.set(root, { root, organ, data });
+  }
+  return Array.from(byRoot.values());
+}
+
+// Staggered entrance delay helper — each major section fades/rises in a
+// beat after the previous one instead of everything appearing at once.
+function stagger(revealed: boolean, index: number): React.CSSProperties {
+  return revealed ? { animation: `fadeUp 0.45s cubic-bezier(0.16,1,0.3,1) ${index * 0.08}s both` } : { opacity: 0 };
+}
+
+export default function SharePatientCard() {
+  const { shareId = '' } = useParams<{ shareId: string }>();
+  const [data, setData] = useState<ReportData | null>(null);
+  const [error, setError] = useState(false);
+  const [noOrganData, setNoOrganData] = useState(false);
+  const [revealed, setRevealed] = useState(false);
+  const [copied, setCopied] = useState(false);
+  const [activeIdx, setActiveIdx] = useState(0);
+
+  useEffect(() => {
+    let cancelled = false;
+    fetch(`${APP_CONSTANTS.API_ORIGIN}/api/share/${shareId}`)
+      .then(r => r.json())
+      .then(j => {
+        if (cancelled) return;
+        if (j.error) { setError(true); return; }
+        if (j.masks_available === false || !j.organ_volumes || Object.keys(j.organ_volumes).length === 0) {
+          setNoOrganData(true);
+          return;
+        }
+        setData(j);
+      })
+      .catch(() => { if (!cancelled) setError(true); });
+    return () => { cancelled = true; };
+  }, [shareId]);
+
+  useEffect(() => {
+    if (!data) return;
+    const t = setTimeout(() => setRevealed(true), 30);
+    return () => clearTimeout(t);
+  }, [data]);
+
+  const { flagged, normal } = useMemo(() => splitOrgans(data), [data]);
+  const findings = useMemo(() => dedupeFindingsByRoot(flagged), [flagged]);
+  const allClear = data ? findings.length === 0 : false;
+
+  const active = findings[activeIdx] ?? null;
+  const measurements = active && data ? getReportMeasurements(active.organ, data.comments || '') : null;
+  const plainLanguage = active && measurements ? patientFindingText(active.organ, measurements) : null;
+
+  const handleShare = async () => {
+    try {
+      await navigator.clipboard.writeText(window.location.href);
+      setCopied(true);
+      setTimeout(() => setCopied(false), 2000);
+    } catch { /* clipboard unavailable */ }
+  };
+
+  const bodyMapsUrl = 'https://bodymaps.wse.jhu.edu';
+  const shareUrl = typeof window !== 'undefined' ? window.location.href : '';
+  const qrSrc = `https://api.qrserver.com/v1/create-qr-code/?size=96x96&margin=0&color=255-255-255&bgcolor=20-38-92&data=${encodeURIComponent(shareUrl)}`;
+
+  return (
+    <div style={page}>
+      <style>{STYLES}</style>
+
+      <div style={stage}>
+        {!data && !error && !noOrganData && (
+          <div style={loadingWrap}><div style={spinnerRing} /></div>
+        )}
+
+        {error && (
+          <div style={emptyState}><div style={emptyStateTitle}>This report link isn't available.</div></div>
+        )}
+
+        {noOrganData && (
+          <div style={emptyState}>
+            <div style={emptyStateTitle}>No mapped organ data available for this case.</div>
+          </div>
+        )}
+
+        {data && (
+          <div style={{ ...card, ...stagger(revealed, 0) }}>
+            <div style={cardBody}>
+              {/* Identity */}
+              <a href={bodyMapsUrl} target="_blank" rel="noreferrer" style={{ ...brandLockup, ...stagger(revealed, 1) }}>
+                <div style={brandMark}>
+                  <svg width="16" height="16" viewBox="0 0 24 24" fill="none">
+                    <circle cx="12" cy="12" r="8.4" stroke="#fff" strokeWidth="1.6" />
+                    <circle cx="12" cy="12" r="3" fill="#fff" />
+                  </svg>
+                </div>
+                <div>
+                  <div style={brandName}>BodyMaps</div>
+                  <div style={brandSub}>Johns Hopkins University</div>
+                </div>
+              </a>
+
+              <div style={stagger(revealed, 2)}>
+                <div style={eyebrow}>CT SCAN SUMMARY</div>
+                <div style={statLineWrap}>
+                  <span style={{ ...statAccentBar, background: allClear ? GREEN : AMBER }} />
+                  <span style={{ ...statLine, color: allClear ? GREEN : AMBER }}>
+                    {allClear ? 'All clear' : `${findings.length} organ${findings.length === 1 ? '' : 's'} with findings`}
+                  </span>
+                </div>
+                {!allClear && normal.length > 0 && (
+                  <p style={subStatLine}>{normal.length} other mapped structure{normal.length === 1 ? '' : 's'} showed no flagged findings.</p>
+                )}
+              </div>
+
+              {!allClear && active && findings.length > 1 && (
+                <div style={{ ...chipRow, ...stagger(revealed, 3) }}>
+                  {findings.map((f, i) => (
+                    <span key={f.root} className="spc-chip" onClick={() => setActiveIdx(i)} style={chip(i === activeIdx)}>
+                      {labelize(f.root)}
+                    </span>
+                  ))}
+                </div>
+              )}
+
+              {!allClear && active && (
+                <>
+                  <div style={{ ...panel, ...stagger(revealed, 4) }}>
+                    <div style={panelInner}>
+                      {/* Organ image slot — intentionally left empty for your
+                          own illustration/render. */}
+                      <div style={organImageSlot} />
+
+                      <div style={{ flex: 1, minWidth: 200 }}>
+                        <div style={panelLabel}>PRIMARY FINDING</div>
+                        <div style={organNameBig}>{labelize(active.root)}</div>
+                        <div style={findingBadge}>
+                          <GearIcon /> Finding to review
+                        </div>
+                      </div>
+                    </div>
+                  </div>
+
+                  {/* Radiology Impression sits right below the organ name —
+                      this is the most important line on the card, sized up
+                      accordingly. */}
+                  <div style={{ ...impressionPanel, ...stagger(revealed, 5) }}>
+                    <div style={impressionIconWrap}><DocIcon /></div>
+                    <div style={{ flex: 1, minWidth: 0 }}>
+                      <div style={impressionLabel}>RADIOLOGY IMPRESSION</div>
+                      <p style={impressionText}>{plainLanguage || 'This organ was flagged for your doctor to review.'}</p>
+                    </div>
+                  </div>
+
+                  {(measurements?.organVolumeCc != null || measurements?.organMeanHu != null) && (
+                    <div style={stagger(revealed, 6)}>
+                      <div style={sectionLabel}>KEY MEASUREMENTS</div>
+                      <div style={measureCardsRow}>
+                        {measurements?.organVolumeCc != null && (
+                          <div style={measureCard}>
+                            <div style={measureIconWrap}><CubeIcon /></div>
+                            <div style={measureLabel}>{labelize(active.root)} volume</div>
+                            <div style={measureValue}>{measurements.organVolumeCc.toFixed(1)} cm³</div>
+                            <div style={measureSub}>Measured from segmentation</div>
+                          </div>
+                        )}
+                        {measurements?.organMeanHu != null && (
+                          <div style={measureCard}>
+                            <div style={measureIconWrap}><PulseIcon /></div>
+                            <div style={measureLabel}>Mean attenuation</div>
+                            <div style={measureValue}>{measurements.organMeanHu.toFixed(1)} HU</div>
+                            <div style={measureSub}>Measured from CT data</div>
+                          </div>
+                        )}
+                      </div>
+                    </div>
+                  )}
+                </>
+              )}
+
+              {allClear && (
+                <p style={{ ...impressionText, marginTop: 14, fontSize: 14 }}>
+                  All {normal.length} reviewed structure{normal.length === 1 ? '' : 's'} looked healthy on this scan.
+                </p>
+              )}
+
+              <div style={hairline} />
+
+              <div style={{ ...actionsRow, ...stagger(revealed, 7) }}>
+                <button className="spc-share" onClick={handleShare} style={shareInlineBtn}>
+                  <span className="spc-share-icon" style={{ display: 'inline-flex' }}><ShareIcon /></span>
+                  {copied ? 'Link copied' : 'Share this BodyMap'}
+                </button>
+              </div>
+            </div>
+
+            {/* Big navy advertising footer — JHU shield, BodyMaps, link, and
+                the QR code all together, replacing the smaller de-identified
+                text block that used to sit above it. */}
+            <a
+              href={bodyMapsUrl}
+              target="_blank"
+              rel="noreferrer"
+              className="spc-ad"
+              style={{ ...adBar, ...stagger(revealed, 8) }}
+            >
+              <div style={adLeft}>
+                <img
+                  src={JHU_SHIELD_SRC}
+                  alt="Johns Hopkins University"
+                  style={adShield}
+                  onError={(e) => { (e.target as HTMLImageElement).style.display = 'none'; }}
+                />
+                <div style={adDivider} />
+                <div>
+                  <div style={adTitle}>BodyMaps</div>
+                  <div style={adUrl}>bodymaps.wse.jhu.edu</div>
+                </div>
+              </div>
+              <div className="spc-qr-wrap" style={adQrWrap}>
+                <img src={qrSrc} alt="QR code to this BodyMap" width={56} height={56} style={adQrImg} />
+              </div>
+            </a>
+          </div>
+        )}
+      </div>
+    </div>
+  );
+}
+
+function GearIcon() {
+  return <svg width="11" height="11" viewBox="0 0 24 24" fill="none" style={{ marginRight: 5 }}><circle cx="12" cy="12" r="3" stroke={AMBER} strokeWidth="2" /><path d="M12 2v3M12 19v3M4.2 4.2l2.1 2.1M17.7 17.7l2.1 2.1M2 12h3M19 12h3M4.2 19.8l2.1-2.1M17.7 6.3l2.1-2.1" stroke={AMBER} strokeWidth="2" strokeLinecap="round" /></svg>;
+}
+function CubeIcon() {
+  return <svg width="15" height="15" viewBox="0 0 24 24" fill="none"><path d="M12 3l8 4.5v9L12 21l-8-4.5v-9L12 3z" stroke={SPIRIT_TEXT} strokeWidth="1.7" strokeLinejoin="round" /><path d="M4 7.5L12 12l8-4.5M12 12v9" stroke={SPIRIT_TEXT} strokeWidth="1.7" strokeLinejoin="round" /></svg>;
+}
+function PulseIcon() {
+  return <svg width="15" height="15" viewBox="0 0 24 24" fill="none"><path d="M3 12h4l2-7 4 14 2-7h6" stroke={SPIRIT_TEXT} strokeWidth="1.8" strokeLinecap="round" strokeLinejoin="round" /></svg>;
+}
+function DocIcon() {
+  return <svg width="17" height="17" viewBox="0 0 24 24" fill="none"><path d="M6 3h9l5 5v13a1 1 0 01-1 1H6a1 1 0 01-1-1V4a1 1 0 011-1z" stroke="#fff" strokeWidth="1.6" strokeLinejoin="round" /><path d="M14 3v5h5" stroke="#fff" strokeWidth="1.6" strokeLinejoin="round" /><path d="M8 13h8M8 17h8" stroke="#fff" strokeWidth="1.5" strokeLinecap="round" /></svg>;
+}
+function ShareIcon() {
+  return <svg width="14" height="14" viewBox="0 0 24 24" fill="none" style={{ marginRight: 7 }}><path d="M12 3v13M8 7l4-4 4 4" stroke="#fff" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" /><path d="M5 13v6a1 1 0 001 1h12a1 1 0 001-1v-6" stroke="#fff" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" /></svg>;
+}
+
+// ─── Style tokens ───────────────────────────────────────────────────────────
+
+const page: React.CSSProperties = {
+  minHeight: '100vh', width: '100%', background: '#FBFCFE',
+  display: 'flex', alignItems: 'center', justifyContent: 'center',
+  padding: '36px 20px', fontFamily: "'Inter', -apple-system, BlinkMacSystemFont, sans-serif",
+};
+
+const stage: React.CSSProperties = { width: '100%', maxWidth: CARD_MAX };
+
+const loadingWrap: React.CSSProperties = { display: 'flex', justifyContent: 'center', padding: '80px 0' };
+const spinnerRing: React.CSSProperties = { width: 22, height: 22, borderRadius: '50%', border: `2px solid ${HAIRLINE}`, borderTopColor: NAVY, animation: 'spin 0.8s linear infinite' };
+
+const emptyState: React.CSSProperties = { textAlign: 'center', padding: '44px 24px', border: `1px solid ${HAIRLINE}`, borderRadius: 16, background: '#fff' };
+const emptyStateTitle: React.CSSProperties = { fontSize: 14.5, fontWeight: 600, color: MUTED };
+
+const card: React.CSSProperties = {
+  background: '#ffffff', borderRadius: 18, border: `1px solid ${HAIRLINE}`,
+  boxShadow: '0 12px 32px rgba(20,38,92,0.08)', overflow: 'hidden',
+};
+const cardBody: React.CSSProperties = { padding: '24px 26px 6px' };
+
+const brandLockup: React.CSSProperties = { display: 'flex', alignItems: 'center', gap: 10, textDecoration: 'none', marginBottom: 14 };
+const brandMark: React.CSSProperties = { width: 30, height: 30, borderRadius: 8, background: NAVY, display: 'flex', alignItems: 'center', justifyContent: 'center', flexShrink: 0 };
+const brandName: React.CSSProperties = { fontFamily: "'Poppins', sans-serif", fontWeight: 700, fontSize: 19, color: NAVY, lineHeight: 1.15 };
+const brandSub: React.CSSProperties = { fontSize: 11, color: MUTED, fontWeight: 500 };
+
+const eyebrow: React.CSSProperties = { fontSize: 10.5, fontWeight: 750, letterSpacing: '0.1em', color: SPIRIT_TEXT };
+const statLineWrap: React.CSSProperties = { display: 'flex', alignItems: 'center', gap: 10, marginTop: 5 };
+const statAccentBar: React.CSSProperties = { width: 4, height: 24, borderRadius: 2, flexShrink: 0 };
+const statLine: React.CSSProperties = { fontSize: 26, fontWeight: 700, fontFamily: "'Poppins', sans-serif" };
+const subStatLine: React.CSSProperties = { fontSize: 13, color: MUTED, marginTop: 6, marginBottom: 4, marginLeft: 14 };
+
+const chipRow: React.CSSProperties = { display: 'flex', flexWrap: 'wrap', gap: 6, marginTop: 14 };
+const chip = (active: boolean): React.CSSProperties => ({
+  fontSize: 11.5, fontWeight: 650, padding: '5px 11px', borderRadius: 999,
+  background: active ? NAVY : '#F1F4F9', color: active ? '#fff' : MUTED,
+});
+
+const panel: React.CSSProperties = { marginTop: 14, padding: '18px 20px', borderRadius: 14, background: PANEL, border: `1px solid ${HAIRLINE}` };
+const panelInner: React.CSSProperties = { display: 'flex', gap: 18, flexWrap: 'wrap' };
+const organImageSlot: React.CSSProperties = {
+  width: 140, height: 140, borderRadius: 12, flexShrink: 0,
+  background: '#fff', border: `1px dashed ${HAIRLINE}`,
+};
+const panelLabel: React.CSSProperties = { fontSize: 10, fontWeight: 750, letterSpacing: '0.08em', color: SPIRIT_TEXT };
+const organNameBig: React.CSSProperties = { fontFamily: "'Poppins', sans-serif", fontSize: 26, fontWeight: 700, color: INK, marginTop: 4, marginBottom: 10 };
+const findingBadge: React.CSSProperties = {
+  display: 'inline-flex', alignItems: 'center', fontSize: 12, fontWeight: 700, color: AMBER, background: AMBER_BG,
+  padding: '5px 12px', borderRadius: 999, border: '1px solid #EAD2A6',
+};
+
+const sectionLabel: React.CSSProperties = { fontSize: 10.5, fontWeight: 750, letterSpacing: '0.08em', color: SPIRIT_TEXT, marginTop: 20, marginBottom: 8 };
+const measureCardsRow: React.CSSProperties = { display: 'flex', gap: 10 };
+const measureCard: React.CSSProperties = { flex: 1, padding: '13px 14px', borderRadius: 12, background: PANEL, border: `1px solid ${HAIRLINE}` };
+const measureIconWrap: React.CSSProperties = { width: 26, height: 26, borderRadius: 8, background: '#E8F0FB', display: 'flex', alignItems: 'center', justifyContent: 'center', marginBottom: 8 };
+const measureLabel: React.CSSProperties = { fontSize: 10, fontWeight: 700, color: SPIRIT_TEXT, marginBottom: 4, textTransform: 'uppercase', letterSpacing: '0.02em' };
+const measureValue: React.CSSProperties = { fontFamily: "'Poppins', sans-serif", fontSize: 19, fontWeight: 700, color: INK };
+const measureSub: React.CSSProperties = { fontSize: 10.5, color: '#9AA5B8', marginTop: 2 };
+
+const impressionPanel: React.CSSProperties = {
+  display: 'flex', gap: 14, marginTop: 14, padding: '18px 20px',
+  background: '#EFF4FB', border: `1px solid ${HAIRLINE}`, borderRadius: 14,
+};
+const impressionIconWrap: React.CSSProperties = { width: 32, height: 32, borderRadius: 9, background: SPIRIT_TEXT, display: 'flex', alignItems: 'center', justifyContent: 'center', flexShrink: 0, marginTop: 1 };
+const impressionLabel: React.CSSProperties = { fontSize: 11, fontWeight: 750, letterSpacing: '0.08em', color: SPIRIT_TEXT, marginBottom: 7 };
+const impressionText: React.CSSProperties = { fontSize: 17, lineHeight: 1.5, color: INK, margin: 0, fontWeight: 500 };
+
+const hairline: React.CSSProperties = { height: 1, background: HAIRLINE, margin: '16px 0 12px' };
+
+const actionsRow: React.CSSProperties = { display: 'flex', justifyContent: 'center', marginBottom: 16 };
+const shareInlineBtn: React.CSSProperties = {
+  display: 'inline-flex', alignItems: 'center', padding: '13px 28px', borderRadius: 999, border: 'none',
+  color: '#fff', fontSize: 14, fontWeight: 700, letterSpacing: '0.01em', cursor: 'pointer', fontFamily: 'inherit',
+};
+
+// Bigger, single "advertising" footer — replaces both the old small
+// de-identified text block and the thin bottom bar with one prominent band.
+const adBar: React.CSSProperties = {
+  display: 'flex', alignItems: 'center', justifyContent: 'space-between',
+  padding: '22px 28px', background: NAVY, textDecoration: 'none', transition: 'background 0.2s',
+};
+const adLeft: React.CSSProperties = { display: 'flex', alignItems: 'center', gap: 16 };
+const adShield: React.CSSProperties = { height: 40, width: 'auto' };
+const adDivider: React.CSSProperties = { width: 1, height: 34, background: 'rgba(255,255,255,0.22)' };
+const adTitle: React.CSSProperties = { fontFamily: "'Poppins', sans-serif", fontSize: 16, fontWeight: 700, color: '#fff' };
+const adUrl: React.CSSProperties = { fontSize: 12, color: '#AFC2E8', marginTop: 2, fontWeight: 600 };
+const adQrWrap: React.CSSProperties = { padding: 5, background: '#fff', borderRadius: 10, flexShrink: 0 };
+const adQrImg: React.CSSProperties = { display: 'block', borderRadius: 4 };
diff --git a/flask-server/api/api_blueprint.py b/flask-server/api/api_blueprint.py
index dcd7a7f5..fffad4e2 100644
--- a/flask-server/api/api_blueprint.py
+++ b/flask-server/api/api_blueprint.py
@@ -59,6 +59,7 @@
 LOWRES_ROOT = os.environ.get("PANTS_LOWRES_PATH", "/home/visitor/pants_lowres")
 
 import hmac
+from itsdangerous import URLSafeSerializer, BadSignature
 import threading
 
 # Session/case ids come straight from client requests and are joined into
@@ -860,7 +861,10 @@ def report_html(id):
     protects case access here protects this route too -- no new data-exposure
     surface. The 'Download radiology report' button on the clinician side
     links to the existing /generate-report-pdf/<id> route."""
-    data = _build_report_data(id)
+    resolved = _resolve_case_id_or_token(id)
+    if resolved is None:
+        return jsonify({"error": "Invalid or expired link"}), 404
+    data = _build_report_data(resolved)
     if "error" in data:
         status = 400 if data["error"] == "Invalid id parameter" else 500
         return jsonify(data), status
@@ -1784,7 +1788,10 @@ def generate_report_pdf(id):
     temp_pdf_path = f"{PDF_DIR}/temp_report_{id}.pdf"
     output_pdf_path = f"{PDF_DIR}/report_{id}.pdf"
     try:
-        report_data = _build_report_data(id)
+        resolved = _resolve_case_id_or_token(id)
+        if resolved is None:
+            return jsonify({"error": "Invalid or expired link"}), 404
+        report_data = _build_report_data(resolved)
         if "error" in report_data:
             status = 400 if report_data["error"] == "Invalid id parameter" else 500
             return jsonify(report_data), status
@@ -5627,4 +5634,49 @@ def vessel_cpr(case_id):
         print("[vessel_cpr error]", type(error).__name__, error)
         return jsonify({"error": "Vessel analysis failed."}), 500
     finally:
-        _ANALYSIS_SLOTS.release()
\ No newline at end of file
+        _ANALYSIS_SLOTS.release()
+
+
+# --- share-token routes (auto-patched) ---
+def _share_serializer():
+    """Deterministic, stateless share tokens: same case_id always signs to
+    the same token (no DB row, no mapping file). Reuses whatever secret
+    Flask already has configured for sessions -- no new secret to manage.
+    NOTE: this makes share URLs opaque, it is NOT an access-control layer;
+    /api/get-report-data/<id> has no auth today regardless of this token."""
+    secret = current_app.secret_key or os.getenv("SECRET_KEY") or "dev-only-insecure-fallback"
+    return URLSafeSerializer(secret, salt="bodymaps-share-v1")
+
+
+@api_blueprint.route('/share/<case_id>/token', methods=['POST'])
+def create_share_token(case_id):
+    if not _is_safe_id(case_id):
+        return jsonify({"error": "Invalid id"}), 400
+    token = _share_serializer().dumps(str(case_id))
+    return jsonify({"share_id": token, "url": f"{_api_prefix_path()}/share/{token}"})
+
+
+@api_blueprint.route('/share/<token>', methods=['GET'])
+def get_shared_case(token):
+    try:
+        case_id = _share_serializer().loads(token)
+    except BadSignature:
+        return jsonify({"error": "Invalid or expired share link"}), 404
+    data = _build_report_data(case_id)
+    if "error" in data:
+        status = 400 if data["error"] == "Invalid id parameter" else 500
+        return jsonify(data), status
+    return jsonify(data)
+
+
+def _resolve_case_id_or_token(id_or_token: str):
+    """Accepts either a raw numeric case id (existing links keep working)
+    OR an opaque share token. Returns the real case_id, or None."""
+    if str(id_or_token).isdigit():
+        return str(id_or_token)
+    try:
+        case_id = _share_serializer().loads(id_or_token)
+        return str(case_id) if str(case_id).isdigit() else None
+    except BadSignature:
+        return None
+

From c9bbf3556e4172c1577fc9e115dfb2bde9ff4859 Mon Sep 17 00:00:00 2001
From: ishitaahelleya <ishita.ahelleya825@gmail.com>
Date: Mon, 17 Aug 2026 21:04:50 -0700
Subject: [PATCH 4/6] Defer report-data prefetch so it doesn't compete with CT
 load

---
 PanTS-Demo/src/routes/VisualizationPage.tsx | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/PanTS-Demo/src/routes/VisualizationPage.tsx b/PanTS-Demo/src/routes/VisualizationPage.tsx
index 259064df..dfcfc0f6 100644
--- a/PanTS-Demo/src/routes/VisualizationPage.tsx
+++ b/PanTS-Demo/src/routes/VisualizationPage.tsx
@@ -531,12 +531,18 @@ function VisualizationPage() {
 		new URLSearchParams(window.location.search).get("hd") === "1";
 	
 	useEffect(() => {
-		if (!isDicom && caseId && !reportDataCache[caseId]) {
+		if (isDicom || !caseId || reportDataCache[caseId]) return;
+		// Deferred ~2s so this doesn't compete with the CT/segmentation load for
+		// server CPU and disk I/O right when the viewer first opens — the scan
+		// is what the user needs immediately; the report data just needs to be
+		// warm in the cache well before anyone would actually click "Report."
+		const t = setTimeout(() => {
 			fetch(`${API_BASE}/api/get-report-data/${caseId}`)
 				.then(r => r.json())
 				.then(j => { if (!j.error) reportDataCache[caseId] = j; })
 				.catch(() => {});
-		}
+		}, 2000);
+		return () => clearTimeout(t);
 	}, [caseId, isDicom]);
 
 	const [showAnnotationToolbar, setShowAnnotationToolbar] = useState(false);

From 7a42750dee0b6ce1544900282ae3ed9ef0f8246b Mon Sep 17 00:00:00 2001
From: ishitaahelleya <ishita.ahelleya825@gmail.com>
Date: Mon, 17 Aug 2026 21:43:55 -0700
Subject: [PATCH 5/6] Drop unintended changes to the stale flat MeshViewer.tsx

---
 PanTS-Demo/src/components/MeshViewer.tsx | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/PanTS-Demo/src/components/MeshViewer.tsx b/PanTS-Demo/src/components/MeshViewer.tsx
index 1b8a55f8..21a72c6d 100644
--- a/PanTS-Demo/src/components/MeshViewer.tsx
+++ b/PanTS-Demo/src/components/MeshViewer.tsx
@@ -19,7 +19,6 @@ type SegmentationMeshViewerProps = {
   crosshairMm: Vec3 | null
   customOrgans?: CheckBoxData[];
   labelColorMap?: { [key: number]: Color };
-  autoRotate?: boolean;
 };
 
 export async function fetchMeshManifest(caseId: string): Promise<MeshManifest> {
@@ -28,7 +27,8 @@ export async function fetchMeshManifest(caseId: string): Promise<MeshManifest> {
   return res.json();
 }
 
-export function SegmentationMeshViewer({ caseId, checkState, loading, opacity, crosshairMm, customOrgans = [], labelColorMap = {}, autoRotate = false}: SegmentationMeshViewerProps) {  const [manifest, setManifest] = useState<MeshManifest | null>(null);
+export function SegmentationMeshViewer({ caseId, checkState, loading, opacity, crosshairMm, customOrgans = [], labelColorMap = {}}: SegmentationMeshViewerProps) {
+  const [manifest, setManifest] = useState<MeshManifest | null>(null);
   const [loaded, setLoaded] = useState<Record<number, boolean>>({});
   // Bumped on every mask edit so editedSegments below is recomputed — the 3D pane
   // needs to know the instant a static organ's mask changes, not just at mount.
@@ -78,10 +78,10 @@ export function SegmentationMeshViewer({ caseId, checkState, loading, opacity, c
           <ambientLight intensity={0.7} />
           <directionalLight position={[300, 500, 300]} intensity={1.2} />
           <Suspense fallback={null}>
-            <Bounds key={checkState.join(",")} fit clip observe margin={1.2}>
+            <Bounds fit clip observe margin={1.2}>
               <group>
                 {organs.map((organ) => {
-                  if (!loaded[organ.id] || !checkState[organ.id]) return null;
+                  if (!loaded[organ.id]) return null;
                   // Edited static organ: the server-baked GLB is stale — extract a
                   // fresh live mesh from the in-memory labelmap instead, same path
                   // custom classes already use.
@@ -101,7 +101,7 @@ export function SegmentationMeshViewer({ caseId, checkState, loading, opacity, c
                     <OrganMesh
                       key={organ.id}
                       organ={organ}
-                      visible={true}
+                      visible={!!checkState[organ.id]}
                       opacity={opacity/100}
                     />
                   );
@@ -122,7 +122,7 @@ export function SegmentationMeshViewer({ caseId, checkState, loading, opacity, c
               <SceneCrosshair3D position={crosshairPosition} bounds={manifest.bounds} />
             )}
           </Suspense>
-          <OrbitControls makeDefault autoRotate={autoRotate} autoRotateSpeed={2.2} />
+          <OrbitControls makeDefault />
         </Canvas>
       </main>
     </div>

From bd4877c67872ea527f4165f3ca78b17355dbc1f8 Mon Sep 17 00:00:00 2001
From: ishitaahelleya <ishita.ahelleya825@gmail.com>
Date: Thu, 20 Aug 2026 21:19:05 -0700
Subject: [PATCH 6/6] Remove unused framer-motion dependency

---
 PanTS-Demo/package-lock.json | 49 ------------------------------------
 PanTS-Demo/package.json      |  1 -
 2 files changed, 50 deletions(-)

diff --git a/PanTS-Demo/package-lock.json b/PanTS-Demo/package-lock.json
index 97f84b13..c2b8c005 100644
--- a/PanTS-Demo/package-lock.json
+++ b/PanTS-Demo/package-lock.json
@@ -20,7 +20,6 @@
         "@tabler/icons-react": "^3.34.1",
         "@tailwindcss/vite": "^4.1.12",
         "esbuild": "^0.25.9",
-        "framer-motion": "^12.42.2",
         "jszip": "^3.10.1",
         "pako": "^3.0.1",
         "pdfjs-dist": "^6.2.108",
@@ -8170,33 +8169,6 @@
         "url": "https://github.com/sponsors/rawify"
       }
     },
-    "node_modules/framer-motion": {
-      "version": "12.42.2",
-      "resolved": "https://registry.npmjs.org/framer-motion/-/framer-motion-12.42.2.tgz",
-      "integrity": "sha512-5XY9luDiu0oHfHBjpDthFMh0ES+122w6p/papSJBweMkO8Sn+PW2QaEgRblQBpWFnuvZS5qvarpt/hO2pjGmnw==",
-      "license": "MIT",
-      "dependencies": {
-        "motion-dom": "^12.42.2",
-        "motion-utils": "^12.39.0",
-        "tslib": "^2.4.0"
-      },
-      "peerDependencies": {
-        "@emotion/is-prop-valid": "*",
-        "react": "^18.0.0 || ^19.0.0",
-        "react-dom": "^18.0.0 || ^19.0.0"
-      },
-      "peerDependenciesMeta": {
-        "@emotion/is-prop-valid": {
-          "optional": true
-        },
-        "react": {
-          "optional": true
-        },
-        "react-dom": {
-          "optional": true
-        }
-      }
-    },
     "node_modules/fs.realpath": {
       "version": "1.0.0",
       "resolved": "https://registry.npmjs.org/fs.realpath/-/fs.realpath-1.0.0.tgz",
@@ -9465,21 +9437,6 @@
         "url": "https://github.com/sponsors/ljharb"
       }
     },
-    "node_modules/motion-dom": {
-      "version": "12.42.2",
-      "resolved": "https://registry.npmjs.org/motion-dom/-/motion-dom-12.42.2.tgz",
-      "integrity": "sha512-5gIMWLp/PycBtJRJWRgjxke5n8dlvkSn2DrYW+tr3XcqAZY1xZh6BJyooJXCM8wdfM7wfMjkBJNLge1CKPUIRA==",
-      "license": "MIT",
-      "dependencies": {
-        "motion-utils": "^12.39.0"
-      }
-    },
-    "node_modules/motion-utils": {
-      "version": "12.39.0",
-      "resolved": "https://registry.npmjs.org/motion-utils/-/motion-utils-12.39.0.tgz",
-      "integrity": "sha512-8nadJAJjTtqRkmRF36FoJTrywK9nnFmnPwnSMyxaOCU7GDjN9RTMJIxx9De8ErM+vpPhMccr/6fo5WciyQLnMQ==",
-      "license": "MIT"
-    },
     "node_modules/ms": {
       "version": "2.1.3",
       "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
@@ -10944,12 +10901,6 @@
         "typescript": ">=4.8.4"
       }
     },
-    "node_modules/tslib": {
-      "version": "2.8.1",
-      "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz",
-      "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==",
-      "license": "0BSD"
-    },
     "node_modules/tunnel-rat": {
       "version": "0.1.2",
       "resolved": "https://registry.npmjs.org/tunnel-rat/-/tunnel-rat-0.1.2.tgz",
diff --git a/PanTS-Demo/package.json b/PanTS-Demo/package.json
index 1b2b506d..d465e2bd 100644
--- a/PanTS-Demo/package.json
+++ b/PanTS-Demo/package.json
@@ -25,7 +25,6 @@
     "@tabler/icons-react": "^3.34.1",
     "@tailwindcss/vite": "^4.1.12",
     "esbuild": "^0.25.9",
-    "framer-motion": "^12.42.2",
     "jszip": "^3.10.1",
     "pako": "^3.0.1",
     "pdfjs-dist": "^6.2.108",