correcao de mapas

backend/app/api/elaboracao.py

@@ -143,6 +143,7 @@ class ExportModeloPayload(SessionPayload):
 class UpdateMapaPayload(SessionPayload):
     variavel_mapa: str | None = None
     modo_mapa: str | None = None
+    escala_extremo_abs: float | None = None
 
 
 class ColunaDataMercadoPayload(SessionPayload):
@@ -468,7 +469,12 @@ def map_update(payload: UpdateMapaPayload) -> dict[str, Any]:
 @router.post("/residuos/map/update")
 def residuos_map_update(payload: UpdateMapaPayload) -> dict[str, Any]:
     session = session_store.get(payload.session_id)
-    return elaboracao_service.atualizar_mapa_residuos(session, payload.variavel_mapa, payload.modo_mapa)
+    return elaboracao_service.atualizar_mapa_residuos(
+        session,
+        payload.variavel_mapa,
+        payload.modo_mapa,
+        payload.escala_extremo_abs,
+    )
 
 
 @router.post("/market-date/preview")

backend/app/core/elaboracao/charts.py

@@ -7,6 +7,7 @@ import numpy as np
 import pandas as pd
 import plotly.graph_objects as go
 from plotly.subplots import make_subplots
+import math
 from scipy import stats
 from scipy.interpolate import griddata
 from scipy.spatial import ConvexHull, QhullError
@@ -15,6 +16,7 @@ from folium import plugins
 import branca.colormap as cm
 from branca.element import Element
 from html import escape
+from typing import Any
 from app.core.map_layers import add_bairros_layer, add_indice_marker, add_zoom_responsive_circle_markers
 
 # ============================================================
