feat: lighting quality assessment for Fitzpatrick estimation

app.py

@@ -389,6 +389,36 @@ def generate_pdf_report(image_rgb, binary_overlay, multiclass_overlay, result):
         bg = FITZ_RGB.get(ftype, (229, 231, 235))
         fg = FITZ_TEXT_RGB.get(ftype, (50, 50, 50))
 
+        # Lighting warning in PDF
+        lighting_quality = getattr(fitz, "lighting_quality", "good")
+        lighting_warning = getattr(fitz, "lighting_warning", "")
+        if lighting_quality == "insufficient":
+            pdf.set_fill_color(254, 242, 242)
+            pdf.set_draw_color(252, 165, 165)
+            pdf.set_text_color(220, 38, 38)
+            pdf._font("B", 8)
+            y_warn = pdf.get_y()
+            pdf.rect(pdf.get_x(), y_warn, 185, 10, "DF")
+            pdf.set_xy(pdf.get_x() + 2, y_warn + 1)
+            pdf.cell(0, 4, "ADVERTENCIA: Iluminacion insuficiente - tipo Fitzpatrick puede estar sobreestimado", 0, 1)
+            pdf._font("", 7)
+            pdf.set_text_color(153, 27, 27)
+            pdf.cell(0, 3, lighting_warning, 0, 1)
+            pdf.ln(3)
+        elif lighting_quality == "low":
+            pdf.set_fill_color(255, 251, 235)
+            pdf.set_draw_color(252, 211, 77)
+            pdf.set_text_color(217, 119, 6)
+            pdf._font("B", 8)
+            y_warn = pdf.get_y()
+            pdf.rect(pdf.get_x(), y_warn, 185, 10, "DF")
+            pdf.set_xy(pdf.get_x() + 2, y_warn + 1)
+            pdf.cell(0, 4, "PRECAUCION: Iluminacion suboptima - resultado puede tener 1-2 niveles de error", 0, 1)
+            pdf._font("", 7)
+            pdf.set_text_color(146, 64, 14)
+            pdf.cell(0, 3, lighting_warning, 0, 1)
+            pdf.ln(3)
+
         # Badge
         x_badge = pdf.get_x()
         y_badge = pdf.get_y()
@@ -408,12 +438,13 @@ def generate_pdf_report(image_rgb, binary_overlay, multiclass_overlay, result):
         pdf._font("", 9)
         det_x = x_badge + 40
         det_y = y_badge
+        l_scene = getattr(fitz, "l_scene_mean", 0)
         details = [
             ("ITA", f"{fitz.ita_angle:.1f} +/- {fitz.ita_std:.1f} grados"),
             ("L* medio (piel sana)", f"{fitz.l_skin_mean:.1f}"),
+            ("L* escena (global)", f"{l_scene:.1f}"),
             ("b* medio (piel sana)", f"{fitz.b_skin_mean:.1f}"),
             ("Pixeles sanos", f"{fitz.healthy_pixels:,}"),
-            ("Ratio piel sana", f"{fitz.healthy_ratio:.1%}"),
             ("Confianza", f"{fitz.confidence:.0%}"),
         ]
         for label, value in details:
@@ -626,7 +657,32 @@ def build_fitz_html(fitz):
         return "<p style='color:#6b7280;'>No se pudo estimar (insuficientes pixeles de piel sana).</p>"
     bg = FITZ_COLORS.get(fitz.fitzpatrick_type, "#e5e7eb")
     fg = FITZ_TEXT_COLORS.get(fitz.fitzpatrick_type, "#1f2937")
+
+    # Lighting warning banner
+    warning_html = ""
+    lighting_warning = getattr(fitz, "lighting_warning", "")
+    lighting_quality = getattr(fitz, "lighting_quality", "good")
+    l_scene = getattr(fitz, "l_scene_mean", 0)
+
+    if lighting_quality == "insufficient":
+        warning_html = f"""
+        <div style="background:#fef2f2; border:1px solid #fca5a5; border-radius:8px;
+                    padding:12px 16px; margin-bottom:12px; font-size:0.9em;">
+          <span style="color:#dc2626; font-weight:700;">&#9888; Iluminacion insuficiente</span><br>
+          <span style="color:#991b1b;">{lighting_warning}</span><br>
+          <span style="color:#6b7280; font-size:0.85em;">L* escena: {l_scene:.0f} (minimo recomendado: 35)</span>
+        </div>"""
+    elif lighting_quality == "low":
+        warning_html = f"""
+        <div style="background:#fffbeb; border:1px solid #fcd34d; border-radius:8px;
+                    padding:12px 16px; margin-bottom:12px; font-size:0.9em;">
+          <span style="color:#d97706; font-weight:700;">&#9888; Iluminacion suboptima</span><br>
+          <span style="color:#92400e;">{lighting_warning}</span><br>
+          <span style="color:#6b7280; font-size:0.85em;">L* escena: {l_scene:.0f} (recomendado: >50)</span>
+        </div>"""
+
     return f"""
+    {warning_html}
     <div style="display:flex; gap:16px; align-items:center; flex-wrap:wrap;">
       <div style="background:{bg}; color:{fg}; border-radius:12px; padding:18px 28px;
                   font-size:1.5em; font-weight:700; min-width:120px; text-align:center;
@@ -636,7 +692,8 @@ def build_fitz_html(fitz):
       </div>
       <div style="font-size:0.95em; line-height:1.8;">
         <b>ITA:</b> {fitz.ita_angle:.1f}&deg; &plusmn; {fitz.ita_std:.1f}&deg;<br>
-        <b>L* medio:</b> {fitz.l_skin_mean:.1f}<br>
+        <b>L* medio piel:</b> {fitz.l_skin_mean:.1f}<br>
+        <b>L* escena:</b> {l_scene:.1f}<br>
         <b>Pixeles sanos:</b> {fitz.healthy_pixels:,}<br>
         <b>Confianza:</b> {fitz.confidence:.0%}
       </div>