introducao do repositorio

README.md

@@ -53,3 +53,23 @@ Para apontar para outro backend:
 ```bash
 VITE_API_BASE=http://localhost:8000 npm run dev
 ```
+
+## Repositório de modelos `.dai`
+
+Os modelos usados em **Pesquisa**, **Elaboração** (carregar modelo existente) e
+**Visualização** (carregar modelo existente) podem vir de duas fontes:
+
+- `local` (pasta do projeto)
+- `hf_dataset` (dataset no Hugging Face)
+
+Variáveis de ambiente do backend:
+
+- `MODELOS_REPOSITORIO_PROVIDER` (`local` ou `hf_dataset`)
+- `MODELOS_REPOSITORIO_LOCAL_DIR` (opcional, quando `local`)
+- `MODELOS_REPOSITORIO_HF_REPO_ID` (ex.: `gui-sparim/repositorio_mesa`)
+- `MODELOS_REPOSITORIO_HF_REVISION` (ex.: `main`)
+- `MODELOS_REPOSITORIO_HF_SUBDIR` (ex.: `modelos_dai`)
+- `HF_TOKEN` (opcional para dataset privado)
+
+No modo `hf_dataset`, o backend consulta a revisão atual do dataset e só
+sincroniza novamente quando detectar mudança de revisão.

backend/app/api/elaboracao.py

@@ -128,6 +128,10 @@ class ColunaDataMercadoPayload(SessionPayload):
     coluna_data: str
 
 
