From 76352b8a54c1ead09be22c501abb9a5abd0f5054 Mon Sep 17 00:00:00 2001
From: McElwain <sean.mcelwain@outlook.com>
Date: Sat, 9 May 2026 15:14:18 -0500
Subject: [PATCH] Persist replica UI and layout OCR integration changes

---
 app/db/base.py                      |  1 +
 app/templates/documents/detail.html | 24 +++++++++++++++++++++++-
 2 files changed, 24 insertions(+), 1 deletion(-)

diff --git a/app/db/base.py b/app/db/base.py
index 59be703..dbd820b 100644
--- a/app/db/base.py
+++ b/app/db/base.py
@@ -1,3 +1,4 @@
 from sqlalchemy.orm import declarative_base
 
 Base = declarative_base()
+import app.models.document_analysis_version
diff --git a/app/templates/documents/detail.html b/app/templates/documents/detail.html
index 810e9b5..b156aa2 100644
--- a/app/templates/documents/detail.html
+++ b/app/templates/documents/detail.html
@@ -89,7 +89,11 @@ document.addEventListener("DOMContentLoaded", () => {
             <div class="error-box">OCR rerun failed.</div>
         {% elif error == "deprecated_pdf_route_disabled" %}
         <div class="error-box">This deprecated PDF save route has been disabled. Use Save Document instead.</div>
-    {% elif error == "save_replica_pdf_failed" %}
+    {% elif error == "clean_replica_requires_layout_ocr" %}
+<div class="alert alert-warning">
+    Clean replica could not be generated from the current OCR because this document does not yet have usable positional layout data. Run layout-capable OCR next, then save the replica again.
+</div>
+{% elif error == "save_replica_pdf_failed" %}
         <div class="error-box">Could not save replica PDF.</div>
     {% elif error == "save_replica_pdf_scan_backed_failed" %}
         <div class="error-box">Could not save scan-backed replica PDF.</div>
@@ -204,12 +208,30 @@ document.addEventListener("DOMContentLoaded", () => {
         </div>
 
         
+{% if success == "saved_replica_pdf_scan_backed_fallback" %}
+<div style="background:#ecfdf5; border:1px solid #86efac; color:#166534; padding:0.75rem 1rem; border-radius:10px; margin-bottom:1rem;">
+    Clean replica could not be generated for this document, so a scan-backed replica was created instead.
+</div>
+{% endif %}
+
 {% if error == "storage_unavailable" %}
 <div style="background:#ffe4e6; border:1px solid #fecdd3; color:#7f1d1d; padding:0.75rem 1rem; border-radius:10px; margin-bottom:1rem;">
     Storage mount unavailable. Please retry in a moment.
 </div>
 {% endif %}
 
+{% if error == "clean_replica_has_no_renderable_lines" %}
+<div style="background:#fff7ed; border:1px solid #fdba74; color:#9a3412; padding:0.75rem 1rem; border-radius:10px; margin-bottom:1rem;">
+    Clean replica could not be generated because this document does not yet have usable text layout data. Save the scan-backed replica for now, or re-run OCR/review first.
+</div>
+{% endif %}
+
+{% if success == "saved_replica_pdf_scan_backed_fallback" %}
+<div style="background:#ecfdf5; border:1px solid #86efac; color:#166534; padding:0.75rem 1rem; border-radius:10px; margin-bottom:1rem;">
+    Clean replica was unavailable because usable OCR layout boxes were missing. A scan-backed replica was generated instead.
+</div>
+{% endif %}
+
 
 <div class="detail-view-mode-bar">
     <button type="button" class="detail-view-mode-button active" data-detail-mode="split">Split</button>