Update app.py

app.py

@@ -133,11 +133,13 @@ def process_document():
     except Exception as e:
         tb = traceback.format_exc()
         print(f"[app.py] ❌ Processing error:\n{tb}")
+        # Distinguish user-facing errors (blank page) from real crashes
+        is_user_error = isinstance(e, ValueError)
         return jsonify({
             'status':  'error',
             'message': str(e),
-            'trace':   tb
-        }), 500
+            'trace':   '' if is_user_error else tb,
+        }), 200 if is_user_error else 500
     finally:
         try:
             os.remove(saved_path)
@@ -479,38 +481,40 @@ def _map_pipeline_output_form90(raw: dict, role: str):
 #  TEMPLATE MATCHING PIPELINE — coordinate crop + Tesseract OCR
 # ═════════════════════════════════════════════════════════════
 def _run_template_pipeline(file_path, form_hint, file2_path=None):
-    """
-    Use coordinate templates to crop and OCR each field region.
-    form_hint: '1A' / '2A' / '3A' / '90'
-    Maps form_hint → source form type (102/103/97/90).
-    """
-    # Convert PDF to image if needed
     img_path = file_path
     if file_path.lower().endswith('.pdf'):
         img_path = pdf_to_image(file_path) or file_path
 
-    # Auto-detect form type if hint is generic 'cert'
     hint_to_source = {'1A': '102', '2A': '103', '3A': '97', '90': '90'}
     if form_hint == '1A' and hint_to_source.get(form_hint) == '102':
         detected = detect_form_type(img_path)
         source_map = {'102': '1A', '103': '2A', '97': '3A', '90': '90'}
         form_hint = source_map.get(detected, '1A')
         source_type = detected
-        print(
-            f'[app.py] Auto-detected form type: {detected} → output: {form_hint}')
+        print(f'[app.py] Auto-detected form type: {detected} → output: {form_hint}')
     else:
         source_type = hint_to_source.get(form_hint, '102')
 
     # Extract fields from primary file
     raw = extract_fields(img_path, source_type)
 
-    # For Form 90 (marriage license), also process bride file if provided
+    # ── EARLY EXIT: blank or unreadable image ─────────────────
+    if isinstance(raw, dict) and raw.get('status') == 'error':
+        print(f'[app.py] Extraction aborted: {raw["message"]}')
+        raise ValueError(raw['message'])   # caught by the try/except in process_document()
+
+    # For Form 90, also process bride file if provided
     if form_hint == '90' and file2_path:
         img_path2 = file2_path
         if file2_path.lower().endswith('.pdf'):
             img_path2 = pdf_to_image(file2_path) or file2_path
         raw2 = extract_fields(img_path2, '90')
-        raw = {**raw, **raw2}   # merge — bride fields fill any gaps
+        # Guard bride file too
+        if isinstance(raw2, dict) and raw2.get('status') == 'error':
+            print(f'[app.py] Bride file aborted: {raw2["message"]}')
+        else:
+            raw = {**raw, **raw2}
+
 
     # Map source field names → output cert field names
     fields = _map_template_output(raw, form_hint)