+class RepositorioModeloPayload(SessionPayload):
+    modelo_id: str
+
+
 @router.post("/upload")
 async def upload_file(
     session_id: str = Form(...),
@@ -139,6 +143,17 @@ async def upload_file(
     return elaboracao_service.load_uploaded_file(session)
 
 
+@router.get("/repositorio-modelos")
+def repositorio_modelos() -> dict[str, Any]:
+    return elaboracao_service.listar_modelos_repositorio()
+
+
+@router.post("/repositorio-carregar")
+def repositorio_carregar(payload: RepositorioModeloPayload) -> dict[str, Any]:
+    session = session_store.get(payload.session_id)
+    return elaboracao_service.carregar_modelo_repositorio(session, payload.modelo_id)
+
+
 @router.post("/confirm-sheet")
 def confirm_sheet(payload: ConfirmSheetPayload) -> dict[str, Any]:
     session = session_store.get(payload.session_id)

backend/app/api/visualizacao.py

@@ -36,6 +36,10 @@ class AvaliacaoBasePayload(SessionPayload):
     indice_base: str | None = None
 
 
+class RepositorioModeloPayload(SessionPayload):
+    modelo_id: str
+
+
 @router.post("/upload")
 async def upload_file(
     session_id: str = Form(...),
@@ -47,6 +51,17 @@ async def upload_file(
     return visualizacao_service.carregar_modelo(session, caminho)
 
 
+@router.get("/repositorio-modelos")
+def repositorio_modelos() -> dict[str, Any]:
+    return visualizacao_service.listar_modelos_repositorio()
+
+
+@router.post("/repositorio-carregar")
+def repositorio_carregar(payload: RepositorioModeloPayload) -> dict[str, Any]:
+    session = session_store.get(payload.session_id)
+    return visualizacao_service.carregar_modelo_repositorio(session, payload.modelo_id)
+
+
 @router.post("/exibir")
 def exibir(payload: SessionPayload) -> dict[str, Any]:
     session = session_store.get(payload.session_id)

backend/app/core/pesquisa/modelos_dai/README.md

@@ -1,5 +1,8 @@
 # Pasta de Modelos da Aba Pesquisa
 
+Esta pasta é usada quando o provider de repositório de modelos está configurado
+como `local` (`MODELOS_REPOSITORIO_PROVIDER=local`).
+
 Coloque nesta pasta os arquivos `.dai` que devem aparecer na aba **Pesquisa**.
 
 ## Estrutura

backend/app/services/elaboracao_service.py

@@ -40,6 +40,7 @@ from app.core.elaboracao.formatadores import (
     formatar_outliers_anteriores_html,
 )
 from app.models.session import SessionState
+from app.services import model_repository
 from app.services.serializers import dataframe_to_payload, figure_to_payload, sanitize_value
 
 _AVALIADORES_PATH = Path(__file__).resolve().parent.parent / "core" / "elaboracao" / "avaliadores.json"
@@ -472,6 +473,17 @@ def load_uploaded_file(session: SessionState, selected_sheet: str | None = None)
     }
 
 
+def listar_modelos_repositorio() -> dict[str, Any]:
+    return sanitize_value(model_repository.list_repository_models())
+
+
+def carregar_modelo_repositorio(session: SessionState, modelo_id: str) -> dict[str, Any]:
+    caminho = model_repository.resolve_model_file(modelo_id)
+    session.uploaded_file_path = str(caminho)
+    session.uploaded_filename = caminho.name
+    return load_dai_for_elaboracao(session, str(caminho))
+
+
 def load_dai_for_elaboracao(session: SessionState, caminho_arquivo: str) -> dict[str, Any]:
     (
         df,

backend/app/services/model_repository.py

@@ -0,0 +1,271 @@
+from __future__ import annotations
+
+import os
+from dataclasses import dataclass
+from pathlib import Path
+from threading import Lock
+from typing import Any
+
+from fastapi import HTTPException
+
+try:
+    from huggingface_hub import HfApi, snapshot_download
+except Exception:  # pragma: no cover - dependência opcional em tempo de import
+    HfApi = None  # type: ignore[assignment]
+    snapshot_download = None  # type: ignore[assignment]
+
+
+DEFAULT_LOCAL_MODELOS_DIR = Path(__file__).resolve().parent.parent / "core" / "pesquisa" / "modelos_dai"
+DEFAULT_HF_REPO_ID = "gui-sparim/repositorio_mesa"
+DEFAULT_HF_REVISION = "main"
+DEFAULT_HF_SUBDIR = "modelos_dai"
+
+_STATE_LOCK = Lock()
+_STATE: dict[str, Any] = {
+    "provider": None,
+    "signature": None,
+    "revision": None,
+    "repo_id": None,
+    "subdir": None,
+    "modelos_dir": None,
+}
+
+
+@dataclass(frozen=True)
+class ModelRepositoryResolution:
+    provider: str
+    modelos_dir: Path
+    signature: str
+    revision: str | None = None
+    repo_id: str | None = None
+    subdir: str | None = None
+    degraded: bool = False
+
+    def as_payload(self) -> dict[str, Any]:
+        return {
+            "provider": self.provider,
+            "revision": self.revision,
+            "repo_id": self.repo_id,
+            "subdir": self.subdir,
+            "degraded": self.degraded,
+            "modelos_dir": str(self.modelos_dir),
+            "signature": self.signature,
+        }
+
+
+def _provider() -> str:
+    raw = (
+        os.getenv("MODELOS_REPOSITORIO_PROVIDER")
+        or os.getenv("PESQUISA_MODELOS_PROVIDER")
+        or "local"
+    )
+    value = str(raw).strip().lower()
+    if value in {"hf", "hf_dataset", "dataset", "huggingface"}:
+        return "hf_dataset"
+    return "local"
+
+
+def _hf_repo_id() -> str:
+    return str(
+        os.getenv("MODELOS_REPOSITORIO_HF_REPO_ID")
+        or os.getenv("PESQUISA_HF_REPO_ID")
+        or DEFAULT_HF_REPO_ID
+    ).strip()
+
+
+def _hf_revision() -> str:
+    return str(
+        os.getenv("MODELOS_REPOSITORIO_HF_REVISION")
+        or os.getenv("PESQUISA_HF_REVISION")
+        or DEFAULT_HF_REVISION
+    ).strip()
+
+
+def _hf_subdir() -> str:
+    return str(
+        os.getenv("MODELOS_REPOSITORIO_HF_SUBDIR")
+        or os.getenv("PESQUISA_HF_SUBDIR")
+        or DEFAULT_HF_SUBDIR
+    ).strip().strip("/")
+
+
+def _hf_token() -> str | None:
+    for key in ("HF_TOKEN", "HUGGINGFACE_HUB_TOKEN", "HUGGINGFACE_TOKEN"):
+        value = os.getenv(key)
+        if value:
+            return value
+    return None
+
+
+def _local_mode_models_dir() -> Path:
+    raw = os.getenv("MODELOS_REPOSITORIO_LOCAL_DIR")
+    if raw and str(raw).strip():
+        return Path(str(raw).strip()).expanduser().resolve()
+    return DEFAULT_LOCAL_MODELOS_DIR
+
+
+def _ensure_local_resolution() -> ModelRepositoryResolution:
+    modelos_dir = _local_mode_models_dir()
+    modelos_dir.mkdir(parents=True, exist_ok=True)
+    signature = f"local:{modelos_dir}"
+    return ModelRepositoryResolution(
+        provider="local",
+        modelos_dir=modelos_dir,
+        signature=signature,
+    )
+
+
+def _resolve_hf() -> ModelRepositoryResolution:
+    if HfApi is None or snapshot_download is None:
+        raise HTTPException(
+            status_code=500,
+            detail="Provider hf_dataset indisponivel: instale huggingface_hub no backend",
+        )
+
+    repo_id = _hf_repo_id()
+    revision_ref = _hf_revision()
+    subdir = _hf_subdir()
+    token = _hf_token()
+    pattern = f"{subdir}/*.dai"
+
+    api = HfApi(token=token)
+
+    try:
+        info = api.dataset_info(repo_id=repo_id, revision=revision_ref, token=token)
+    except Exception as exc:
+        with _STATE_LOCK:
+            snapshot_dir = _STATE.get("modelos_dir")
+            signature = _STATE.get("signature")
+            rev = _STATE.get("revision")
+            same_repo = _STATE.get("provider") == "hf_dataset" and _STATE.get("repo_id") == repo_id
+        if snapshot_dir and signature and same_repo and Path(snapshot_dir).exists():
+            return ModelRepositoryResolution(
+                provider="hf_dataset",
+                modelos_dir=Path(snapshot_dir),
+                signature=str(signature),
+                revision=str(rev) if rev else None,
+                repo_id=repo_id,
+                subdir=subdir,
+                degraded=True,
+            )
+        raise HTTPException(
+            status_code=503,
+            detail=f"Nao foi possivel consultar o repositório de modelos no Hugging Face: {exc}",
+        ) from exc
+
+    commit_sha = str(getattr(info, "sha", "") or "").strip() or revision_ref
+    signature = f"hf_dataset:{repo_id}@{commit_sha}:{subdir}"
+
+    with _STATE_LOCK:
+        current_signature = _STATE.get("signature")
+        current_dir = _STATE.get("modelos_dir")
+        if (
+            current_signature == signature
+            and current_dir
+            and Path(str(current_dir)).exists()
+        ):
+            return ModelRepositoryResolution(
+                provider="hf_dataset",
+                modelos_dir=Path(str(current_dir)),
+                signature=signature,
+                revision=commit_sha,
+                repo_id=repo_id,
+                subdir=subdir,
+            )
+
+    try:
+        snapshot_root = Path(
+            snapshot_download(
+                repo_id=repo_id,
+                repo_type="dataset",
+                revision=commit_sha,
+                allow_patterns=[pattern],
+                token=token,
+            )
+        )
+        modelos_dir = snapshot_root / subdir
+        if not modelos_dir.exists():
+            raise RuntimeError(f"Pasta '{subdir}' nao encontrada no snapshot '{commit_sha}'")
+    except Exception as exc:
+        with _STATE_LOCK:
+            fallback_dir = _STATE.get("modelos_dir")
+            fallback_signature = _STATE.get("signature")
+            fallback_rev = _STATE.get("revision")
+            same_repo = _STATE.get("provider") == "hf_dataset" and _STATE.get("repo_id") == repo_id
+        if fallback_dir and fallback_signature and same_repo and Path(str(fallback_dir)).exists():
+            return ModelRepositoryResolution(
+                provider="hf_dataset",
+                modelos_dir=Path(str(fallback_dir)),
+                signature=str(fallback_signature),
+                revision=str(fallback_rev) if fallback_rev else None,
+                repo_id=repo_id,
+                subdir=subdir,
+                degraded=True,
+            )
+        raise HTTPException(
+            status_code=503,
+            detail=f"Nao foi possivel sincronizar modelos do dataset no Hugging Face: {exc}",
+        ) from exc
+
+    with _STATE_LOCK:
+        _STATE.update(
+            {
+                "provider": "hf_dataset",
+                "signature": signature,
+                "revision": commit_sha,
+                "repo_id": repo_id,
+                "subdir": subdir,
+                "modelos_dir": str(modelos_dir),
+            }
+        )
+
+    return ModelRepositoryResolution(
+        provider="hf_dataset",
+        modelos_dir=modelos_dir,
+        signature=signature,
+        revision=commit_sha,
+        repo_id=repo_id,
+        subdir=subdir,
+    )
+
+
+def resolve_model_repository() -> ModelRepositoryResolution:
+    provider = _provider()
+    if provider == "hf_dataset":
+        return _resolve_hf()
+    return _ensure_local_resolution()
+
+
+def list_repository_models() -> dict[str, Any]:
+    resolved = resolve_model_repository()
+    modelos = sorted(resolved.modelos_dir.glob("*.dai"), key=lambda item: item.name.lower())
+    return {
+        "modelos": [
+            {
+                "id": caminho.stem,
+                "arquivo": caminho.name,
+                "nome_modelo": caminho.stem,
+            }
+            for caminho in modelos
+        ],
+        "total_modelos": len(modelos),
+        "fonte": resolved.as_payload(),
+    }
+
+
+def resolve_model_file(modelo_id: str) -> Path:
+    resolved = resolve_model_repository()
+    chave = str(modelo_id or "").strip()
+    if not chave:
+        raise HTTPException(status_code=400, detail="Informe o identificador do modelo")
+
+    modelos = sorted(resolved.modelos_dir.glob("*.dai"), key=lambda item: item.name.lower())
+    by_stem = {caminho.stem.lower(): caminho for caminho in modelos}
+    by_name = {caminho.name.lower(): caminho for caminho in modelos}
+
+    candidato = by_stem.get(chave.lower()) or by_name.get(chave.lower())
+    if candidato is None and not chave.lower().endswith(".dai"):
+        candidato = by_name.get(f"{chave.lower()}.dai")
+    if candidato is None:
+        raise HTTPException(status_code=404, detail="Modelo nao encontrado no repositório configurado")
+    return candidato

backend/app/services/pesquisa_service.py

@@ -17,9 +17,9 @@ from fastapi import HTTPException
 from joblib import load
 
 from app.core.elaboracao.core import _migrar_pacote_v1_para_v2
+from app.services import model_repository
 from app.services.serializers import sanitize_value
 
-MODELOS_DIR = Path(__file__).resolve().parent.parent / "core" / "pesquisa" / "modelos_dai"
 ADMIN_CONFIG_PATH = Path(__file__).resolve().parent.parent / "core" / "pesquisa" / "pesquisa_admin_config.json"
 
 AREA_PRIVATIVA_ALIASES = ["APRIV", "APRIVEQ", "ATPRIV", "ACOPRIV", "AREAPRIV", "AREA_PRIVATIVA", "AREA PRIVATIVA"]
@@ -192,15 +192,26 @@ class PesquisaFiltros:
 _CACHE_LOCK = Lock()
 _CACHE: dict[str, dict[str, Any]] = {}
 _ADMIN_CONFIG_LOCK = Lock()
+_CACHE_SOURCE_SIGNATURE: str | None = None
+
+
+def _resolver_repositorio_modelos() -> model_repository.ModelRepositoryResolution:
+    global _CACHE_SOURCE_SIGNATURE
+    resolved = model_repository.resolve_model_repository()
+    with _CACHE_LOCK:
+        if _CACHE_SOURCE_SIGNATURE != resolved.signature:
+            _CACHE.clear()
+            _CACHE_SOURCE_SIGNATURE = resolved.signature
+    return resolved
 
 
 def ensure_modelos_dir() -> Path:
-    MODELOS_DIR.mkdir(parents=True, exist_ok=True)
-    return MODELOS_DIR
+    return _resolver_repositorio_modelos().modelos_dir
 
 
 def obter_admin_config_pesquisa() -> dict[str, Any]:
-    pasta = ensure_modelos_dir()
+    resolved = _resolver_repositorio_modelos()
+    pasta = resolved.modelos_dir
     modelos = sorted(pasta.glob("*.dai"), key=lambda item: item.name.lower())
     todos = [_carregar_resumo_com_cache(caminho) for caminho in modelos]
     colunas_filtro = _montar_config_colunas_filtro(todos)
@@ -210,12 +221,14 @@ def obter_admin_config_pesquisa() -> dict[str, Any]:
             "colunas_filtro": colunas_filtro,
             "admin_fontes": admin_fontes,
             "total_modelos": len(todos),
+            "fonte_modelos": resolved.as_payload(),
         }
     )
 
 
 def salvar_admin_config_pesquisa(campos: dict[str, list[str]] | None) -> dict[str, Any]:
-    pasta = ensure_modelos_dir()
+    resolved = _resolver_repositorio_modelos()
+    pasta = resolved.modelos_dir
     modelos = sorted(pasta.glob("*.dai"), key=lambda item: item.name.lower())
     todos = [_carregar_resumo_com_cache(caminho) for caminho in modelos]
     colunas_filtro = _montar_config_colunas_filtro(todos)
@@ -227,12 +240,14 @@ def salvar_admin_config_pesquisa(campos: dict[str, list[str]] | None) -> dict[st
             "admin_fontes": admin_fontes,
             "total_modelos": len(todos),
             "status": "Configuracao de busca salva com sucesso.",
+            "fonte_modelos": resolved.as_payload(),
         }
     )
 
 
 def listar_modelos(filtros: PesquisaFiltros, limite: int | None = None, somente_contexto: bool = False) -> dict[str, Any]:
-    pasta = ensure_modelos_dir()
+    resolved = _resolver_repositorio_modelos()
+    pasta = resolved.modelos_dir
     modelos = sorted(pasta.glob("*.dai"), key=lambda item: item.name.lower())
 
     otica = _normalizar_otica(filtros.otica)
@@ -252,6 +267,7 @@ def listar_modelos(filtros: PesquisaFiltros, limite: int | None = None, somente_
                 "total_filtrado": 0,
                 "total_geral": len(todos),
                 "modelos_dir": str(pasta),
+                "fonte_modelos": resolved.as_payload(),
                 "admin_fontes": admin_fontes,
                 "filtros_aplicados": {
                     "nome": filtros.nome,
@@ -316,6 +332,7 @@ def listar_modelos(filtros: PesquisaFiltros, limite: int | None = None, somente_
             "total_filtrado": len(filtrados),
             "total_geral": len(todos),
             "modelos_dir": str(pasta),
+            "fonte_modelos": resolved.as_payload(),
             "admin_fontes": admin_fontes,
             "filtros_aplicados": {
                 "nome": filtros.nome,

backend/app/services/visualizacao_service.py

@@ -12,12 +12,24 @@ from app.core.visualizacao import app as viz_app
 from app.core.elaboracao.core import _migrar_pacote_v1_para_v2, avaliar_imovel, exportar_avaliacoes_excel
 from app.core.elaboracao.formatadores import formatar_avaliacao_html
 from app.models.session import SessionState
+from app.services import model_repository
 from app.services.serializers import dataframe_to_payload, figure_to_payload, sanitize_value
 
 
 CHAVES_ESPERADAS = ["versao", "dados", "transformacoes", "modelo"]
 
 
+def listar_modelos_repositorio() -> dict[str, Any]:
+    return sanitize_value(model_repository.list_repository_models())
+
+
+def carregar_modelo_repositorio(session: SessionState, modelo_id: str) -> dict[str, Any]:
+    caminho = model_repository.resolve_model_file(modelo_id)
+    session.uploaded_file_path = str(caminho)
+    session.uploaded_filename = caminho.name
+    return carregar_modelo(session, str(caminho))
+
+
 def carregar_modelo(session: SessionState, caminho_arquivo: str) -> dict[str, Any]:
     try:
         pacote = load(caminho_arquivo)

backend/requirements.txt

@@ -14,3 +14,4 @@ openpyxl
 geopandas
 fiona
 gradio>=4.0
+huggingface_hub>=0.30.0

frontend/src/api.js

@@ -83,6 +83,8 @@ export const api = {
     form.append('file', file)
     return postForm('/api/elaboracao/upload', form)
   },
+  elaboracaoRepositorioModelos: () => getJson('/api/elaboracao/repositorio-modelos'),
+  elaboracaoRepositorioCarregar: (sessionId, modeloId) => postJson('/api/elaboracao/repositorio-carregar', { session_id: sessionId, modelo_id: modeloId }),
 
   confirmSheet: (sessionId, sheetName) => postJson('/api/elaboracao/confirm-sheet', { session_id: sessionId, sheet_name: sheetName }),
   mapCoords: (sessionId, colLat, colLon) => postJson('/api/elaboracao/map-coords', { session_id: sessionId, col_lat: colLat, col_lon: colLon }),
@@ -164,6 +166,8 @@ export const api = {
     form.append('file', file)
     return postForm('/api/visualizacao/upload', form)
   },
+  visualizacaoRepositorioModelos: () => getJson('/api/visualizacao/repositorio-modelos'),
+  visualizacaoRepositorioCarregar: (sessionId, modeloId) => postJson('/api/visualizacao/repositorio-carregar', { session_id: sessionId, modelo_id: modeloId }),
   exibirVisualizacao: (sessionId) => postJson('/api/visualizacao/exibir', { session_id: sessionId }),
   updateVisualizacaoMap: (sessionId, variavelMapa) => postJson('/api/visualizacao/map/update', { session_id: sessionId, variavel_mapa: variavelMapa }),
   evaluationFieldsViz: (sessionId) => postJson('/api/visualizacao/evaluation/fields', { session_id: sessionId }),

frontend/src/components/ElaboracaoTab.jsx

@@ -544,6 +544,10 @@ export default function ElaboracaoTab({ sessionId }) {
   const [selectedSheet, setSelectedSheet] = useState('')
   const [elaborador, setElaborador] = useState(null)
   const [modeloCarregadoInfo, setModeloCarregadoInfo] = useState(null)
+  const [repoModelos, setRepoModelos] = useState([])
+  const [repoModeloSelecionado, setRepoModeloSelecionado] = useState('')
+  const [repoModelosLoading, setRepoModelosLoading] = useState(false)
+  const [repoFonteModelos, setRepoFonteModelos] = useState('')
 
   const [dados, setDados] = useState(null)
   const [mapaHtml, setMapaHtml] = useState('')
@@ -953,6 +957,34 @@ export default function ElaboracaoTab({ sessionId }) {
     }
   }, [sessionId])
 
+  useEffect(() => {
+    let ativo = true
+    if (!sessionId) return () => {
+      ativo = false
+    }
+
+    setRepoModelosLoading(true)
+    api.elaboracaoRepositorioModelos()
+      .then((resp) => {
+        if (!ativo) return
+        aplicarRespostaModelosRepositorio(resp)
+      })
+      .catch(() => {
+        if (!ativo) return
+        setRepoModelos([])
+        setRepoModeloSelecionado('')
+        setRepoFonteModelos('')
+      })
+      .finally(() => {
+        if (!ativo) return
+        setRepoModelosLoading(false)
+      })
+
+    return () => {
+      ativo = false
+    }
+  }, [sessionId])
+
   async function withBusy(fn) {
     setLoading(true)
     setError('')
@@ -980,6 +1012,45 @@ export default function ElaboracaoTab({ sessionId }) {
     })
   }
 
+  function formatarFonteRepositorio(fonte) {
+    if (!fonte || typeof fonte !== 'object') return ''
+    const provider = String(fonte.provider || '').toLowerCase()
+    if (provider === 'hf_dataset') {
+      const repo = String(fonte.repo_id || '').trim()
+      const revision = String(fonte.revision || '').trim()
+      const degradado = Boolean(fonte.degraded)
+      const sufixo = degradado ? ' (modo contingência)' : ''
+      return `Fonte: HF Dataset${repo ? ` (${repo})` : ''}${revision ? ` | revisão ${revision.slice(0, 8)}` : ''}${sufixo}`
+    }
+    return 'Fonte: pasta local'
+  }
+
+  function aplicarRespostaModelosRepositorio(resp) {
+    const modelos = Array.isArray(resp?.modelos) ? resp.modelos : []
+    setRepoModelos(modelos)
+    setRepoFonteModelos(formatarFonteRepositorio(resp?.fonte || null))
+    setRepoModeloSelecionado((prev) => {
+      const atual = String(prev || '')
+      if (atual && modelos.some((item) => String(item.id) === atual)) return atual
+      return String(modelos[0]?.id || '')
+    })
+  }
+
+  async function carregarModelosRepositorio() {
+    setRepoModelosLoading(true)
+    try {
+      const resp = await api.elaboracaoRepositorioModelos()
+      aplicarRespostaModelosRepositorio(resp)
+    } catch (err) {
+      setError(err.message || 'Falha ao carregar modelos do repositório.')
+      setRepoModelos([])
+      setRepoModeloSelecionado('')
+      setRepoFonteModelos('')
+    } finally {
+      setRepoModelosLoading(false)
+    }
+  }
+
   function applyBaseResponse(resp, options = {}) {
     const resetXSelection = Boolean(options.resetXSelection)
     const colunaYPadrao = String(resp.coluna_y_padrao || '')
@@ -1169,6 +1240,70 @@ export default function ElaboracaoTab({ sessionId }) {
     setBaseValue('')
   }
 
+  function aplicarRespostaCarregamento(resp, tipoFonteFallback = 'tabular') {
+    setManualMapError('')
+    setGeoProcessError('')
+    setGeoStatusHtml('')
+    setGeoFalhasHtml('')
+    setGeoCorrecoes([])
+    setElaborador(resp.elaborador || null)
+    setModeloCarregadoInfo(buildLoadedModelInfo(resp))
+    setAvaliadorSelecionado(resp.elaborador?.nome_completo || '')
+    setRequiresSheet(Boolean(resp.requires_sheet))
+    setSheetOptions(resp.sheets || [])
+    setSelectedSheet(resp.sheet_selected || '')
+
+    if (!resp.requires_sheet) {
+      const origemResp = String(resp.tipo || '').toLowerCase()
+      const tipoFonte = origemResp === 'dai'
+        ? 'dai'
+        : String(tipoFonteFallback || '').toLowerCase() === 'dai'
+          ? 'dai'
+          : 'tabular'
+      setTipoFonteDados(tipoFonte)
+      const resetXSelection = String(resp.tipo || '').toLowerCase() !== 'dai'
+      applyBaseResponse(resp, { resetXSelection })
+      return
+    }
+
+    if (resp.status) {
+      setTipoFonteDados('tabular')
+      setColunaY('')
+      setColunaYDraft('')
+      setSelection(null)
+      setFit(null)
+      setSelectionAppliedSnapshot(buildSelectionSnapshot())
+      setColunasX([])
+      setDicotomicas([])
+      setCodigoAlocado([])
+      setPercentuais([])
+      setTransformacaoY('(x)')
+      setTransformacoesX({})
+      setTransformacoesAplicadas(null)
+      setOrigemTransformacoes(null)
+      setBuscaTransformAppliedSnapshot(buildGrauSnapshot(0, 0))
+      setManualTransformAppliedSnapshot(buildTransformacoesSnapshot('(x)', {}))
+      setColunasDataMercado([])
+      setColunaDataMercadoSugerida('')
+      setColunaDataMercado('')
+      setColunaDataMercadoAplicada('')
+      setPeriodoDadosMercado(null)
+      setPeriodoDadosMercadoPreview(null)
+      setDataMercadoError('')
+      setFiltros(defaultFiltros())
+      setOutliersTexto('')
+      setReincluirTexto('')
+      setOutlierFiltrosAplicadosSnapshot(buildFiltrosSnapshot(defaultFiltros()))
+      setOutlierTextosAplicadosSnapshot(buildOutlierTextSnapshot('', ''))
+      setCamposAvaliacao([])
+      valoresAvaliacaoRef.current = {}
+      setAvaliacaoFormVersion((prev) => prev + 1)
+      setAvaliacaoPendente(false)
+      setResultadoAvaliacaoHtml('')
+      setStatus(resp.status)
+    }
+  }
+
   async function onUploadClick(arquivo = null) {
     const arquivoUpload = arquivo || uploadedFile
     if (!arquivoUpload || !sessionId) return
@@ -1180,58 +1315,20 @@ export default function ElaboracaoTab({ sessionId }) {
       const uploadEhDai = nomeArquivo.endsWith('.dai')
       setTipoFonteDados(uploadEhDai ? 'dai' : 'tabular')
       const resp = await api.uploadElaboracaoFile(sessionId, arquivoUpload)
-      setManualMapError('')
-      setGeoProcessError('')
-      setGeoStatusHtml('')
-      setGeoFalhasHtml('')
-      setGeoCorrecoes([])
-      setElaborador(resp.elaborador || null)
-      setModeloCarregadoInfo(buildLoadedModelInfo(resp))
-      setAvaliadorSelecionado(resp.elaborador?.nome_completo || '')
-      setRequiresSheet(Boolean(resp.requires_sheet))
-      setSheetOptions(resp.sheets || [])
-      setSelectedSheet(resp.sheet_selected || '')
-      if (!resp.requires_sheet) {
-        const origemResp = String(resp.tipo || '').toLowerCase()
-        setTipoFonteDados(origemResp === 'dai' ? 'dai' : 'tabular')
-        const resetXSelection = String(resp.tipo || '').toLowerCase() !== 'dai'
-        applyBaseResponse(resp, { resetXSelection })
-      } else if (resp.status) {
-        setTipoFonteDados('tabular')
-        setColunaY('')
-        setColunaYDraft('')
-        setSelection(null)
-        setFit(null)
-        setSelectionAppliedSnapshot(buildSelectionSnapshot())
-        setColunasX([])
-        setDicotomicas([])
-        setCodigoAlocado([])
-        setPercentuais([])
-        setTransformacaoY('(x)')
-        setTransformacoesX({})
-        setTransformacoesAplicadas(null)
-        setOrigemTransformacoes(null)
-        setBuscaTransformAppliedSnapshot(buildGrauSnapshot(0, 0))
-        setManualTransformAppliedSnapshot(buildTransformacoesSnapshot('(x)', {}))
-        setColunasDataMercado([])
-        setColunaDataMercadoSugerida('')
-        setColunaDataMercado('')
-        setColunaDataMercadoAplicada('')
-        setPeriodoDadosMercado(null)
-        setPeriodoDadosMercadoPreview(null)
-        setDataMercadoError('')
-        setFiltros(defaultFiltros())
-        setOutliersTexto('')
-        setReincluirTexto('')
-        setOutlierFiltrosAplicadosSnapshot(buildFiltrosSnapshot(defaultFiltros()))
-        setOutlierTextosAplicadosSnapshot(buildOutlierTextSnapshot('', ''))
-        setCamposAvaliacao([])
-        valoresAvaliacaoRef.current = {}
-        setAvaliacaoFormVersion((prev) => prev + 1)
-        setAvaliacaoPendente(false)
-        setResultadoAvaliacaoHtml('')
-        setStatus(resp.status)
-      }
+      aplicarRespostaCarregamento(resp, uploadEhDai ? 'dai' : 'tabular')
+    })
+  }
+
+  async function onCarregarModeloRepositorio() {
+    if (!sessionId || !repoModeloSelecionado) return
+    await withBusy(async () => {
+      setMapaGerado(false)
+      setMapaHtml('')
+      setGeoAuto200(true)
+      setTipoFonteDados('dai')
+      const resp = await api.elaboracaoRepositorioCarregar(sessionId, repoModeloSelecionado)
+      aplicarRespostaCarregamento(resp, 'dai')
+      setUploadedFile(null)
     })
   }
 
@@ -1963,6 +2060,32 @@ export default function ElaboracaoTab({ sessionId }) {
         <div className="section1-groups">
           <div className="subpanel section1-group">
             <h4>Carregar modelo</h4>
+            <div className="row upload-repo-row">
+              <label>Modelo do repositório</label>
+              <select
+                value={repoModeloSelecionado}
+                onChange={(e) => setRepoModeloSelecionado(e.target.value)}
+                disabled={loading || repoModelosLoading || repoModelos.length === 0}
+              >
+                <option value="">
+                  {repoModelosLoading ? 'Carregando lista...' : repoModelos.length > 0 ? 'Selecione um modelo' : 'Nenhum modelo disponível'}
+                </option>
+                {repoModelos.map((item) => (
+                  <option key={`repo-elab-${item.id}`} value={item.id}>
+                    {item.nome_modelo || item.arquivo}
+                  </option>
+                ))}
+              </select>
+              <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>
             <div
               className={`upload-dropzone${uploadDragOver ? ' is-dragover' : ''}`}
               onDragOver={onUploadDropZoneDragOver}

frontend/src/components/VisualizacaoTab.jsx

@@ -1,4 +1,4 @@
-import React, { useRef, useState } from 'react'
+import React, { useEffect, useRef, useState } from 'react'
 import { api, downloadBlob } from '../api'
 import DataTable from './DataTable'
 import LoadingOverlay from './LoadingOverlay'
@@ -27,6 +27,10 @@ export default function VisualizacaoTab({ sessionId }) {
 
   const [uploadedFile, setUploadedFile] = useState(null)
   const [uploadDragOver, setUploadDragOver] = useState(false)
+  const [repoModelos, setRepoModelos] = useState([])
+  const [repoModeloSelecionado, setRepoModeloSelecionado] = useState('')
+  const [repoModelosLoading, setRepoModelosLoading] = useState(false)
+  const [repoFonteModelos, setRepoFonteModelos] = useState('')
 
   const [dados, setDados] = useState(null)
   const [estatisticas, setEstatisticas] = useState(null)
@@ -129,6 +133,73 @@ export default function VisualizacaoTab({ sessionId }) {
     }
   }
 
+  function formatarFonteRepositorio(fonte) {
+    if (!fonte || typeof fonte !== 'object') return ''
+    const provider = String(fonte.provider || '').toLowerCase()
+    if (provider === 'hf_dataset') {
+      const repo = String(fonte.repo_id || '').trim()
+      const revision = String(fonte.revision || '').trim()
+      const degradado = Boolean(fonte.degraded)
+      const sufixo = degradado ? ' (modo contingência)' : ''
+      return `Fonte: HF Dataset${repo ? ` (${repo})` : ''}${revision ? ` | revisão ${revision.slice(0, 8)}` : ''}${sufixo}`
+    }
+    return 'Fonte: pasta local'
+  }
+
+  function aplicarRespostaModelosRepositorio(resp) {
+    const modelos = Array.isArray(resp?.modelos) ? resp.modelos : []
+    setRepoModelos(modelos)
+    setRepoFonteModelos(formatarFonteRepositorio(resp?.fonte || null))
+    setRepoModeloSelecionado((prev) => {
+      const atual = String(prev || '')
+      if (atual && modelos.some((item) => String(item.id) === atual)) return atual
+      return String(modelos[0]?.id || '')
+    })
+  }
+
+  async function carregarModelosRepositorio() {
+    setRepoModelosLoading(true)
+    try {
+      const resp = await api.visualizacaoRepositorioModelos()
+      aplicarRespostaModelosRepositorio(resp)
+    } catch (err) {
+      setError(err.message || 'Falha ao carregar modelos do repositório.')
+      setRepoModelos([])
+      setRepoModeloSelecionado('')
+      setRepoFonteModelos('')
+    } finally {
+      setRepoModelosLoading(false)
+    }
+  }
+
+  useEffect(() => {
+    let ativo = true
+    if (!sessionId) return () => {
+      ativo = false
+    }
+
+    setRepoModelosLoading(true)
+    api.visualizacaoRepositorioModelos()
+      .then((resp) => {
+        if (!ativo) return
+        aplicarRespostaModelosRepositorio(resp)
+      })
+      .catch(() => {
+        if (!ativo) return
+        setRepoModelos([])
+        setRepoModeloSelecionado('')
+        setRepoFonteModelos('')
+      })
+      .finally(() => {
+        if (!ativo) return
+        setRepoModelosLoading(false)
+      })
+
+    return () => {
+      ativo = false
+    }
+  }, [sessionId])
+
   async function onUploadModel(arquivo = null) {
     const arquivoUpload = arquivo || uploadedFile
     if (!sessionId || !arquivoUpload) return
@@ -143,6 +214,20 @@ export default function VisualizacaoTab({ sessionId }) {
     })
   }
 
+  async function onCarregarModeloRepositorio() {
+    if (!sessionId || !repoModeloSelecionado) return
+    await withBusy(async () => {
+      resetConteudoVisualizacao()
+      const uploadResp = await api.visualizacaoRepositorioCarregar(sessionId, repoModeloSelecionado)
+      setStatus(uploadResp.status || '')
+      setBadgeHtml(uploadResp.badge_html || '')
+
+      const exibirResp = await api.exibirVisualizacao(sessionId)
+      applyExibicaoResponse(exibirResp)
+      setUploadedFile(null)
+    })
+  }
+
   function onUploadInputChange(event) {
     const input = event.target
     const file = input.files?.[0] ?? null
@@ -277,6 +362,32 @@ export default function VisualizacaoTab({ sessionId }) {
   return (
     <div className="tab-content">
       <SectionBlock step="1" title="Carregar Modelo .dai" subtitle="Carregue o arquivo e o conteúdo será exibido automaticamente.">
+        <div className="row upload-repo-row">
+          <label>Modelo do repositório</label>
+          <select
+            value={repoModeloSelecionado}
+            onChange={(e) => setRepoModeloSelecionado(e.target.value)}
+            disabled={loading || repoModelosLoading || repoModelos.length === 0}
+          >
+            <option value="">
+              {repoModelosLoading ? 'Carregando lista...' : repoModelos.length > 0 ? 'Selecione um modelo' : 'Nenhum modelo disponível'}
+            </option>
+            {repoModelos.map((item) => (
+              <option key={`repo-viz-${item.id}`} value={item.id}>
+                {item.nome_modelo || item.arquivo}
+              </option>
+            ))}
+          </select>
+          <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>
         <div
           className={`upload-dropzone${uploadDragOver ? ' is-dragover' : ''}`}
           onDragOver={onUploadDropZoneDragOver}

frontend/src/styles.css

@@ -1345,6 +1345,14 @@ button:disabled {
   transition: border-color 0.15s ease, background 0.15s ease, box-shadow 0.15s ease;
 }
 
+.upload-repo-row {
+  margin-bottom: 10px;
+}
+
+.upload-repo-actions {
+  margin-top: 2px;
+}
+
 .upload-dropzone.is-dragover {
   border-color: #3b7fb8;
   background: linear-gradient(180deg, #f3f9ff 0%, #ebf4ff 100%);