multiplas alteracoes

README.md

@@ -1,5 +1,5 @@
 ---
-title: Mesa React
+title: Mesa React Beta
 emoji: "🌖"
 colorFrom: blue
 colorTo: indigo
@@ -8,7 +8,7 @@ app_port: 7860
 pinned: false
 ---
 
-# MESA Frame (FastAPI + React)
+# MESA React Beta (FastAPI + React)
 
 Rearquitetura do app MESA com:
 
@@ -29,12 +29,15 @@ Rearquitetura do app MESA com:
 
 ```bash
 cd backend
-python -m venv .venv
+python3.12 -m venv .venv
 source .venv/bin/activate
 pip install -r requirements.txt
 ./run_backend.sh
 ```
 
+Observacao: o stack geoespacial do backend fecha melhor com Python 3.12 no macOS.
+Se `backend/.venv` existir, `./run_backend.sh` passa a usa-lo automaticamente.
+
 API: `http://localhost:8000`
 Swagger: `http://localhost:8000/docs`
 

backend/app/api/pesquisa.py

@@ -9,6 +9,7 @@ from pydantic import BaseModel
 from app.services.pesquisa_service import (
     PesquisaFiltros,
     gerar_mapa_modelos,
+    listar_logradouros_eixos,
     listar_modelos,
     obter_admin_config_pesquisa,
     resolver_localizacao_avaliando,
@@ -83,6 +84,11 @@ def pesquisar_admin_config_salvar(payload: PesquisaAdminConfigPayload) -> dict:
     return salvar_admin_config_pesquisa(payload.campos)
 
 
+@router.get("/logradouros-eixos")
+def pesquisar_logradouros_eixos(limite: int = Query(2000, ge=1, le=20000)) -> dict:
+    return listar_logradouros_eixos(limite=limite)
+
+
 @router.get("/modelos")
 def pesquisar_modelos(
     somente_contexto: bool = Query(False),

backend/app/api/visualizacao.py

@@ -28,6 +28,11 @@ class MapaPayload(SessionPayload):
     trabalhos_tecnicos_modelos_modo: str | None = None
 
 
+class SecaoPayload(SessionPayload):
+    secao: str
+    trabalhos_tecnicos_modelos_modo: str | None = None
+
+
 class MapaPopupPayload(SessionPayload):
     row_id: int
 
@@ -110,6 +115,18 @@ def exibir(payload: ExibirPayload, request: Request) -> dict[str, Any]:
     )
 
 
+@router.post("/section")
+def section(payload: SecaoPayload, request: Request) -> dict[str, Any]:
+    session = session_store.get(payload.session_id)
+    return visualizacao_service.carregar_secao_modelo(
+        session,
+        payload.secao,
+        trabalhos_tecnicos_modelos_modo=payload.trabalhos_tecnicos_modelos_modo,
+        api_base_url=str(request.base_url).rstrip("/"),
+        popup_auth_token=getattr(request.state, "auth_token", None),
+    )
+
+
 @router.post("/evaluation/context")
 def evaluation_context(payload: SessionPayload) -> dict[str, Any]:
     session = session_store.get(payload.session_id)

backend/app/core/dados/Bairros_LC12112_16.shp

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:1446d8cc7fdff70154b792fd1cf78b251d064ce38a58c8a81128702d2352967a
+size 5562340

backend/app/core/map_layers.py

@@ -16,18 +16,34 @@ _SIMPLIFY_TOLERANCE = 0.00005
 
 _BAIRROS_CACHE_LOCK = Lock()
 _BAIRROS_GEOJSON_CACHE: dict[str, Any] | None = None
-_BAIRROS_GEOJSON_CARREGADO = False
+_BAIRROS_SOURCE_SIGNATURE: tuple[tuple[str, int, int], ...] | None = None
+
+
+def _assinatura_bairros_source() -> tuple[tuple[str, int, int], ...] | None:
+    arquivos = sorted(_BAIRROS_SHP_PATH.parent.glob(f"{_BAIRROS_SHP_PATH.stem}.*"))
+    if not arquivos:
+        return None
+
+    assinatura: list[tuple[str, int, int]] = []
+    for caminho in arquivos:
+        try:
+            stat = caminho.stat()
+        except OSError:
+            continue
+        assinatura.append((caminho.name, int(stat.st_mtime_ns), int(stat.st_size)))
+    return tuple(assinatura) or None
 
 
 def _carregar_bairros_geojson() -> dict[str, Any] | None:
-    global _BAIRROS_GEOJSON_CACHE, _BAIRROS_GEOJSON_CARREGADO
+    global _BAIRROS_GEOJSON_CACHE, _BAIRROS_SOURCE_SIGNATURE
+    assinatura = _assinatura_bairros_source()
+    if assinatura is None or not _BAIRROS_SHP_PATH.exists():
+        return None
+
     with _BAIRROS_CACHE_LOCK:
-        if _BAIRROS_GEOJSON_CARREGADO:
+        if _BAIRROS_SOURCE_SIGNATURE == assinatura and _BAIRROS_GEOJSON_CACHE is not None:
             return _BAIRROS_GEOJSON_CACHE
-        _BAIRROS_GEOJSON_CARREGADO = True
 
-    if not _BAIRROS_SHP_PATH.exists():
-        return None
 
     try:
         import geopandas as gpd
@@ -54,7 +70,12 @@ def _carregar_bairros_geojson() -> dict[str, Any] | None:
         geojson = None
 
     with _BAIRROS_CACHE_LOCK:
-        _BAIRROS_GEOJSON_CACHE = geojson
+        if geojson is not None:
+            _BAIRROS_GEOJSON_CACHE = geojson
+            _BAIRROS_SOURCE_SIGNATURE = assinatura
+        else:
+            _BAIRROS_GEOJSON_CACHE = None
+            _BAIRROS_SOURCE_SIGNATURE = None
     return geojson
 
 

backend/app/models/session.py

@@ -53,6 +53,7 @@ class SessionState:
     pacote_visualizacao: dict[str, Any] | None = None
     dados_visualizacao: pd.DataFrame | None = None
     avaliacoes_visualizacao: list[dict[str, Any]] = field(default_factory=list)
+    visualizacao_cache: dict[str, Any] = field(default_factory=dict)
     graficos_dispersao_cache: dict[str, dict[str, Any]] = field(default_factory=dict)
 
     elaborador: dict[str, Any] | None = None
@@ -73,3 +74,4 @@ class SessionState:
         self.pacote_visualizacao = None
         self.dados_visualizacao = None
         self.avaliacoes_visualizacao = []
+        self.visualizacao_cache = {}

backend/app/services/elaboracao_service.py

@@ -383,7 +383,7 @@ def _montar_payload_dispersao(
 
     usar_png = _usar_png_dispersao(int(total_pontos))
     if not usar_png:
-        session.graficos_dispersao_cache.pop(key, None)
+        session.graficos_dispersao_cache[key] = payload_interativo
         return {
             "modo": "interativo",
             "grafico": payload_interativo,
@@ -419,6 +419,99 @@ def _montar_payload_dispersao(
     }
 
 
+def _trace_mode_includes_markers(mode: Any) -> bool:
+    return "markers" in str(mode or "").strip().lower()
+
+
+def _extrair_sequencia_payload(valores: Any) -> list[Any]:
+    if isinstance(valores, list):
+        return valores
+    if isinstance(valores, tuple):
+        return list(valores)
+    if isinstance(valores, dict):
+        dtype_text = str(valores.get("dtype") or "").strip()
+        bdata_text = str(valores.get("bdata") or "").strip()
+        if dtype_text and bdata_text:
+            try:
+                buffer = base64.b64decode(bdata_text)
+                array = np.frombuffer(buffer, dtype=np.dtype(dtype_text))
+                return array.tolist()
+            except Exception:
+                return []
+        return []
+    try:
+        return list(valores)
+    except Exception:
+        return []
+
+
+def _coletar_rotulos_indices_trace_payload(trace: dict[str, Any] | None) -> list[str]:
+    if not isinstance(trace, dict):
+        return []
+    if not _trace_mode_includes_markers(trace.get("mode")):
+        return []
+
+    for source_key in ("customdata", "ids", "text"):
+        valores = _extrair_sequencia_payload(trace.get(source_key))
+        if not valores:
+            continue
+        rotulos: list[str] = []
+        for item in valores:
+            if isinstance(item, (list, tuple)):
+                texto = next((str(sub).strip() for sub in item if str(sub).strip()), "")
+            elif isinstance(item, dict):
+                texto = str(
+                    item.get("indice")
+                    or item.get("Indice")
+                    or item.get("Índice")
+                    or "",
+                ).strip()
+            else:
+                texto = str(item or "").strip()
+            rotulos.append(texto)
+        if any(rotulos):
+            return rotulos
+    return []
+
+
+def _payload_grafico_com_indices(payload: Any) -> dict[str, Any] | None:
+    payload_sanitizado = sanitize_value(payload)
+    if not isinstance(payload_sanitizado, dict):
+        return None
+
+    clone = json.loads(json.dumps(payload_sanitizado))
+    data = clone.get("data")
+    if not isinstance(data, list):
+        return None
+
+    alterado = False
+
+    for trace in data:
+        if not isinstance(trace, dict):
+            continue
+        rotulos = _coletar_rotulos_indices_trace_payload(trace)
+        if not rotulos:
+            continue
+        mode_parts = [part.strip() for part in str(trace.get("mode") or "markers").split("+") if part.strip()]
+        if "text" not in mode_parts:
+            mode_parts.append("text")
+        if "markers" not in mode_parts:
+            mode_parts.append("markers")
+        trace["mode"] = "+".join(mode_parts)
+        trace["text"] = rotulos
+        trace["textposition"] = trace.get("textposition") or "top center"
+        base_textfont = trace.get("textfont") if isinstance(trace.get("textfont"), dict) else {}
+        trace["textfont"] = {
+            "size": 10,
+            "color": "#243746",
+            **base_textfont,
+        }
+        trace["cliponaxis"] = False
+        alterado = True
+
+    return clone if alterado else None
+
+
 def _clean_int_list(values: list[Any] | None) -> list[int]:
     if not values:
         return []
@@ -1414,6 +1507,10 @@ def fit_model(
 
     graficos = charts.criar_painel_diagnostico(resultado)
     usar_png_diagnosticos = _usar_png_dispersao(total_pontos_modelo)
+    obs_calc_payload = None if usar_png_diagnosticos else figure_to_payload(graficos.get("obs_calc"))
+    residuos_payload = None if usar_png_diagnosticos else figure_to_payload(graficos.get("residuos"))
+    histograma_payload = None if usar_png_diagnosticos else figure_to_payload(graficos.get("histograma"))
+    cook_payload = None if usar_png_diagnosticos else figure_to_payload(graficos.get("cook"))
     obs_calc_png = _renderizar_png_grafico(graficos.get("obs_calc")) if usar_png_diagnosticos else None
     residuos_png = _renderizar_png_grafico(graficos.get("residuos")) if usar_png_diagnosticos else None
     histograma_png = _renderizar_png_grafico(graficos.get("histograma")) if usar_png_diagnosticos else None
@@ -1425,7 +1522,7 @@ def fit_model(
         "secao15_cook": graficos.get("cook"),
     }
     for cache_key, fig_diag in diagnosticos_cache_map.items():
-        if usar_png_diagnosticos and fig_diag is not None:
+        if fig_diag is not None:
             payload_diag = figure_to_payload(fig_diag)
             if payload_diag:
                 session.graficos_dispersao_cache[cache_key] = payload_diag
@@ -1499,10 +1596,10 @@ def fit_model(
         "graficos_diagnostico_modo": "png" if usar_png_diagnosticos else "interativo",
         "graficos_diagnostico_total_pontos": total_pontos_modelo,
         "graficos_diagnostico_limiar_png": LIMIAR_DISPERSAO_PNG,
-        "grafico_obs_calc": None if usar_png_diagnosticos else figure_to_payload(graficos.get("obs_calc")),
-        "grafico_residuos": None if usar_png_diagnosticos else figure_to_payload(graficos.get("residuos")),
-        "grafico_histograma": None if usar_png_diagnosticos else figure_to_payload(graficos.get("histograma")),
-        "grafico_cook": None if usar_png_diagnosticos else figure_to_payload(graficos.get("cook")),
+        "grafico_obs_calc": obs_calc_payload,
+        "grafico_residuos": residuos_payload,
+        "grafico_histograma": histograma_payload,
+        "grafico_cook": cook_payload,
         "grafico_obs_calc_png": obs_calc_png,
         "grafico_residuos_png": residuos_png,
         "grafico_histograma_png": histograma_png,
@@ -1660,6 +1757,7 @@ def obter_grafico_dispersao_interativo(session: SessionState, alvo: str) -> dict
     return {
         "alvo": key,
         "grafico": sanitize_value(grafico),
+        "grafico_com_indices": _payload_grafico_com_indices(grafico),
     }
 
 
@@ -1682,6 +1780,7 @@ def obter_grafico_diagnostico_interativo(session: SessionState, grafico: str) ->
     return {
         "grafico": alvo,
         "payload": sanitize_value(payload),
+        "payload_com_indices": _payload_grafico_com_indices(payload),
     }
 
 

backend/app/services/pesquisa_service.py

@@ -287,7 +287,7 @@ def listar_modelos(filtros: PesquisaFiltros, limite: int | None = None, somente_
     todos = [_carregar_resumo_com_cache(caminho) for caminho in modelos]
     colunas_filtro = _montar_config_colunas_filtro(todos)
     admin_fontes = _carregar_fontes_admin(colunas_filtro)
-    sugestoes = _extrair_sugestoes(todos, admin_fontes)
+    sugestoes = _extrair_sugestoes(todos, admin_fontes, incluir_logradouros_eixos=False)
     aval_lat, aval_lon = _normalizar_coordenadas_avaliando(filtros_exec.aval_lat, filtros_exec.aval_lon)
     avaliandos_geo = _normalizar_avaliandos_geo(filtros_exec.avaliandos_geo)
     if (aval_lat is None or aval_lon is None) and len(avaliandos_geo) == 1:
@@ -3057,6 +3057,7 @@ def _extrair_sugestoes(
     modelos: list[dict[str, Any]],
     fontes_admin: dict[str, list[str]] | None = None,
     limite: int = 200,
+    incluir_logradouros_eixos: bool = True,
 ) -> dict[str, list[str]]:
     fontes_admin = fontes_admin or {}
     nomes: list[str] = []
@@ -3087,13 +3088,14 @@ def _extrair_sugestoes(
         tipos_modelo.append(str(_tipo_modelo_modelo(modelo) or ""))
         zonas_avaliacao.extend(_zonas_avaliacao_modelo(modelo))
 
-    try:
-        logradouros_eixos = [
-            str(item.get("logradouro") or "").strip()
-            for item in _carregar_catalogo_vias()
-        ]
-    except HTTPException:
-        logradouros_eixos = []
+    if incluir_logradouros_eixos:
+        try:
+            logradouros_eixos = [
+                str(item.get("logradouro") or "").strip()
+                for item in _carregar_catalogo_vias()
+            ]
+        except HTTPException:
+            logradouros_eixos = []
 
     return {
         "nomes_modelo": _lista_textos_unicos(nomes, limite),
@@ -3107,6 +3109,24 @@ def _extrair_sugestoes(
     }
 
 
+def listar_logradouros_eixos(limite: int | None = None) -> dict[str, Any]:
+    try:
+        logradouros = [
+            str(item.get("logradouro") or "").strip()
+            for item in _carregar_catalogo_vias()
+        ]
+    except HTTPException:
+        logradouros = []
+
+    itens = _lista_textos_unicos(logradouros, limite)
+    return sanitize_value(
+        {
+            "logradouros_eixos": itens,
+            "total_logradouros": len(itens),
+        }
+    )
+
+
 def _nomes_modelo_sugestao(modelo: dict[str, Any]) -> list[str]:
     nomes: list[str] = []
     vistos = set()

backend/app/services/trabalhos_tecnicos_service.py

@@ -6,6 +6,7 @@ import math
 import sqlite3
 from pathlib import Path
 from statistics import median
+from threading import Lock
 from typing import Any
 
 import folium
@@ -33,6 +34,12 @@ MAPA_TRABALHOS_CLUSTERIZADO = "clusterizado"
 MAPA_TRABALHOS_PONTOS = "pontos"
 
 
+_MODEL_MATCH_CACHE_LOCK = Lock()
+_MODEL_MATCH_CACHE_SIGNATURE: str | None = None
+_MODEL_MATCH_CACHE_CATALOGO: dict[str, dict[str, str]] = {}
+_MODEL_MATCH_CACHE_TRABALHOS: dict[str, set[str]] = {}
+
+
 def _connect_database(path: Path) -> sqlite3.Connection:
     conn = sqlite3.connect(str(path))
     conn.row_factory = sqlite3.Row
@@ -170,6 +177,70 @@ def _expandir_chaves_modelo(values: list[str], catalogo: dict[str, dict[str, str
     return chaves
 
 
+def _assinatura_cache_modelos_relacionados() -> str:
+    resolved_db = trabalhos_tecnicos_repository.resolve_database()
+    resolved_modelos = model_repository.resolve_model_repository()
+    return "|".join(
+        [
+            str(resolved_db.provider or ""),
+            str(resolved_db.repo_id or ""),
+            str(resolved_db.revision or ""),
+            str(resolved_db.db_path or ""),
+            str(resolved_modelos.signature or ""),
+        ]
+    )
+
+
+def _montar_cache_trabalhos_por_modelo() -> tuple[dict[str, dict[str, str]], dict[str, set[str]]]:
+    global _MODEL_MATCH_CACHE_SIGNATURE, _MODEL_MATCH_CACHE_CATALOGO, _MODEL_MATCH_CACHE_TRABALHOS
+    assinatura = _assinatura_cache_modelos_relacionados()
+    with _MODEL_MATCH_CACHE_LOCK:
+        if _MODEL_MATCH_CACHE_SIGNATURE == assinatura:
+            return _MODEL_MATCH_CACHE_CATALOGO, _MODEL_MATCH_CACHE_TRABALHOS
+        resolved = trabalhos_tecnicos_repository.resolve_database()
+        catalogo_modelos = _catalogo_modelos_mesa()
+
+        conn = _connect_database(resolved.db_path)
+        try:
+            overrides = _fetch_overrides(conn)
+            rows = conn.execute(
+                "SELECT trabalho_id, modelo_nome FROM trabalho_modelos ORDER BY trabalho_id, ordem, LOWER(modelo_nome)"
+            ).fetchall()
+        finally:
+            try:
+                conn.close()
+            except Exception:
+                pass
+
+        modelos_por_trabalho: dict[str, list[str]] = {}
+        trabalho_ids_override = set(overrides.keys())
+        for row in rows:
+            trabalho_id = str(row["trabalho_id"])
+            if trabalho_id in trabalho_ids_override:
+                continue
+            modelos_por_trabalho.setdefault(trabalho_id, []).append(str(row["modelo_nome"] or ""))
+
+        for trabalho_id, override in overrides.items():
+            modelos_por_trabalho[trabalho_id] = _dedupe_text_list(override.get("modelos"))
+
+        trabalhos_por_chave: dict[str, set[str]] = {}
+        for trabalho_id, modelos in modelos_por_trabalho.items():
+            chaves_trabalho: set[str] = set()
+            for modelo_nome in modelos:
+                texto = str(modelo_nome or "").strip()
+                if not texto:
+                    continue
+                _registrar_chaves_modelo(chaves_trabalho, texto)
+
+            for chave in chaves_trabalho:
+                trabalhos_por_chave.setdefault(chave, set()).add(trabalho_id)
+
+        _MODEL_MATCH_CACHE_SIGNATURE = assinatura
+        _MODEL_MATCH_CACHE_CATALOGO = catalogo_modelos
+        _MODEL_MATCH_CACHE_TRABALHOS = trabalhos_por_chave
+        return _MODEL_MATCH_CACHE_CATALOGO, _MODEL_MATCH_CACHE_TRABALHOS
+
+
 def _enriquecer_modelos(modelo_nomes: list[str], catalogo: dict[str, dict[str, str]]) -> list[dict[str, Any]]:
     enriched: list[dict[str, Any]] = []
     for nome in modelo_nomes:
@@ -426,8 +497,7 @@ def contar_avaliandos_por_modelo(chaves_modelo: list[str]) -> int:
         return 0
 
     try:
-        resolved = trabalhos_tecnicos_repository.resolve_database()
-        catalogo_modelos = _catalogo_modelos_mesa()
+        catalogo_modelos, trabalhos_por_chave = _montar_cache_trabalhos_por_modelo()
     except Exception:
         return 0
 
@@ -435,35 +505,10 @@ def contar_avaliandos_por_modelo(chaves_modelo: list[str]) -> int:
     if not chaves_selecionadas:
         return 0
 
-    conn = _connect_database(resolved.db_path)
-    try:
-        overrides = _fetch_overrides(conn)
-        rows = conn.execute(
-            "SELECT trabalho_id, modelo_nome FROM trabalho_modelos ORDER BY trabalho_id, ordem, LOWER(modelo_nome)"
-        ).fetchall()
-    finally:
-        try:
-            conn.close()
-        except Exception:
-            pass
-
-    modelos_por_trabalho: dict[str, list[str]] = {}
-    trabalho_ids_override = set(overrides.keys())
-    for row in rows:
-        trabalho_id = str(row["trabalho_id"])
-        if trabalho_id in trabalho_ids_override:
-            continue
-        modelos_por_trabalho.setdefault(trabalho_id, []).append(str(row["modelo_nome"] or ""))
-
-    for trabalho_id, override in overrides.items():
-        modelos_por_trabalho[trabalho_id] = _dedupe_text_list(override.get("modelos"))
-
-    total = 0
-    for modelos in modelos_por_trabalho.values():
-        chaves_trabalho = _expandir_chaves_modelo(modelos, catalogo_modelos)
-        if chaves_trabalho and not chaves_trabalho.isdisjoint(chaves_selecionadas):
-            total += 1
-    return total
+    trabalhos_relacionados: set[str] = set()
+    for chave in chaves_selecionadas:
+        trabalhos_relacionados.update(trabalhos_por_chave.get(chave) or ())
+    return len(trabalhos_relacionados)
 
 
 def _carregar_trabalho_base(

backend/app/services/visualizacao_service.py

@@ -340,6 +340,7 @@ def carregar_modelo(session: SessionState, caminho_arquivo: str) -> dict[str, An
     session.pacote_visualizacao = pacote
     session.dados_visualizacao = None
     session.avaliacoes_visualizacao = []
+    session.visualizacao_cache = {}
 
     nome_modelo = Path(caminho_arquivo).stem
     badge_html = viz_app._formatar_badge_completo(pacote, nome_modelo=nome_modelo)
@@ -623,37 +624,91 @@ def _preparar_dados_visualizacao(pacote: dict[str, Any]) -> pd.DataFrame:
     return dados
 
 
-def exibir_contexto_avaliacao(session: SessionState) -> dict[str, Any]:
-    pacote = session.pacote_visualizacao
-    if pacote is None:
-        raise HTTPException(status_code=400, detail="Carregue um modelo primeiro")
+def _visualizacao_cache(session: SessionState) -> dict[str, Any]:
+    cache = getattr(session, "visualizacao_cache", None)
+    if isinstance(cache, dict):
+        return cache
+    session.visualizacao_cache = {}
+    return session.visualizacao_cache
 
-    info = _extrair_modelo_info(pacote)
-    equacoes = _equacoes_do_modelo(pacote, info)
-    return {
-        "campos_avaliacao": campos_avaliacao(session),
-        "meta_modelo": sanitize_value(info),
-        "equacoes": sanitize_value(equacoes),
-    }
 
+def _visualizacao_tabs_cache(session: SessionState) -> dict[str, Any]:
+    cache = _visualizacao_cache(session)
+    tabs = cache.get("tabs")
+    if isinstance(tabs, dict):
+        return tabs
+    cache["tabs"] = {}
+    return cache["tabs"]
 
-def exibir_modelo(
-    session: SessionState,
-    trabalhos_tecnicos_modelos_modo: Any = None,
-    api_base_url: str | None = None,
-    popup_auth_token: str | None = None,
-) -> dict[str, Any]:
+
+def _obter_visualizacao_core(session: SessionState) -> dict[str, Any]:
     pacote = session.pacote_visualizacao
     if pacote is None:
         raise HTTPException(status_code=400, detail="Carregue um modelo primeiro")
 
+    cache = _visualizacao_cache(session)
+    core = cache.get("core")
+    if isinstance(core, dict):
+        dados_cache = core.get("dados")
+        if isinstance(dados_cache, pd.DataFrame):
+            session.dados_visualizacao = dados_cache
+            return core
+
     dados = _preparar_dados_visualizacao(pacote)
+    info = _extrair_modelo_info(pacote)
     dados_publicos = dados.drop(columns=["__mesa_row_id__"])
+    colunas_numericas = [
+        str(col)
+        for col in dados_publicos.select_dtypes(include=[np.number]).columns
+        if str(col).lower() not in ["lat", "lon", "latitude", "longitude", "index"]
+    ]
+    core = {
+        "dados": dados,
+        "info": info,
+        "mapa_choices": ["Visualização Padrão"] + colunas_numericas,
+    }
+    cache["core"] = core
+    session.dados_visualizacao = dados
+    return core
 
-    estat = _tabela_estatisticas(pacote).round(2)
 
-    escalas_html = viz_app.formatar_escalas_html(pacote["transformacoes"]["info"])
+def _payload_modelo_dados_mercado(session: SessionState) -> dict[str, Any]:
+    tabs_cache = _visualizacao_tabs_cache(session)
+    cached = tabs_cache.get("dados_mercado")
+    if isinstance(cached, dict):
+        return cached
+
+    core = _obter_visualizacao_core(session)
+    dados_publicos = core["dados"].drop(columns=["__mesa_row_id__"])
+    payload = {
+        "dados": dataframe_to_payload(dados_publicos, decimals=2, max_rows=None),
+    }
+    tabs_cache["dados_mercado"] = payload
+    return payload
+
+
+def _payload_modelo_metricas(session: SessionState) -> dict[str, Any]:
+    tabs_cache = _visualizacao_tabs_cache(session)
+    cached = tabs_cache.get("metricas")
+    if isinstance(cached, dict):
+        return cached
+
+    estat = _tabela_estatisticas(session.pacote_visualizacao).round(2)
+    payload = {
+        "estatisticas": dataframe_to_payload(estat, decimals=2),
+    }
+    tabs_cache["metricas"] = payload
+    return payload
 
+
+def _payload_modelo_transformacoes(session: SessionState) -> dict[str, Any]:
+    tabs_cache = _visualizacao_tabs_cache(session)
+    cached = tabs_cache.get("transformacoes")
+    if isinstance(cached, dict):
+        return cached
+
+    pacote = session.pacote_visualizacao
+    escalas_html = viz_app.formatar_escalas_html(pacote["transformacoes"]["info"])
     X = pacote["transformacoes"]["X"].reset_index()
     y = pacote["transformacoes"]["y"].reset_index()
     if "index" in y.columns and "index" in X.columns:
@@ -661,8 +716,40 @@ def exibir_modelo(
     df_xy = pd.concat([X, y], axis=1)
     df_xy = df_xy.loc[:, ~df_xy.columns.duplicated()].round(2)
 
+    payload = {
+        "escalas_html": escalas_html,
+        "dados_transformados": dataframe_to_payload(df_xy, decimals=2, max_rows=None),
+    }
+    tabs_cache["transformacoes"] = payload
+    return payload
+
+
+def _payload_modelo_resumo(session: SessionState) -> dict[str, Any]:
+    tabs_cache = _visualizacao_tabs_cache(session)
+    cached = tabs_cache.get("resumo")
+    if isinstance(cached, dict):
+        return cached
+
+    pacote = session.pacote_visualizacao
+    core = _obter_visualizacao_core(session)
     resumo_html = viz_app.formatar_resumo_html(viz_app.reorganizar_modelos_resumos(pacote["modelo"]["diagnosticos"]))
+    equacoes = _equacoes_do_modelo(pacote, core["info"])
 
+    payload = {
+        "resumo_html": resumo_html,
+        "equacoes": sanitize_value(equacoes),
+    }
+    tabs_cache["resumo"] = payload
+    return payload
+
+
+def _payload_modelo_coeficientes(session: SessionState) -> dict[str, Any]:
+    tabs_cache = _visualizacao_tabs_cache(session)
+    cached = tabs_cache.get("coeficientes")
+    if isinstance(cached, dict):
+        return cached
+
+    pacote = session.pacote_visualizacao
     tab_coef = pd.DataFrame(pacote["modelo"]["coeficientes"])
     if not isinstance(tab_coef.index, pd.RangeIndex):
         tab_coef.insert(0, "Variável", tab_coef.index.astype(str))
@@ -672,58 +759,170 @@ def exibir_modelo(
         tab_coef = pd.concat([tab_coef[mask], tab_coef[~mask]], ignore_index=True)
     tab_coef = tab_coef.round(4)
 
+    payload = {
+        "coeficientes": dataframe_to_payload(tab_coef, decimals=4),
+    }
+    tabs_cache["coeficientes"] = payload
+    return payload
+
+
+def _payload_modelo_obs_calc(session: SessionState) -> dict[str, Any]:
+    tabs_cache = _visualizacao_tabs_cache(session)
+    cached = tabs_cache.get("obs_calc")
+    if isinstance(cached, dict):
+        return cached
+
+    pacote = session.pacote_visualizacao
     tab_obs_calc = pacote["modelo"]["obs_calc"].reset_index().round(2)
+    payload = {
+        "obs_calc": dataframe_to_payload(tab_obs_calc, decimals=2),
+    }
+    tabs_cache["obs_calc"] = payload
+    return payload
 
-    figs = viz_app.gerar_todos_graficos(pacote)
 
-    info = _extrair_modelo_info(pacote)
-    equacoes = _equacoes_do_modelo(pacote, info)
+def _payload_modelo_graficos(session: SessionState) -> dict[str, Any]:
+    tabs_cache = _visualizacao_tabs_cache(session)
+    cached = tabs_cache.get("graficos")
+    if isinstance(cached, dict):
+        return cached
+
+    figs = viz_app.gerar_todos_graficos(session.pacote_visualizacao)
+    payload = {
+        "grafico_obs_calc": figure_to_payload(figs.get("obs_calc")),
+        "grafico_residuos": figure_to_payload(figs.get("residuos")),
+        "grafico_histograma": figure_to_payload(figs.get("hist")),
+        "grafico_cook": figure_to_payload(figs.get("cook")),
+        "grafico_correlacao": figure_to_payload(figs.get("corr")),
+    }
+    tabs_cache["graficos"] = payload
+    return payload
+
+
+def _payload_modelo_trabalhos_tecnicos(
+    session: SessionState,
+    trabalhos_tecnicos_modelos_modo: Any = None,
+) -> dict[str, Any]:
+    _, trabalhos_tecnicos, trabalhos_tecnicos_modelos_modo_norm = _carregar_trabalhos_tecnicos_visualizacao(
+        session,
+        trabalhos_tecnicos_modelos_modo,
+    )
+    return {
+        "trabalhos_tecnicos": trabalhos_tecnicos,
+        "trabalhos_tecnicos_modelos_modo": trabalhos_tecnicos_modelos_modo_norm,
+    }
+
+
+def _payload_modelo_mapa(
+    session: SessionState,
+    trabalhos_tecnicos_modelos_modo: Any = None,
+    api_base_url: str | None = None,
+    popup_auth_token: str | None = None,
+) -> dict[str, Any]:
+    core = _obter_visualizacao_core(session)
+    info = core["info"]
     avaliandos_tecnicos, trabalhos_tecnicos, trabalhos_tecnicos_modelos_modo_norm = _carregar_trabalhos_tecnicos_visualizacao(
         session,
         trabalhos_tecnicos_modelos_modo,
     )
     popup_endpoint = f"{api_base_url.rstrip('/')}/api/visualizacao/map/popup" if api_base_url else "/api/visualizacao/map/popup"
     mapa_html = viz_app.criar_mapa(
-        dados,
+        core["dados"],
         col_y=info["nome_y"],
         session_id=session.session_id,
         popup_endpoint=popup_endpoint,
         popup_auth_token=popup_auth_token,
         avaliandos_tecnicos=avaliandos_tecnicos,
     )
+    return {
+        "mapa_html": mapa_html,
+        "mapa_choices": core["mapa_choices"],
+        "trabalhos_tecnicos": trabalhos_tecnicos,
+        "trabalhos_tecnicos_modelos_modo": trabalhos_tecnicos_modelos_modo_norm,
+    }
 
-    colunas_numericas = [
-        str(col)
-        for col in dados_publicos.select_dtypes(include=[np.number]).columns
-        if str(col).lower() not in ["lat", "lon", "latitude", "longitude", "index"]
-    ]
-    choices_mapa = ["Visualização Padrão"] + colunas_numericas
 
-    session.dados_visualizacao = dados
+def carregar_secao_modelo(
+    session: SessionState,
+    secao: str,
+    trabalhos_tecnicos_modelos_modo: Any = None,
+    api_base_url: str | None = None,
+    popup_auth_token: str | None = None,
+) -> dict[str, Any]:
+    secao_norm = str(secao or "").strip().lower().replace("-", "_")
+    if secao_norm == "mapa":
+        return _payload_modelo_mapa(
+            session,
+            trabalhos_tecnicos_modelos_modo=trabalhos_tecnicos_modelos_modo,
+            api_base_url=api_base_url,
+            popup_auth_token=popup_auth_token,
+        )
+    if secao_norm == "trabalhos_tecnicos":
+        return _payload_modelo_trabalhos_tecnicos(session, trabalhos_tecnicos_modelos_modo)
+    if secao_norm == "dados_mercado":
+        return _payload_modelo_dados_mercado(session)
+    if secao_norm == "metricas":
+        return _payload_modelo_metricas(session)
+    if secao_norm == "transformacoes":
+        return _payload_modelo_transformacoes(session)
+    if secao_norm == "resumo":
+        return _payload_modelo_resumo(session)
+    if secao_norm == "coeficientes":
+        return _payload_modelo_coeficientes(session)
+    if secao_norm == "obs_calc":
+        return _payload_modelo_obs_calc(session)
+    if secao_norm == "graficos":
+        return _payload_modelo_graficos(session)
+    raise HTTPException(status_code=400, detail="Secao de visualizacao invalida")
 
+
+def exibir_contexto_avaliacao(session: SessionState) -> dict[str, Any]:
+    pacote = session.pacote_visualizacao
+    if pacote is None:
+        raise HTTPException(status_code=400, detail="Carregue um modelo primeiro")
+
+    info = _extrair_modelo_info(pacote)
+    equacoes = _equacoes_do_modelo(pacote, info)
     return {
-        "dados": dataframe_to_payload(dados_publicos, decimals=2, max_rows=None),
-        "estatisticas": dataframe_to_payload(estat, decimals=2),
-        "escalas_html": escalas_html,
-        "dados_transformados": dataframe_to_payload(df_xy, decimals=2, max_rows=None),
-        "resumo_html": resumo_html,
-        "coeficientes": dataframe_to_payload(tab_coef, decimals=4),
-        "obs_calc": dataframe_to_payload(tab_obs_calc, decimals=2),
-        "grafico_obs_calc": figure_to_payload(figs.get("obs_calc")),
-        "grafico_residuos": figure_to_payload(figs.get("residuos")),
-        "grafico_histograma": figure_to_payload(figs.get("hist")),
-        "grafico_cook": figure_to_payload(figs.get("cook")),
-        "grafico_correlacao": figure_to_payload(figs.get("corr")),
-        "mapa_html": mapa_html,
-        "mapa_choices": choices_mapa,
         "campos_avaliacao": campos_avaliacao(session),
         "meta_modelo": sanitize_value(info),
         "equacoes": sanitize_value(equacoes),
-        "trabalhos_tecnicos": trabalhos_tecnicos,
-        "trabalhos_tecnicos_modelos_modo": trabalhos_tecnicos_modelos_modo_norm,
     }
 
 
+def exibir_modelo(
+    session: SessionState,
+    trabalhos_tecnicos_modelos_modo: Any = None,
+    api_base_url: str | None = None,
+    popup_auth_token: str | None = None,
+) -> dict[str, Any]:
+    core = _obter_visualizacao_core(session)
+    resposta = {
+        "campos_avaliacao": campos_avaliacao(session),
+        "meta_modelo": sanitize_value(core["info"]),
+    }
+    for secao in (
+        "dados_mercado",
+        "metricas",
+        "transformacoes",
+        "resumo",
+        "coeficientes",
+        "obs_calc",
+        "graficos",
+    ):
+        resposta.update(carregar_secao_modelo(session, secao))
+    resposta.update(
+        carregar_secao_modelo(
+            session,
+            "mapa",
+            trabalhos_tecnicos_modelos_modo=trabalhos_tecnicos_modelos_modo,
+            api_base_url=api_base_url,
+            popup_auth_token=popup_auth_token,
+        )
+    )
+    return resposta
+
+
 def atualizar_mapa(
     session: SessionState,
     variavel_mapa: str | None,

backend/run_backend.sh

@@ -4,4 +4,10 @@ set -euo pipefail
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 cd "${SCRIPT_DIR}"
 
+# Prefere o ambiente virtual local do backend quando ele existir.
+if [[ -f "${SCRIPT_DIR}/.venv/bin/activate" ]]; then
+  # shellcheck disable=SC1091
+  source "${SCRIPT_DIR}/.venv/bin/activate"
+fi
+
 uvicorn app.main:app --host 0.0.0.0 --port "${PORT:-8000}" --reload --reload-dir "${SCRIPT_DIR}"

frontend/src/App.jsx

@@ -1,5 +1,13 @@
 import React, { useEffect, useRef, useState } from 'react'
 import { api, getAuthToken, setAuthToken } from './api'
+import {
+  getAppTabKeyFromSlug,
+  getAppTabSlugFromKey,
+  hasMesaDeepLink,
+  normalizeMesaDeepLink,
+  parseMesaDeepLink,
+  replaceMesaDeepLink,
+} from './deepLinks'
 import AvaliacaoTab from './components/AvaliacaoTab'
 import ElaboracaoTab from './components/ElaboracaoTab'
 import InicioTab from './components/InicioTab'
@@ -21,9 +29,13 @@ export default function App() {
   const [sessionId, setSessionId] = useState('')
   const [bootError, setBootError] = useState('')
   const [avaliacaoQuickLoad, setAvaliacaoQuickLoad] = useState(null)
-  const [modeloRepositorioQuickOpen, setModeloRepositorioQuickOpen] = useState(null)
+  const [elaboracaoQuickLoad, setElaboracaoQuickLoad] = useState(null)
   const [trabalhoTecnicoQuickOpen, setTrabalhoTecnicoQuickOpen] = useState(null)
-  const [pesquisaMapaReturnRequest, setPesquisaMapaReturnRequest] = useState(null)
+  const [modelosRouteRequest, setModelosRouteRequest] = useState(null)
+  const [trabalhosRouteRequest, setTrabalhosRouteRequest] = useState(null)
+  const [pendingDeepLinkIntent, setPendingDeepLinkIntent] = useState(null)
+  const [modelosModoImersivo, setModelosModoImersivo] = useState(false)
+  const [trabalhosModoImersivo, setTrabalhosModoImersivo] = useState(false)
 
   const [authLoading, setAuthLoading] = useState(true)
   const [authUser, setAuthUser] = useState(null)
@@ -45,6 +57,11 @@ export default function App() {
   const [scrollHomeBtnLeft, setScrollHomeBtnLeft] = useState(8)
   const headerRef = useRef(null)
   const settingsMenuRef = useRef(null)
+  const lastModelosRouteRef = useRef(null)
+  const lastPesquisaRouteRef = useRef(null)
+  const lastTrabalhosRouteRef = useRef(null)
+  const lastAvaliacaoRouteRef = useRef(null)
+  const lastElaboracaoRouteRef = useRef(null)
 
   const isAdmin = String(authUser?.perfil || '').toLowerCase() === 'admin'
   const logsEnabled = Boolean(logsStatus?.enabled)
@@ -56,6 +73,44 @@ export default function App() {
   const logsVisibleEvents = logsEvents.slice(logsStartIndex, logsStartIndex + LOGS_PAGE_SIZE)
   const logsEndIndex = logsEvents.length ? Math.min(logsStartIndex + LOGS_PAGE_SIZE, logsEvents.length) : 0
 
+  function buildRequestKey(prefix = 'mesa') {
+    return `${prefix}-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`
+  }
+
+  function rememberRouteIntent(intent) {
+    const normalized = normalizeMesaDeepLink(intent)
+    if (!normalized.tab) return normalized
+    if (normalized.tab === 'modelos') {
+      lastModelosRouteRef.current = normalized
+      if (normalized.subtab === 'pesquisa') {
+        lastPesquisaRouteRef.current = normalized
+      }
+    }
+    if (normalized.tab === 'trabalhos') lastTrabalhosRouteRef.current = normalized
+    if (normalized.tab === 'avaliacao') lastAvaliacaoRouteRef.current = normalized
+    if (normalized.tab === 'elaboracao') lastElaboracaoRouteRef.current = normalized
+    return normalized
+  }
+
+  function syncRouteIntent(intent) {
+    const normalized = rememberRouteIntent(intent)
+    replaceMesaDeepLink(normalized)
+    return normalized
+  }
+
+  function getCurrentMesaRouteIntent(fallbackIntent = null) {
+    if (typeof window !== 'undefined') {
+      const parsed = parseMesaDeepLink(window.location.search)
+      if (hasMesaDeepLink(parsed)) {
+        return normalizeMesaDeepLink(parsed)
+      }
+    }
+    if (fallbackIntent) {
+      return normalizeMesaDeepLink(fallbackIntent)
+    }
+    return null
+  }
+
   function resetToLogin(message = '') {
     setAuthToken('')
     setAuthUser(null)
@@ -63,9 +118,13 @@ export default function App() {
     setLoginLoading(false)
     setSessionId('')
     setBootError('')
-    setModeloRepositorioQuickOpen(null)
+    setElaboracaoQuickLoad(null)
     setTrabalhoTecnicoQuickOpen(null)
-    setPesquisaMapaReturnRequest(null)
+    setModelosRouteRequest(null)
+    setTrabalhosRouteRequest(null)
+    setPendingDeepLinkIntent(null)
+    setModelosModoImersivo(false)
+    setTrabalhosModoImersivo(false)
     setLogsStatus(null)
     setLogsOpen(false)
     setLogsEvents([])
@@ -76,6 +135,19 @@ export default function App() {
     setAuthError(message)
   }
 
+  useEffect(() => {
+    if (typeof window === 'undefined') return undefined
+
+    function syncPendingDeepLink() {
+      const nextIntent = parseMesaDeepLink(window.location.search)
+      setPendingDeepLinkIntent(hasMesaDeepLink(nextIntent) ? nextIntent : null)
+    }
+
+    syncPendingDeepLink()
+    window.addEventListener('popstate', syncPendingDeepLink)
+    return () => window.removeEventListener('popstate', syncPendingDeepLink)
+  }, [])
+
   useEffect(() => {
     let mounted = true
 
@@ -128,7 +200,7 @@ export default function App() {
       if (!trabalhoId) return
 
       setTrabalhoTecnicoQuickOpen({
-        requestKey: `${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+        requestKey: buildRequestKey('trabalho-open'),
         trabalhoId,
         origem: String(data?.origem || '').trim() || 'pesquisa_mapa',
       })
@@ -136,6 +208,10 @@ export default function App() {
       setLogsOpen(false)
       setShowStartupIntro(false)
       setSettingsOpen(false)
+      syncRouteIntent({
+        tab: 'trabalhos',
+        trabalhoId,
+      })
     }
 
     if (typeof window !== 'undefined') {
@@ -174,6 +250,70 @@ export default function App() {
     }
   }, [authUser])
 
+  useEffect(() => {
+    if (!pendingDeepLinkIntent || !authUser) return
+    const normalized = normalizeMesaDeepLink(pendingDeepLinkIntent)
+    const requiresSession = Boolean(
+      normalized.modeloId
+      || normalized.trabalhoId
+      || normalized.tab === 'avaliacao'
+      || normalized.tab === 'elaboracao',
+    )
+    if (requiresSession && !sessionId) return
+
+    const nextTab = getAppTabKeyFromSlug(normalized.tab)
+    const requestKey = buildRequestKey('deep-link')
+    if (nextTab) {
+      setActiveTab(nextTab)
+      setShowStartupIntro(false)
+      setLogsOpen(false)
+      setSettingsOpen(false)
+    }
+
+    if (normalized.tab === 'modelos') {
+      setModelosRouteRequest({
+        requestKey,
+        subtab: normalized.subtab,
+        filters: normalized.filters,
+        avaliando: normalized.avaliando,
+        modeloId: normalized.modeloId,
+        modelTab: normalized.modelTab,
+      })
+      rememberRouteIntent(normalized)
+    }
+
+    if (normalized.tab === 'avaliacao' && normalized.modeloId) {
+      setAvaliacaoQuickLoad({
+        requestKey,
+        modeloId: normalized.modeloId,
+        modeloArquivo: '',
+        nomeModelo: normalized.modeloId,
+      })
+      rememberRouteIntent(normalized)
+    }
+
+    if (normalized.tab === 'elaboracao' && normalized.modeloId) {
+      setElaboracaoQuickLoad({
+        requestKey,
+        modeloId: normalized.modeloId,
+        nomeModelo: normalized.modeloId,
+      })
+      rememberRouteIntent(normalized)
+    }
+
+    if (normalized.tab === 'trabalhos') {
+      setTrabalhosRouteRequest({
+        requestKey,
+        subtab: normalized.subtab,
+        trabalhoId: normalized.trabalhoId,
+      })
+      rememberRouteIntent(normalized)
+    }
+
+    replaceMesaDeepLink(normalized)
+    setPendingDeepLinkIntent(null)
+  }, [authUser, pendingDeepLinkIntent, sessionId])
+
   useEffect(() => {
     if (!authUser || !isAdmin) {
       setLogsStatus(null)
@@ -346,7 +486,7 @@ export default function App() {
     const modeloId = String(modelo?.id || '').trim()
     if (!modeloId) return
     setAvaliacaoQuickLoad({
-      requestKey: `${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+      requestKey: buildRequestKey('avaliacao-open'),
       modeloId,
       modeloArquivo: String(modelo?.arquivo || '').trim(),
       nomeModelo: String(modelo?.nome_modelo || modelo?.arquivo || modeloId),
@@ -354,30 +494,111 @@ export default function App() {
     setActiveTab('Avaliação')
     setLogsOpen(false)
     setShowStartupIntro(false)
+    syncRouteIntent({ tab: 'avaliacao', modeloId })
+  }
+
+  function onEditarModeloEmElaboracao(modelo) {
+    const modeloId = String(modelo?.id || '').trim()
+    if (!modeloId) return
+    setElaboracaoQuickLoad({
+      requestKey: buildRequestKey('elaboracao-open'),
+      modeloId,
+      modeloArquivo: String(modelo?.arquivo || '').trim(),
+      nomeModelo: String(modelo?.nome_modelo || modelo?.arquivo || modeloId),
+    })
+    setActiveTab('Elaboração/Edição')
+    setLogsOpen(false)
+    setShowStartupIntro(false)
+    syncRouteIntent({ tab: 'elaboracao', modeloId })
   }
 
   function onAbrirModeloNoRepositorio(modelo) {
     const modeloId = String(modelo?.modeloId || modelo?.id || '').trim()
     if (!modeloId) return
-    setModeloRepositorioQuickOpen({
-      requestKey: `${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+    const nomeModelo = String(modelo?.nomeModelo || modelo?.nome_modelo || modeloId).trim()
+    const modeloArquivo = String(modelo?.modeloArquivo || modelo?.arquivo || '').trim()
+    const explicitReturnIntent = modelo?.returnIntent && typeof modelo.returnIntent === 'object'
+      ? modelo.returnIntent
+      : null
+    const returnIntent = explicitReturnIntent || getCurrentMesaRouteIntent(lastModelosRouteRef.current || { tab: 'modelos', subtab: 'repositorio' })
+    setModelosRouteRequest({
+      requestKey: buildRequestKey('repo-open'),
+      subtab: 'repositorio',
       modeloId,
-      modeloArquivo: String(modelo?.modeloArquivo || modelo?.arquivo || '').trim(),
-      nomeModelo: String(modelo?.nomeModelo || modelo?.nome_modelo || modeloId).trim(),
+      modelTab: 'mapa',
+      nomeModelo,
+      modeloArquivo,
+      returnIntent,
     })
     setActiveTab('Modelos Estatísticos')
     setLogsOpen(false)
     setShowStartupIntro(false)
+    syncRouteIntent({
+      tab: 'modelos',
+      subtab: 'repositorio',
+      modeloId,
+      modelTab: 'mapa',
+    })
   }
 
   function onVoltarAoMapaPesquisa() {
-    setPesquisaMapaReturnRequest({
-      requestKey: `${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+    const nextIntent = lastPesquisaRouteRef.current || { tab: 'modelos', subtab: 'pesquisa' }
+    setModelosRouteRequest({
+      requestKey: buildRequestKey('pesquisa-return'),
+      subtab: nextIntent.subtab || 'pesquisa',
+      filters: nextIntent.filters || {},
+      avaliando: nextIntent.avaliando || null,
+      scrollToMapa: true,
     })
     setActiveTab('Modelos Estatísticos')
     setLogsOpen(false)
     setShowStartupIntro(false)
     setSettingsOpen(false)
+    syncRouteIntent(nextIntent)
+  }
+
+  function onModelosRouteChange(intent) {
+    const normalized = normalizeMesaDeepLink(intent)
+    if (intent?.forceRouteRequest) {
+      const nextTab = getAppTabKeyFromSlug(normalized.tab)
+      if (nextTab) {
+        setActiveTab(nextTab)
+        setShowStartupIntro(false)
+        setLogsOpen(false)
+        setSettingsOpen(false)
+      }
+      if (normalized.tab === 'modelos' && !normalized.modeloId) {
+        setModelosRouteRequest({
+          requestKey: buildRequestKey('modelos-route'),
+          subtab: normalized.subtab || 'pesquisa',
+          filters: normalized.filters,
+          avaliando: normalized.avaliando,
+          avaliandos: Array.isArray(intent?.avaliandos) ? intent.avaliandos : null,
+          pesquisaExecutada: Boolean(intent?.pesquisaExecutada),
+          scrollToMapa: Boolean(intent?.scrollToMapa),
+        })
+      }
+      if (normalized.tab === 'trabalhos') {
+        setTrabalhosRouteRequest({
+          requestKey: buildRequestKey('trabalhos-route'),
+          subtab: normalized.subtab,
+          trabalhoId: normalized.trabalhoId,
+        })
+      }
+    }
+    syncRouteIntent(normalized)
+  }
+
+  function onAvaliacaoRouteChange(intent) {
+    syncRouteIntent(intent)
+  }
+
+  function onElaboracaoRouteChange(intent) {
+    syncRouteIntent(intent)
+  }
+
+  function onTrabalhosRouteChange(intent) {
+    syncRouteIntent(intent)
   }
 
   function onScrollToHeader() {
@@ -390,81 +611,99 @@ export default function App() {
 
   return (
     <div className="app-shell">
-      <header ref={headerRef} className={authUser ? 'app-header app-header-logged' : 'app-header app-header-logo-only'}>
-        <div className="brand-mark" aria-hidden="true">
-          <img src={`${import.meta.env.BASE_URL}logo_mesa.png`} alt="MESA" />
-        </div>
-        {authUser ? (
-          <div className="app-top-actions">
-            <nav className="tabs" aria-label="Navegação principal">
-              {TABS.map((tab) => {
-                const active = tab.key === activeTab
-                return (
-                  <button
-                    key={tab.key}
-                    className={active ? 'tab-pill active' : 'tab-pill'}
-                    onClick={() => {
-                      setActiveTab(tab.key)
-                      setShowStartupIntro(false)
-                      setLogsOpen(false)
-                      setSettingsOpen(false)
-                    }}
-                    type="button"
-                  >
-                    <strong>{tab.label}</strong>
-                  </button>
-                )
-              })}
-            </nav>
-
-            <div ref={settingsMenuRef} className={`settings-menu${settingsOpen ? ' is-open' : ''}`}>
-              <button
-                type="button"
-                className="settings-gear-btn"
-                aria-haspopup="menu"
-                aria-expanded={settingsOpen}
-                aria-label="Abrir configurações"
-                onClick={() => setSettingsOpen((prev) => !prev)}
-                title="Configurações"
-              >
-                &#9881;
-              </button>
-              {settingsOpen ? (
-                <div className="settings-menu-panel" role="menu" aria-label="Configurações do usuário">
-                  <div className="settings-user-summary">
-                    Usuário: <strong>{authUser.nome || authUser.usuario}</strong> ({authUser.perfil || 'viewer'})
-                  </div>
-                  <div className="settings-menu-actions">
-                    {isAdmin ? (
-                      <button
-                        type="button"
-                        className="settings-menu-btn"
-                        onClick={() => {
-                          void onToggleLogs()
-                          setSettingsOpen(false)
-                        }}
-                        disabled={logsStatusLoading || (!logsEnabled && !logsOpen)}
-                        title={logsOpen ? 'Fechar visualização de logs' : !logsEnabled ? logsDisabledReason : 'Abrir leitura de logs'}
-                      >
-                        {logsOpen ? 'Fechar logs' : 'Abrir logs'}
-                      </button>
-                    ) : null}
+      {!(modelosModoImersivo || trabalhosModoImersivo) ? (
+        <header ref={headerRef} className={authUser ? 'app-header app-header-logged' : 'app-header app-header-logo-only'}>
+          <div className="brand-mark" aria-hidden="true">
+            <img src={`${import.meta.env.BASE_URL}logo_mesa.png`} alt="MESA" />
+          </div>
+          {authUser ? (
+            <div className="app-top-actions">
+              <nav className="tabs" aria-label="Navegação principal">
+                {TABS.map((tab) => {
+                  const active = tab.key === activeTab
+                  return (
                     <button
+                      key={tab.key}
+                      className={active ? 'tab-pill active' : 'tab-pill'}
+                      onClick={() => {
+                        setActiveTab(tab.key)
+                        setShowStartupIntro(false)
+                        setLogsOpen(false)
+                        setSettingsOpen(false)
+                        const slug = getAppTabSlugFromKey(tab.key)
+                        if (slug === 'modelos') {
+                          syncRouteIntent(lastModelosRouteRef.current || { tab: 'modelos' })
+                          return
+                        }
+                        if (slug === 'trabalhos') {
+                          syncRouteIntent(lastTrabalhosRouteRef.current || { tab: 'trabalhos' })
+                          return
+                        }
+                        if (slug === 'avaliacao') {
+                          syncRouteIntent(lastAvaliacaoRouteRef.current || { tab: 'avaliacao' })
+                          return
+                        }
+                        if (slug === 'elaboracao') {
+                          syncRouteIntent(lastElaboracaoRouteRef.current || { tab: 'elaboracao' })
+                        }
+                      }}
                       type="button"
-                      className="settings-menu-btn settings-menu-btn-danger"
-                      onClick={() => void onLogout()}
                     >
-                      Sair
+                      <strong>{tab.label}</strong>
                     </button>
+                  )
+                })}
+              </nav>
+
+              <div ref={settingsMenuRef} className={`settings-menu${settingsOpen ? ' is-open' : ''}`}>
+                <button
+                  type="button"
+                  className="settings-gear-btn"
+                  aria-haspopup="menu"
+                  aria-expanded={settingsOpen}
+                  aria-label="Abrir configurações"
+                  onClick={() => setSettingsOpen((prev) => !prev)}
+                  title="Configurações"
+                >
+                  &#9881;
+                </button>
+                {settingsOpen ? (
+                  <div className="settings-menu-panel" role="menu" aria-label="Configurações do usuário">
+                    <div className="settings-user-summary">
+                      Usuário: <strong>{authUser.nome || authUser.usuario}</strong> ({authUser.perfil || 'viewer'})
+                    </div>
+                    <div className="settings-menu-actions">
+                      {isAdmin ? (
+                        <button
+                          type="button"
+                          className="settings-menu-btn"
+                          onClick={() => {
+                            void onToggleLogs()
+                            setSettingsOpen(false)
+                          }}
+                          disabled={logsStatusLoading || (!logsEnabled && !logsOpen)}
+                          title={logsOpen ? 'Fechar visualização de logs' : !logsEnabled ? logsDisabledReason : 'Abrir leitura de logs'}
+                        >
+                          {logsOpen ? 'Fechar logs' : 'Abrir logs'}
+                        </button>
+                      ) : null}
+                      <button
+                        type="button"
+                        className="settings-menu-btn settings-menu-btn-danger"
+                        onClick={() => void onLogout()}
+                      >
+                        Sair
+                      </button>
+                    </div>
                   </div>
-                </div>
-              ) : null}
+                ) : null}
+              </div>
             </div>
-          </div>
-        ) : null}
-      </header>
+          ) : null}
+        </header>
+      ) : null}
 
-      {authUser && showScrollHomeBtn ? (
+      {authUser && showScrollHomeBtn && !(modelosModoImersivo || trabalhosModoImersivo) ? (
         <button
           type="button"
           className="scroll-home-btn"
@@ -645,13 +884,21 @@ export default function App() {
               sessionId={sessionId}
               authUser={authUser}
               onUsarModeloEmAvaliacao={onUsarModeloEmAvaliacao}
-              openRepositorioModeloRequest={modeloRepositorioQuickOpen}
-              returnToPesquisaMapaRequest={pesquisaMapaReturnRequest}
+              onEditarModeloEmElaboracao={onEditarModeloEmElaboracao}
+              onAbrirModeloNoRepositorio={onAbrirModeloNoRepositorio}
+              routeRequest={modelosRouteRequest}
+              onRouteChange={onModelosRouteChange}
+              onModoImersivoChange={setModelosModoImersivo}
             />
           </div>
 
           <div className="tab-pane" hidden={activeTab !== 'Elaboração/Ediç��o'}>
-            <ElaboracaoTab sessionId={sessionId} authUser={authUser} />
+            <ElaboracaoTab
+              sessionId={sessionId}
+              authUser={authUser}
+              quickLoadRequest={elaboracaoQuickLoad}
+              onRouteChange={onElaboracaoRouteChange}
+            />
           </div>
 
           <div className="tab-pane" hidden={activeTab !== 'Trabalhos Técnicos'}>
@@ -659,12 +906,19 @@ export default function App() {
               sessionId={sessionId}
               onAbrirModeloNoRepositorio={onAbrirModeloNoRepositorio}
               quickOpenRequest={trabalhoTecnicoQuickOpen}
+              routeRequest={trabalhosRouteRequest}
+              onRouteChange={onTrabalhosRouteChange}
               onVoltarAoMapaPesquisa={onVoltarAoMapaPesquisa}
+              onModoImersivoChange={setTrabalhosModoImersivo}
             />
           </div>
 
           <div className="tab-pane" hidden={activeTab !== 'Avaliação'}>
-            <AvaliacaoTab sessionId={sessionId} quickLoadRequest={avaliacaoQuickLoad} />
+            <AvaliacaoTab
+              sessionId={sessionId}
+              quickLoadRequest={avaliacaoQuickLoad}
+              onRouteChange={onAvaliacaoRouteChange}
+            />
           </div>
           </>
         )

frontend/src/api.js

@@ -174,6 +174,7 @@ export const api = {
 
   pesquisaAdminConfig: () => getJson('/api/pesquisa/admin-config'),
   pesquisaAdminConfigSalvar: (campos = {}) => postJson('/api/pesquisa/admin-config', { campos }),
+  pesquisarLogradourosEixos: (limite = 2000) => getJson(`/api/pesquisa/logradouros-eixos?limite=${encodeURIComponent(String(limite))}`),
 
   pesquisarModelos(filtros = {}) {
     const params = new URLSearchParams()
@@ -355,6 +356,11 @@ export const api = {
     session_id: sessionId,
     trabalhos_tecnicos_modelos_modo: trabalhosTecnicosModelosModo,
   }),
+  visualizacaoSection: (sessionId, secao, trabalhosTecnicosModelosModo = 'selecionados_e_outras_versoes') => postJson('/api/visualizacao/section', {
+    session_id: sessionId,
+    secao,
+    trabalhos_tecnicos_modelos_modo: trabalhosTecnicosModelosModo,
+  }),
   evaluationContextViz: (sessionId) => postJson('/api/visualizacao/evaluation/context', { session_id: sessionId }),
   updateVisualizacaoMap: (sessionId, variavelMapa, trabalhosTecnicosModelosModo = 'selecionados_e_outras_versoes') => postJson('/api/visualizacao/map/update', {
     session_id: sessionId,

frontend/src/components/AvaliacaoTab.jsx

@@ -1,8 +1,10 @@
 import React, { useEffect, useMemo, useRef, useState } from 'react'
 import { api, downloadBlob } from '../api'
 import { buildCsvBlob } from '../csv'
+import { buildAvaliacaoModeloLink } from '../deepLinks'
 import LoadingOverlay from './LoadingOverlay'
 import MapFrame from './MapFrame'
+import ShareLinkButton from './ShareLinkButton'
 import SinglePillAutocomplete from './SinglePillAutocomplete'
 import TruncatedCellContent from './TruncatedCellContent'
 
@@ -496,7 +498,7 @@ function obterCoordenadasResolvidas(localizacao) {
   return { lat, lon }
 }
 
-export default function AvaliacaoTab({ sessionId, quickLoadRequest = null }) {
+export default function AvaliacaoTab({ sessionId, quickLoadRequest = null, onRouteChange = null }) {
   const [loading, setLoading] = useState(false)
   const [error, setError] = useState('')
   const [status, setStatus] = useState('')
@@ -832,6 +834,9 @@ export default function AvaliacaoTab({ sessionId, quickLoadRequest = null }) {
       const nomeModelo = uploadResp?.nome_modelo || arquivoUpload.name || ''
       const contextoResp = await api.evaluationContextViz(sessionId)
       aplicarRespostaExibicao(contextoResp, nomeModelo)
+      if (typeof onRouteChange === 'function') {
+        onRouteChange({ tab: 'avaliacao' })
+      }
     })
   }
 
@@ -858,6 +863,12 @@ export default function AvaliacaoTab({ sessionId, quickLoadRequest = null }) {
       const contextoResp = await api.evaluationContextViz(sessionId)
       aplicarRespostaExibicao(contextoResp, nomeModelo)
       setUploadedFile(null)
+      if (typeof onRouteChange === 'function') {
+        onRouteChange({
+          tab: 'avaliacao',
+          modeloId: modeloIdUsado,
+        })
+      }
     })
   }
 
@@ -1189,6 +1200,9 @@ export default function AvaliacaoTab({ sessionId, quickLoadRequest = null }) {
     ? (avaliacoesCards.findIndex((item) => item.id === baseCard?.id) + 1)
     : 0
   const avaliandoLocalizacaoAtiva = Boolean(obterCoordenadasResolvidas(avaliandoLocalizacaoResolvida))
+  const avaliacaoShareHref = repoModeloSelecionado
+    ? buildAvaliacaoModeloLink(repoModeloSelecionado)
+    : ''
 
   return (
     <div className="tab-content">
@@ -1220,11 +1234,17 @@ export default function AvaliacaoTab({ sessionId, quickLoadRequest = null }) {
               <button
                 type="button"
                 className="model-source-back-btn"
-                onClick={() => setModeloLoadSource('')}
+                onClick={() => {
+                  setModeloLoadSource('')
+                  if (typeof onRouteChange === 'function') {
+                    onRouteChange({ tab: 'avaliacao' })
+                  }
+                }}
                 disabled={loading}
               >
                 Voltar
               </button>
+              {modeloLoadSource === 'repo' && repoModeloSelecionado ? <ShareLinkButton href={avaliacaoShareHref} /> : null}
             </div>
 
             {modeloLoadSource === 'repo' ? (

frontend/src/components/ElaboracaoTab.jsx

@@ -1,6 +1,7 @@
 import React, { useCallback, useEffect, useMemo, useRef, useState } from 'react'
 import { api, downloadBlob } from '../api'
 import { tableToCsvBlob } from '../csv'
+import { buildElaboracaoModeloLink } from '../deepLinks'
 import Plotly from 'plotly.js-dist-min'
 import DataTable from './DataTable'
 import EquationFormatsPanel from './EquationFormatsPanel'
@@ -8,6 +9,7 @@ import LoadingOverlay from './LoadingOverlay'
 import MapFrame from './MapFrame'
 import PlotFigure from './PlotFigure'
 import SectionBlock from './SectionBlock'
+import ShareLinkButton from './ShareLinkButton'
 import SinglePillAutocomplete from './SinglePillAutocomplete'
 import TruncatedCellContent from './TruncatedCellContent'
 
@@ -678,6 +680,16 @@ function buildScatterPanels(figure, options = {}) {
   })
 }
 
+function buildScatterPanelFigureMap(panels) {
+  const mapa = new Map()
+  ;(panels || []).forEach((item) => {
+    const label = String(item?.label || '').trim()
+    if (!label || !item?.figure) return
+    mapa.set(label, item.figure)
+  })
+  return mapa
+}
+
 function formatConselhoRegistro(elaborador) {
   if (!elaborador) return ''
   const conselho = String(elaborador.conselho || '').trim()
@@ -847,7 +859,7 @@ function DiagnosticPngCard({ title, pngPayload, alt }) {
   )
 }
 
-export default function ElaboracaoTab({ sessionId, authUser }) {
+export default function ElaboracaoTab({ sessionId, authUser, quickLoadRequest = null, onRouteChange = null }) {
   const [loading, setLoading] = useState(false)
   const [downloadingAssets, setDownloadingAssets] = useState(false)
   const [error, setError] = useState('')
@@ -942,10 +954,13 @@ export default function ElaboracaoTab({ sessionId, authUser }) {
   const [secao13InterativoEixoYResiduo, setSecao13InterativoEixoYResiduo] = useState('residuo_pad')
   const [secao13InterativoEixoYColuna, setSecao13InterativoEixoYColuna] = useState('')
   const [secao10InterativoFigura, setSecao10InterativoFigura] = useState(null)
+  const [secao10InterativoFiguraComIndices, setSecao10InterativoFiguraComIndices] = useState(null)
   const [secao10InterativoSelecionado, setSecao10InterativoSelecionado] = useState('none')
   const [secao13InterativoFigura, setSecao13InterativoFigura] = useState(null)
+  const [secao13InterativoFiguraComIndices, setSecao13InterativoFiguraComIndices] = useState(null)
   const [secao13InterativoSelecionado, setSecao13InterativoSelecionado] = useState('none')
   const [secao15InterativoFigura, setSecao15InterativoFigura] = useState(null)
+  const [secao15InterativoFiguraComIndices, setSecao15InterativoFiguraComIndices] = useState(null)
   const [secao15InterativoSelecionado, setSecao15InterativoSelecionado] = useState('none')
 
   const [filtros, setFiltros] = useState(defaultFiltros())
@@ -989,11 +1004,15 @@ export default function ElaboracaoTab({ sessionId, authUser }) {
   const deleteConfirmTimersRef = useRef({})
   const uploadInputRef = useRef(null)
   const elaboracaoRootRef = useRef(null)
+  const quickLoadHandledRef = useRef('')
   const [disabledHint, setDisabledHint] = useState(null)
   const [sectionsMountKey, setSectionsMountKey] = useState(0)
   const [renderedSectionSteps, setRenderedSectionSteps] = useState(() => ['1'])
   const [visibleSectionSteps, setVisibleSectionSteps] = useState(() => ['1'])
   const visibleSectionStepsRef = useRef(new Set(['1']))
+  const elaboracaoShareHref = repoModeloSelecionado
+    ? buildElaboracaoModeloLink(repoModeloSelecionado)
+    : ''
   const [sideNavDynamicStyle, setSideNavDynamicStyle] = useState({})
 
   const mapaChoices = useMemo(() => [MAPA_VARIAVEL_PADRAO, ...colunasNumericas], [colunasNumericas])
@@ -1334,6 +1353,18 @@ export default function ElaboracaoTab({ sessionId, authUser }) {
     }),
     [selection?.grafico_dispersao, colunaY],
   )
+  const graficosSecao9ComIndices = useMemo(
+    () => buildScatterPanels(selection?.grafico_dispersao_com_indices, {
+      singleLabel: 'Dispersão',
+      height: 360,
+      yLabel: colunaY || 'Y',
+    }),
+    [selection?.grafico_dispersao_com_indices, colunaY],
+  )
+  const graficosSecao9ComIndicesMap = useMemo(
+    () => buildScatterPanelFigureMap(graficosSecao9ComIndices),
+    [graficosSecao9ComIndices],
+  )
   const graficosSecao9Interativo = useMemo(
     () => buildScatterPanels(secao10InterativoFigura, {
       singleLabel: 'Dispersão',
@@ -1343,6 +1374,19 @@ export default function ElaboracaoTab({ sessionId, authUser }) {
     }),
     [secao10InterativoFigura, colunaY],
   )
+  const graficosSecao9InterativoComIndices = useMemo(
+    () => buildScatterPanels(secao10InterativoFiguraComIndices, {
+      singleLabel: 'Dispersão',
+      height: 360,
+      yLabel: colunaY || 'Y',
+      useScatterGlMarkers: true,
+    }),
+    [secao10InterativoFiguraComIndices, colunaY],
+  )
+  const graficosSecao9InterativoComIndicesMap = useMemo(
+    () => buildScatterPanelFigureMap(graficosSecao9InterativoComIndices),
+    [graficosSecao9InterativoComIndices],
+  )
   const secao10InterativoOpcoes = useMemo(() => {
     const labels = graficosSecao9Interativo.length > 0
       ? graficosSecao9Interativo.map((item) => String(item.label || '').trim()).filter(Boolean)
@@ -1383,6 +1427,18 @@ export default function ElaboracaoTab({ sessionId, authUser }) {
     }),
     [fit?.grafico_dispersao_modelo, yLabelSecao13],
   )
+  const graficosSecao12ComIndices = useMemo(
+    () => buildScatterPanels(fit?.grafico_dispersao_modelo_com_indices, {
+      singleLabel: 'Dispersão do modelo',
+      height: 360,
+      yLabel: yLabelSecao13,
+    }),
+    [fit?.grafico_dispersao_modelo_com_indices, yLabelSecao13],
+  )
+  const graficosSecao12ComIndicesMap = useMemo(
+    () => buildScatterPanelFigureMap(graficosSecao12ComIndices),
+    [graficosSecao12ComIndices],
+  )
   const secao13ModoPng = useMemo(
     () => String(fit?.grafico_dispersao_modelo_modo || '') === 'png',
     [fit?.grafico_dispersao_modelo_modo],
@@ -1409,6 +1465,19 @@ export default function ElaboracaoTab({ sessionId, authUser }) {
     }),
     [secao13InterativoFigura, yLabelSecao13Interativo],
   )
+  const graficosSecao12InterativoComIndices = useMemo(
+    () => buildScatterPanels(secao13InterativoFiguraComIndices, {
+      singleLabel: 'Dispersão do modelo',
+      height: 360,
+      yLabel: yLabelSecao13Interativo,
+      useScatterGlMarkers: true,
+    }),
+    [secao13InterativoFiguraComIndices, yLabelSecao13Interativo],
+  )
+  const graficosSecao12InterativoComIndicesMap = useMemo(
+    () => buildScatterPanelFigureMap(graficosSecao12InterativoComIndices),
+    [graficosSecao12InterativoComIndices],
+  )
   const secao13InterativoOpcoes = useMemo(() => {
     const labels = graficosSecao12Interativo.map((item) => String(item.label || '').trim()).filter(Boolean)
     return Array.from(new Set(labels))
@@ -1790,8 +1859,9 @@ export default function ElaboracaoTab({ sessionId, authUser }) {
     if (!fit || !secao15DiagnosticoPng) {
       if (secao15InterativoSelecionado !== 'none') setSecao15InterativoSelecionado('none')
       if (secao15InterativoFigura) setSecao15InterativoFigura(null)
+      if (secao15InterativoFiguraComIndices) setSecao15InterativoFiguraComIndices(null)
     }
-  }, [fit, secao15DiagnosticoPng, secao15InterativoSelecionado, secao15InterativoFigura])
+  }, [fit, secao15DiagnosticoPng, secao15InterativoSelecionado, secao15InterativoFigura, secao15InterativoFiguraComIndices])
 
   useEffect(() => {
     if (!sessionId || tipoFonteDados === 'dai') return undefined
@@ -2125,8 +2195,10 @@ export default function ElaboracaoTab({ sessionId, authUser }) {
       setSection6EditOpen(true)
       setFit(null)
       setSecao10InterativoFigura(null)
+      setSecao10InterativoFiguraComIndices(null)
       setSecao10InterativoSelecionado('none')
       setSecao13InterativoFigura(null)
+      setSecao13InterativoFiguraComIndices(null)
       setSecao13InterativoSelecionado('none')
       setFiltros(defaultFiltros())
       setOutliersTexto('')
@@ -2164,6 +2236,7 @@ export default function ElaboracaoTab({ sessionId, authUser }) {
   function applySelectionResponse(resp) {
     setSelection(resp)
     setSecao10InterativoFigura(null)
+    setSecao10InterativoFiguraComIndices(null)
     setSecao10InterativoSelecionado('none')
     setSection6EditOpen(false)
     setSection11LocksOpen(false)
@@ -2225,8 +2298,10 @@ export default function ElaboracaoTab({ sessionId, authUser }) {
   function applyFitResponse(resp, origemMeta = null) {
     setFit(resp)
     setSecao13InterativoFigura(null)
+    setSecao13InterativoFiguraComIndices(null)
     setSecao13InterativoSelecionado('none')
     setSecao15InterativoFigura(null)
+    setSecao15InterativoFiguraComIndices(null)
     setSecao15InterativoSelecionado('none')
     setDispersaoEixoX('transformado')
     setDispersaoEixoYTipo('y_transformado')
@@ -2335,8 +2410,10 @@ export default function ElaboracaoTab({ sessionId, authUser }) {
     setGrauF(0)
     setFit(null)
     setSecao10InterativoFigura(null)
+    setSecao10InterativoFiguraComIndices(null)
     setSecao10InterativoSelecionado('none')
     setSecao13InterativoFigura(null)
+    setSecao13InterativoFiguraComIndices(null)
     setSecao13InterativoSelecionado('none')
     setSelectionAppliedSnapshot(buildSelectionSnapshot())
     setColunasX([])
@@ -2413,8 +2490,16 @@ export default function ElaboracaoTab({ sessionId, authUser }) {
     })
   }
 
-  async function onCarregarModeloRepositorio() {
-    if (!sessionId || !repoModeloSelecionado) return
+  async function onCarregarModeloRepositorio(modeloIdOverride = '') {
+    const overrideNormalizado = (
+      modeloIdOverride
+      && typeof modeloIdOverride === 'object'
+      && typeof modeloIdOverride.preventDefault === 'function'
+    )
+      ? ''
+      : modeloIdOverride
+    const modeloId = String(overrideNormalizado || repoModeloSelecionado || '').trim()
+    if (!sessionId || !modeloId) return
     setModeloLoadSource('repo')
     setImportacaoErro('')
     setArquivoCarregadoInfo(null)
@@ -2432,14 +2517,32 @@ export default function ElaboracaoTab({ sessionId, authUser }) {
       setRequiresSheet(false)
       setSheetOptions([])
       setTipoFonteDados('dai')
-      const resp = await api.elaboracaoRepositorioCarregar(sessionId, repoModeloSelecionado)
+      const resp = await api.elaboracaoRepositorioCarregar(sessionId, modeloId)
       aplicarRespostaCarregamento(resp, 'dai', { source: 'repo' })
+      setRepoModeloSelecionado(modeloId)
       setUploadedFile(null)
+      if (typeof onRouteChange === 'function') {
+        onRouteChange({
+          tab: 'elaboracao',
+          modeloId,
+        })
+      }
     }, {
       onError: (err) => setImportacaoErro(err?.message || 'Falha ao carregar modelo do repositório.'),
     })
   }
 
+  useEffect(() => {
+    const requestKey = String(quickLoadRequest?.requestKey || '').trim()
+    const modeloId = String(quickLoadRequest?.modeloId || '').trim()
+    if (!sessionId || !requestKey || !modeloId) return
+    if (quickLoadHandledRef.current === requestKey) return
+    quickLoadHandledRef.current = requestKey
+    setModeloLoadSource('repo')
+    setRepoModeloSelecionado(modeloId)
+    void onCarregarModeloRepositorio(modeloId)
+  }, [quickLoadRequest, sessionId])
+
   function onUploadInputChange(event) {
     const input = event.target
     const file = input.files?.[0] ?? null
@@ -2594,8 +2697,10 @@ export default function ElaboracaoTab({ sessionId, authUser }) {
     setSelection(null)
     setFit(null)
     setSecao10InterativoFigura(null)
+    setSecao10InterativoFiguraComIndices(null)
     setSecao10InterativoSelecionado('none')
     setSecao13InterativoFigura(null)
+    setSecao13InterativoFiguraComIndices(null)
     setSecao13InterativoSelecionado('none')
     setTransformacaoY('(x)')
     setTransformacoesX({})
@@ -2761,6 +2866,7 @@ export default function ElaboracaoTab({ sessionId, authUser }) {
       setSection6EditOpen(false)
       setFit(null)
       setSecao13InterativoFigura(null)
+      setSecao13InterativoFiguraComIndices(null)
       setSecao13InterativoSelecionado('none')
       setOutlierFiltrosAplicadosSnapshot(buildFiltrosSnapshot(defaultFiltros()))
       setOutlierTextosAplicadosSnapshot(buildOutlierTextSnapshot('', ''))
@@ -2867,6 +2973,7 @@ export default function ElaboracaoTab({ sessionId, authUser }) {
       setFit((prev) => ({
         ...prev,
         grafico_dispersao_modelo: resp.grafico,
+        grafico_dispersao_modelo_com_indices: null,
         grafico_dispersao_modelo_modo: resp.modo || (resp.grafico ? 'interativo' : ''),
         grafico_dispersao_modelo_png: resp.grafico_png || null,
         grafico_dispersao_modelo_total_pontos: resp.total_pontos,
@@ -2901,6 +3008,7 @@ export default function ElaboracaoTab({ sessionId, authUser }) {
         figuraInterativa = respInterativo?.grafico || null
       }
       setSecao13InterativoFigura(figuraInterativa)
+      setSecao13InterativoFiguraComIndices(null)
       const yLabelInterativo = getDispersaoYLabel(eixoYTipo, eixoYResiduo, eixoYColuna, colunaYComRotulo)
       const paineis = buildScatterPanels(figuraInterativa, {
         singleLabel: 'Dispersão do modelo',
@@ -3053,6 +3161,7 @@ export default function ElaboracaoTab({ sessionId, authUser }) {
       setOutlierTextosAplicadosSnapshot(buildOutlierTextSnapshot('', ''))
       setFit(null)
       setSecao13InterativoFigura(null)
+      setSecao13InterativoFiguraComIndices(null)
       setSecao13InterativoSelecionado('none')
       setTransformacoesAplicadas(null)
       setOrigemTransformacoes(null)
@@ -3100,8 +3209,10 @@ export default function ElaboracaoTab({ sessionId, authUser }) {
       setSection6EditOpen(true)
       setFit(null)
       setSecao10InterativoFigura(null)
+      setSecao10InterativoFiguraComIndices(null)
       setSecao10InterativoSelecionado('none')
       setSecao13InterativoFigura(null)
+      setSecao13InterativoFiguraComIndices(null)
       setSecao13InterativoSelecionado('none')
       setTransformacoesAplicadas(null)
       setOrigemTransformacoes(null)
@@ -3639,6 +3750,84 @@ export default function ElaboracaoTab({ sessionId, authUser }) {
     }
   }
 
+  async function ensureSecao10GraficoComIndices() {
+    const figuraAtual = selection?.grafico_dispersao_com_indices || null
+    if (figuraAtual) {
+      if (secao10InterativoFigura && !secao10InterativoFiguraComIndices) {
+        setSecao10InterativoFiguraComIndices(figuraAtual)
+      }
+      return figuraAtual
+    }
+    if (!sessionId) return null
+    try {
+      const resp = await api.getDispersaoInterativo(sessionId, 'secao10')
+      const figura = resp?.grafico_com_indices || null
+      setSelection((prev) => (prev ? { ...prev, grafico_dispersao_com_indices: figura } : prev))
+      if (secao10InterativoFigura) {
+        setSecao10InterativoFiguraComIndices(figura)
+      }
+      return figura
+    } catch (err) {
+      setError(err?.message || 'Falha ao carregar índices da seção 10.')
+      return null
+    }
+  }
+
+  async function ensureSecao13GraficoComIndices() {
+    const figuraAtual = fit?.grafico_dispersao_modelo_com_indices || null
+    if (figuraAtual) {
+      if (secao13InterativoFigura && !secao13InterativoFiguraComIndices) {
+        setSecao13InterativoFiguraComIndices(figuraAtual)
+      }
+      return figuraAtual
+    }
+    if (!sessionId) return null
+    try {
+      const resp = await api.getDispersaoInterativo(sessionId, 'secao13')
+      const figura = resp?.grafico_com_indices || null
+      setFit((prev) => (prev ? { ...prev, grafico_dispersao_modelo_com_indices: figura } : prev))
+      if (secao13InterativoFigura) {
+        setSecao13InterativoFiguraComIndices(figura)
+      }
+      return figura
+    } catch (err) {
+      setError(err?.message || 'Falha ao carregar índices da seção 13.')
+      return null
+    }
+  }
+
+  async function ensureSecao15GraficoComIndices(grafico) {
+    const alvo = String(grafico || '').trim()
+    if (!alvo || !sessionId) return null
+    const fieldMap = {
+      obs_calc: 'grafico_obs_calc_com_indices',
+      residuos: 'grafico_residuos_com_indices',
+      histograma: 'grafico_histograma_com_indices',
+      cook: 'grafico_cook_com_indices',
+    }
+    const field = fieldMap[alvo]
+    if (!field) return null
+    const figuraAtual = fit?.[field] || null
+    if (figuraAtual) {
+      if (secao15InterativoSelecionado === alvo && !secao15InterativoFiguraComIndices) {
+        setSecao15InterativoFiguraComIndices(figuraAtual)
+      }
+      return figuraAtual
+    }
+    try {
+      const resp = await api.getDiagnosticoInterativo(sessionId, alvo)
+      const figura = resp?.payload_com_indices || null
+      setFit((prev) => (prev ? { ...prev, [field]: figura } : prev))
+      if (secao15InterativoSelecionado === alvo) {
+        setSecao15InterativoFiguraComIndices(figura)
+      }
+      return figura
+    } catch (err) {
+      setError(err?.message || 'Falha ao carregar índices da seção 15.')
+      return null
+    }
+  }
+
   async function onChangeSecao10InterativoSelecionado(value) {
     const nextValue = String(value || 'none').trim() || 'none'
     setSecao10InterativoSelecionado(nextValue)
@@ -3650,6 +3839,7 @@ export default function ElaboracaoTab({ sessionId, authUser }) {
     await withBusy(async () => {
       const resp = await api.getDispersaoInterativo(sessionId, 'secao10')
       setSecao10InterativoFigura(resp?.grafico || null)
+      setSecao10InterativoFiguraComIndices(null)
     })
   }
 
@@ -3668,6 +3858,7 @@ export default function ElaboracaoTab({ sessionId, authUser }) {
     setSecao15InterativoSelecionado(nextValue)
     if (nextValue === 'none') {
       setSecao15InterativoFigura(null)
+      setSecao15InterativoFiguraComIndices(null)
       return
     }
     if (!sessionId) return
@@ -3675,6 +3866,7 @@ export default function ElaboracaoTab({ sessionId, authUser }) {
     await withBusy(async () => {
       const resp = await api.getDiagnosticoInterativo(sessionId, nextValue)
       setSecao15InterativoFigura(resp?.payload || null)
+      setSecao15InterativoFiguraComIndices(null)
     })
   }
 
@@ -3786,21 +3978,25 @@ export default function ElaboracaoTab({ sessionId, authUser }) {
                     </button>
                   </div>
                 ) : (
-                  <div className="model-source-flow">
-                <div className="model-source-flow-head">
-                  <button
-                    type="button"
-                    className="model-source-back-btn"
-                    onClick={() => {
-                      setModeloLoadSource('')
-                      setRepoModeloDropdownOpen(false)
-                      setImportacaoErro('')
-                    }}
-                    disabled={loading}
-                  >
-                    Voltar
-                  </button>
-                </div>
+	                  <div className="model-source-flow">
+	                    <div className="model-source-flow-head">
+	                      <button
+	                        type="button"
+	                        className="model-source-back-btn"
+	                        onClick={() => {
+	                          setModeloLoadSource('')
+	                          setRepoModeloDropdownOpen(false)
+	                          setImportacaoErro('')
+	                          if (typeof onRouteChange === 'function') {
+	                            onRouteChange({ tab: 'elaboracao' })
+	                          }
+	                        }}
+	                        disabled={loading}
+	                      >
+	                        Voltar
+	                      </button>
+	                      {modeloLoadSource === 'repo' && repoModeloSelecionado ? <ShareLinkButton href={elaboracaoShareHref} /> : null}
+	                    </div>
 
             {modeloLoadSource === 'repo' ? (
               <div className="row upload-repo-row">
@@ -3816,15 +4012,15 @@ export default function ElaboracaoTab({ sessionId, authUser }) {
                     disabled={loading || repoModelosLoading || repoModeloOptions.length === 0}
                     onOpenChange={setRepoModeloDropdownOpen}
                   />
-                </label>
-                <div className="row compact upload-repo-actions">
-                  <button type="button" onClick={onCarregarModeloRepositorio} disabled={loading || repoModelosLoading || !repoModeloSelecionado}>
-                    Carregar do repositório
-                  </button>
-                  <button type="button" onClick={() => void carregarModelosRepositorio()} disabled={loading || repoModelosLoading}>
-                    Atualizar lista
-                  </button>
-                </div>
+	                </label>
+	                <div className="row compact upload-repo-actions">
+	                  <button type="button" onClick={onCarregarModeloRepositorio} disabled={loading || repoModelosLoading || !repoModeloSelecionado}>
+	                    Carregar do repositório
+	                  </button>
+	                  <button type="button" onClick={() => void carregarModelosRepositorio()} disabled={loading || repoModelosLoading}>
+	                    Atualizar lista
+	                  </button>
+	                </div>
                 {repoFonteModelos ? <div className="section1-empty-hint">{repoFonteModelos}</div> : null}
               </div>
             ) : null}
@@ -4755,8 +4951,11 @@ export default function ElaboracaoTab({ sessionId, authUser }) {
                       <PlotFigure
                         key={`s9-interativo-plot-${secao10InterativoAtual.id}`}
                         figure={secao10InterativoAtual.figure}
+                        indexedFigure={graficosSecao9InterativoComIndicesMap.get(String(secao10InterativoAtual.label || '').trim()) || null}
+                        onRequestIndexedFigure={ensureSecao10GraficoComIndices}
                         title={secao10InterativoAtual.title}
                         subtitle={secao10InterativoAtual.subtitle}
+                        showPointIndexToggle
                         forceHideLegend
                         className="plot-stretch"
                         lazy
@@ -4809,8 +5008,11 @@ export default function ElaboracaoTab({ sessionId, authUser }) {
                       <PlotFigure
                         key={`s9-plot-${item.id}`}
                         figure={item.figure}
+                        indexedFigure={graficosSecao9ComIndicesMap.get(String(item.label || '').trim()) || null}
+                        onRequestIndexedFigure={ensureSecao10GraficoComIndices}
                         title={item.title}
                         subtitle={item.subtitle}
+                        showPointIndexToggle
                         forceHideLegend
                         className="plot-stretch"
                         lazy
@@ -5286,8 +5488,11 @@ export default function ElaboracaoTab({ sessionId, authUser }) {
                       <PlotFigure
                         key={`s12-interativo-plot-${secao13InterativoAtual.id}`}
                         figure={secao13InterativoAtual.figure}
+                        indexedFigure={graficosSecao12InterativoComIndicesMap.get(String(secao13InterativoAtual.label || '').trim()) || null}
+                        onRequestIndexedFigure={ensureSecao13GraficoComIndices}
                         title={secao13InterativoAtual.title}
                         subtitle={secao13InterativoAtual.subtitle}
+                        showPointIndexToggle
                         forceHideLegend
                         className="plot-stretch"
                         lazy
@@ -5340,8 +5545,11 @@ export default function ElaboracaoTab({ sessionId, authUser }) {
                       <PlotFigure
                         key={`s12-plot-${item.id}`}
                         figure={item.figure}
+                        indexedFigure={graficosSecao12ComIndicesMap.get(String(item.label || '').trim()) || null}
+                        onRequestIndexedFigure={ensureSecao13GraficoComIndices}
                         title={item.title}
                         subtitle={item.subtitle}
+                        showPointIndexToggle
                         forceHideLegend
                         className="plot-stretch"
                         lazy
@@ -5510,14 +5718,14 @@ export default function ElaboracaoTab({ sessionId, authUser }) {
               </div>
             ) : (
               <div className="plot-grid-2-fixed">
-                <PlotFigure figure={fit.grafico_obs_calc} title="Obs x Calc" />
-                <PlotFigure figure={fit.grafico_residuos} title="Resíduos" />
-                <PlotFigure figure={fit.grafico_histograma} title="Histograma" />
-                <PlotFigure figure={fit.grafico_cook} title="Cook" forceHideLegend />
+                <PlotFigure figure={fit.grafico_obs_calc} indexedFigure={fit.grafico_obs_calc_com_indices || null} onRequestIndexedFigure={() => ensureSecao15GraficoComIndices('obs_calc')} title="Obs x Calc" showPointIndexToggle />
+                <PlotFigure figure={fit.grafico_residuos} indexedFigure={fit.grafico_residuos_com_indices || null} onRequestIndexedFigure={() => ensureSecao15GraficoComIndices('residuos')} title="Resíduos" showPointIndexToggle />
+                <PlotFigure figure={fit.grafico_histograma} indexedFigure={fit.grafico_histograma_com_indices || null} onRequestIndexedFigure={() => ensureSecao15GraficoComIndices('histograma')} title="Histograma" showPointIndexToggle />
+                <PlotFigure figure={fit.grafico_cook} indexedFigure={fit.grafico_cook_com_indices || null} onRequestIndexedFigure={() => ensureSecao15GraficoComIndices('cook')} title="Cook" showPointIndexToggle forceHideLegend />
               </div>
             )}
             <div className="plot-full-width">
-              <PlotFigure figure={fit.grafico_correlacao} title="Matriz de correlação" className="plot-correlation-card" />
+              <PlotFigure figure={fit.grafico_correlacao} title="Matriz de correlação" showPointIndexToggle className="plot-correlation-card" />
             </div>
             {secao15DiagnosticoPng ? (
               <>
@@ -5558,7 +5766,10 @@ export default function ElaboracaoTab({ sessionId, authUser }) {
                       <PlotFigure
                         key={`s15-interativo-${secao15InterativoSelecionado}`}
                         figure={secao15InterativoFigura}
+                        indexedFigure={secao15InterativoFiguraComIndices}
+                        onRequestIndexedFigure={() => ensureSecao15GraficoComIndices(secao15InterativoSelecionado)}
                         title={secao15InterativoLabel}
+                        showPointIndexToggle
                         forceHideLegend={secao15InterativoSelecionado === 'cook'}
                         className="plot-stretch"
                         lazy

frontend/src/components/ModelosEstatisticosTab.jsx

@@ -1,4 +1,5 @@
-import React, { useEffect, useState } from 'react'
+import React, { useEffect, useMemo, useRef, useState } from 'react'
+import { getModelosSubtabKeyFromSlug, getModelosSubtabSlugFromKey } from '../deepLinks'
 import PesquisaTab from './PesquisaTab'
 import RepositorioTab from './RepositorioTab'
 import VisaoGeralTab from './VisaoGeralTab'
@@ -13,51 +14,91 @@ export default function ModelosEstatisticosTab({
   sessionId,
   authUser,
   onUsarModeloEmAvaliacao,
-  openRepositorioModeloRequest = null,
-  returnToPesquisaMapaRequest = null,
+  onEditarModeloEmElaboracao = null,
+  onAbrirModeloNoRepositorio = null,
+  routeRequest = null,
+  onRouteChange = null,
+  onModoImersivoChange = null,
 }) {
   const [activeSubtab, setActiveSubtab] = useState('Pesquisar Modelos')
   const [pesquisaMapaScrollRequest, setPesquisaMapaScrollRequest] = useState(null)
+  const [repositorioModeloAberto, setRepositorioModeloAberto] = useState(false)
+  const handledRouteRequestRef = useRef('')
 
   useEffect(() => {
-    const modeloId = String(openRepositorioModeloRequest?.modeloId || '').trim()
-    if (!modeloId) return
-    setActiveSubtab('Repositório de Modelos')
-  }, [openRepositorioModeloRequest])
-
-  useEffect(() => {
-    const requestKey = String(returnToPesquisaMapaRequest?.requestKey || '').trim()
+    const requestKey = String(routeRequest?.requestKey || '').trim()
     if (!requestKey) return
-    setActiveSubtab('Pesquisar Modelos')
-  }, [returnToPesquisaMapaRequest])
+    if (handledRouteRequestRef.current === requestKey) return
+    handledRouteRequestRef.current = requestKey
+
+    const nextSubtab = getModelosSubtabKeyFromSlug(routeRequest?.subtab)
+    setActiveSubtab(routeRequest?.modeloId ? 'Repositório de Modelos' : nextSubtab)
+
+    if (routeRequest?.scrollToMapa) {
+      setPesquisaMapaScrollRequest({ requestKey })
+    }
+  }, [routeRequest])
+
+  const pesquisaRouteRequest = useMemo(() => {
+    const requestKey = String(routeRequest?.requestKey || '').trim()
+    if (!requestKey) return null
+    if (String(routeRequest?.subtab || '').trim() !== 'pesquisa') return null
+    return routeRequest
+  }, [routeRequest])
+
+  const repositorioOpenRequest = useMemo(() => {
+    const requestKey = String(routeRequest?.requestKey || '').trim()
+    const modeloId = String(routeRequest?.modeloId || '').trim()
+    if (!requestKey || !modeloId) return null
+    return {
+      requestKey,
+      modeloId,
+      modelTab: routeRequest?.modelTab || 'mapa',
+      nomeModelo: routeRequest?.nomeModelo || modeloId,
+      modeloArquivo: routeRequest?.modeloArquivo || '',
+      returnIntent: routeRequest?.returnIntent || null,
+    }
+  }, [routeRequest])
 
   useEffect(() => {
-    const requestKey = String(returnToPesquisaMapaRequest?.requestKey || '').trim()
-    if (!requestKey) return
-    if (activeSubtab !== 'Pesquisar Modelos') return
-    setPesquisaMapaScrollRequest(returnToPesquisaMapaRequest)
-  }, [activeSubtab, returnToPesquisaMapaRequest])
+    if (typeof onModoImersivoChange !== 'function') return undefined
+    onModoImersivoChange(repositorioModeloAberto)
+    return () => onModoImersivoChange(false)
+  }, [repositorioModeloAberto, onModoImersivoChange])
 
   return (
     <div className="tab-content">
-      <div className="inner-tabs" role="tablist" aria-label="Abas de modelos estatísticos">
-        {SUBTABS.map((tab) => (
-          <button
-            key={tab.key}
-            type="button"
-            className={activeSubtab === tab.key ? 'inner-tab-pill active' : 'inner-tab-pill'}
-            onClick={() => setActiveSubtab(tab.key)}
-          >
-            {tab.label}
-          </button>
-        ))}
-      </div>
+      {!repositorioModeloAberto ? (
+        <div className="inner-tabs" role="tablist" aria-label="Abas de modelos estatísticos">
+          {SUBTABS.map((tab) => (
+            <button
+              key={tab.key}
+              type="button"
+              className={activeSubtab === tab.key ? 'inner-tab-pill active' : 'inner-tab-pill'}
+              onClick={() => {
+                setActiveSubtab(tab.key)
+                if (typeof onRouteChange === 'function') {
+                  onRouteChange({
+                    tab: 'modelos',
+                    subtab: getModelosSubtabSlugFromKey(tab.key),
+                  })
+                }
+              }}
+            >
+              {tab.label}
+            </button>
+          ))}
+        </div>
+      ) : null}
 
       <div className="tab-pane" hidden={activeSubtab !== 'Pesquisar Modelos'}>
         <PesquisaTab
           sessionId={sessionId}
           onUsarModeloEmAvaliacao={onUsarModeloEmAvaliacao}
+          onAbrirModeloNoRepositorio={onAbrirModeloNoRepositorio}
+          routeRequest={pesquisaRouteRequest}
           scrollToMapaRequest={pesquisaMapaScrollRequest}
+          onRouteChange={onRouteChange}
         />
       </div>
 
@@ -65,7 +106,11 @@ export default function ModelosEstatisticosTab({
         <RepositorioTab
           authUser={authUser}
           sessionId={sessionId}
-          openModeloRequest={openRepositorioModeloRequest}
+          openModeloRequest={repositorioOpenRequest}
+          onUsarModeloEmAvaliacao={onUsarModeloEmAvaliacao}
+          onEditarModeloEmElaboracao={onEditarModeloEmElaboracao}
+          onRouteChange={onRouteChange}
+          onModeloAbertoChange={setRepositorioModeloAberto}
         />
       </div>
 

frontend/src/components/PesquisaTab.jsx

@@ -1,6 +1,7 @@
 import React, { useEffect, useMemo, useRef, useState } from 'react'
 import { createPortal } from 'react-dom'
 import { api, downloadBlob } from '../api'
+import { buildPesquisaLink, buildPesquisaRoutePayload, getPesquisaFilterDefaults, hasPesquisaRoutePayload } from '../deepLinks'
 import DataTable from './DataTable'
 import EquationFormatsPanel from './EquationFormatsPanel'
 import LoadingOverlay from './LoadingOverlay'
@@ -9,6 +10,7 @@ import ModeloTrabalhosTecnicosPanel from './ModeloTrabalhosTecnicosPanel'
 import PlotFigure from './PlotFigure'
 import PesquisaAdminConfigPanel from './PesquisaAdminConfigPanel'
 import SectionBlock from './SectionBlock'
+import ShareLinkButton from './ShareLinkButton'
 import SinglePillAutocomplete from './SinglePillAutocomplete'
 import { getFaixaDataRecencyInfo } from '../modelRecency'
 
@@ -944,13 +946,20 @@ function ChipAutocompleteInput({
 export default function PesquisaTab({
   sessionId,
   onUsarModeloEmAvaliacao = null,
+  onAbrirModeloNoRepositorio = null,
+  routeRequest = null,
   scrollToMapaRequest = null,
+  onRouteChange = null,
 }) {
-  const [loading, setLoading] = useState(false)
+  const [searchLoading, setSearchLoading] = useState(false)
+  const [contextLoading, setContextLoading] = useState(false)
   const [error, setError] = useState('')
   const [pesquisaInicializada, setPesquisaInicializada] = useState(false)
   const [sugestoesInicializadas, setSugestoesInicializadas] = useState(false)
   const [mostrarAdminConfig, setMostrarAdminConfig] = useState(false)
+  const [logradouroOptions, setLogradouroOptions] = useState([])
+  const [logradouroOptionsLoading, setLogradouroOptionsLoading] = useState(false)
+  const [logradouroOptionsLoaded, setLogradouroOptionsLoaded] = useState(false)
 
   const [filters, setFilters] = useState(EMPTY_FILTERS)
   const [result, setResult] = useState(RESULT_INITIAL)
@@ -1001,6 +1010,10 @@ export default function PesquisaTab({
   const sectionResultadosRef = useRef(null)
   const sectionMapaRef = useRef(null)
   const scrollMapaHandledRef = useRef('')
+  const routeRequestHandledRef = useRef('')
+  const resultRequestSeqRef = useRef(0)
+  const searchRequestSeqRef = useRef(0)
+  const contextRequestSeqRef = useRef(0)
 
   const sugestoes = result.sugestoes || {}
   const opcoesTipoModelo = useMemo(
@@ -1025,6 +1038,33 @@ export default function PesquisaTab({
   const algunsSelecionados = resultIds.some((id) => selectedIds.includes(id))
   const mapaHtmlAtual = mapaHtmls[mapaModoExibicao] || ''
   const mapaFoiGerado = Boolean(mapaHtmls.pontos || mapaHtmls.cobertura)
+  const pesquisaShareAvaliando = !localizacaoMultipla ? (avaliandosGeoPayload[0] || null) : null
+  const pesquisaShareHref = buildPesquisaLink(filters, pesquisaShareAvaliando)
+  const pesquisaShareDisabled = localizacaoMultipla
+  const isPesquisaBusy = searchLoading
+
+  function buildPesquisaReturnIntent() {
+    return {
+      ...buildPesquisaRoutePayload(filters, pesquisaShareAvaliando),
+      pesquisaExecutada: true,
+      avaliandos: avaliandosGeolocalizados.map((item, index) => ({
+        id: String(item?.id || `avaliando-${index + 1}`),
+        lat: Number(item?.lat),
+        lon: Number(item?.lon),
+        logradouro: String(item?.logradouro || ''),
+        numero_usado: String(item?.numero_usado || ''),
+        cdlog: item?.cdlog ?? null,
+        origem: String(item?.origem || 'coords'),
+      })).filter((item) => Number.isFinite(item.lat) && Number.isFinite(item.lon)),
+    }
+  }
+
+  function emitPesquisaRoute(nextFilters = filters, nextAvaliandos = avaliandosGeolocalizados) {
+    if (typeof onRouteChange !== 'function') return
+    const avaliandosPayload = buildAvaliandosGeoPayload(nextAvaliandos)
+    const avaliando = avaliandosPayload.length === 1 ? avaliandosPayload[0] : null
+    onRouteChange(buildPesquisaRoutePayload(nextFilters, avaliando))
+  }
 
   function scrollToElementTop(el, behavior = 'smooth', offsetPx = 0) {
     if (!el || typeof window === 'undefined') return
@@ -1033,13 +1073,8 @@ export default function PesquisaTab({
     window.scrollTo({ top: targetTop, behavior })
   }
 
-  function scrollParaAbasGeraisNoTopo() {
-    if (typeof document === 'undefined') return
-    const tabsEl = document.querySelector('.tabs')
-    if (tabsEl) {
-      scrollToElementTop(tabsEl, 'smooth', 0)
-      return
-    }
+  function scrollParaTopoDaPagina() {
+    if (typeof window === 'undefined') return
     window.scrollTo({ top: 0, behavior: 'smooth' })
   }
 
@@ -1126,11 +1161,16 @@ export default function PesquisaTab({
     }
   }
 
-  async function buscarModelos(nextFilters = filters, nextAvaliandos = avaliandosGeolocalizados) {
-    setLoading(true)
+  async function buscarModelos(nextFilters = filters, nextAvaliandos = avaliandosGeolocalizados, options = {}) {
+    const requestId = resultRequestSeqRef.current + 1
+    const searchRequestId = searchRequestSeqRef.current + 1
+    resultRequestSeqRef.current = requestId
+    searchRequestSeqRef.current = searchRequestId
+    setSearchLoading(true)
     setError('')
     try {
       const response = await api.pesquisarModelos(buildApiFilters(nextFilters, nextAvaliandos))
+      if (requestId !== resultRequestSeqRef.current) return
       const modelos = response.modelos || []
       const idsNovos = new Set(modelos.map((item) => item.id))
 
@@ -1146,18 +1186,29 @@ export default function PesquisaTab({
       resetMapaPesquisa()
       setPesquisaInicializada(true)
       setSugestoesInicializadas(true)
+      if (options.syncRoute !== false) {
+        emitPesquisaRoute(nextFilters, nextAvaliandos)
+      }
     } catch (err) {
+      if (requestId !== resultRequestSeqRef.current) return
       setError(err.message)
     } finally {
-      setLoading(false)
+      if (searchRequestId === searchRequestSeqRef.current) {
+        setSearchLoading(false)
+      }
     }
   }
 
-  async function carregarContextoInicial() {
-    setLoading(true)
+  async function carregarContextoInicial(options = {}) {
+    const requestId = resultRequestSeqRef.current + 1
+    const contextRequestId = contextRequestSeqRef.current + 1
+    resultRequestSeqRef.current = requestId
+    contextRequestSeqRef.current = contextRequestId
+    setContextLoading(true)
     setError('')
     try {
       const response = await api.pesquisarModelos({ somente_contexto: true })
+      if (requestId !== resultRequestSeqRef.current) return
 
       setResult({
         ...RESULT_INITIAL,
@@ -1169,17 +1220,102 @@ export default function PesquisaTab({
       resetMapaPesquisa()
       setPesquisaInicializada(false)
       setSugestoesInicializadas(true)
+      if (options.syncRoute) {
+        emitPesquisaRoute(options.filters || getPesquisaFilterDefaults(), options.avaliandos || avaliandosGeolocalizados)
+      }
     } catch (err) {
+      if (requestId !== resultRequestSeqRef.current) return
       setError(err.message)
       setSugestoesInicializadas(true)
     } finally {
-      setLoading(false)
+      if (contextRequestId === contextRequestSeqRef.current) {
+        setContextLoading(false)
+      }
+    }
+  }
+
+  async function carregarSugestoesLogradouro() {
+    if (logradouroOptionsLoading || logradouroOptionsLoaded) return
+    setLogradouroOptionsLoading(true)
+    try {
+      const response = await api.pesquisarLogradourosEixos()
+      const opcoes = Array.isArray(response?.logradouros_eixos)
+        ? response.logradouros_eixos.map((item) => String(item || '').trim()).filter(Boolean)
+        : []
+      setLogradouroOptions(opcoes)
+      setLogradouroOptionsLoaded(true)
+    } catch (_err) {
+      setLogradouroOptions([])
+    } finally {
+      setLogradouroOptionsLoading(false)
     }
   }
 
   useEffect(() => {
+    const requestKey = String(routeRequest?.requestKey || '').trim()
+    if (requestKey) return undefined
     void carregarContextoInicial()
-  }, [])
+    return undefined
+  }, [routeRequest])
+
+  useEffect(() => {
+    const requestKey = String(routeRequest?.requestKey || '').trim()
+    if (!requestKey) return
+    if (routeRequestHandledRef.current === requestKey) return
+    routeRequestHandledRef.current = requestKey
+
+    const nextFilters = {
+      ...getPesquisaFilterDefaults(),
+      ...(routeRequest?.filters || {}),
+    }
+    const rawAvaliandos = Array.isArray(routeRequest?.avaliandos) ? routeRequest.avaliandos : []
+    let nextEntries = rawAvaliandos
+      .map((item, index) => {
+        const lat = Number(item?.lat)
+        const lon = Number(item?.lon)
+        if (!Number.isFinite(lat) || !Number.isFinite(lon)) return null
+        return createLocalizacaoEntry({
+          lat,
+          lon,
+          origem: String(item?.origem || 'coords'),
+          logradouro: String(item?.logradouro || ''),
+          numero_usado: String(item?.numero_usado || ''),
+          cdlog: item?.cdlog ?? null,
+        }, String(item?.id || `avaliando-${localizacaoIdCounterRef.current + index}`))
+      })
+      .filter(Boolean)
+    const lat = Number(routeRequest?.avaliando?.lat)
+    const lon = Number(routeRequest?.avaliando?.lon)
+    const possuiAvaliando = Number.isFinite(lat) && Number.isFinite(lon)
+    if (!nextEntries.length && possuiAvaliando) {
+      nextEntries = [createLocalizacaoEntry({
+        lat,
+        lon,
+        origem: 'coords',
+        logradouro: '',
+        numero_usado: '',
+        cdlog: null,
+      }, `avaliando-${localizacaoIdCounterRef.current}`)]
+      localizacaoIdCounterRef.current += 1
+    } else if (nextEntries.length) {
+      localizacaoIdCounterRef.current += nextEntries.length
+    }
+
+    setFilters(nextFilters)
+    setAvaliandosGeolocalizados(nextEntries)
+    setLocalizacaoModo(possuiAvaliando ? 'coords' : 'endereco')
+    setLocalizacaoInputs(EMPTY_LOCATION_INPUTS)
+    setLocalizacaoError('')
+    setLocalizacaoStatus('')
+    resetMapaPesquisa()
+
+    if (routeRequest?.pesquisaExecutada || hasPesquisaRoutePayload(nextFilters, routeRequest?.avaliando) || nextEntries.length > 1) {
+      void buscarModelos(nextFilters, nextEntries, { syncRoute: false })
+      return
+    }
+
+    void carregarContextoInicial({ syncRoute: false, filters: nextFilters, avaliandos: nextEntries })
+  }, [routeRequest])
 
   useEffect(() => {
     if (!selectAllRef.current) return
@@ -1245,8 +1381,13 @@ export default function PesquisaTab({
   }
 
   async function onLimparFiltros() {
-    setFilters(EMPTY_FILTERS)
-    await carregarContextoInicial()
+    const nextFilters = getPesquisaFilterDefaults()
+    setFilters(nextFilters)
+    await carregarContextoInicial({
+      syncRoute: true,
+      filters: nextFilters,
+      avaliandos: avaliandosGeolocalizados,
+    })
   }
 
   function onToggleSelecionado(modelId) {
@@ -1302,6 +1443,14 @@ export default function PesquisaTab({
   }
 
   async function onAbrirModelo(modelo) {
+    if (typeof onAbrirModeloNoRepositorio === 'function') {
+      onAbrirModeloNoRepositorio({
+        ...modelo,
+        returnIntent: buildPesquisaReturnIntent(),
+      })
+      return
+    }
+
     if (!sessionId) {
       setError('Sessao indisponivel no momento. Aguarde e tente novamente.')
       return
@@ -1319,7 +1468,7 @@ export default function PesquisaTab({
         observacao: String(resp?.meta_modelo?.observacao_modelo || '').trim(),
       })
       window.requestAnimationFrame(() => {
-        scrollParaAbasGeraisNoTopo()
+        scrollParaTopoDaPagina()
       })
     } catch (err) {
       setModeloAbertoError(err.message || 'Falha ao abrir modelo.')
@@ -1623,7 +1772,7 @@ export default function PesquisaTab({
                       type="button"
                       className="pesquisa-localizacao-action pesquisa-localizacao-action-reset"
                       onClick={() => void onRemoverAvaliandoLocalizacao(item.id)}
-                      disabled={localizacaoLoading || loading}
+                      disabled={localizacaoLoading || isPesquisaBusy}
                     >
                       Excluir avaliando
                     </button>
@@ -1697,11 +1846,14 @@ export default function PesquisaTab({
                 <SinglePillAutocomplete
                   value={localizacaoInputs.logradouro}
                   onChange={(nextValue) => atualizarCampoLocalizacao('logradouro', nextValue)}
-                  options={sugestoes.logradouros_eixos || []}
+                  options={logradouroOptions}
                   placeholder="Digite ou selecione um logradouro dos eixos"
                   panelTitle="Logradouros dos eixos"
                   emptyMessage="Nenhum logradouro encontrado nos eixos."
-                  loading={loading && !sugestoesInicializadas}
+                  loading={logradouroOptionsLoading}
+                  onOpenChange={(open) => {
+                    if (open) void carregarSugestoesLogradouro()
+                  }}
                   inputName={toInputName('logradouroEixosPesquisa')}
                   inputAutoComplete="new-password"
                 />
@@ -1765,7 +1917,7 @@ export default function PesquisaTab({
               placeholder="Digite e pressione Enter"
               suggestions={sugestoes.nomes_modelo || []}
               panelTitle="Modelos sugeridos"
-              loading={loading && !sugestoesInicializadas}
+              loading={contextLoading && !sugestoesInicializadas}
             />
           </label>
           <label className="pesquisa-field">
@@ -1804,7 +1956,7 @@ export default function PesquisaTab({
               placeholder="Digite e pressione Enter"
               suggestions={sugestoes.finalidades || []}
               panelTitle="Finalidades sugeridas"
-              loading={loading && !sugestoesInicializadas}
+              loading={contextLoading && !sugestoesInicializadas}
             />
           </label>
         </div>
@@ -1831,7 +1983,7 @@ export default function PesquisaTab({
                 placeholder="Selecione uma ou mais zonas"
                 suggestions={sugestoes.zonas_avaliacao || []}
                 panelTitle="Zonas sugeridas"
-                loading={loading && !sugestoesInicializadas}
+                loading={contextLoading && !sugestoesInicializadas}
               />
             </label>
             <label className="pesquisa-field pesquisa-bairro-bottom-field">
@@ -1843,7 +1995,7 @@ export default function PesquisaTab({
                 placeholder="Digite e pressione Enter"
                 suggestions={sugestoes.bairros || []}
                 panelTitle="Bairros sugeridos"
-                loading={loading && !sugestoesInicializadas}
+                loading={contextLoading && !sugestoesInicializadas}
               />
             </label>
           </div>
@@ -1876,10 +2028,10 @@ export default function PesquisaTab({
         </div>
 
         <div className="row pesquisa-actions pesquisa-actions-primary">
-          <button type="button" onClick={() => void buscarModelos()} disabled={loading}>
-            {loading ? 'Pesquisando...' : 'Pesquisar'}
+          <button type="button" onClick={() => void buscarModelos()} disabled={isPesquisaBusy}>
+            {searchLoading ? 'Pesquisando...' : 'Pesquisar'}
           </button>
-          <button type="button" onClick={() => void onLimparFiltros()} disabled={loading}>
+          <button type="button" onClick={() => void onLimparFiltros()} disabled={isPesquisaBusy}>
             Limpar filtros
           </button>
         </div>
@@ -1912,12 +2064,20 @@ export default function PesquisaTab({
               </select>
             </label>
           ) : null}
-          {resultIds.length ? (
-            <label className="pesquisa-select-all">
-              <input ref={selectAllRef} type="checkbox" checked={todosSelecionados} onChange={onToggleSelecionarTodos} />
-              Selecionar todos os exibidos
-            </label>
-          ) : null}
+          <div className="pesquisa-results-toolbar-actions">
+            <ShareLinkButton
+              href={pesquisaShareHref}
+              label="Copiar link da pesquisa"
+              disabled={pesquisaShareDisabled}
+              title={pesquisaShareDisabled ? 'O compartilhamento da pesquisa suporta apenas um avaliando na versão atual.' : pesquisaShareHref}
+            />
+            {resultIds.length ? (
+              <label className="pesquisa-select-all">
+                <input ref={selectAllRef} type="checkbox" checked={todosSelecionados} onChange={onToggleSelecionarTodos} />
+                Selecionar todos os exibidos
+              </label>
+            ) : null}
+          </div>
         </div>
 
         {!modelosOrdenados.length ? (

frontend/src/components/PlotFigure.jsx

@@ -2,9 +2,21 @@ import React, { useEffect, useRef, useState } from 'react'
 import Plot from 'react-plotly.js'
 import Plotly from 'plotly.js-dist-min'
 
-function PlotFigure({ figure, title, subtitle = '', forceHideLegend = false, className = '', lazy = false }) {
+function PlotFigure({
+  figure,
+  indexedFigure = null,
+  onRequestIndexedFigure = null,
+  title,
+  subtitle = '',
+  forceHideLegend = false,
+  className = '',
+  lazy = false,
+  showPointIndexToggle = false,
+}) {
   const containerRef = useRef(null)
   const [shouldRenderPlot, setShouldRenderPlot] = useState(() => !lazy)
+  const [showPointIndices, setShowPointIndices] = useState(false)
+  const [loadingIndexedFigure, setLoadingIndexedFigure] = useState(false)
 
   useEffect(() => {
     if (!lazy) {
@@ -32,16 +44,21 @@ function PlotFigure({ figure, title, subtitle = '', forceHideLegend = false, cla
     return () => observer.disconnect()
   }, [lazy, shouldRenderPlot])
 
+  useEffect(() => {
+    setShowPointIndices(false)
+    setLoadingIndexedFigure(false)
+  }, [figure])
+
   if (!figure) {
     return <div className="empty-box">Grafico indisponivel.</div>
   }
 
-  const data = (figure.data || []).map((trace) => {
-    if (!forceHideLegend) return trace
-    return { ...trace, showlegend: false }
-  })
-
-  const baseLayout = figure.layout || {}
+  const hasIndexedFigure = Boolean(indexedFigure)
+  const canRequestIndexedFigure = typeof onRequestIndexedFigure === 'function'
+  const canToggleIndices = hasIndexedFigure || canRequestIndexedFigure
+  const activeFigure = showPointIndices && hasIndexedFigure ? indexedFigure : figure
+  const safeFigure = activeFigure || { data: [], layout: {} }
+  const baseLayout = safeFigure.layout || {}
   const { width: _ignoreWidth, ...layoutNoWidth } = baseLayout
   const safeAnnotations = Array.isArray(baseLayout.annotations)
     ? baseLayout.annotations.map((annotation) => {
@@ -49,35 +66,85 @@ function PlotFigure({ figure, title, subtitle = '', forceHideLegend = false, cla
         return { ...clean, showarrow: false }
       })
     : baseLayout.annotations
+
+  const data = (safeFigure.data || []).map((trace) => (
+    forceHideLegend ? { ...trace, showlegend: false } : { ...trace }
+  ))
   const layout = {
     ...layoutNoWidth,
     autosize: true,
-    annotations: safeAnnotations,
+    annotations: Array.isArray(safeAnnotations) ? safeAnnotations : [],
     margin: baseLayout.margin || { t: 40, r: 20, b: 50, l: 50 },
   }
   if (forceHideLegend) {
     layout.showlegend = false
   }
+
   const plotHeight = layout.height ? `${layout.height}px` : '100%'
   const cardClassName = `plot-card ${className}`.trim()
 
+  async function handleToggleChange(event) {
+    const checked = Boolean(event.target.checked)
+    if (!checked) {
+      setShowPointIndices(false)
+      return
+    }
+    if (hasIndexedFigure) {
+      setShowPointIndices(true)
+      return
+    }
+    if (!canRequestIndexedFigure || loadingIndexedFigure) return
+    setLoadingIndexedFigure(true)
+    try {
+      const loadedFigure = await onRequestIndexedFigure()
+      setShowPointIndices(Boolean(loadedFigure))
+    } catch {
+      setShowPointIndices(false)
+    } finally {
+      setLoadingIndexedFigure(false)
+    }
+  }
+
+  const toggleTitle = loadingIndexedFigure
+    ? 'Carregando índices dos pontos...'
+    : hasIndexedFigure
+      ? 'Exibir índices dos pontos'
+      : canRequestIndexedFigure
+        ? 'Carregar índices dos pontos sob demanda'
+        : 'Este gráfico não trouxe uma versão com índices.'
+
   return (
     <div ref={containerRef} className={cardClassName}>
       {title || subtitle ? (
         <div className="plot-card-head">
           {title ? <h4 className="plot-card-title">{title}</h4> : null}
           {subtitle ? <div className="plot-card-subtitle">{subtitle}</div> : null}
+          {showPointIndexToggle ? (
+            <label className={`plot-card-toggle${canToggleIndices ? '' : ' is-disabled'}`}>
+              <input
+                type="checkbox"
+                checked={showPointIndices}
+                disabled={!canToggleIndices || loadingIndexedFigure}
+                onChange={handleToggleChange}
+                title={toggleTitle}
+              />
+              {loadingIndexedFigure ? 'Carregando índices...' : 'Exibir índices dos pontos'}
+            </label>
+          ) : null}
         </div>
       ) : null}
       {shouldRenderPlot ? (
-        <Plot
-          data={data}
-          layout={layout}
-          config={{ responsive: true, displaylogo: false }}
-          style={{ width: '100%', height: plotHeight, minHeight: '320px' }}
-          useResizeHandler
-          plotly={Plotly}
-        />
+        <div className="plot-card-body">
+          <Plot
+            data={data}
+            layout={layout}
+            revision={showPointIndices && hasIndexedFigure ? 1 : 0}
+            config={{ responsive: true, displaylogo: false }}
+            style={{ width: '100%', height: plotHeight, minHeight: '320px' }}
+            useResizeHandler
+            plotly={Plotly}
+          />
+        </div>
       ) : (
         <div className="plot-lazy-placeholder">Carregando gráfico...</div>
       )}
@@ -85,4 +152,4 @@ function PlotFigure({ figure, title, subtitle = '', forceHideLegend = false, cla
   )
 }
 
-export default React.memo(PlotFigure)
+export default PlotFigure

frontend/src/components/RepositorioTab.jsx

@@ -1,5 +1,6 @@
 import React, { useEffect, useRef, useState } from 'react'
 import { api, downloadBlob } from '../api'
+import { buildRepositorioModeloLink, hasMesaDeepLink, normalizeMesaDeepLink, parseMesaDeepLink } from '../deepLinks'
 import DataTable from './DataTable'
 import EquationFormatsPanel from './EquationFormatsPanel'
 import ListPagination from './ListPagination'
@@ -7,6 +8,7 @@ import LoadingOverlay from './LoadingOverlay'
 import MapFrame from './MapFrame'
 import ModeloTrabalhosTecnicosPanel from './ModeloTrabalhosTecnicosPanel'
 import PlotFigure from './PlotFigure'
+import ShareLinkButton from './ShareLinkButton'
 import TruncatedCellContent from './TruncatedCellContent'
 import { getFaixaDataRecencyInfo } from '../modelRecency'
 
@@ -24,6 +26,54 @@ const REPO_INNER_TABS = [
   { key: 'graficos', label: 'Gráficos' },
 ]
 const MODELO_ABERTO_TRABALHOS_TECNICOS_PADRAO = 'selecionados_e_outras_versoes'
+const REPO_MODEL_TAB_KEY_BY_SLUG = {
+  mapa: 'mapa',
+  'trabalhos-tecnicos': 'trabalhos_tecnicos',
+  'dados-mercado': 'dados_mercado',
+  metricas: 'metricas',
+  transformacoes: 'transformacoes',
+  resumo: 'resumo',
+  coeficientes: 'coeficientes',
+  'obs-calc': 'obs_calc',
+  graficos: 'graficos',
+}
+const REPO_MODEL_TAB_SLUG_BY_KEY = Object.fromEntries(
+  Object.entries(REPO_MODEL_TAB_KEY_BY_SLUG).map(([slug, key]) => [key, slug]),
+)
+
+function getRepoModelTabKeyFromSlug(slug) {
+  return REPO_MODEL_TAB_KEY_BY_SLUG[String(slug || '').trim()] || 'mapa'
+}
+
+function getRepoModelTabSlugFromKey(key) {
+  return REPO_MODEL_TAB_SLUG_BY_KEY[String(key || '').trim()] || 'mapa'
+}
+
+function scrollParaTopoDaPagina() {
+  if (typeof window === 'undefined') return
+  window.requestAnimationFrame(() => {
+    window.requestAnimationFrame(() => {
+      window.scrollTo({ top: 0, behavior: 'smooth' })
+    })
+  })
+}
+
+function buildReturnIntent(value) {
+  const normalized = normalizeMesaDeepLink(value)
+  if (!value || typeof value !== 'object') return normalized
+  return {
+    ...normalized,
+    pesquisaExecutada: Boolean(value.pesquisaExecutada),
+    avaliandos: Array.isArray(value.avaliandos) ? value.avaliandos : null,
+    scrollToMapa: Boolean(value.scrollToMapa),
+  }
+}
+
+function resolveRepoModelTabKey(value) {
+  const text = String(value || '').trim()
+  if (REPO_MODEL_TAB_SLUG_BY_KEY[text]) return text
+  return getRepoModelTabKeyFromSlug(text)
+}
 
 function formatarFonte(fonte) {
   if (!fonte || typeof fonte !== 'object') return 'Fonte não informada'
@@ -37,7 +87,60 @@ function formatarFonte(fonte) {
   return 'Pasta local'
 }
 
-export default function RepositorioTab({ authUser, sessionId, openModeloRequest = null }) {
+function getReturnButtonLabel(intent) {
+  if (!intent || typeof intent !== 'object') {
+    return 'Voltar ao repositório'
+  }
+  const normalized = normalizeMesaDeepLink(intent)
+  if (normalized.tab === 'modelos' && normalized.subtab === 'pesquisa') {
+    return 'Voltar à pesquisa'
+  }
+  if (normalized.tab === 'trabalhos') {
+    return normalized.trabalhoId ? 'Voltar ao trabalho técnico' : 'Voltar aos trabalhos técnicos'
+  }
+  if (normalized.tab === 'avaliacao') {
+    return 'Voltar à avaliação'
+  }
+  if (normalized.tab === 'elaboracao') {
+    return 'Voltar à elaboração'
+  }
+  return 'Voltar ao repositório'
+}
+
+function getModeloAbertoLoadingLabel(tabKey) {
+  switch (resolveRepoModelTabKey(tabKey)) {
+    case 'mapa':
+      return 'Carregando mapa do modelo...'
+    case 'trabalhos_tecnicos':
+      return 'Carregando trabalhos técnicos do modelo...'
+    case 'dados_mercado':
+      return 'Carregando dados de mercado...'
+    case 'metricas':
+      return 'Carregando métricas do modelo...'
+    case 'transformacoes':
+      return 'Carregando transformações do modelo...'
+    case 'resumo':
+      return 'Carregando resumo do modelo...'
+    case 'coeficientes':
+      return 'Carregando coeficientes do modelo...'
+    case 'obs_calc':
+      return 'Carregando observados x calculados...'
+    case 'graficos':
+      return 'Carregando gráficos do modelo...'
+    default:
+      return 'Carregando modelo...'
+  }
+}
+
+export default function RepositorioTab({
+  authUser,
+  sessionId,
+  openModeloRequest = null,
+  onUsarModeloEmAvaliacao = null,
+  onEditarModeloEmElaboracao = null,
+  onRouteChange = null,
+  onModeloAbertoChange = null,
+}) {
   const [modelos, setModelos] = useState([])
   const [fonte, setFonte] = useState(null)
   const [loading, setLoading] = useState(false)
@@ -57,6 +160,7 @@ export default function RepositorioTab({ authUser, sessionId, openModeloRequest
   })
 
   const [modeloAbertoMeta, setModeloAbertoMeta] = useState(null)
+  const [modeloAbertoReturnIntent, setModeloAbertoReturnIntent] = useState(null)
   const [modeloAbertoLoading, setModeloAbertoLoading] = useState(false)
   const [modeloAbertoError, setModeloAbertoError] = useState('')
   const [modeloAbertoActiveTab, setModeloAbertoActiveTab] = useState('mapa')
@@ -78,7 +182,11 @@ export default function RepositorioTab({ authUser, sessionId, openModeloRequest
   const [modeloAbertoPlotHistograma, setModeloAbertoPlotHistograma] = useState(null)
   const [modeloAbertoPlotCook, setModeloAbertoPlotCook] = useState(null)
   const [modeloAbertoPlotCorr, setModeloAbertoPlotCorr] = useState(null)
+  const [modeloAbertoLoadedTabs, setModeloAbertoLoadedTabs] = useState({})
+  const [modeloAbertoLoadingTabs, setModeloAbertoLoadingTabs] = useState({})
   const lastOpenRequestKeyRef = useRef('')
+  const pendingTabRequestsRef = useRef({})
+  const modeloOpenVersionRef = useRef(0)
 
   const isAdmin = String(authUser?.perfil || '').toLowerCase() === 'admin'
   const totalModelos = modelos.length
@@ -92,6 +200,12 @@ export default function RepositorioTab({ authUser, sessionId, openModeloRequest
     void carregarModelos()
   }, [])
 
+  useEffect(() => {
+    if (typeof onModeloAbertoChange !== 'function') return undefined
+    onModeloAbertoChange(modoModeloAberto)
+    return () => onModeloAbertoChange(false)
+  }, [modoModeloAberto, onModeloAbertoChange])
+
   useEffect(() => {
     const totalPages = Math.max(1, Math.ceil(totalModelos / PAGE_SIZE))
     setListaPage((prev) => Math.min(Math.max(1, prev), totalPages))
@@ -103,20 +217,30 @@ export default function RepositorioTab({ authUser, sessionId, openModeloRequest
     if (!sessionId || !requestKey || !modeloId) return
     if (lastOpenRequestKeyRef.current === requestKey) return
     lastOpenRequestKeyRef.current = requestKey
-    setModeloAbertoMeta({
-      id: modeloId,
-      nome: openModeloRequest?.nomeModelo || modeloId,
-      observacao: '',
-    })
-    setModeloAbertoError('')
-    setModeloAbertoActiveTab('mapa')
+    const nextModelTab = resolveRepoModelTabKey(openModeloRequest?.modelTab)
+    const nextReturnIntent = buildReturnIntent(
+      openModeloRequest?.returnIntent || { tab: 'modelos', subtab: 'repositorio' },
+    )
     void onAbrirModelo({
       id: modeloId,
       nome_modelo: openModeloRequest?.nomeModelo || modeloId,
       arquivo: openModeloRequest?.modeloArquivo || '',
+    }, {
+      initialModelTab: nextModelTab,
+      returnIntent: nextReturnIntent,
     })
   }, [openModeloRequest, sessionId])
 
+  function resolveCurrentReturnIntent() {
+    if (typeof window !== 'undefined') {
+      const parsed = parseMesaDeepLink(window.location.search)
+      if (hasMesaDeepLink(parsed)) {
+        return normalizeMesaDeepLink(parsed)
+      }
+    }
+    return normalizeMesaDeepLink({ tab: 'modelos', subtab: 'repositorio' })
+  }
+
   async function carregarModelos() {
     setLoading(true)
     setError('')
@@ -213,55 +337,208 @@ export default function RepositorioTab({ authUser, sessionId, openModeloRequest
     await onExcluirModelo(modeloId)
   }
 
-  function preencherModeloAberto(resp) {
-    setModeloAbertoDados(resp?.dados || null)
-    setModeloAbertoEstatisticas(resp?.estatisticas || null)
-    setModeloAbertoEscalasHtml(resp?.escalas_html || '')
-    setModeloAbertoDadosTransformados(resp?.dados_transformados || null)
-    setModeloAbertoResumoHtml(resp?.resumo_html || '')
-    setModeloAbertoEquacoes(resp?.equacoes || null)
-    setModeloAbertoCoeficientes(resp?.coeficientes || null)
-    setModeloAbertoObsCalc(resp?.obs_calc || null)
-    setModeloAbertoMapaHtml(resp?.mapa_html || '')
-    setModeloAbertoMapaChoices(resp?.mapa_choices || ['Visualização Padrão'])
+  function limparConteudoModeloAberto() {
+    pendingTabRequestsRef.current = {}
+    setModeloAbertoDados(null)
+    setModeloAbertoEstatisticas(null)
+    setModeloAbertoEscalasHtml('')
+    setModeloAbertoDadosTransformados(null)
+    setModeloAbertoResumoHtml('')
+    setModeloAbertoEquacoes(null)
+    setModeloAbertoCoeficientes(null)
+    setModeloAbertoObsCalc(null)
+    setModeloAbertoMapaHtml('')
+    setModeloAbertoMapaChoices(['Visualização Padrão'])
     setModeloAbertoMapaVar('Visualização Padrão')
-    setModeloAbertoTrabalhosTecnicosModelosModo(resp?.trabalhos_tecnicos_modelos_modo || MODELO_ABERTO_TRABALHOS_TECNICOS_PADRAO)
-    setModeloAbertoTrabalhosTecnicos(Array.isArray(resp?.trabalhos_tecnicos) ? resp.trabalhos_tecnicos : [])
-    setModeloAbertoPlotObsCalc(resp?.grafico_obs_calc || null)
-    setModeloAbertoPlotResiduos(resp?.grafico_residuos || null)
-    setModeloAbertoPlotHistograma(resp?.grafico_histograma || null)
-    setModeloAbertoPlotCook(resp?.grafico_cook || null)
-    setModeloAbertoPlotCorr(resp?.grafico_correlacao || null)
+    setModeloAbertoTrabalhosTecnicosModelosModo(MODELO_ABERTO_TRABALHOS_TECNICOS_PADRAO)
+    setModeloAbertoTrabalhosTecnicos([])
+    setModeloAbertoPlotObsCalc(null)
+    setModeloAbertoPlotResiduos(null)
+    setModeloAbertoPlotHistograma(null)
+    setModeloAbertoPlotCook(null)
+    setModeloAbertoPlotCorr(null)
+    setModeloAbertoLoadedTabs({})
+    setModeloAbertoLoadingTabs({})
+  }
+
+  function aplicarSecaoModeloAberto(secao, resp) {
+    const secaoNormalizada = resolveRepoModelTabKey(secao)
+    if (secaoNormalizada === 'dados_mercado') {
+      setModeloAbertoDados(resp?.dados || null)
+      return
+    }
+    if (secaoNormalizada === 'metricas') {
+      setModeloAbertoEstatisticas(resp?.estatisticas || null)
+      return
+    }
+    if (secaoNormalizada === 'transformacoes') {
+      setModeloAbertoEscalasHtml(resp?.escalas_html || '')
+      setModeloAbertoDadosTransformados(resp?.dados_transformados || null)
+      return
+    }
+    if (secaoNormalizada === 'resumo') {
+      setModeloAbertoResumoHtml(resp?.resumo_html || '')
+      setModeloAbertoEquacoes(resp?.equacoes || null)
+      return
+    }
+    if (secaoNormalizada === 'coeficientes') {
+      setModeloAbertoCoeficientes(resp?.coeficientes || null)
+      return
+    }
+    if (secaoNormalizada === 'obs_calc') {
+      setModeloAbertoObsCalc(resp?.obs_calc || null)
+      return
+    }
+    if (secaoNormalizada === 'graficos') {
+      setModeloAbertoPlotObsCalc(resp?.grafico_obs_calc || null)
+      setModeloAbertoPlotResiduos(resp?.grafico_residuos || null)
+      setModeloAbertoPlotHistograma(resp?.grafico_histograma || null)
+      setModeloAbertoPlotCook(resp?.grafico_cook || null)
+      setModeloAbertoPlotCorr(resp?.grafico_correlacao || null)
+      return
+    }
+    if (secaoNormalizada === 'trabalhos_tecnicos') {
+      setModeloAbertoTrabalhosTecnicos(Array.isArray(resp?.trabalhos_tecnicos) ? resp.trabalhos_tecnicos : [])
+      setModeloAbertoTrabalhosTecnicosModelosModo(resp?.trabalhos_tecnicos_modelos_modo || MODELO_ABERTO_TRABALHOS_TECNICOS_PADRAO)
+      return
+    }
+    if (secaoNormalizada === 'mapa') {
+      const nextChoices = Array.isArray(resp?.mapa_choices) && resp.mapa_choices.length
+        ? resp.mapa_choices
+        : ['Visualização Padrão']
+      setModeloAbertoMapaHtml(resp?.mapa_html || '')
+      setModeloAbertoMapaChoices(nextChoices)
+      setModeloAbertoMapaVar((current) => (nextChoices.includes(current) ? current : 'Visualização Padrão'))
+      setModeloAbertoTrabalhosTecnicos(Array.isArray(resp?.trabalhos_tecnicos) ? resp.trabalhos_tecnicos : [])
+      setModeloAbertoTrabalhosTecnicosModelosModo(resp?.trabalhos_tecnicos_modelos_modo || MODELO_ABERTO_TRABALHOS_TECNICOS_PADRAO)
+    }
+  }
+
+  async function garantirSecaoModeloAberto(secao, options = {}) {
+    const secaoNormalizada = resolveRepoModelTabKey(secao)
+    const modeloId = String(options.modeloId || modeloAbertoMeta?.id || '').trim()
+    if (!sessionId || !modeloId) return
+    if (!options.force && modeloAbertoLoadedTabs[secaoNormalizada]) return
+    if (pendingTabRequestsRef.current[secaoNormalizada]) {
+      await pendingTabRequestsRef.current[secaoNormalizada]
+      return
+    }
+
+    const expectedVersion = options.expectedVersion ?? modeloOpenVersionRef.current
+    const trabalhosTecnicosModo = options.trabalhosTecnicosModelosModo || modeloAbertoTrabalhosTecnicosModelosModo
+    setModeloAbertoLoadingTabs((prev) => ({ ...prev, [secaoNormalizada]: true }))
+
+    const request = (async () => {
+      try {
+        const resp = await api.visualizacaoSection(
+          sessionId,
+          getRepoModelTabSlugFromKey(secaoNormalizada),
+          trabalhosTecnicosModo,
+        )
+        if (modeloOpenVersionRef.current !== expectedVersion) return
+        aplicarSecaoModeloAberto(secaoNormalizada, resp)
+        setModeloAbertoLoadedTabs((prev) => ({
+          ...prev,
+          [secaoNormalizada]: true,
+          ...(secaoNormalizada === 'mapa' ? { trabalhos_tecnicos: true } : {}),
+        }))
+      } catch (err) {
+        if (modeloOpenVersionRef.current !== expectedVersion) return
+        setModeloAbertoError(err.message || 'Falha ao carregar dados do modelo.')
+      } finally {
+        if (modeloOpenVersionRef.current !== expectedVersion) return
+        setModeloAbertoLoadingTabs((prev) => ({ ...prev, [secaoNormalizada]: false }))
+      }
+    })()
+
+    pendingTabRequestsRef.current[secaoNormalizada] = request
+    try {
+      await request
+    } finally {
+      if (pendingTabRequestsRef.current[secaoNormalizada] === request) {
+        delete pendingTabRequestsRef.current[secaoNormalizada]
+      }
+    }
   }
 
-  async function onAbrirModelo(item) {
+  function emitOpenedModelRoute(meta = modeloAbertoMeta, activeTab = modeloAbertoActiveTab) {
+    const modeloId = String(meta?.id || '').trim()
+    if (!modeloId || typeof onRouteChange !== 'function') return
+    onRouteChange({
+      tab: 'modelos',
+      subtab: 'repositorio',
+      modeloId,
+      modelTab: getRepoModelTabSlugFromKey(activeTab),
+    })
+  }
+
+  async function onAbrirModelo(item, options = {}) {
     if (!sessionId) {
       setError('Sessão indisponível no momento. Aguarde e tente novamente.')
       return
     }
+    const nextModelTab = resolveRepoModelTabKey(options?.initialModelTab)
+    const nextReturnIntent = buildReturnIntent(options?.returnIntent || resolveCurrentReturnIntent())
+    const nextMeta = {
+      id: String(item?.id || ''),
+      nome: item?.nome_modelo || item?.arquivo || String(item?.id || ''),
+      arquivo: String(item?.arquivo || '').trim(),
+      observacao: '',
+    }
+    modeloOpenVersionRef.current += 1
+    const openVersion = modeloOpenVersionRef.current
+    limparConteudoModeloAberto()
     setModeloAbertoLoading(true)
     setModeloAbertoError('')
+    setModeloAbertoMeta(nextMeta)
+    setModeloAbertoActiveTab(nextModelTab)
+    setModeloAbertoReturnIntent(nextReturnIntent)
+    scrollParaTopoDaPagina()
+    emitOpenedModelRoute(nextMeta, nextModelTab)
     try {
-      await api.visualizacaoRepositorioCarregar(sessionId, String(item?.id || ''))
-      const resp = await api.exibirVisualizacao(sessionId, MODELO_ABERTO_TRABALHOS_TECNICOS_PADRAO)
-      preencherModeloAberto(resp)
-      setModeloAbertoActiveTab('mapa')
-      setModeloAbertoMeta({
-        id: String(item?.id || ''),
-        nome: item?.nome_modelo || item?.arquivo || String(item?.id || ''),
-        observacao: String(resp?.meta_modelo?.observacao_modelo || '').trim(),
+      const resp = await api.visualizacaoRepositorioCarregar(sessionId, String(item?.id || ''))
+      if (modeloOpenVersionRef.current !== openVersion) return
+      setModeloAbertoMeta((prev) => (
+        prev ? { ...prev, observacao: String(resp?.observacao_modelo || '').trim() } : prev
+      ))
+      await garantirSecaoModeloAberto(nextModelTab, {
+        force: true,
+        expectedVersion: openVersion,
+        modeloId: nextMeta.id,
+        trabalhosTecnicosModelosModo: MODELO_ABERTO_TRABALHOS_TECNICOS_PADRAO,
       })
     } catch (err) {
+      if (modeloOpenVersionRef.current !== openVersion) return
       setModeloAbertoError(err.message || 'Falha ao abrir modelo.')
     } finally {
-      setModeloAbertoLoading(false)
+      if (modeloOpenVersionRef.current === openVersion) {
+        setModeloAbertoLoading(false)
+      }
     }
   }
 
   function onVoltarRepositorio() {
+    const nextIntent = hasMesaDeepLink(modeloAbertoReturnIntent)
+      ? {
+          ...modeloAbertoReturnIntent,
+          forceRouteRequest: true,
+        }
+      : {
+          tab: 'modelos',
+          subtab: 'repositorio',
+          forceRouteRequest: true,
+        }
+    modeloOpenVersionRef.current += 1
+    pendingTabRequestsRef.current = {}
     setModeloAbertoMeta(null)
+    setModeloAbertoReturnIntent(null)
     setModeloAbertoError('')
     setModeloAbertoActiveTab('mapa')
+    setModeloAbertoLoading(false)
+    limparConteudoModeloAberto()
+    if (typeof onRouteChange === 'function') {
+      onRouteChange(nextIntent)
+    }
   }
 
   async function atualizarMapaModeloAberto(
@@ -269,10 +546,16 @@ export default function RepositorioTab({ authUser, sessionId, openModeloRequest
     nextTrabalhosTecnicosModo = modeloAbertoTrabalhosTecnicosModelosModo,
   ) {
     if (!sessionId) return
-    const resp = await api.updateVisualizacaoMap(sessionId, nextVar, nextTrabalhosTecnicosModo)
-    setModeloAbertoMapaHtml(resp?.mapa_html || '')
-    setModeloAbertoTrabalhosTecnicos(Array.isArray(resp?.trabalhos_tecnicos) ? resp.trabalhos_tecnicos : [])
-    setModeloAbertoTrabalhosTecnicosModelosModo(resp?.trabalhos_tecnicos_modelos_modo || nextTrabalhosTecnicosModo)
+    setModeloAbertoLoadingTabs((prev) => ({ ...prev, mapa: true }))
+    try {
+      const resp = await api.updateVisualizacaoMap(sessionId, nextVar, nextTrabalhosTecnicosModo)
+      setModeloAbertoMapaHtml(resp?.mapa_html || '')
+      setModeloAbertoTrabalhosTecnicos(Array.isArray(resp?.trabalhos_tecnicos) ? resp.trabalhos_tecnicos : [])
+      setModeloAbertoTrabalhosTecnicosModelosModo(resp?.trabalhos_tecnicos_modelos_modo || nextTrabalhosTecnicosModo)
+      setModeloAbertoLoadedTabs((prev) => ({ ...prev, mapa: true, trabalhos_tecnicos: true }))
+    } finally {
+      setModeloAbertoLoadingTabs((prev) => ({ ...prev, mapa: false }))
+    }
   }
 
   async function onModeloAbertoMapChange(nextVar) {
@@ -307,7 +590,28 @@ export default function RepositorioTab({ authUser, sessionId, openModeloRequest
     }
   }
 
+  function onModeloAbertoTabSelect(nextTab) {
+    setModeloAbertoActiveTab(nextTab)
+    emitOpenedModelRoute(modeloAbertoMeta, nextTab)
+    void garantirSecaoModeloAberto(nextTab)
+  }
+
   if (modoModeloAberto) {
+    const shareHref = buildRepositorioModeloLink(
+      modeloAbertoMeta?.id || '',
+      getRepoModelTabSlugFromKey(modeloAbertoActiveTab),
+    )
+    const modeloAcao = {
+      id: String(modeloAbertoMeta?.id || '').trim(),
+      nome_modelo: String(modeloAbertoMeta?.nome || '').trim(),
+      arquivo: String(modeloAbertoMeta?.arquivo || '').trim(),
+    }
+    const returnButtonLabel = getReturnButtonLabel(modeloAbertoReturnIntent)
+    const activeTabLoading = Boolean(modeloAbertoLoadingTabs[modeloAbertoActiveTab])
+    const activeTabLoaded = Boolean(modeloAbertoLoadedTabs[modeloAbertoActiveTab])
+    const modeloLoadingLabel = modeloAbertoLoading
+      ? 'Abrindo modelo...'
+      : getModeloAbertoLoadingLabel(modeloAbertoActiveTab)
     return (
       <div className="tab-content">
         <div className="pesquisa-opened-model-view">
@@ -316,9 +620,32 @@ export default function RepositorioTab({ authUser, sessionId, openModeloRequest
               <h3>{modeloAbertoMeta?.nome || 'Modelo'}</h3>
               {modeloAbertoMeta?.observacao ? <p>{modeloAbertoMeta.observacao}</p> : null}
             </div>
-            <button type="button" className="model-source-back-btn model-source-back-btn-danger" onClick={onVoltarRepositorio} disabled={modeloAbertoLoading}>
-              Voltar ao repositório
-            </button>
+            <div className="pesquisa-opened-model-actions">
+              <ShareLinkButton href={shareHref} />
+              {typeof onUsarModeloEmAvaliacao === 'function' ? (
+                <button
+                  type="button"
+                  className="pesquisa-opened-model-action-btn pesquisa-opened-model-action-btn-secondary"
+                  onClick={() => onUsarModeloEmAvaliacao(modeloAcao)}
+                  disabled={modeloAbertoLoading}
+                >
+                  Usar na avaliação
+                </button>
+              ) : null}
+              {typeof onEditarModeloEmElaboracao === 'function' ? (
+                <button
+                  type="button"
+                  className="pesquisa-opened-model-action-btn pesquisa-opened-model-action-btn-secondary"
+                  onClick={() => onEditarModeloEmElaboracao(modeloAcao)}
+                  disabled={modeloAbertoLoading}
+                >
+                  Editar na elaboração
+                </button>
+              ) : null}
+              <button type="button" className="model-source-back-btn model-source-back-btn-danger" onClick={onVoltarRepositorio} disabled={modeloAbertoLoading}>
+                {returnButtonLabel}
+              </button>
+            </div>
           </div>
 
           <div className="inner-tabs" role="tablist" aria-label="Abas internas do modelo aberto no repositório">
@@ -327,7 +654,8 @@ export default function RepositorioTab({ authUser, sessionId, openModeloRequest
                 key={tab.key}
                 type="button"
                 className={modeloAbertoActiveTab === tab.key ? 'inner-tab-pill active' : 'inner-tab-pill'}
-                onClick={() => setModeloAbertoActiveTab(tab.key)}
+                onClick={() => onModeloAbertoTabSelect(tab.key)}
+                disabled={modeloAbertoLoading}
               >
                 {tab.label}
               </button>
@@ -336,84 +664,110 @@ export default function RepositorioTab({ authUser, sessionId, openModeloRequest
 
           <div className="inner-tab-panel">
             {modeloAbertoActiveTab === 'mapa' ? (
-              <>
-                <div className="row compact visualizacao-mapa-controls pesquisa-mapa-controls-row">
-                  <label className="pesquisa-field pesquisa-mapa-modo-field">
-                    Variável no mapa
-                    <select value={modeloAbertoMapaVar} onChange={(event) => void onModeloAbertoMapChange(event.target.value)}>
-                      {modeloAbertoMapaChoices.map((choice) => (
-                        <option key={`repo-modelo-aberto-mapa-${choice}`} value={choice}>{choice}</option>
-                      ))}
-                    </select>
-                  </label>
-                  <label className="pesquisa-field pesquisa-mapa-trabalhos-field">
-                    Exibição dos trabalhos técnicos
-                    <select
-                      value={modeloAbertoTrabalhosTecnicosModelosModo === 'selecionados_e_anteriores'
-                        ? MODELO_ABERTO_TRABALHOS_TECNICOS_PADRAO
-                        : modeloAbertoTrabalhosTecnicosModelosModo}
-                      onChange={(event) => void onModeloAbertoTrabalhosTecnicosModeChange(event.target.value)}
-                      autoComplete="off"
-                    >
-                      <option value="selecionados">Somente deste modelo</option>
-                      <option value="selecionados_e_outras_versoes">Incluir demais versões do modelo</option>
-                    </select>
-                  </label>
-                </div>
-                <MapFrame html={modeloAbertoMapaHtml} />
-              </>
+              !activeTabLoaded ? (
+                <div className="empty-box">Carregando mapa do modelo...</div>
+              ) : (
+                <>
+                  <div className="row compact visualizacao-mapa-controls pesquisa-mapa-controls-row">
+                    <label className="pesquisa-field pesquisa-mapa-modo-field">
+                      Variável no mapa
+                      <select value={modeloAbertoMapaVar} onChange={(event) => void onModeloAbertoMapChange(event.target.value)}>
+                        {modeloAbertoMapaChoices.map((choice) => (
+                          <option key={`repo-modelo-aberto-mapa-${choice}`} value={choice}>{choice}</option>
+                        ))}
+                      </select>
+                    </label>
+                    <label className="pesquisa-field pesquisa-mapa-trabalhos-field">
+                      Exibição dos trabalhos técnicos
+                      <select
+                        value={modeloAbertoTrabalhosTecnicosModelosModo === 'selecionados_e_anteriores'
+                          ? MODELO_ABERTO_TRABALHOS_TECNICOS_PADRAO
+                          : modeloAbertoTrabalhosTecnicosModelosModo}
+                        onChange={(event) => void onModeloAbertoTrabalhosTecnicosModeChange(event.target.value)}
+                        autoComplete="off"
+                      >
+                        <option value="selecionados">Somente deste modelo</option>
+                        <option value="selecionados_e_outras_versoes">Incluir demais versões do modelo</option>
+                      </select>
+                    </label>
+                  </div>
+                  <MapFrame html={modeloAbertoMapaHtml} />
+                </>
+              )
             ) : null}
 
             {modeloAbertoActiveTab === 'trabalhos_tecnicos' ? (
-              <ModeloTrabalhosTecnicosPanel trabalhos={modeloAbertoTrabalhosTecnicos} />
+              activeTabLoaded
+                ? <ModeloTrabalhosTecnicosPanel trabalhos={modeloAbertoTrabalhosTecnicos} />
+                : <div className="empty-box">Carregando trabalhos técnicos do modelo...</div>
             ) : null}
 
-            {modeloAbertoActiveTab === 'dados_mercado' ? <DataTable table={modeloAbertoDados} maxHeight={620} /> : null}
-            {modeloAbertoActiveTab === 'metricas' ? <DataTable table={modeloAbertoEstatisticas} maxHeight={620} /> : null}
+            {modeloAbertoActiveTab === 'dados_mercado'
+              ? (activeTabLoaded ? <DataTable table={modeloAbertoDados} maxHeight={620} /> : <div className="empty-box">Carregando dados de mercado...</div>)
+              : null}
+            {modeloAbertoActiveTab === 'metricas'
+              ? (activeTabLoaded ? <DataTable table={modeloAbertoEstatisticas} maxHeight={620} /> : <div className="empty-box">Carregando métricas do modelo...</div>)
+              : null}
 
             {modeloAbertoActiveTab === 'transformacoes' ? (
-              <>
-                <div dangerouslySetInnerHTML={{ __html: modeloAbertoEscalasHtml }} />
-                <h4 className="visualizacao-table-title">Dados com variáveis transformadas</h4>
-                <DataTable table={modeloAbertoDadosTransformados} />
-              </>
+              activeTabLoaded ? (
+                <>
+                  <div dangerouslySetInnerHTML={{ __html: modeloAbertoEscalasHtml }} />
+                  <h4 className="visualizacao-table-title">Dados com variáveis transformadas</h4>
+                  <DataTable table={modeloAbertoDadosTransformados} />
+                </>
+              ) : (
+                <div className="empty-box">Carregando transformações do modelo...</div>
+              )
             ) : null}
 
             {modeloAbertoActiveTab === 'resumo' ? (
-              <>
-                <div className="equation-formats-section">
-                  <h4>Equações do Modelo</h4>
-                  <EquationFormatsPanel
-                    equacoes={modeloAbertoEquacoes}
-                    onDownload={(mode) => void onDownloadEquacaoModeloAberto(mode)}
-                    disabled={modeloAbertoLoading}
-                  />
-                </div>
-                <div dangerouslySetInnerHTML={{ __html: modeloAbertoResumoHtml }} />
-              </>
+              activeTabLoaded ? (
+                <>
+                  <div className="equation-formats-section">
+                    <h4>Equações do Modelo</h4>
+                    <EquationFormatsPanel
+                      equacoes={modeloAbertoEquacoes}
+                      onDownload={(mode) => void onDownloadEquacaoModeloAberto(mode)}
+                      disabled={modeloAbertoLoading}
+                    />
+                  </div>
+                  <div dangerouslySetInnerHTML={{ __html: modeloAbertoResumoHtml }} />
+                </>
+              ) : (
+                <div className="empty-box">Carregando resumo do modelo...</div>
+              )
             ) : null}
 
-            {modeloAbertoActiveTab === 'coeficientes' ? <DataTable table={modeloAbertoCoeficientes} maxHeight={620} /> : null}
-            {modeloAbertoActiveTab === 'obs_calc' ? <DataTable table={modeloAbertoObsCalc} maxHeight={620} /> : null}
+            {modeloAbertoActiveTab === 'coeficientes'
+              ? (activeTabLoaded ? <DataTable table={modeloAbertoCoeficientes} maxHeight={620} /> : <div className="empty-box">Carregando coeficientes do modelo...</div>)
+              : null}
+            {modeloAbertoActiveTab === 'obs_calc'
+              ? (activeTabLoaded ? <DataTable table={modeloAbertoObsCalc} maxHeight={620} /> : <div className="empty-box">Carregando observados x calculados...</div>)
+              : null}
 
             {modeloAbertoActiveTab === 'graficos' ? (
-              <>
-                <div className="plot-grid-2-fixed">
-                  <PlotFigure figure={modeloAbertoPlotObsCalc} title="Obs x Calc" />
-                  <PlotFigure figure={modeloAbertoPlotResiduos} title="Resíduos" />
-                  <PlotFigure figure={modeloAbertoPlotHistograma} title="Histograma" />
-                  <PlotFigure figure={modeloAbertoPlotCook} title="Cook" forceHideLegend />
-                </div>
-                <div className="plot-full-width">
-                  <PlotFigure figure={modeloAbertoPlotCorr} title="Correlação" className="plot-correlation-card" />
-                </div>
-              </>
+              activeTabLoaded ? (
+                <>
+                  <div className="plot-grid-2-fixed">
+                    <PlotFigure figure={modeloAbertoPlotObsCalc} title="Obs x Calc" />
+                    <PlotFigure figure={modeloAbertoPlotResiduos} title="Resíduos" />
+                    <PlotFigure figure={modeloAbertoPlotHistograma} title="Histograma" />
+                    <PlotFigure figure={modeloAbertoPlotCook} title="Cook" forceHideLegend />
+                  </div>
+                  <div className="plot-full-width">
+                    <PlotFigure figure={modeloAbertoPlotCorr} title="Correlação" className="plot-correlation-card" />
+                  </div>
+                </>
+              ) : (
+                <div className="empty-box">Carregando gráficos do modelo...</div>
+              )
             ) : null}
           </div>
 
           {modeloAbertoError ? <div className="error-line inline-error">{modeloAbertoError}</div> : null}
         </div>
-        <LoadingOverlay show={modeloAbertoLoading} label="Carregando modelo..." />
+        <LoadingOverlay show={modeloAbertoLoading || activeTabLoading} label={modeloLoadingLabel} />
       </div>
     )
   }

frontend/src/components/ShareLinkButton.jsx

@@ -0,0 +1,57 @@
+import React, { useEffect, useState } from 'react'
+
+function fallbackCopyText(text) {
+  const textarea = document.createElement('textarea')
+  textarea.value = text
+  textarea.setAttribute('readonly', 'true')
+  textarea.style.position = 'fixed'
+  textarea.style.opacity = '0'
+  document.body.appendChild(textarea)
+  textarea.select()
+  document.execCommand('copy')
+  document.body.removeChild(textarea)
+}
+
+export default function ShareLinkButton({
+  href = '',
+  label = 'Copiar link',
+  copiedLabel = 'Link copiado',
+  className = 'model-source-back-btn',
+  disabled = false,
+  title = '',
+}) {
+  const [copied, setCopied] = useState(false)
+
+  useEffect(() => {
+    if (!copied) return undefined
+    const timeoutId = window.setTimeout(() => setCopied(false), 1800)
+    return () => window.clearTimeout(timeoutId)
+  }, [copied])
+
+  async function onCopyClick() {
+    if (disabled || !href) return
+    try {
+      if (navigator.clipboard?.writeText) {
+        await navigator.clipboard.writeText(href)
+      } else {
+        fallbackCopyText(href)
+      }
+      setCopied(true)
+    } catch {
+      fallbackCopyText(href)
+      setCopied(true)
+    }
+  }
+
+  return (
+    <button
+      type="button"
+      className={className}
+      onClick={() => void onCopyClick()}
+      disabled={disabled || !href}
+      title={title || href || 'Copiar link'}
+    >
+      {copied ? copiedLabel : label}
+    </button>
+  )
+}

frontend/src/components/TrabalhosTecnicosTab.jsx

@@ -1,8 +1,10 @@
 import React, { useEffect, useRef, useState } from 'react'
 import { api } from '../api'
+import { buildTrabalhoTecnicoLink, getTrabalhosSubtabKeyFromSlug } from '../deepLinks'
 import ListPagination from './ListPagination'
 import LoadingOverlay from './LoadingOverlay'
 import MapFrame from './MapFrame'
+import ShareLinkButton from './ShareLinkButton'
 import TruncatedCellContent from './TruncatedCellContent'
 
 const PAGE_SIZE = 50
@@ -150,7 +152,10 @@ export default function TrabalhosTecnicosTab({
   sessionId,
   onAbrirModeloNoRepositorio = null,
   quickOpenRequest = null,
+  routeRequest = null,
+  onRouteChange = null,
   onVoltarAoMapaPesquisa = null,
+  onModoImersivoChange = null,
 }) {
   const [activeInnerTab, setActiveInnerTab] = useState('repositorio')
   const [trabalhos, setTrabalhos] = useState([])
@@ -183,7 +188,9 @@ export default function TrabalhosTecnicosTab({
   const [modeloSugestoesMesa, setModeloSugestoesMesa] = useState([])
   const [modeloSugestoesLoading, setModeloSugestoesLoading] = useState(false)
   const [origemAbertura, setOrigemAbertura] = useState('lista')
+  const [abrindoTrabalhoId, setAbrindoTrabalhoId] = useState('')
   const quickOpenHandledRef = useRef('')
+  const routeRequestHandledRef = useRef('')
   const mapaRequestKeyRef = useRef('')
   const mapaUltimaSelecaoRef = useRef({ ids: [], avaliando: null })
   const mapaAreaRef = useRef(null)
@@ -210,6 +217,34 @@ export default function TrabalhosTecnicosTab({
     void abrirTrabalhoPorId(trabalhoId, { origem })
   }, [quickOpenRequest])
 
+  useEffect(() => {
+    const requestKey = String(routeRequest?.requestKey || '').trim()
+    if (!requestKey) return
+    if (routeRequestHandledRef.current === requestKey) return
+    routeRequestHandledRef.current = requestKey
+    const nextSubtab = getTrabalhosSubtabKeyFromSlug(routeRequest?.subtab)
+    setActiveInnerTab(nextSubtab)
+    const trabalhoId = String(routeRequest?.trabalhoId || '').trim()
+    if (trabalhoId) {
+      const trabalhoAbertoId = String(trabalhoAberto?.id || '').trim()
+      if (trabalhoAbertoId && trabalhoAbertoId === trabalhoId) {
+        setTrabalhoError('')
+        return
+      }
+      void abrirTrabalhoPorId(trabalhoId, { origem: 'lista' })
+      return
+    }
+    if (trabalhoAberto) {
+      onVoltarLista({ syncRoute: false, subtab: nextSubtab })
+    }
+  }, [routeRequest, trabalhoAberto])
+
+  useEffect(() => {
+    if (typeof onModoImersivoChange !== 'function') return undefined
+    onModoImersivoChange(Boolean(trabalhoAberto))
+    return () => onModoImersivoChange(false)
+  }, [trabalhoAberto, onModoImersivoChange])
+
   async function carregarTrabalhos() {
     setLoading(true)
     setError('')
@@ -376,6 +411,7 @@ export default function TrabalhosTecnicosTab({
   async function abrirTrabalhoPorId(trabalhoId, options = {}) {
     const chave = String(trabalhoId || '').trim()
     if (!chave) return
+    setAbrindoTrabalhoId(chave)
     setTrabalhoLoading(true)
     setTrabalhoError('')
     setEdicaoErro('')
@@ -385,10 +421,17 @@ export default function TrabalhosTecnicosTab({
     try {
       const resp = await api.trabalhosTecnicosDetalhe(chave)
       setTrabalhoAberto(resp?.trabalho || null)
+      if (typeof onRouteChange === 'function') {
+        onRouteChange({
+          tab: 'trabalhos',
+          trabalhoId: chave,
+        })
+      }
     } catch (err) {
       setTrabalhoError(err.message || 'Falha ao abrir trabalho técnico.')
     } finally {
       setTrabalhoLoading(false)
+      setAbrindoTrabalhoId((prev) => (prev === chave ? '' : prev))
     }
   }
 
@@ -398,28 +441,34 @@ export default function TrabalhosTecnicosTab({
     await abrirTrabalhoPorId(trabalhoId, { origem: 'lista' })
   }
 
-  function onVoltarLista() {
+  function onVoltarLista(options = {}) {
     setTrabalhoAberto(null)
     setTrabalhoError('')
     setEdicaoErro('')
     setEditando(false)
     setEdicao(null)
     setModeloDraft('')
+    if (options.syncRoute !== false && typeof onRouteChange === 'function') {
+      onRouteChange({
+        tab: 'trabalhos',
+        subtab: options.subtab || activeInnerTab,
+      })
+    }
   }
 
   function onVoltarDoDetalhe() {
     if (origemAbertura === 'pesquisa_mapa' && typeof onVoltarAoMapaPesquisa === 'function') {
-      onVoltarLista()
+      onVoltarLista({ syncRoute: false })
       onVoltarAoMapaPesquisa()
       return
     }
     if (origemAbertura === 'trabalhos_tecnicos_mapa') {
       scrollRetornoMapaRef.current = true
       setActiveInnerTab('mapa')
-      onVoltarLista()
+      onVoltarLista({ subtab: 'mapa' })
       return
     }
-    onVoltarLista()
+    onVoltarLista({ subtab: activeInnerTab })
   }
 
   function onAbrirModeloAssociado(modelo) {
@@ -428,6 +477,11 @@ export default function TrabalhosTecnicosTab({
       modeloId: modelo?.mesa_modelo_id,
       nomeModelo: modelo?.mesa_modelo_nome || modelo?.nome,
       modeloArquivo: modelo?.mesa_modelo_arquivo || '',
+      returnIntent: {
+        tab: 'trabalhos',
+        subtab: activeInnerTab,
+        trabalhoId: String(trabalhoAberto?.id || '').trim(),
+      },
     })
   }
 
@@ -632,6 +686,7 @@ export default function TrabalhosTecnicosTab({
     const modelosMesa = modelos.filter((item) => item?.disponivel_mesa)
     const imoveis = Array.isArray(trabalhoAberto?.imoveis) ? trabalhoAberto.imoveis : []
     const processosSei = listarProcessosSei(trabalhoAberto)
+    const shareHref = buildTrabalhoTecnicoLink(trabalhoAberto?.id || '')
 
     return (
       <div className="tab-content">
@@ -642,6 +697,7 @@ export default function TrabalhosTecnicosTab({
               <p>{trabalhoAberto?.tipo_label || 'Tipo não identificado'}</p>
             </div>
             <div className="trabalho-detail-actions">
+              <ShareLinkButton href={shareHref} />
               {!editando ? (
                 <button
                   type="button"
@@ -898,7 +954,7 @@ export default function TrabalhosTecnicosTab({
                 )}
                 {modelosMesa.length ? (
                   <div className="section1-empty-hint">
-                    Clique em um modelo disponível para abri-lo em Modelos Estatísticos &gt; Repositório de Modelos.
+                    Clique em um modelo disponível para abri-lo na MESA.
                   </div>
                 ) : null}
               </>
@@ -962,7 +1018,7 @@ export default function TrabalhosTecnicosTab({
         </div>
         <LoadingOverlay
           show={trabalhoLoading || salvando}
-          label={salvando ? 'Salvando trabalho técnico...' : 'Carregando trabalho técnico...'}
+          label={salvando ? 'Salvando trabalho técnico...' : 'Abrindo trabalho técnico...'}
         />
       </div>
     )
@@ -976,7 +1032,15 @@ export default function TrabalhosTecnicosTab({
             key={tab.key}
             type="button"
             className={activeInnerTab === tab.key ? 'inner-tab-pill active' : 'inner-tab-pill'}
-            onClick={() => setActiveInnerTab(tab.key)}
+            onClick={() => {
+              setActiveInnerTab(tab.key)
+              if (typeof onRouteChange === 'function') {
+                onRouteChange({
+                  tab: 'trabalhos',
+                  subtab: tab.key,
+                })
+              }
+            }}
           >
             {tab.label}
           </button>
@@ -1059,7 +1123,10 @@ export default function TrabalhosTecnicosTab({
                   </tr>
                 </thead>
                 <tbody>
-                  {trabalhosPagina.map((item) => (
+                  {trabalhosPagina.map((item) => {
+                    const trabalhoId = String(item?.id || '').trim()
+                    const abrindoEsteTrabalho = abrindoTrabalhoId === trabalhoId
+                    return (
                     <tr key={String(item?.id || '')}>
                       <td className="trabalhos-col-nome"><TruncatedCellContent tooltipContent={item?.nome || '-'}>{item?.nome || '-'}</TruncatedCellContent></td>
                       <td className="trabalhos-col-tipo"><TruncatedCellContent tooltipContent={item?.tipo_label || item?.tipo_codigo || '-'}>{item?.tipo_label || item?.tipo_codigo || '-'}</TruncatedCellContent></td>
@@ -1107,16 +1174,18 @@ export default function TrabalhosTecnicosTab({
                       <td className="repo-col-open">
                         <button
                           type="button"
-                          className="repo-open-btn"
+                          className={abrindoEsteTrabalho ? 'repo-open-btn is-loading' : 'repo-open-btn'}
                           onClick={() => void onAbrirTrabalho(item)}
-                          title="Abrir trabalho técnico"
-                          aria-label={`Abrir ${item?.nome || 'trabalho técnico'}`}
+                          disabled={trabalhoLoading}
+                          title={abrindoEsteTrabalho ? 'Abrindo trabalho técnico...' : 'Abrir trabalho técnico'}
+                          aria-label={`${abrindoEsteTrabalho ? 'Abrindo' : 'Abrir'} ${item?.nome || 'trabalho técnico'}`}
                         >
-                          ↗
+                          {abrindoEsteTrabalho ? <span className="repo-open-btn-spinner" aria-hidden="true" /> : '↗'}
                         </button>
                       </td>
                     </tr>
-                  ))}
+                    )
+                  })}
                   {!trabalhosFiltrados.length ? (
                     <tr>
                       <td colSpan={7}>
@@ -1345,8 +1414,10 @@ export default function TrabalhosTecnicosTab({
         )}
       </div>
       <LoadingOverlay
-        show={loading || mapaLoading}
-        label={mapaLoading ? 'Gerando mapa dos trabalhos técnicos...' : 'Carregando trabalhos técnicos...'}
+        show={loading || mapaLoading || trabalhoLoading}
+        label={trabalhoLoading
+          ? 'Abrindo trabalho técnico...'
+          : (mapaLoading ? 'Gerando mapa dos trabalhos técnicos...' : 'Carregando trabalhos técnicos...')}
       />
     </div>
   )

frontend/src/deepLinks.js

@@ -0,0 +1,348 @@
+const TAB_LABEL_BY_SLUG = {
+  modelos: 'Modelos Estatísticos',
+  elaboracao: 'Elaboração/Edição',
+  avaliacao: 'Avaliação',
+  trabalhos: 'Trabalhos Técnicos',
+}
+
+const TAB_SLUG_BY_LABEL = Object.fromEntries(
+  Object.entries(TAB_LABEL_BY_SLUG).map(([slug, label]) => [label, slug]),
+)
+
+const MODELOS_SUBTAB_LABEL_BY_SLUG = {
+  pesquisa: 'Pesquisar Modelos',
+  repositorio: 'Repositório de Modelos',
+  'visao-geral': 'Visão Geral',
+}
+
+const MODELOS_SUBTAB_SLUG_BY_LABEL = Object.fromEntries(
+  Object.entries(MODELOS_SUBTAB_LABEL_BY_SLUG).map(([slug, label]) => [label, slug]),
+)
+
+const TRABALHOS_SUBTAB_LABEL_BY_SLUG = {
+  repositorio: 'repositorio',
+  mapa: 'mapa',
+}
+
+const TRABALHOS_SUBTAB_SLUG_BY_LABEL = Object.fromEntries(
+  Object.entries(TRABALHOS_SUBTAB_LABEL_BY_SLUG).map(([slug, label]) => [label, slug]),
+)
+
+const MODEL_TAB_SET = new Set([
+  'mapa',
+  'trabalhos-tecnicos',
+  'dados-mercado',
+  'metricas',
+  'transformacoes',
+  'resumo',
+  'coeficientes',
+  'obs-calc',
+  'graficos',
+])
+
+const PESQUISA_FILTER_KEYS = [
+  'nomeModelo',
+  'tipoModelo',
+  'negociacaoModelo',
+  'dataMin',
+  'dataMax',
+  'versionamentoModelos',
+  'avalFinalidade',
+  'avalZona',
+  'avalBairro',
+  'avalArea',
+  'avalRh',
+]
+
+const PESQUISA_FILTER_DEFAULTS = {
+  nomeModelo: '',
+  tipoModelo: '',
+  negociacaoModelo: '',
+  dataMin: '',
+  dataMax: '',
+  versionamentoModelos: 'incluir_antigos',
+  avalFinalidade: '',
+  avalZona: '',
+  avalBairro: '',
+  avalArea: '',
+  avalRh: '',
+}
+
+function normalizeSlug(value) {
+  return String(value || '').trim().toLowerCase()
+}
+
+function trimValue(value) {
+  return String(value || '').trim()
+}
+
+function parseFiniteNumber(value) {
+  const text = trimValue(value).replace(',', '.')
+  if (!text) return null
+  const parsed = Number(text)
+  return Number.isFinite(parsed) ? parsed : null
+}
+
+function sanitizePesquisaFilters(rawFilters = {}) {
+  const next = { ...PESQUISA_FILTER_DEFAULTS }
+  PESQUISA_FILTER_KEYS.forEach((key) => {
+    if (!Object.prototype.hasOwnProperty.call(rawFilters, key)) return
+    const value = trimValue(rawFilters[key])
+    if (key === 'versionamentoModelos') {
+      next[key] = value === 'atuais' ? 'atuais' : 'incluir_antigos'
+      return
+    }
+    next[key] = value
+  })
+  return next
+}
+
+function hasPesquisaFilters(filters = {}) {
+  return PESQUISA_FILTER_KEYS.some((key) => {
+    const value = key === 'versionamentoModelos'
+      ? trimValue(filters[key] || PESQUISA_FILTER_DEFAULTS[key])
+      : trimValue(filters[key])
+    if (key === 'versionamentoModelos') return value === 'atuais'
+    return Boolean(value)
+  })
+}
+
+export function getAppTabKeyFromSlug(slug) {
+  return TAB_LABEL_BY_SLUG[normalizeSlug(slug)] || ''
+}
+
+export function getAppTabSlugFromKey(label) {
+  return TAB_SLUG_BY_LABEL[String(label || '').trim()] || ''
+}
+
+export function getModelosSubtabKeyFromSlug(slug) {
+  return MODELOS_SUBTAB_LABEL_BY_SLUG[normalizeSlug(slug)] || MODELOS_SUBTAB_LABEL_BY_SLUG.pesquisa
+}
+
+export function getModelosSubtabSlugFromKey(label) {
+  return MODELOS_SUBTAB_SLUG_BY_LABEL[String(label || '').trim()] || 'pesquisa'
+}
+
+export function getTrabalhosSubtabKeyFromSlug(slug) {
+  return TRABALHOS_SUBTAB_LABEL_BY_SLUG[normalizeSlug(slug)] || TRABALHOS_SUBTAB_LABEL_BY_SLUG.repositorio
+}
+
+export function getTrabalhosSubtabSlugFromKey(label) {
+  return TRABALHOS_SUBTAB_SLUG_BY_LABEL[String(label || '').trim()] || 'repositorio'
+}
+
+export function getModelTabSlug(value) {
+  const slug = normalizeSlug(value)
+  return MODEL_TAB_SET.has(slug) ? slug : 'mapa'
+}
+
+export function hasMesaDeepLink(intent) {
+  if (!intent || typeof intent !== 'object') return false
+  return Boolean(
+    trimValue(intent.tab)
+    || trimValue(intent.modeloId)
+    || trimValue(intent.trabalhoId)
+    || trimValue(intent.subtab)
+    || hasPesquisaFilters(intent.filters)
+    || (intent.avaliando && Number.isFinite(Number(intent.avaliando.lat)) && Number.isFinite(Number(intent.avaliando.lon))),
+  )
+}
+
+export function normalizeMesaDeepLink(intent = {}) {
+  const safeIntent = intent && typeof intent === 'object' ? intent : {}
+  const rawTab = normalizeSlug(safeIntent.tab)
+  const modeloId = trimValue(safeIntent.modeloId)
+  const trabalhoId = trimValue(safeIntent.trabalhoId)
+  let tab = TAB_LABEL_BY_SLUG[rawTab] ? rawTab : ''
+
+  if (!tab) {
+    if (modeloId) tab = 'modelos'
+    if (!tab && trabalhoId) tab = 'trabalhos'
+  }
+
+  let subtab = normalizeSlug(safeIntent.subtab)
+  if (tab === 'modelos') {
+    if (modeloId) {
+      subtab = 'repositorio'
+    } else if (!MODELOS_SUBTAB_LABEL_BY_SLUG[subtab]) {
+      subtab = 'pesquisa'
+    }
+  } else if (tab === 'trabalhos') {
+    if (!TRABALHOS_SUBTAB_LABEL_BY_SLUG[subtab]) subtab = 'repositorio'
+  } else {
+    subtab = ''
+  }
+
+  const filters = sanitizePesquisaFilters(safeIntent.filters)
+  const lat = parseFiniteNumber(safeIntent.avaliando?.lat)
+  const lon = parseFiniteNumber(safeIntent.avaliando?.lon)
+  const avaliando = lat !== null && lon !== null ? { lat, lon } : null
+  const modelTab = tab === 'modelos' && subtab === 'repositorio' && modeloId
+    ? getModelTabSlug(safeIntent.modelTab)
+    : ''
+
+  return {
+    tab,
+    subtab,
+    modelTab,
+    modeloId,
+    trabalhoId,
+    filters,
+    avaliando,
+  }
+}
+
+export function parseMesaDeepLink(search = '') {
+  const params = new URLSearchParams(String(search || '').replace(/^\?/, ''))
+  const filters = {}
+  PESQUISA_FILTER_KEYS.forEach((key) => {
+    if (!params.has(key)) return
+    filters[key] = params.get(key)
+  })
+
+  return normalizeMesaDeepLink({
+    tab: params.get('tab'),
+    subtab: params.get('subtab'),
+    modelTab: params.get('modelTab'),
+    modeloId: params.get('modeloId'),
+    trabalhoId: params.get('trabalhoId'),
+    filters,
+    avaliando: {
+      lat: params.get('avalLat'),
+      lon: params.get('avalLon'),
+    },
+  })
+}
+
+export function serializeMesaDeepLink(intent = {}) {
+  const normalized = normalizeMesaDeepLink(intent)
+  const params = new URLSearchParams()
+
+  if (normalized.tab) params.set('tab', normalized.tab)
+
+  if (normalized.tab === 'modelos' && normalized.subtab) {
+    params.set('subtab', normalized.subtab)
+  }
+
+  if (normalized.tab === 'trabalhos' && normalized.subtab && !normalized.trabalhoId) {
+    params.set('subtab', normalized.subtab)
+  }
+
+  if (normalized.modeloId) params.set('modeloId', normalized.modeloId)
+  if (normalized.trabalhoId) params.set('trabalhoId', normalized.trabalhoId)
+  if (normalized.modelTab) params.set('modelTab', normalized.modelTab)
+
+  if (normalized.tab === 'modelos' && normalized.subtab === 'pesquisa') {
+    PESQUISA_FILTER_KEYS.forEach((key) => {
+      const value = key === 'versionamentoModelos'
+        ? trimValue(normalized.filters[key] || PESQUISA_FILTER_DEFAULTS[key])
+        : trimValue(normalized.filters[key])
+      if (key === 'versionamentoModelos') {
+        if (value === 'atuais') params.set(key, value)
+        return
+      }
+      if (value) params.set(key, value)
+    })
+    if (normalized.avaliando) {
+      params.set('avalLat', String(normalized.avaliando.lat))
+      params.set('avalLon', String(normalized.avaliando.lon))
+    }
+  }
+
+  const query = params.toString()
+  return query ? `?${query}` : ''
+}
+
+export function buildMesaUrl(intent = {}) {
+  if (typeof window === 'undefined') return serializeMesaDeepLink(intent)
+  const url = new URL(window.location.href)
+  url.search = serializeMesaDeepLink(intent)
+  url.hash = ''
+  return url.toString()
+}
+
+function syncHuggingFaceParentUrl(queryString = '', hash = '') {
+  if (typeof window === 'undefined') return
+  if (!window.parent || window.parent === window) return
+  try {
+    window.parent.postMessage(
+      {
+        queryString,
+        hash,
+      },
+      'https://huggingface.co',
+    )
+  } catch {
+    // Ignora falhas cross-origin e mantém o sync local no iframe.
+  }
+}
+
+export function replaceMesaDeepLink(intent = {}) {
+  if (typeof window === 'undefined') return
+  const queryString = serializeMesaDeepLink(intent)
+  window.history.replaceState(null, '', buildMesaUrl(intent))
+  syncHuggingFaceParentUrl(queryString, '')
+}
+
+export function pushMesaDeepLink(intent = {}) {
+  if (typeof window === 'undefined') return
+  const queryString = serializeMesaDeepLink(intent)
+  window.history.pushState(null, '', buildMesaUrl(intent))
+  syncHuggingFaceParentUrl(queryString, '')
+}
+
+export function buildRepositorioModeloLink(modeloId, modelTab = 'mapa') {
+  return buildMesaUrl({
+    tab: 'modelos',
+    subtab: 'repositorio',
+    modeloId,
+    modelTab,
+  })
+}
+
+export function buildAvaliacaoModeloLink(modeloId) {
+  return buildMesaUrl({
+    tab: 'avaliacao',
+    modeloId,
+  })
+}
+
+export function buildElaboracaoModeloLink(modeloId) {
+  return buildMesaUrl({
+    tab: 'elaboracao',
+    modeloId,
+  })
+}
+
+export function buildTrabalhoTecnicoLink(trabalhoId) {
+  return buildMesaUrl({
+    tab: 'trabalhos',
+    trabalhoId,
+  })
+}
+
+export function buildPesquisaLink(filters = {}, avaliando = null) {
+  return buildMesaUrl({
+    tab: 'modelos',
+    subtab: 'pesquisa',
+    filters,
+    avaliando,
+  })
+}
+
+export function buildPesquisaRoutePayload(filters = {}, avaliando = null) {
+  return normalizeMesaDeepLink({
+    tab: 'modelos',
+    subtab: 'pesquisa',
+    filters,
+    avaliando,
+  })
+}
+
+export function getPesquisaFilterDefaults() {
+  return { ...PESQUISA_FILTER_DEFAULTS }
+}
+
+export function hasPesquisaRoutePayload(filters = {}, avaliando = null) {
+  return hasPesquisaFilters(filters) || Boolean(avaliando)
+}

frontend/src/styles.css

@@ -780,6 +780,20 @@ textarea {
   color: #1b7a40;
 }
 
+.repo-open-btn.is-loading {
+  cursor: wait;
+}
+
+.repo-open-btn-spinner {
+  width: 14px;
+  height: 14px;
+  display: inline-block;
+  border-radius: 50%;
+  border: 2px solid currentColor;
+  border-right-color: transparent;
+  animation: spinLoader 0.7s linear infinite;
+}
+
 .repo-delete-icon-btn {
   min-width: 28px;
   min-height: 28px;
@@ -2984,7 +2998,7 @@ button.pesquisa-coluna-remove:hover {
 .pesquisa-results-toolbar {
   display: flex;
   align-items: center;
-  justify-content: space-between;
+  justify-content: flex-start;
   flex-wrap: wrap;
   gap: 10px;
   margin-bottom: 10px;
@@ -3007,6 +3021,14 @@ button.pesquisa-coluna-remove:hover {
   min-height: 34px;
 }
 
+.pesquisa-results-toolbar-actions {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  flex-wrap: wrap;
+  margin-left: auto;
+}
+
 .pesquisa-select-all {
   display: inline-flex;
   align-items: center;
@@ -3064,6 +3086,66 @@ button.pesquisa-coluna-remove:hover {
   justify-content: space-between;
   align-items: flex-start;
   gap: 12px;
+  padding-bottom: 12px;
+  margin-bottom: 14px;
+  border-bottom: 1px solid #dbe5ef;
+}
+
+.pesquisa-opened-model-title-wrap {
+  flex: 1 1 320px;
+}
+
+.pesquisa-opened-model-actions {
+  display: flex;
+  align-items: center;
+  justify-content: flex-end;
+  gap: 10px;
+  flex-wrap: wrap;
+}
+
+.pesquisa-opened-model-action-btn {
+  min-height: 36px;
+  padding: 7px 12px;
+  font-size: 0.82rem;
+}
+
+.pesquisa-opened-model-action-btn-primary {
+  --btn-bg-start: #3f90d5;
+  --btn-bg-end: #2f79b8;
+  --btn-border: #2a6da8;
+  --btn-shadow-soft: rgba(42, 109, 168, 0.2);
+  --btn-shadow-strong: rgba(42, 109, 168, 0.28);
+  color: #fff;
+}
+
+.pesquisa-opened-model-action-btn-secondary {
+  --btn-bg-start: #f1f4f7;
+  --btn-bg-end: #e4e9ef;
+  --btn-border: #c6d0db;
+  --btn-shadow-soft: rgba(66, 84, 103, 0.12);
+  --btn-shadow-strong: rgba(66, 84, 103, 0.2);
+  color: #35506a;
+}
+
+.plot-card-toggle {
+  display: inline-flex;
+  align-items: center;
+  gap: 8px;
+  margin-top: 8px;
+  color: #42586e;
+  font-size: 0.8rem;
+  font-weight: 700;
+  position: relative;
+  z-index: 2;
+  pointer-events: auto;
+}
+
+.plot-card-toggle.is-disabled {
+  color: #7a8b9c;
+}
+
+.plot-card-toggle input {
+  margin: 0;
 }
 
 .pesquisa-opened-model-title-wrap h3 {
@@ -5521,6 +5603,7 @@ button.btn-upload-select {
   background: #fff;
   min-height: 420px;
   padding: 8px;
+  position: relative;
 }
 
 .plot-card-head {
@@ -5529,6 +5612,8 @@ button.btn-upload-select {
   display: grid;
   align-content: start;
   gap: 2px;
+  position: relative;
+  z-index: 2;
 }
 
 .plot-card-title {
@@ -5547,6 +5632,10 @@ button.btn-upload-select {
   line-height: 1.15;
 }
 
+.plot-card-body {
+  position: relative;
+}
+
 .plot-lazy-placeholder {
   min-height: 320px;
   display: flex;
@@ -6790,6 +6879,21 @@ button.btn-download-subtle {
     width: 100%;
   }
 
+  .pesquisa-results-toolbar-actions {
+    width: 100%;
+    justify-content: flex-end;
+    margin-left: 0;
+  }
+
+  .pesquisa-opened-model-head {
+    flex-direction: column;
+  }
+
+  .pesquisa-opened-model-actions {
+    width: 100%;
+    justify-content: flex-start;
+  }
+
   .pesquisa-select-all {
     white-space: normal;
   }