@@ -606,6 +608,159 @@ def _mascara_dentro_poligono(x_grid: np.ndarray, y_grid: np.ndarray, poligono: n
     return inside
 
 
+def _aplicar_jitter_sobrepostos(
+    df_mapa: pd.DataFrame,
+    lat_col: str,
+    lon_col: str,
+    lat_plot_col: str,
+    lon_plot_col: str,
+) -> pd.DataFrame:
+    """
+    Aplica jitter visual apenas em pontos com coordenadas idênticas.
+    Mantém as coordenadas originais intactas para cálculos e filtros.
+    """
+    df_plot = df_mapa.copy()
+    df_plot[lat_plot_col] = pd.to_numeric(df_plot[lat_col], errors="coerce")
+    df_plot[lon_plot_col] = pd.to_numeric(df_plot[lon_col], errors="coerce")
+
+    if len(df_plot) <= 1:
+        return df_plot
+
+    chave_lat = df_plot[lat_col].round(7)
+    chave_lon = df_plot[lon_col].round(7)
+    grupos = df_plot.groupby([chave_lat, chave_lon], sort=False)
+
+    passo_metros = 4.0
+    max_raio_metros = 22.0
+    metros_por_grau_lat = 111_320.0
+
+    for _, idx_labels in grupos.indices.items():
+        if len(idx_labels) <= 1:
+            continue
+        idx_list = list(idx_labels)
+        base_lat = float(df_plot.at[idx_list[0], lat_plot_col])
+        base_lon = float(df_plot.at[idx_list[0], lon_plot_col])
+        if not np.isfinite(base_lat) or not np.isfinite(base_lon):
+            continue
+
+        seed_val = int((abs(base_lat) * 1_000_000.0) + (abs(base_lon) * 1_000_000.0) * 3.0) % 360
+        angulo_base = math.radians(seed_val)
+        cos_lat = max(abs(math.cos(math.radians(base_lat))), 1e-6)
+        metros_por_grau_lon = metros_por_grau_lat * cos_lat
+
+        for pos, idx_label in enumerate(idx_list):
+            if pos == 0:
+                continue
+
+            pos_ring = pos - 1
+            ring = 1
+            while pos_ring >= (6 * ring):
+                pos_ring -= 6 * ring
+                ring += 1
+
+            slots_ring = max(6 * ring, 1)
+            angulo = angulo_base + (2.0 * math.pi * (pos_ring / slots_ring))
+            raio_m = min(ring * passo_metros, max_raio_metros)
+
+            delta_lat = (raio_m * math.sin(angulo)) / metros_por_grau_lat
+            delta_lon = (raio_m * math.cos(angulo)) / metros_por_grau_lon
+
+            df_plot.at[idx_label, lat_plot_col] = base_lat + delta_lat
+            df_plot.at[idx_label, lon_plot_col] = base_lon + delta_lon
+
+    return df_plot
+
+
+def _montar_popup_registro_em_colunas(
+    idx: Any,
+    row: pd.Series,
+    allowed_cols: list[str],
+    max_itens_coluna: int = 8,
+    popup_uid: str | None = None,
+) -> tuple[str, int]:
+    itens: list[tuple[str, str]] = []
+    for col in allowed_cols:
+        if col not in row.index:
+            continue
+        col_txt = str(col)
+        col_low = col_txt.lower()
+        if col_txt.startswith("__mesa_"):
+            continue
+        if col_low in {"lat", "latitude", "lon", "longitude"}:
+            continue
+        val = row[col]
+        if isinstance(val, (int, float, np.floating, np.integer)) and np.isfinite(val):
+            val_fmt = f"{float(val):.2f}"
+        else:
+            val_fmt = str(val)
+        itens.append((col_txt, val_fmt))
+
+    if not itens:
+        return f"<b>Índice: {escape(str(idx))}</b>", 320
+
+    paginas = [itens[i:i + max_itens_coluna] for i in range(0, len(itens), max_itens_coluna)]
+    popup_uid = popup_uid or f"mesa-pop-{abs(hash(str(idx))) % 10_000_000}"
+
+    pages_html = []
+    botoes_html = []
+    for pagina_idx, pagina_itens in enumerate(paginas):
+        trs = "".join([
+            "<tr style='border-bottom:1px solid #e9ecef;'>"
+            f"<td style='padding:4px 8px 4px 0; color:#6c757d; font-weight:500;'>{escape(c)}</td>"
+            f"<td style='padding:4px 0; text-align:right; color:#495057;'>{escape(v)}</td>"
+            "</tr>"
+            for c, v in pagina_itens
+        ])
+        display = "block" if pagina_idx == 0 else "none"
+        pages_html.append(
+            f"<div class='mesa-popup-page' data-page='{pagina_idx}' style='display:{display};'>"
+            f"<table style='border-collapse:collapse; font-size:12px; width:100%;'>{trs}</table>"
+            "</div>"
+        )
+        botao_style = (
+            "border:1px solid #9fb4c8; background:#eaf1f7; border-radius:6px; "
+            "padding:2px 7px; font-size:11px; cursor:pointer; color:#2f4b66;"
+            if pagina_idx == 0
+            else
+            "border:1px solid #ced8e2; background:#fff; border-radius:6px; "
+            "padding:2px 7px; font-size:11px; cursor:pointer; color:#4e6479;"
+        )
+        onclick = (
+            f"var root=document.getElementById('{popup_uid}');"
+            "if(!root){return false;}"
+            "var pages=root.querySelectorAll('.mesa-popup-page');"
+            "for(var i=0;i<pages.length;i++){pages[i].style.display=(i==="
+            f"{pagina_idx}"
+            ")?'block':'none';}"
+            "var btns=root.querySelectorAll('[data-page-btn]');"
+            "for(var j=0;j<btns.length;j++){btns[j].style.background='#fff';btns[j].style.borderColor='#ced8e2';btns[j].style.color='#4e6479';}"
+            "this.style.background='#eaf1f7';this.style.borderColor='#9fb4c8';this.style.color='#2f4b66';"
+            "return false;"
+        )
+        botoes_html.append(
+            f"<button type='button' data-page-btn='1' style=\"{botao_style}\" onclick=\"{onclick}\">"
+            f"{pagina_idx + 1}</button>"
+        )
+
+    controls_html = ""
+    if len(paginas) > 1:
+        controls_html = (
+            "<div class='mesa-popup-controls' style='display:flex; gap:6px; flex-wrap:wrap; margin-top:8px; align-items:center;'>"
+            f"<span style='font-size:11px; color:#5d7388; margin-right:2px;'>Páginas:</span>{''.join(botoes_html)}"
+            "</div>"
+        )
+
+    popup_html = (
+        f"<div id='{popup_uid}' style=\"font-family:'Segoe UI'; border-radius:8px; overflow:hidden;\">"
+        "<div style=\"background:#6c757d; color:white; padding:10px 15px; font-weight:600;\">Dados do Registro</div>"
+        "<div style=\"padding:12px 15px; background:#f8f9fa;\">"
+        f"<div class='mesa-popup-pages'>{''.join(pages_html)}</div>"
+        f"{controls_html}"
+        "</div></div>"
+    )
+    return popup_html, 430
+
+
 def _normalizar_stops_cor(
     cor_stops: list[float] | None,
     colors: list[str],
@@ -974,6 +1129,20 @@ def criar_mapa(
     # Camada de índices (oculta por padrão, ativável pelo controle de camadas)
     mostrar_indices = (not modo_calor and not modo_superficie) and len(df_mapa) <= 800
     camada_indices = folium.FeatureGroup(name="Índices", show=False) if mostrar_indices else None
+    lat_plot_col = "__mesa_lat_plot__"
+    lon_plot_col = "__mesa_lon_plot__"
+    if not modo_calor and not modo_superficie:
+        df_plot_pontos = _aplicar_jitter_sobrepostos(
+            df_mapa,
+            lat_col=lat_real,
+            lon_col=lon_real,
+            lat_plot_col=lat_plot_col,
+            lon_plot_col=lon_plot_col,
+        )
+    else:
+        df_plot_pontos = df_mapa.copy()
+        df_plot_pontos[lat_plot_col] = df_plot_pontos[lat_real]
+        df_plot_pontos[lon_plot_col] = df_plot_pontos[lon_real]
 
     if modo_superficie:
         superficie_ok = _adicionar_superficie_continua(
@@ -1074,7 +1243,7 @@ def criar_mapa(
             ).add_to(m)
     elif not modo_superficie:
         # Adiciona pontos
-        for idx, row in df_mapa.iterrows():
+        for marker_ordem, (idx, row) in enumerate(df_plot_pontos.iterrows()):
             # Cor do ponto
             if colormap and cor_col:
                 cor = colormap(row[cor_col])
@@ -1091,19 +1260,20 @@ def criar_mapa(
             peso = 3 if idx == indice_destacado else 1
 
             # Popup com informações
-            popup_html = f"<b>Índice: {idx}</b><br>"
-            if len(df_mapa) <= 1200:
-                for col in df_mapa.columns:
-                    if str(col).lower() not in ['lat', 'latitude', 'lon', 'longitude']:
-                        val = row[col]
-                        if isinstance(val, (int, float)):
-                            popup_html += f"{col}: {val:.2f}<br>"
-                        else:
-                            popup_html += f"{col}: {val}<br>"
-            elif tamanho_col and tamanho_col in df_mapa.columns:
-                val = row[tamanho_col]
-                val_str = f"{val:.2f}" if isinstance(val, (int, float)) else str(val)
-                popup_html += f"{tamanho_col}: {val_str}<br>"
+            popup_cols: list[str]
+            if len(df_plot_pontos) <= 1200:
+                popup_cols = [str(c) for c in df_plot_pontos.columns]
+            elif tamanho_col and tamanho_col in df_plot_pontos.columns:
+                popup_cols = [str(tamanho_col)]
+            else:
+                popup_cols = []
+            popup_html, popup_width = _montar_popup_registro_em_colunas(
+                idx,
+                row,
+                popup_cols,
+                max_itens_coluna=8,
+                popup_uid=f"mesa-pop-{marker_ordem}",
+            )
 
             # Tooltip (hover): índice + variável selecionada no dropdown
             tooltip_html = (
@@ -1121,9 +1291,9 @@ def criar_mapa(
             tooltip_html += "</div>"
 
             marcador = folium.CircleMarker(
-                location=[row[lat_real], row[lon_real]],
+                location=[row[lat_plot_col], row[lon_plot_col]],
                 radius=raio,
-                popup=folium.Popup(popup_html, max_width=300, auto_pan=False),
+                popup=folium.Popup(popup_html, max_width=popup_width, auto_pan=False),
                 tooltip=folium.Tooltip(tooltip_html, sticky=True),
                 color='black',
                 weight=peso,
@@ -1137,8 +1307,8 @@ def criar_mapa(
             if mostrar_indices and camada_indices is not None:
                 add_indice_marker(
                     camada_indices,
-                    lat=float(row[lat_real]),
-                    lon=float(row[lon_real]),
+                    lat=float(row[lat_plot_col]),
+                    lon=float(row[lon_plot_col]),
                     indice=idx,
                 )
 

backend/app/core/visualizacao/app.py

@@ -11,6 +11,7 @@ import os
 import re
 import traceback
 from datetime import datetime
+from html import escape
 
 
 # Importações para gráficos (trazidas de graficos.py)
@@ -670,6 +671,135 @@ def formatar_escalas_html(escalas_raw):
 
     return f"""<div class="dai-card">{criar_titulo_secao_html("Escalas / Transformações")}<div class="dai-cards-grid" style="grid-template-columns: repeat(auto-fill, minmax({largura_min}px, 1fr));">{cards_html}</div></div>"""
 
+
+def _aplicar_jitter_sobrepostos(df_mapa, lat_col, lon_col, lat_plot_col, lon_plot_col):
+    """
+    Aplica jitter visual mínimo para separar pontos com coordenadas idênticas.
+    Não altera as coordenadas originais da base.
+    """
+    df_plot = df_mapa.copy()
+    df_plot[lat_plot_col] = pd.to_numeric(df_plot[lat_col], errors="coerce")
+    df_plot[lon_plot_col] = pd.to_numeric(df_plot[lon_col], errors="coerce")
+
+    if len(df_plot) <= 1:
+        return df_plot
+
+    chave_lat = df_plot[lat_col].round(7)
+    chave_lon = df_plot[lon_col].round(7)
+    grupos = df_plot.groupby([chave_lat, chave_lon], sort=False)
+
+    passo_metros = 4.0
+    max_raio_metros = 22.0
+    metros_por_grau_lat = 111_320.0
+
+    for _, idx_labels in grupos.indices.items():
+        if len(idx_labels) <= 1:
+            continue
+        idx_list = list(idx_labels)
+        base_lat = float(df_plot.at[idx_list[0], lat_plot_col])
+        base_lon = float(df_plot.at[idx_list[0], lon_plot_col])
+        if not np.isfinite(base_lat) or not np.isfinite(base_lon):
+            continue
+
+        seed_val = int((abs(base_lat) * 1_000_000.0) + (abs(base_lon) * 1_000_000.0) * 3.0) % 360
+        angulo_base = math.radians(seed_val)
+        cos_lat = max(abs(math.cos(math.radians(base_lat))), 1e-6)
+        metros_por_grau_lon = metros_por_grau_lat * cos_lat
+
+        for pos, idx_label in enumerate(idx_list):
+            if pos == 0:
+                continue
+
+            pos_ring = pos - 1
+            ring = 1
+            while pos_ring >= (6 * ring):
+                pos_ring -= 6 * ring
+                ring += 1
+
+            slots_ring = max(6 * ring, 1)
+            angulo = angulo_base + (2.0 * math.pi * (pos_ring / slots_ring))
+            raio_m = min(ring * passo_metros, max_raio_metros)
+
+            delta_lat = (raio_m * math.sin(angulo)) / metros_por_grau_lat
+            delta_lon = (raio_m * math.cos(angulo)) / metros_por_grau_lon
+
+            df_plot.at[idx_label, lat_plot_col] = base_lat + delta_lat
+            df_plot.at[idx_label, lon_plot_col] = base_lon + delta_lon
+
+    return df_plot
+
+
+def _montar_popup_registro_paginado(itens, popup_uid, max_itens_pagina=8):
+    if not itens:
+        html = (
+            "<div style=\"font-family:'Segoe UI'; border-radius:8px; overflow:hidden;\">"
+            "<div style=\"background:#6c757d; color:white; padding:10px 15px; font-weight:600;\">Dados do Registro</div>"
+            "<div style=\"padding:12px 15px; background:#f8f9fa; color:#6c757d; font-size:12px;\">Sem variáveis para exibir.</div>"
+            "</div>"
+        )
+        return html, 360
+
+    paginas = [itens[i:i + max_itens_pagina] for i in range(0, len(itens), max_itens_pagina)]
+    pages_html = []
+    botoes_html = []
+
+    for page_idx, page_items in enumerate(paginas):
+        trs = "".join([
+            "<tr style='border-bottom:1px solid #e9ecef;'>"
+            f"<td style='padding:4px 8px 4px 0; color:#6c757d; font-weight:500;'>{escape(str(c))}</td>"
+            f"<td style='padding:4px 0; text-align:right; color:#495057;'>{escape(str(v))}</td>"
+            "</tr>"
+            for c, v in page_items
+        ])
+        display = "block" if page_idx == 0 else "none"
+        pages_html.append(
+            f"<div class='mesa-popup-page' data-page='{page_idx}' style='display:{display};'>"
+            f"<table style='border-collapse:collapse; font-size:12px; width:100%;'>{trs}</table>"
+            "</div>"
+        )
+        botao_style = (
+            "border:1px solid #9fb4c8; background:#eaf1f7; border-radius:6px; "
+            "padding:2px 7px; font-size:11px; cursor:pointer; color:#2f4b66;"
+            if page_idx == 0
+            else
+            "border:1px solid #ced8e2; background:#fff; border-radius:6px; "
+            "padding:2px 7px; font-size:11px; cursor:pointer; color:#4e6479;"
+        )
+        onclick = (
+            f"var root=document.getElementById('{popup_uid}');"
+            "if(!root){return false;}"
+            "var pages=root.querySelectorAll('.mesa-popup-page');"
+            "for(var i=0;i<pages.length;i++){pages[i].style.display=(i==="
+            f"{page_idx}"
+            ")?'block':'none';}"
+            "var btns=root.querySelectorAll('[data-page-btn]');"
+            "for(var j=0;j<btns.length;j++){btns[j].style.background='#fff';btns[j].style.borderColor='#ced8e2';btns[j].style.color='#4e6479';}"
+            "this.style.background='#eaf1f7';this.style.borderColor='#9fb4c8';this.style.color='#2f4b66';"
+            "return false;"
+        )
+        botoes_html.append(
+            f"<button type='button' data-page-btn='1' style=\"{botao_style}\" onclick=\"{onclick}\">"
+            f"{page_idx + 1}</button>"
+        )
+
+    controls_html = ""
+    if len(paginas) > 1:
+        controls_html = (
+            "<div class='mesa-popup-controls' style='display:flex; gap:6px; flex-wrap:wrap; margin-top:8px; align-items:center;'>"
+            f"<span style='font-size:11px; color:#5d7388; margin-right:2px;'>Páginas:</span>{''.join(botoes_html)}"
+            "</div>"
+        )
+
+    html = (
+        f"<div id='{popup_uid}' style=\"font-family:'Segoe UI'; border-radius:8px; overflow:hidden;\">"
+        "<div style=\"background:#6c757d; color:white; padding:10px 15px; font-weight:600;\">Dados do Registro</div>"
+        "<div style=\"padding:12px 15px; background:#f8f9fa;\">"
+        f"<div class='mesa-popup-pages'>{''.join(pages_html)}</div>"
+        f"{controls_html}"
+        "</div></div>"
+    )
+    return html, 430
+
 # ============================================================
 # FUNÇÃO: GERAR MAPA FOLIUM (com suporte a dimensionamento por variável)
 # ============================================================
@@ -786,6 +916,15 @@ def criar_mapa(df, lat_col="lat", lon_col="lon", cor_col=None, tamanho_col=None,
 
     mostrar_indices = len(df_mapa) <= 800
     camada_indices = folium.FeatureGroup(name="Índices", show=False) if mostrar_indices else None
+    lat_plot_key = "__mesa_lat_plot__"
+    lon_plot_key = "__mesa_lon_plot__"
+    df_plot_pontos = _aplicar_jitter_sobrepostos(
+        df_mapa,
+        lat_col=lat_key,
+        lon_col=lon_key,
+        lat_plot_col=lat_plot_key,
+        lon_plot_col=lon_plot_key,
+    )
 
     tooltip_col = None
     tooltip_key = None
@@ -800,7 +939,7 @@ def criar_mapa(df, lat_col="lat", lon_col="lon", cor_col=None, tamanho_col=None,
             df_mapa[tooltip_key] = serie_tooltip
 
     # Adiciona pontos
-    for idx, row in df_mapa.iterrows():
+    for marker_ordem, (idx, row) in enumerate(df_plot_pontos.iterrows()):
         # Cor do ponto
         if colormap and cor_key and pd.notna(row[cor_key]):
             cor = colormap(row[cor_key])
@@ -830,19 +969,11 @@ def criar_mapa(df, lat_col="lat", lon_col="lon", cor_col=None, tamanho_col=None,
                     val_fmt = str(val)
                 itens.append((col, val_fmt))
 
-        MAX_ITENS = 8
-        colunas_html = []
-        for i in range(0, len(itens), MAX_ITENS):
-            chunk = itens[i:i+MAX_ITENS]
-            trs = "".join([f"<tr style='border-bottom: 1px solid #e9ecef;'><td style='padding:4px 8px 4px 0; color:#6c757d; font-weight:500;'>{c}</td><td style='padding:4px 0; text-align:right; color:#495057;'>{v}</td></tr>" for c, v in chunk])
-            style = "border-left: 2px solid #dee2e6; padding-left: 20px;" if i > 0 else ""
-            colunas_html.append(f"<div style='flex: 0 0 auto; {style}'><table style='border-collapse:collapse; font-size:12px;'>{trs}</table></div>")
-
-        popup_html = f"""<div style="font-family:'Segoe UI'; border-radius:8px; overflow:hidden;"><div style="background:#6c757d; color:white; padding:10px 15px; font-weight:600;">Dados do Registro</div><div style="padding:12px 15px; background:#f8f9fa;"><div style="display:flex; gap:20px;">{"".join(colunas_html)}</div></div></div>"""
-
         # Tooltip (hover): índice + variável selecionada no dropdown (ou dependente como fallback)
         # Usa coluna "index" (original, gerada pelo reset_index) quando disponível
         idx_display = int(row["index"]) if "index" in row.index else idx
+        popup_uid = f"mesa-pop-{marker_ordem}"
+        popup_html, popup_width = _montar_popup_registro_paginado(itens, popup_uid, max_itens_pagina=8)
         tooltip_html = (
             "<div style='font-family:\"Segoe UI\",Arial,sans-serif; font-size:14px;"
             " line-height:1.7; padding:2px 4px;'>"
@@ -865,9 +996,9 @@ def criar_mapa(df, lat_col="lat", lon_col="lon", cor_col=None, tamanho_col=None,
         tooltip_html += "</div>"
 
         marcador = folium.CircleMarker(
-            location=[row[lat_key], row[lon_key]],
+            location=[row[lat_plot_key], row[lon_plot_key]],
             radius=raio,
-            popup=folium.Popup(popup_html, max_width=280 * len(colunas_html)),
+            popup=folium.Popup(popup_html, max_width=popup_width),
             tooltip=folium.Tooltip(tooltip_html, sticky=True),
             color='black',
             weight=1,
@@ -880,8 +1011,8 @@ def criar_mapa(df, lat_col="lat", lon_col="lon", cor_col=None, tamanho_col=None,
         if mostrar_indices and camada_indices is not None:
             add_indice_marker(
                 camada_indices,
-                lat=float(row[lat_key]),
-                lon=float(row[lon_key]),
+                lat=float(row[lat_plot_key]),
+                lon=float(row[lon_plot_key]),
                 indice=idx_display,
             )
 

backend/app/services/elaboracao_service.py

@@ -2114,7 +2114,45 @@ def atualizar_mapa(session: SessionState, var_mapa: str | None, modo_mapa: str |
     return {"mapa_html": mapa_html}
 
 
-def atualizar_mapa_residuos(session: SessionState, var_mapa: str | None, modo_mapa: str | None = None) -> dict[str, Any]:
+def _normalizar_extremo_abs_residuos(valor: float | None) -> float | None:
+    if valor is None:
+        return None
+    try:
+        extremo = float(valor)
+    except (TypeError, ValueError):
+        return None
+    if not np.isfinite(extremo):
+        return None
+    if abs(extremo) <= 0:
+        return None
+    return float(np.clip(abs(extremo), 0.5, 20.0))
+
+
+def _montar_ticks_residuos(extremo_abs: float) -> tuple[list[float], list[str]]:
+    inteiro = int(round(extremo_abs))
+    if np.isclose(extremo_abs, inteiro) and inteiro <= 12:
+        valores = [float(v) for v in range(-inteiro, inteiro + 1)] if inteiro > 0 else [-1.0, 0.0, 1.0]
+    else:
+        valores = [float(v) for v in np.linspace(-extremo_abs, extremo_abs, 11)]
+
+    def _label(v: float) -> str:
+        if np.isclose(v, round(v)):
+            return str(int(round(v)))
+        return f"{v:.2f}".rstrip("0").rstrip(".")
+
+    labels = [_label(v) for v in valores]
+    if labels:
+        labels[0] = f"<= {labels[0]}"
+        labels[-1] = f">= {labels[-1]}"
+    return valores, labels
+
+
+def atualizar_mapa_residuos(
+    session: SessionState,
+    var_mapa: str | None,
+    modo_mapa: str | None = None,
+    escala_extremo_abs: float | None = None,
+) -> dict[str, Any]:
     tabela_metricas = session.tabela_metricas_estado
     if tabela_metricas is None or tabela_metricas.empty:
         raise HTTPException(status_code=400, detail="Ajuste o modelo para gerar métricas de resíduos")
@@ -2127,23 +2165,35 @@ def atualizar_mapa_residuos(session: SessionState, var_mapa: str | None, modo_ma
     modo = str(modo_mapa or "pontos").strip().lower()
     if modo not in {"pontos", "calor", "superficie"}:
         modo = "pontos"
+    extremo_abs = _normalizar_extremo_abs_residuos(escala_extremo_abs)
+    cor_vmin = None if extremo_abs is None else -extremo_abs
+    cor_vmax = None if extremo_abs is None else extremo_abs
+    ticks_valores, ticks_labels = (None, None)
+    if extremo_abs is not None:
+        ticks_valores, ticks_labels = _montar_ticks_residuos(extremo_abs)
+    extremo_txt = None if extremo_abs is None else f"{extremo_abs:.2f}".rstrip("0").rstrip(".")
+    caption = (
+        "Resíduo Pad. (escala livre conforme limites dos dados)"
+        if extremo_abs is None
+        else f"Resíduo Pad. (escala fixa -{extremo_txt} a +{extremo_txt})"
+    )
 
     mapa_html = charts.criar_mapa(
         df,
         tamanho_col=var_escolhida,
         modo=modo,
-        cor_vmin=-5.0,
-        cor_vmax=5.0,
-        cor_caption="Resíduo Pad. (escala fixa -5 a +5)",
+        cor_vmin=cor_vmin,
+        cor_vmax=cor_vmax,
+        cor_caption=caption,
         cor_colors=["#2e7d32", "#f1c40f", "#ffffff", "#f1c40f", "#c62828"],
-        cor_stops=[-5.0, -2.0, 0.0, 2.0, 5.0],
-        cor_tick_values=[-5.0, -4.0, -3.0, -2.0, -1.0, 0.0, 1.0, 2.0, 3.0, 4.0, 5.0],
-        cor_tick_labels=["-5", "-4", "-3", "-2", "-1", "0", "1", "2", "3", "4", "5"],
+        cor_tick_values=ticks_valores,
+        cor_tick_labels=ticks_labels,
     )
     return {
         "mapa_html": mapa_html,
         "variavel_mapa": var_escolhida,
         "modo_mapa": modo,
+        "escala_extremo_abs": extremo_abs,
     }
 
 

frontend/src/App.jsx

@@ -18,7 +18,7 @@ const TABS = [
 ]
 
 export default function App() {
-  const [activeTab, setActiveTab] = useState(TABS[0].key)
+  const [activeTab, setActiveTab] = useState('')
   const [showStartupIntro, setShowStartupIntro] = useState(true)
   const [sessionId, setSessionId] = useState('')
   const [bootError, setBootError] = useState('')
@@ -61,7 +61,7 @@ export default function App() {
     setLogsEvents([])
     setLogsError('')
     setLogsPage(1)
-    setActiveTab(TABS[0].key)
+    setActiveTab('')
     setShowStartupIntro(true)
     setAuthError(message)
   }

frontend/src/api.js

@@ -230,10 +230,11 @@ export const api = {
     variavel_mapa: variavelMapa,
     modo_mapa: modoMapa,
   }),
-  updateElaboracaoResiduosMap: (sessionId, variavelMapa, modoMapa = 'pontos') => postJson('/api/elaboracao/residuos/map/update', {
+  updateElaboracaoResiduosMap: (sessionId, variavelMapa, modoMapa = 'pontos', escalaExtremoAbs = null) => postJson('/api/elaboracao/residuos/map/update', {
     session_id: sessionId,
     variavel_mapa: variavelMapa,
     modo_mapa: modoMapa,
+    escala_extremo_abs: escalaExtremoAbs,
   }),
   previewMarketDateColumn: (sessionId, colunaData) => postJson('/api/elaboracao/market-date/preview', { session_id: sessionId, coluna_data: colunaData }),
   applyMarketDateColumn: (sessionId, colunaData) => postJson('/api/elaboracao/market-date/apply', { session_id: sessionId, coluna_data: colunaData }),

frontend/src/components/ElaboracaoTab.jsx

@@ -33,6 +33,9 @@ const MAPA_MODO_PONTOS = 'pontos'
 const MAPA_MODO_CALOR = 'calor'
 const MAPA_MODO_SUPERFICIE = 'superficie'
 const MAPA_RESIDUOS_VARIAVEL = 'Resíduo Pad.'
+const MAPA_RESIDUOS_EXTREMO_LIVRE = 'livre'
+const MAPA_RESIDUOS_EXTREMO_ABS_DEFAULT = MAPA_RESIDUOS_EXTREMO_LIVRE
+const MAPA_RESIDUOS_EXTREMO_ABS_OPTIONS = [2, 3, 4, 5, 6, 7, 8, 10]
 const OUTLIER_RECURSIVO_TOOLTIP = 'Aplicar com recursividade executa os mesmos filtros em ciclos sucessivos: nos bastidores, simula a exclusão dos índices encontrados, recalcula o ajuste do modelo e as métricas de outlier e reaplica os filtros, repetindo até não surgir nenhum índice novo. Para você, o resultado prático é que o campo "A excluir" é preenchido automaticamente com o conjunto total de índices encontrados nessa simulação recursiva.'
 
 function grauBadgeClass(value) {
@@ -166,6 +169,36 @@ function formatMetric4(value) {
   return Number.isFinite(num) ? num.toFixed(4) : '-'
 }
 
+function formatNumberBr(value, maximumFractionDigits = 4) {
+  const num = Number(value)
+  if (!Number.isFinite(num)) return '-'
+  return num.toLocaleString('pt-BR', {
+    minimumFractionDigits: 0,
+    maximumFractionDigits,
+  })
+}
+
+function quantileLinear(sortedValues, q) {
+  if (!Array.isArray(sortedValues) || sortedValues.length === 0) return null
+  const clampedQ = Math.min(1, Math.max(0, Number(q)))
+  const pos = (sortedValues.length - 1) * clampedQ
+  const low = Math.floor(pos)
+  const high = Math.ceil(pos)
+  const lowValue = Number(sortedValues[low])
+  const highValue = Number(sortedValues[high])
+  if (!Number.isFinite(lowValue) || !Number.isFinite(highValue)) return null
+  if (low === high) return lowValue
+  return lowValue + ((highValue - lowValue) * (pos - low))
+}
+
+function parseMapaResiduosExtremoAbs(value) {
+  const raw = String(value ?? '').trim().toLowerCase()
+  if (!raw || raw === MAPA_RESIDUOS_EXTREMO_LIVRE) return null
+  const parsed = Number(raw)
+  if (!Number.isFinite(parsed) || parsed <= 0) return null
+  return parsed
+}
+
 function sleep(ms) {
   return new Promise((resolve) => {
     window.setTimeout(resolve, ms)
@@ -704,6 +737,7 @@ export default function ElaboracaoTab({ sessionId }) {
   const [mapaGerado, setMapaGerado] = useState(false)
   const [mapaResiduosHtml, setMapaResiduosHtml] = useState('')
   const [mapaResiduosModo, setMapaResiduosModo] = useState(MAPA_MODO_PONTOS)
+  const [mapaResiduosExtremoAbs, setMapaResiduosExtremoAbs] = useState(MAPA_RESIDUOS_EXTREMO_ABS_DEFAULT)
   const [mapaResiduosGerado, setMapaResiduosGerado] = useState(false)
 
   const [coordsInfo, setCoordsInfo] = useState(null)
@@ -992,6 +1026,46 @@ export default function ElaboracaoTab({ sessionId }) {
 
     return Array.from(indices)
   }, [fit?.tabela_metricas, filtros, outlierHighlightIndexColumn])
+  const resumoResiduoPadStats = useMemo(() => {
+    const rows = fit?.tabela_metricas?.rows
+    if (!Array.isArray(rows) || rows.length === 0) return null
+
+    const colunasCandidatas = ['Resíduo Pad.', 'Residuo Pad.', 'Resíduo Padronizado', 'Residuo Padronizado']
+    let colunaResiduo = ''
+    for (let i = 0; i < colunasCandidatas.length; i += 1) {
+      const candidata = colunasCandidatas[i]
+      if (rows.some((row) => row && typeof row === 'object' && Object.prototype.hasOwnProperty.call(row, candidata))) {
+        colunaResiduo = candidata
+        break
+      }
+    }
+    if (!colunaResiduo) return null
+
+    const valores = rows
+      .map((row) => toFiniteNumber(row?.[colunaResiduo]))
+      .filter((item) => item !== null)
+      .map((item) => Number(item))
+
+    if (valores.length === 0) return null
+    const ordenados = [...valores].sort((a, b) => a - b)
+    const min = ordenados[0]
+    const max = ordenados[ordenados.length - 1]
+    const q1 = quantileLinear(ordenados, 0.25)
+    const mediana = quantileLinear(ordenados, 0.5)
+    const q3 = quantileLinear(ordenados, 0.75)
+
+    return {
+      minimo: min,
+      q1,
+      mediana,
+      q3,
+      maximo: max,
+    }
+  }, [fit?.tabela_metricas?.rows])
+  const mapaResiduosExtremoAbsAtivo = useMemo(
+    () => parseMapaResiduosExtremoAbs(mapaResiduosExtremoAbs),
+    [mapaResiduosExtremoAbs],
+  )
   const transformacaoAplicadaYBadge = useMemo(
     () => formatTransformacaoBadge(transformacoesAplicadas?.transformacao_y),
     [transformacoesAplicadas],
@@ -1675,6 +1749,7 @@ export default function ElaboracaoTab({ sessionId }) {
     setSecao13InterativoEixoYResiduo('residuo_pad')
     setSecao13InterativoEixoYColuna('')
     setMapaResiduosModo(MAPA_MODO_PONTOS)
+    setMapaResiduosExtremoAbs(MAPA_RESIDUOS_EXTREMO_ABS_DEFAULT)
     setMapaResiduosHtml('')
     setMapaResiduosGerado(false)
     const transformacaoYAplicada = resp.transformacao_y || transformacaoY
@@ -1824,6 +1899,7 @@ export default function ElaboracaoTab({ sessionId }) {
       setMapaResiduosGerado(false)
       setMapaResiduosHtml('')
       setMapaResiduosModo(MAPA_MODO_PONTOS)
+      setMapaResiduosExtremoAbs(MAPA_RESIDUOS_EXTREMO_ABS_DEFAULT)
       setGeoAuto200(true)
       setSelectedSheet('')
       setRequiresSheet(false)
@@ -1854,6 +1930,7 @@ export default function ElaboracaoTab({ sessionId }) {
       setMapaResiduosGerado(false)
       setMapaResiduosHtml('')
       setMapaResiduosModo(MAPA_MODO_PONTOS)
+      setMapaResiduosExtremoAbs(MAPA_RESIDUOS_EXTREMO_ABS_DEFAULT)
       setGeoAuto200(true)
       setSelectedSheet('')
       setRequiresSheet(false)
@@ -1913,6 +1990,7 @@ export default function ElaboracaoTab({ sessionId }) {
       setMapaResiduosGerado(false)
       setMapaResiduosHtml('')
       setMapaResiduosModo(MAPA_MODO_PONTOS)
+      setMapaResiduosExtremoAbs(MAPA_RESIDUOS_EXTREMO_ABS_DEFAULT)
       setGeoAuto200(true)
       const resp = await api.confirmSheet(sessionId, selectedSheet)
       setTipoFonteDados('tabular')
@@ -2677,17 +2755,48 @@ export default function ElaboracaoTab({ sessionId }) {
   async function onMapaResiduosModoChange(value) {
     setMapaResiduosModo(value)
     if (!sessionId || !mapaResiduosGerado) return
+    const extremoAbs = parseMapaResiduosExtremoAbs(mapaResiduosExtremoAbs)
     await withBusy(async () => {
-      const resp = await api.updateElaboracaoResiduosMap(sessionId, MAPA_RESIDUOS_VARIAVEL, value)
+      const resp = await api.updateElaboracaoResiduosMap(sessionId, MAPA_RESIDUOS_VARIAVEL, value, extremoAbs)
       setMapaResiduosHtml(resp.mapa_html || '')
+      const extremoResp = Number(resp?.escala_extremo_abs)
+      if (Number.isFinite(extremoResp) && extremoResp > 0) {
+        setMapaResiduosExtremoAbs(String(Number(extremoResp)))
+      } else {
+        setMapaResiduosExtremoAbs(MAPA_RESIDUOS_EXTREMO_LIVRE)
+      }
+    })
+  }
+
+  async function onMapaResiduosExtremoAbsChange(value) {
+    const raw = String(value || MAPA_RESIDUOS_EXTREMO_LIVRE)
+    setMapaResiduosExtremoAbs(raw)
+    const extremoAbs = parseMapaResiduosExtremoAbs(raw)
+    if (!sessionId || !mapaResiduosGerado) return
+    await withBusy(async () => {
+      const resp = await api.updateElaboracaoResiduosMap(sessionId, MAPA_RESIDUOS_VARIAVEL, mapaResiduosModo, extremoAbs)
+      setMapaResiduosHtml(resp.mapa_html || '')
+      const extremoResp = Number(resp?.escala_extremo_abs)
+      if (Number.isFinite(extremoResp) && extremoResp > 0) {
+        setMapaResiduosExtremoAbs(String(Number(extremoResp)))
+      } else {
+        setMapaResiduosExtremoAbs(MAPA_RESIDUOS_EXTREMO_LIVRE)
+      }
     })
   }
 
   async function onGerarMapaResiduos() {
     if (!sessionId) return
+    const extremoAbs = parseMapaResiduosExtremoAbs(mapaResiduosExtremoAbs)
     await withBusy(async () => {
-      const resp = await api.updateElaboracaoResiduosMap(sessionId, MAPA_RESIDUOS_VARIAVEL, mapaResiduosModo)
+      const resp = await api.updateElaboracaoResiduosMap(sessionId, MAPA_RESIDUOS_VARIAVEL, mapaResiduosModo, extremoAbs)
       setMapaResiduosHtml(resp.mapa_html || '')
+      const extremoResp = Number(resp?.escala_extremo_abs)
+      if (Number.isFinite(extremoResp) && extremoResp > 0) {
+        setMapaResiduosExtremoAbs(String(Number(extremoResp)))
+      } else {
+        setMapaResiduosExtremoAbs(MAPA_RESIDUOS_EXTREMO_LIVRE)
+      }
       setMapaResiduosGerado(true)
     })
   }
@@ -4693,62 +4802,122 @@ export default function ElaboracaoTab({ sessionId }) {
           </SectionBlock>
 
           <SectionBlock step="16" title="Analisar Resíduos" subtitle="Métricas para identificação de observações influentes.">
-            <details className="dados-mapa-details" open>
-              <summary>Mapa de resíduos padronizados</summary>
-              {!mapaResiduosGerado ? (
-                <div className="empty-box">
-                  <div className="row">
-                    <button type="button" className="btn-gerar-mapa" onClick={onGerarMapaResiduos} disabled={loading}>
-                      Gerar Mapa de Resíduos Padronizados
-                    </button>
+            <div className="sec16-subsection">
+              <h5 className="sec16-subtitle">Resumo Estatístico dos Resíduos Padronizados</h5>
+              {resumoResiduoPadStats ? (
+                <div className="residuos-stats-box">
+                  <div className="residuos-stats-grid">
+                    <div className="residuos-stats-item">
+                      <span>Mínimo</span>
+                      <strong>{formatNumberBr(resumoResiduoPadStats.minimo)}</strong>
+                    </div>
+                    <div className="residuos-stats-item">
+                      <span>1º Quartil</span>
+                      <strong>{formatNumberBr(resumoResiduoPadStats.q1)}</strong>
+                    </div>
+                    <div className="residuos-stats-item">
+                      <span>Mediana</span>
+                      <strong>{formatNumberBr(resumoResiduoPadStats.mediana)}</strong>
+                    </div>
+                    <div className="residuos-stats-item">
+                      <span>3º Quartil</span>
+                      <strong>{formatNumberBr(resumoResiduoPadStats.q3)}</strong>
+                    </div>
+                    <div className="residuos-stats-item">
+                      <span>Máximo</span>
+                      <strong>{formatNumberBr(resumoResiduoPadStats.maximo)}</strong>
+                    </div>
                   </div>
-                  <div className="section1-empty-hint">O mapa de resíduos padronizados será carregado somente após solicitação explícita.</div>
                 </div>
               ) : (
-                <>
-                  <div className="dados-mapa-controls">
-                    <div className="dados-mapa-control-field">
-                      <label>Visualização</label>
-                      <select value={mapaResiduosModo} onChange={(e) => onMapaResiduosModoChange(e.target.value)}>
-                        <option value={MAPA_MODO_PONTOS}>Pontos</option>
-                        <option value={MAPA_MODO_CALOR}>Mapa de calor</option>
-                        <option value={MAPA_MODO_SUPERFICIE}>Superfície contínua</option>
-                      </select>
+                <div className="section1-empty-hint">Resumo indisponível para os resíduos padronizados.</div>
+              )}
+            </div>
+
+            <div className="sec16-subsection">
+              <h5 className="sec16-subtitle">Mapa de Resíduos Padronizados</h5>
+              <details className="dados-mapa-details" open>
+                <summary>Mostrar/Ocultar mapa</summary>
+                {!mapaResiduosGerado ? (
+                  <div className="empty-box">
+                    <div className="row">
+                      <button type="button" className="btn-gerar-mapa" onClick={onGerarMapaResiduos} disabled={loading}>
+                        Gerar Mapa de Resíduos Padronizados
+                      </button>
                     </div>
+                    <div className="section1-empty-hint">O mapa de resíduos padronizados será carregado somente após solicitação explícita.</div>
                   </div>
-                  <div className="download-actions-bar">
-                    <button
-                      type="button"
-                      className="btn-download-subtle"
-                      onClick={onDownloadMapaSecao16}
-                      disabled={loading || downloadingAssets || !mapaResiduosHtml}
-                    >
-                      Fazer download
-                    </button>
-                  </div>
-                  <MapFrame html={mapaResiduosHtml} />
-                </>
-              )}
-            </details>
-            <div className="download-actions-bar">
-              <button
-                type="button"
-                className="btn-download-subtle"
-                onClick={() => onDownloadTableCsv(fit.tabela_metricas, 'secao16_tabela_metricas')}
-                disabled={loading || downloadingAssets || !fit.tabela_metricas}
-              >
-                Fazer download
-              </button>
+                ) : (
+                  <>
+                    <div className="dados-mapa-controls">
+                      <div className="dados-mapa-control-field">
+                        <label>Visualização</label>
+                        <select value={mapaResiduosModo} onChange={(e) => onMapaResiduosModoChange(e.target.value)}>
+                          <option value={MAPA_MODO_PONTOS}>Pontos</option>
+                          <option value={MAPA_MODO_CALOR}>Mapa de calor</option>
+                          <option value={MAPA_MODO_SUPERFICIE}>Superfície contínua</option>
+                        </select>
+                      </div>
+                      <div className="dados-mapa-control-field">
+                        <label>Extremos da escala (abs.)</label>
+                        <select
+                          value={String(mapaResiduosExtremoAbs)}
+                          onChange={(e) => {
+                            void onMapaResiduosExtremoAbsChange(e.target.value)
+                          }}
+                        >
+                          <option value={MAPA_RESIDUOS_EXTREMO_LIVRE}>Livre (limites dos dados)</option>
+                          {MAPA_RESIDUOS_EXTREMO_ABS_OPTIONS.map((valor) => (
+                            <option key={`mapa-res-ext-${valor}`} value={String(valor)}>
+                              ±{formatNumberBr(valor, 1)}
+                            </option>
+                          ))}
+                        </select>
+                      </div>
+                    </div>
+                    <div className="residuos-map-scale-hint">
+                      {mapaResiduosExtremoAbsAtivo === null
+                        ? 'Escala livre: os extremos seguem os limites observados dos resíduos padronizados.'
+                        : `Escala fixa: valores ≤ -${formatNumberBr(mapaResiduosExtremoAbsAtivo, 2)} e ≥ ${formatNumberBr(mapaResiduosExtremoAbsAtivo, 2)} usam as cores máximas.`}
+                    </div>
+                    <div className="download-actions-bar">
+                      <button
+                        type="button"
+                        className="btn-download-subtle"
+                        onClick={onDownloadMapaSecao16}
+                        disabled={loading || downloadingAssets || !mapaResiduosHtml}
+                      >
+                        Fazer download
+                      </button>
+                    </div>
+                    <MapFrame html={mapaResiduosHtml} />
+                  </>
+                )}
+              </details>
             </div>
-            <div className="outlier-highlight-note">
-              Linhas amarelas indicam observações que atendem aos filtros definidos na seção 17.
+
+            <div className="sec16-subsection">
+              <h5 className="sec16-subtitle">Dados de Resíduos</h5>
+              <div className="download-actions-bar">
+                <button
+                  type="button"
+                  className="btn-download-subtle"
+                  onClick={() => onDownloadTableCsv(fit.tabela_metricas, 'secao16_tabela_metricas')}
+                  disabled={loading || downloadingAssets || !fit.tabela_metricas}
+                >
+                  Fazer download
+                </button>
+              </div>
+              <div className="outlier-highlight-note">
+                Linhas amarelas indicam observações que atendem aos filtros definidos na seção 17.
+              </div>
+              <DataTable
+                table={fit.tabela_metricas}
+                maxHeight={320}
+                highlightedRowIndices={outlierRowsHighlight}
+                highlightIndexColumn={outlierHighlightIndexColumn}
+              />
             </div>
-            <DataTable
-              table={fit.tabela_metricas}
-              maxHeight={320}
-              highlightedRowIndices={outlierRowsHighlight}
-              highlightIndexColumn={outlierHighlightIndexColumn}
-            />
           </SectionBlock>
 
           <SectionBlock step="17" title="Exclusão ou Reinclusão de Outliers" subtitle="Filtre índices, revise e atualize o modelo.">

frontend/src/styles.css

@@ -927,6 +927,57 @@ textarea {
   margin-top: 6px;
 }
 
+.sec16-subsection {
+  border: 1px solid #dfe7ef;
+  border-radius: 10px;
+  background: #fbfdff;
+  padding: 10px;
+  margin-bottom: 10px;
+}
+
+.sec16-subtitle {
+  margin: 0 0 8px;
+  font-family: 'Sora', sans-serif;
+  font-size: 0.86rem;
+  color: #2e4459;
+}
+
+.residuos-stats-box {
+  margin-bottom: 0;
+}
+
+.residuos-stats-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(140px, 1fr));
+  gap: 8px;
+}
+
+.residuos-stats-item {
+  border: 1px solid #dce6ef;
+  background: #f7fafc;
+  border-radius: 8px;
+  padding: 6px 8px;
+  display: grid;
+  gap: 1px;
+}
+
+.residuos-stats-item span {
+  font-size: 0.72rem;
+  color: #667d92;
+}
+
+.residuos-stats-item strong {
+  font-family: 'Sora', sans-serif;
+  font-size: 0.84rem;
+  color: #2a3f53;
+}
+
+.residuos-map-scale-hint {
+  font-size: 0.74rem;
+  color: #5b7085;
+  margin: -4px 0 6px;
+}
+
 .dispersao-config-row {
   align-items: flex-end;
   gap: 14px;