inclusao do botao salvar no repositorio e do campo de obsercaoes

backend/app/api/elaboracao.py

@@ -144,6 +144,11 @@ class AvaliacaoBasePayload(SessionPayload):
 class ExportModeloPayload(SessionPayload):
     nome_arquivo: str
     elaborador: dict[str, Any] | None = None
+    observacao_modelo: str | None = None
+
+
+class SalvarModeloRepositorioPayload(ExportModeloPayload):
+    confirmar_substituicao: bool = False
 
 
 class UpdateMapaPayload(SessionPayload):
@@ -455,7 +460,12 @@ def listar_avaliadores() -> dict[str, Any]:
 @router.post("/export-model")
 def export_model(payload: ExportModeloPayload, request: Request) -> FileResponse:
     session = session_store.get(payload.session_id)
-    caminho, _ = elaboracao_service.exportar_modelo(session, payload.nome_arquivo, elaborador=payload.elaborador)
+    caminho, _ = elaboracao_service.exportar_modelo(
+        session,
+        payload.nome_arquivo,
+        elaborador=payload.elaborador,
+        observacao_modelo=payload.observacao_modelo,
+    )
     user = auth_service.require_user(request)
     log_event(
         "elaboracao",
@@ -472,6 +482,33 @@ def export_model(payload: ExportModeloPayload, request: Request) -> FileResponse
     )
 
 
+@router.post("/save-model-repository")
+def save_model_repository(payload: SalvarModeloRepositorioPayload, request: Request) -> dict[str, Any]:
+    session = session_store.get(payload.session_id)
+    user = auth_service.require_admin(request)
+    resposta = elaboracao_service.salvar_modelo_repositorio(
+        session,
+        payload.nome_arquivo,
+        elaborador=payload.elaborador,
+        observacao_modelo=payload.observacao_modelo,
+        actor=user.get("usuario"),
+        confirmar_substituicao=payload.confirmar_substituicao,
+    )
+    log_event(
+        "repositorio",
+        "salvar_modelo_repositorio_elaboracao",
+        user=user,
+        session_id=payload.session_id,
+        request=request,
+        details={
+            "nome_arquivo": payload.nome_arquivo,
+            "confirmar_substituicao": bool(payload.confirmar_substituicao),
+            "substituidos": resposta.get("resultado_upload", {}).get("substituidos", []),
+        },
+    )
+    return resposta
+
+
 @router.get("/export-base")
 def export_base(session_id: str, filtered: bool = True) -> FileResponse:
     session = session_store.get(session_id)

backend/app/core/elaboracao/carregamento.py

@@ -270,6 +270,7 @@ def carregar_dados_de_dai(caminho_arquivo):
         msg,
         sucesso,
         elaborador,
+        _observacao_modelo,
         outliers_excluidos,
         _periodo_dados_mercado,
         _config_avaliacao,

backend/app/core/elaboracao/core.py

@@ -376,12 +376,18 @@ def normalizar_config_avaliacao_modelo(config, df=None):
     }
 
 
+def normalizar_observacao_modelo(observacao):
+    """Normaliza a observação livre salva junto do modelo."""
+    texto = str(observacao or "").strip()
+    return texto or None
+
+
 def carregar_dai(caminho):
     """
     Carrega arquivo .dai e extrai DataFrame, variáveis e transformações.
 
     Retorna:
-        tuple: (df, coluna_y, colunas_x, transformacao_y, transformacoes_x, dicotomicas, codigo_alocado, percentuais, mensagem, sucesso, elaborador, outliers_excluidos, periodo_dados_mercado, config_avaliacao)
+        tuple: (df, coluna_y, colunas_x, transformacao_y, transformacoes_x, dicotomicas, codigo_alocado, percentuais, mensagem, sucesso, elaborador, observacao_modelo, outliers_excluidos, periodo_dados_mercado, config_avaliacao)
     """
     try:
         pacote = load(caminho)
@@ -458,6 +464,7 @@ def carregar_dai(caminho):
             df=df,
         )
         elaborador = pacote.get("elaborador", None)
+        observacao_modelo = normalizar_observacao_modelo(pacote.get("observacao_modelo"))
         msg = f"Modelo .dai carregado: {os.path.basename(caminho)} ({len(df)} dados, Y={coluna_y}, {len(colunas_x)} variáveis X)"
         return (
             df,
@@ -471,6 +478,7 @@ def carregar_dai(caminho):
             msg,
             True,
             elaborador,
+            observacao_modelo,
             outliers_excluidos,
             periodo_dados_mercado,
             config_avaliacao,
@@ -489,6 +497,7 @@ def carregar_dai(caminho):
             f"Erro ao carregar .dai: {str(e)}",
             False,
             None,
+            None,
             [],
             {"data_inicial": None, "data_final": None},
             {"tipo_y": None, "coluna_area": None},
@@ -2026,7 +2035,8 @@ def exportar_base_csv(df):
 
 def exportar_modelo_dai(resultado_modelo, df_original, df_completo=None, estatisticas=None,
                         nome_arquivo="", elaborador=None, outliers_excluidos=None,
-                        periodo_dados_mercado=None, tipo_y=None, coluna_area=None):
+                        periodo_dados_mercado=None, tipo_y=None, coluna_area=None,
+                        observacao_modelo=None):
     """
     Exporta o modelo em formato .dai v2 (estrutura nested).
 
@@ -2041,6 +2051,7 @@ def exportar_modelo_dai(resultado_modelo, df_original, df_completo=None, estatis
         periodo_dados_mercado: dict com data_inicial e data_final dos dados de mercado
         tipo_y: natureza do Y ("unitario" ou "total")
         coluna_area: nome da coluna de área usada nas conversões
+        observacao_modelo: texto livre associado ao modelo
 
     Retorna:
         tuple: (caminho_arquivo, mensagem)
@@ -2160,6 +2171,7 @@ def exportar_modelo_dai(resultado_modelo, df_original, df_completo=None, estatis
         pacote = {
             "versao": 2,
             "elaborador": elaborador,
+            "observacao_modelo": normalizar_observacao_modelo(observacao_modelo),
             "periodo_dados_mercado": _normalizar_periodo_dados_mercado(periodo_dados_mercado),
             "avaliacao": normalizar_config_avaliacao_modelo(
                 {"tipo_y": tipo_y, "coluna_area": coluna_area},

backend/app/core/visualizacao/app.py

@@ -1460,6 +1460,7 @@ def _formatar_badge_completo(pacote, nome_modelo=""):
         return texto
 
     model_name = str(nome_modelo or "").strip() or "-"
+    observacao_modelo = str(pacote.get("observacao_modelo") or "").strip()
 
     periodo = pacote.get("periodo_dados_mercado") or {}
     data_inicial = _data_br(periodo.get("data_inicial"))
@@ -1555,6 +1556,13 @@ def _formatar_badge_completo(pacote, nome_modelo=""):
             + (f"<div class='elaborador-badge-meta'>{_esc(meta_txt)}</div>" if meta_txt else "")
         )
     )
+    nome_modelo_html = (
+        "<div class='modelo-info-stack-block'>"
+        "<div class='elaborador-badge-title'>NOME DO MODELO:</div>"
+        f"<div class='elaborador-badge-name'>{_esc(model_name)}</div>"
+        + (f"<div class='elaborador-badge-meta'>{_esc(observacao_modelo)}</div>" if observacao_modelo else "")
+        + "</div>"
+    )
 
     return (
         "<div class='subpanel section1-group'>"
@@ -1562,10 +1570,7 @@ def _formatar_badge_completo(pacote, nome_modelo=""):
         "<div class='modelo-info-card'>"
         "<div class='modelo-info-split'>"
         "<div class='modelo-info-col'>"
-        "<div class='modelo-info-stack-block'>"
-        "<div class='elaborador-badge-title'>NOME DO MODELO:</div>"
-        f"<div class='elaborador-badge-name'>{_esc(model_name)}</div>"
-        "</div>"
+        + nome_modelo_html +
         "<div class='modelo-info-stack-block'>"
         "<div class='elaborador-badge-title'>ELABORADO POR:</div>"
         + elaborador_html +

backend/app/models/session.py

@@ -56,6 +56,7 @@ class SessionState:
     graficos_dispersao_cache: dict[str, dict[str, Any]] = field(default_factory=dict)
 
     elaborador: dict[str, Any] | None = None
+    observacao_modelo: str | None = None
 
     def reset_modelo(self) -> None:
         self.resultados_busca = []
@@ -66,6 +67,7 @@ class SessionState:
         self.transformacao_y = "(x)"
         self.transformacoes_x = {}
         self.graficos_dispersao_cache = {}
+        self.observacao_modelo = None
 
     def reset_visualizacao(self) -> None:
         self.pacote_visualizacao = None

backend/app/services/elaboracao_service.py

@@ -39,6 +39,7 @@ from app.core.elaboracao.core import (
     exportar_base_csv,
     exportar_modelo_dai,
     identificar_coluna_y_padrao,
+    normalizar_observacao_modelo,
     obter_colunas_numericas,
     avaliar_imovel,
     testar_micronumerosidade,
@@ -1011,6 +1012,7 @@ def load_dai_for_elaboracao(session: SessionState, caminho_arquivo: str) -> dict
         msg,
         sucesso,
         elaborador,
+        observacao_modelo,
         outliers_excluidos,
         periodo_dados_mercado,
         config_avaliacao,
@@ -1020,10 +1022,12 @@ def load_dai_for_elaboracao(session: SessionState, caminho_arquivo: str) -> dict
         raise HTTPException(status_code=400, detail=msg)
 
     session.elaborador = elaborador
+    observacao_modelo_normalizada = normalizar_observacao_modelo(observacao_modelo)
     outliers_carregados = _clean_int_list(outliers_excluidos)
     periodo_normalizado = _normalizar_periodo_dados_mercado(periodo_dados_mercado)
 
     base = _set_dataframe_base(session, df, clear_models=True)
+    session.observacao_modelo = observacao_modelo_normalizada
     session.coluna_data_mercado = periodo_normalizado["coluna_data"]
     session.periodo_dados_mercado_inicio = periodo_normalizado["data_inicial"]
     session.periodo_dados_mercado_fim = periodo_normalizado["data_final"]
@@ -1069,6 +1073,7 @@ def load_dai_for_elaboracao(session: SessionState, caminho_arquivo: str) -> dict
         "outliers_html": html_outliers,
         "contexto": _selection_context(session),
         "elaborador": sanitize_value(elaborador),
+        "observacao_modelo": sanitize_value(observacao_modelo_normalizada),
         **_payload_data_mercado(session),
     }
 
@@ -2373,7 +2378,12 @@ def aplicar_coluna_data_mercado(session: SessionState, coluna_data: str) -> dict
     }
 
 
-def exportar_modelo(session: SessionState, nome_arquivo: str, elaborador: dict[str, Any] | None = None) -> tuple[str, str]:
+def exportar_modelo(
+    session: SessionState,
+    nome_arquivo: str,
+    elaborador: dict[str, Any] | None = None,
+    observacao_modelo: str | None = None,
+) -> tuple[str, str]:
     if session.resultado_modelo is None:
         raise HTTPException(status_code=400, detail="Ajuste um modelo antes de exportar")
     if session.df_filtrado is None or session.df_original is None:
@@ -2382,6 +2392,10 @@ def exportar_modelo(session: SessionState, nome_arquivo: str, elaborador: dict[s
     if not nome_arquivo or not nome_arquivo.strip():
         raise HTTPException(status_code=400, detail="Informe o nome do arquivo")
 
+    session.observacao_modelo = normalizar_observacao_modelo(
+        observacao_modelo if observacao_modelo is not None else session.observacao_modelo
+    )
+
     caminho, msg = exportar_modelo_dai(
         session.resultado_modelo,
         session.df_filtrado,
@@ -2397,6 +2411,7 @@ def exportar_modelo(session: SessionState, nome_arquivo: str, elaborador: dict[s
         },
         tipo_y=session.tipo_y,
         coluna_area=session.coluna_area,
+        observacao_modelo=session.observacao_modelo,
     )
 
     if not caminho:
@@ -2405,6 +2420,46 @@ def exportar_modelo(session: SessionState, nome_arquivo: str, elaborador: dict[s
     return caminho, msg
 
 
+def salvar_modelo_repositorio(
+    session: SessionState,
+    nome_arquivo: str,
+    elaborador: dict[str, Any] | None = None,
+    observacao_modelo: str | None = None,
+    actor: str | None = None,
+    confirmar_substituicao: bool = False,
+) -> dict[str, Any]:
+    resolved = model_repository.resolve_model_repository()
+    if resolved.provider != "hf_dataset":
+        raise HTTPException(
+            status_code=400,
+            detail="Salvar direto no repositorio so esta disponivel quando o repositorio usa HF Dataset.",
+        )
+
+    caminho, _ = exportar_modelo(
+        session,
+        nome_arquivo,
+        elaborador=elaborador,
+        observacao_modelo=observacao_modelo,
+    )
+    arquivo = Path(caminho)
+    if not arquivo.exists():
+        raise HTTPException(status_code=500, detail="Falha ao gerar o arquivo .dai para envio ao repositorio.")
+
+    resultado = model_repository.upsert_repository_models(
+        [(arquivo.name, arquivo.read_bytes())],
+        actor=actor,
+        confirmar_substituicao=confirmar_substituicao,
+    )
+    contexto = listar_modelos_repositorio()
+    return sanitize_value(
+        {
+            "status": "Modelo salvo no repositorio.",
+            "resultado_upload": resultado,
+            **contexto,
+        }
+    )
+
+
 def exportar_base(session: SessionState, usar_filtrado: bool = True) -> str:
     df = session.df_filtrado if usar_filtrado else session.df_original
     caminho = exportar_base_csv(df)

backend/app/services/visualizacao_service.py

@@ -20,6 +20,7 @@ from app.core.elaboracao.core import (
     exportar_avaliacoes_excel,
     normalizar_coluna_area,
     normalizar_config_avaliacao_modelo,
+    normalizar_observacao_modelo,
 )
 from app.core.elaboracao.formatadores import formatar_avaliacao_html
 from app.models.session import SessionState
@@ -253,6 +254,7 @@ def carregar_modelo(session: SessionState, caminho_arquivo: str) -> dict[str, An
         "status": "",
         "badge_html": badge_html,
         "nome_modelo": nome_modelo,
+        "observacao_modelo": normalizar_observacao_modelo(pacote.get("observacao_modelo")),
     }
 
 
@@ -297,6 +299,7 @@ def _extrair_modelo_info(pacote: dict[str, Any]) -> dict[str, Any]:
         "nome_y": nome_y.strip(),
         "tipo_y": config_avaliacao.get("tipo_y"),
         "coluna_area": config_avaliacao.get("coluna_area"),
+        "observacao_modelo": normalizar_observacao_modelo(pacote.get("observacao_modelo")),
         "transformacao_y": transformacao_y,
         "colunas_x": colunas_x,
         "transformacoes_x": transformacoes_x,

frontend/src/App.jsx

@@ -587,7 +587,7 @@ export default function App() {
           </div>
 
           <div className="tab-pane" hidden={activeTab !== 'Elaboração/Edição'}>
-            <ElaboracaoTab sessionId={sessionId} />
+            <ElaboracaoTab sessionId={sessionId} authUser={authUser} />
           </div>
 
           <div className="tab-pane" hidden={activeTab !== 'Repositório de Modelos'}>

frontend/src/api.js

@@ -270,16 +270,28 @@ export const api = {
   }),
   exportEvaluationElab: async (sessionId) => getBlob(`/api/elaboracao/evaluation/export?session_id=${encodeURIComponent(sessionId)}`),
   exportEquationElab: async (sessionId, mode = 'excel') => getBlob(`/api/elaboracao/equation/export?session_id=${encodeURIComponent(sessionId)}&mode=${encodeURIComponent(String(mode || 'excel'))}`),
-  exportModel: async (sessionId, nomeArquivo, elaborador) => {
+  exportModel: async (sessionId, nomeArquivo, elaborador, observacaoModelo = '') => {
     const path = '/api/elaboracao/export-model'
     const response = await fetchWithDiagnostics(path, {
       method: 'POST',
       headers: authHeaders({ 'Content-Type': 'application/json' }),
-      body: JSON.stringify({ session_id: sessionId, nome_arquivo: nomeArquivo, elaborador }),
+      body: JSON.stringify({
+        session_id: sessionId,
+        nome_arquivo: nomeArquivo,
+        elaborador,
+        observacao_modelo: observacaoModelo,
+      }),
     })
     await handleResponse(response, path)
     return responseBlobWithDiagnostics(response, path)
   },
+  saveModelRepository: (sessionId, nomeArquivo, elaborador, observacaoModelo = '', confirmarSubstituicao = false) => postJson('/api/elaboracao/save-model-repository', {
+    session_id: sessionId,
+    nome_arquivo: nomeArquivo,
+    elaborador,
+    observacao_modelo: observacaoModelo,
+    confirmar_substituicao: confirmarSubstituicao,
+  }),
   exportBase: (sessionId, filtered = true) => getBlob(`/api/elaboracao/export-base?session_id=${encodeURIComponent(sessionId)}&filtered=${String(filtered)}`),
   updateElaboracaoMap: (sessionId, variavelMapa, modoMapa = 'pontos') => postJson('/api/elaboracao/map/update', {
     session_id: sessionId,

frontend/src/components/AvaliacaoTab.jsx

@@ -444,6 +444,19 @@ function formatarFonteRepositorio(fonte) {
   return 'Fonte: pasta local'
 }
 
+function removerObservacaoDoBadgeHtml(html) {
+  const markup = String(html || '').trim()
+  if (!markup || typeof document === 'undefined') return markup
+
+  const root = document.createElement('div')
+  root.innerHTML = markup
+  const observacao = root.querySelector('.modelo-info-stack-block:first-child .elaborador-badge-meta')
+  if (observacao) {
+    observacao.remove()
+  }
+  return root.innerHTML
+}
+
 const BASE_COMPARACAO_SEM_BASE = '__none__'
 
 export default function AvaliacaoTab({ sessionId, quickLoadRequest = null }) {
@@ -451,6 +464,7 @@ export default function AvaliacaoTab({ sessionId, quickLoadRequest = null }) {
   const [error, setError] = useState('')
   const [status, setStatus] = useState('')
   const [badgeHtml, setBadgeHtml] = useState('')
+  const [modeloObservacao, setModeloObservacao] = useState('')
 
   const [uploadedFile, setUploadedFile] = useState(null)
   const [uploadDragOver, setUploadDragOver] = useState(false)
@@ -688,6 +702,7 @@ export default function AvaliacaoTab({ sessionId, quickLoadRequest = null }) {
     resetCamposAvaliacao(campos)
     setEquacaoSab(String(resp?.equacoes?.excel_sab || ''))
     setModeloAtualNome(String(nomeModelo || '').trim())
+    setModeloObservacao(String(resp?.meta_modelo?.observacao_modelo || '').trim())
   }
 
   async function withBusy(fn) {
@@ -730,7 +745,7 @@ export default function AvaliacaoTab({ sessionId, quickLoadRequest = null }) {
     await withBusy(async () => {
       const uploadResp = await api.uploadVisualizacaoFile(sessionId, arquivoUpload)
       setStatus(uploadResp?.status || '')
-      setBadgeHtml(uploadResp?.badge_html || '')
+      setBadgeHtml(removerObservacaoDoBadgeHtml(uploadResp?.badge_html || ''))
       const nomeModelo = uploadResp?.nome_modelo || arquivoUpload.name || ''
       const contextoResp = await api.evaluationContextViz(sessionId)
       aplicarRespostaExibicao(contextoResp, nomeModelo)
@@ -753,7 +768,7 @@ export default function AvaliacaoTab({ sessionId, quickLoadRequest = null }) {
       const tentativas = [alvoModeloId, ...(fallbackChaves || [])]
       const { uploadResp, modeloIdUsado } = await carregarModeloRepositorioComFallback(tentativas)
       setStatus(uploadResp?.status || '')
-      setBadgeHtml(uploadResp?.badge_html || '')
+      setBadgeHtml(removerObservacaoDoBadgeHtml(uploadResp?.badge_html || ''))
       setRepoModeloSelecionado(modeloIdUsado)
       const modeloSelecionado = repoModeloOptions.find((item) => item.value === modeloIdUsado)
       const nomeModelo = uploadResp?.nome_modelo || modeloSelecionado?.label || ''
@@ -1110,6 +1125,12 @@ export default function AvaliacaoTab({ sessionId, quickLoadRequest = null }) {
         )}
         {status ? <div className="status-line">{status}</div> : null}
         {badgeHtml ? <div className="upload-badge-block" dangerouslySetInnerHTML={{ __html: badgeHtml }} /> : null}
+        {modeloObservacao ? (
+          <div className="elaborador-badge modelo-observacao-badge">
+            <div className="elaborador-badge-title">OBSERVAÇÃO</div>
+            <div className="modelo-observacao-text">{modeloObservacao}</div>
+          </div>
+        ) : null}
         </div>
 
         {!modeloPronto ? (

frontend/src/components/ElaboracaoTab.jsx

@@ -745,6 +745,7 @@ function buildLoadedModelInfo(resp) {
 
   return {
     nome_modelo: nomeModelo,
+    observacao_modelo: String(resp?.observacao_modelo || '').trim(),
     coluna_y: colunaY,
     tipo_y: normalizarTipoY(contexto.tipo_y),
     coluna_area: String(contexto.coluna_area || '').trim(),
@@ -859,7 +860,7 @@ function DiagnosticPngCard({ title, pngPayload, alt }) {
   )
 }
 
-export default function ElaboracaoTab({ sessionId }) {
+export default function ElaboracaoTab({ sessionId, authUser }) {
   const [loading, setLoading] = useState(false)
   const [downloadingAssets, setDownloadingAssets] = useState(false)
   const [error, setError] = useState('')
@@ -877,6 +878,7 @@ export default function ElaboracaoTab({ sessionId }) {
   const [repoModelos, setRepoModelos] = useState([])
   const [repoModeloSelecionado, setRepoModeloSelecionado] = useState('')
   const [repoModelosLoading, setRepoModelosLoading] = useState(false)
+  const [repoFonteInfo, setRepoFonteInfo] = useState(null)
   const [repoFonteModelos, setRepoFonteModelos] = useState('')
   const [repoModeloDropdownOpen, setRepoModeloDropdownOpen] = useState(false)
 
@@ -984,8 +986,10 @@ export default function ElaboracaoTab({ sessionId }) {
   const [knnDetalheInfo, setKnnDetalheInfo] = useState(null)
 
   const [nomeArquivoExport, setNomeArquivoExport] = useState('')
+  const [observacaoModelo, setObservacaoModelo] = useState('')
   const [avaliadores, setAvaliadores] = useState([])
   const [avaliadorSelecionado, setAvaliadorSelecionado] = useState('')
+  const [repositorioSaveStatus, setRepositorioSaveStatus] = useState('')
   const [tipoFonteDados, setTipoFonteDados] = useState('')
   const [selectionAppliedSnapshot, setSelectionAppliedSnapshot] = useState(() => buildSelectionSnapshot())
   const [buscaTransformAppliedSnapshot, setBuscaTransformAppliedSnapshot] = useState(() => buildGrauSnapshot(0, 0))
@@ -1027,6 +1031,14 @@ export default function ElaboracaoTab({ sessionId }) {
     [colunasX, colunasXDisponiveis],
   )
   const conselhoRegistro = useMemo(() => formatConselhoRegistro(elaborador), [elaborador])
+  const repositorioUploadAdminHabilitado = useMemo(
+    () => String(authUser?.perfil || '').toLowerCase() === 'admin',
+    [authUser],
+  )
+  const repositorioSalvamentoDiretoHabilitado = useMemo(
+    () => repositorioUploadAdminHabilitado && String(repoFonteInfo?.provider || '').toLowerCase() === 'hf_dataset',
+    [repoFonteInfo, repositorioUploadAdminHabilitado],
+  )
   const elaboradorMeta = useMemo(() => {
     if (!elaborador) return []
     return [elaborador.cargo, conselhoRegistro, elaborador.matricula_sem_digito ? `Matricula ${elaborador.matricula_sem_digito}` : '', elaborador.lotacao].filter(Boolean)
@@ -1901,6 +1913,7 @@ export default function ElaboracaoTab({ sessionId }) {
         if (!ativo) return
         setRepoModelos([])
         setRepoModeloSelecionado('')
+        setRepoFonteInfo(null)
         setRepoFonteModelos('')
       })
       .finally(() => {
@@ -1966,9 +1979,19 @@ export default function ElaboracaoTab({ sessionId }) {
     return 'Fonte: pasta local'
   }
 
+  function parseSubstituidosErro(err) {
+    if (!err || typeof err !== 'object') return []
+    const detail = err.detail
+    if (!detail || typeof detail !== 'object') return []
+    const lista = detail.substituidos
+    if (!Array.isArray(lista)) return []
+    return lista.map((item) => String(item || '').trim()).filter(Boolean)
+  }
+
   function aplicarRespostaModelosRepositorio(resp) {
     const modelos = Array.isArray(resp?.modelos) ? resp.modelos : []
     setRepoModelos(modelos)
+    setRepoFonteInfo(resp?.fonte || null)
     setRepoFonteModelos(formatarFonteRepositorio(resp?.fonte || null))
     setRepoModeloSelecionado((prev) => {
       const atual = String(prev || '')
@@ -1988,6 +2011,7 @@ export default function ElaboracaoTab({ sessionId }) {
       setImportacaoErro(err.message || 'Falha ao carregar modelos do repositório.')
       setRepoModelos([])
       setRepoModeloSelecionado('')
+      setRepoFonteInfo(null)
       setRepoFonteModelos('')
     } finally {
       setRepoModelosLoading(false)
@@ -2273,6 +2297,7 @@ export default function ElaboracaoTab({ sessionId }) {
     setGeoFalhasHtml('')
     setGeoCorrecoes([])
     setElaborador(resp.elaborador || null)
+    setObservacaoModelo(String(resp?.observacao_modelo || '').trim())
     setModeloCarregadoInfo(buildLoadedModelInfo(resp))
     setAvaliadorSelecionado(resp.elaborador?.nome_completo || '')
     const fileName = String(meta.fileName || uploadedFile?.name || arquivoCarregadoInfo?.nome_arquivo || '').trim()
@@ -2477,6 +2502,7 @@ export default function ElaboracaoTab({ sessionId }) {
       setGeoFalhasHtml('')
       setGeoCorrecoes([])
       setElaborador(resp.elaborador || null)
+      setObservacaoModelo(String(resp?.observacao_modelo || '').trim())
       setModeloCarregadoInfo(null)
       setAvaliadorSelecionado(resp.elaborador?.nome_completo || '')
       setRequiresSheet(false)
@@ -3245,12 +3271,71 @@ export default function ElaboracaoTab({ sessionId }) {
     const nomeExport = String(nomeArquivoExport || '').trim()
     if (!sessionId || !nomeExport) return
     await withBusy(async () => {
+      setRepositorioSaveStatus('')
       const avaliadorEscolhido = avaliadores.find((item) => item.nome_completo === avaliadorSelecionado) || null
-      const blob = await api.exportModel(sessionId, nomeExport, avaliadorEscolhido || elaborador || null)
+      const blob = await api.exportModel(
+        sessionId,
+        nomeExport,
+        avaliadorEscolhido || elaborador || null,
+        String(observacaoModelo || '').trim(),
+      )
       downloadBlob(blob, `${nomeExport.replace(/\.dai$/i, '')}.dai`)
     })
   }
 
+  async function onSaveModelRepository() {
+    const nomeExport = String(nomeArquivoExport || '').trim()
+    if (!sessionId || !nomeExport || !repositorioSalvamentoDiretoHabilitado) return
+
+    const senha = window.prompt('Digite a senha para salvar o modelo diretamente no repositório:')
+    if (senha === null) return
+    if (senha !== '123456') {
+      setRepositorioSaveStatus('')
+      setError('Senha incorreta para salvar no repositório.')
+      return
+    }
+
+    const avaliadorEscolhido = avaliadores.find((item) => item.nome_completo === avaliadorSelecionado) || null
+    const elaboradorPayload = avaliadorEscolhido || elaborador || null
+    const observacaoTexto = String(observacaoModelo || '').trim()
+
+    setLoading(true)
+    setError('')
+    setRepositorioSaveStatus('')
+    try {
+      const salvar = async (confirmarSubstituicao) => {
+        const resp = await api.saveModelRepository(
+          sessionId,
+          nomeExport,
+          elaboradorPayload,
+          observacaoTexto,
+          confirmarSubstituicao,
+        )
+        aplicarRespostaModelosRepositorio(resp)
+        setRepositorioSaveStatus(resp?.status || 'Modelo salvo no repositorio.')
+      }
+
+      try {
+        await salvar(false)
+      } catch (err) {
+        const substituidos = parseSubstituidosErro(err)
+        const erroDuplicado = Number(err?.status) === 409 && substituidos.length > 0
+        if (!erroDuplicado) throw err
+
+        const nomes = substituidos.join(', ')
+        const confirma = window.confirm(
+          `Ja existe modelo com este nome no repositorio (${nomes}). Deseja sobrescrever?`,
+        )
+        if (!confirma) return
+        await salvar(true)
+      }
+    } catch (err) {
+      setError(err?.message || 'Falha ao salvar modelo no repositorio.')
+    } finally {
+      setLoading(false)
+    }
+  }
+
   async function onExportBase() {
     if (!sessionId) return
     await withBusy(async () => {
@@ -3903,6 +3988,12 @@ export default function ElaboracaoTab({ sessionId }) {
                       </div>
                     </div>
                   </div>
+                  {modeloCarregadoInfo.observacao_modelo ? (
+                    <div className="elaborador-badge modelo-observacao-badge">
+                      <div className="elaborador-badge-title">OBSERVAÇÃO</div>
+                      <div className="modelo-observacao-text">{modeloCarregadoInfo.observacao_modelo}</div>
+                    </div>
+                  ) : null}
                 </>
               ) : null}
             </div>
@@ -5830,26 +5921,94 @@ export default function ElaboracaoTab({ sessionId }) {
           </SectionBlock>
 
           <SectionBlock step="19" title="Exportar Modelo" subtitle="Geração do pacote .dai e download da base tratada.">
-            <div className="row">
-              <label>Nome do arquivo (.dai)</label>
-              <input
-                type="text"
-                value={nomeArquivoExport}
-                onChange={(e) => setNomeArquivoExport(e.target.value)}
-                placeholder="Digite o nome do arquivo"
-              />
-              <label>Avaliador</label>
-              <select value={avaliadorSelecionado} onChange={(e) => setAvaliadorSelecionado(e.target.value)}>
-                <option value="">Manter elaborador do modelo (se houver)</option>
-                {avaliadores.map((item) => (
-                  <option key={`aval-exp-${item.nome_completo}`} value={item.nome_completo}>
-                    {item.nome_completo}
-                  </option>
-                ))}
-              </select>
-              <button onClick={onExportModel} disabled={loading || !String(nomeArquivoExport || '').trim()}>Exportar modelo</button>
-              <button onClick={onExportBase} disabled={loading}>Exportar base CSV</button>
+            <div className="export-model-layout">
+              <div className="export-model-note-card">
+                <div className="export-model-note-head">
+                  <label htmlFor="elaboracao-observacao-modelo" className="export-model-note-label">Observação do modelo</label>
+                  <p className="export-model-note-help">
+                    Esse texto será salvo e apresentado quando o modelo for visualizado.
+                  </p>
+                </div>
+                <textarea
+                  id="elaboracao-observacao-modelo"
+                  className="export-model-note-input"
+                  value={observacaoModelo}
+                  onChange={(e) => setObservacaoModelo(e.target.value)}
+                  placeholder="Informações relevantes que podem ser úteis ao usuário do modelo."
+                  rows={4}
+                />
+              </div>
+
+              <div className="export-model-actions-card">
+                <div className="export-model-fields">
+                  <label className="export-model-field">
+                    <span>Nome do arquivo (.dai)</span>
+                    <input
+                      type="text"
+                      value={nomeArquivoExport}
+                      onChange={(e) => setNomeArquivoExport(e.target.value)}
+                      placeholder="Digite o nome do arquivo"
+                    />
+                  </label>
+
+                  <label className="export-model-field">
+                    <span>Avaliador</span>
+                    <select value={avaliadorSelecionado} onChange={(e) => setAvaliadorSelecionado(e.target.value)}>
+                      <option value="">Manter elaborador do modelo (se houver)</option>
+                      {avaliadores.map((item) => (
+                        <option key={`aval-exp-${item.nome_completo}`} value={item.nome_completo}>
+                          {item.nome_completo}
+                        </option>
+                      ))}
+                    </select>
+                  </label>
+                </div>
+
+                <div className="export-model-buttons">
+                  <button
+                    type="button"
+                    className="export-model-btn-primary"
+                    onClick={onExportModel}
+                    disabled={loading || !String(nomeArquivoExport || '').trim()}
+                  >
+                    Exportar modelo
+                  </button>
+                  <button
+                    type="button"
+                    className="export-model-btn-repo"
+                    onClick={onSaveModelRepository}
+                    disabled={loading || !String(nomeArquivoExport || '').trim() || !repositorioSalvamentoDiretoHabilitado}
+                    title={
+                      !repositorioUploadAdminHabilitado
+                        ? 'Disponivel apenas para administradores.'
+                        : !repositorioSalvamentoDiretoHabilitado
+                          ? 'Disponivel apenas quando o repositorio usa HF Dataset.'
+                          : ''
+                    }
+                  >
+                    Salvar no repositorio
+                  </button>
+                  <button
+                    type="button"
+                    className="export-model-btn-base"
+                    onClick={onExportBase}
+                    disabled={loading}
+                  >
+                    Exportar base CSV
+                  </button>
+                </div>
+              </div>
+            </div>
+            <div className="section1-empty-hint export-model-hint">
+              {repoModelosLoading
+                ? 'Verificando fonte do repositório...'
+                : !repositorioUploadAdminHabilitado
+                  ? 'Salvar no repositório fica disponível apenas para administradores.'
+                  : repositorioSalvamentoDiretoHabilitado
+                  ? `Salvamento direto habilitado. ${repoFonteModelos || ''}`.trim()
+                  : 'Salvar no repositório fica desabilitado na versão local.'}
             </div>
+            {repositorioSaveStatus ? <div className="section1-empty-hint export-model-status">{repositorioSaveStatus}</div> : null}
           </SectionBlock>
         </>
       ) : null}

frontend/src/components/PesquisaTab.jsx

@@ -679,6 +679,7 @@ export default function PesquisaTab({ sessionId, onUsarModeloEmAvaliacao = null
       setModeloAbertoMeta({
         id: modelo.id,
         nome: modelo.nome_modelo || modelo.arquivo || modelo.id,
+        observacao: String(resp?.meta_modelo?.observacao_modelo || '').trim(),
       })
       window.requestAnimationFrame(() => {
         scrollParaAbasGeraisNoTopo()
@@ -757,7 +758,7 @@ export default function PesquisaTab({ sessionId, onUsarModeloEmAvaliacao = null
           <div className="pesquisa-opened-model-head">
             <div className="pesquisa-opened-model-title-wrap">
               <h3>{modeloAbertoMeta?.nome || 'Modelo'}</h3>
-              <p>Aceito para o avaliando</p>
+              {modeloAbertoMeta?.observacao ? <p>{modeloAbertoMeta.observacao}</p> : null}
             </div>
             <button
               type="button"

frontend/src/components/RepositorioTab.jsx

@@ -210,6 +210,7 @@ export default function RepositorioTab({ authUser, sessionId }) {
       setModeloAbertoMeta({
         id: String(item?.id || ''),
         nome: item?.nome_modelo || item?.arquivo || String(item?.id || ''),
+        observacao: String(resp?.meta_modelo?.observacao_modelo || '').trim(),
       })
     } catch (err) {
       setModeloAbertoError(err.message || 'Falha ao abrir modelo.')
@@ -256,7 +257,7 @@ export default function RepositorioTab({ authUser, sessionId }) {
           <div className="pesquisa-opened-model-head">
             <div className="pesquisa-opened-model-title-wrap">
               <h3>{modeloAbertoMeta?.nome || 'Modelo'}</h3>
-              <p>Visualização do modelo do repositório</p>
+              {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

frontend/src/styles.css

@@ -2840,6 +2840,143 @@ button:disabled {
   color: #2a3b4d;
 }
 
+.export-model-layout {
+  display: grid;
+  gap: 14px;
+  margin-bottom: 12px;
+}
+
+.export-model-note-card,
+.export-model-actions-card {
+  border: 1px solid #dde7f0;
+  border-radius: 14px;
+  background:
+    linear-gradient(180deg, rgba(255, 255, 255, 0.98) 0%, rgba(248, 251, 255, 0.98) 100%);
+  box-shadow:
+    0 10px 22px rgba(30, 44, 60, 0.05),
+    inset 0 1px 0 rgba(255, 255, 255, 0.8);
+  padding: 16px;
+}
+
+.export-model-note-card {
+  display: grid;
+  gap: 12px;
+  border-left: 4px solid #ffb259;
+}
+
+.export-model-note-head {
+  display: grid;
+  gap: 4px;
+}
+
+.export-model-note-label {
+  margin: 0;
+  font-family: 'Sora', sans-serif;
+  font-size: 0.94rem;
+  color: #243547;
+}
+
+.export-model-note-help {
+  margin: 0;
+  color: #61778d;
+  font-size: 0.84rem;
+  line-height: 1.45;
+}
+
+.export-model-note-input {
+  min-height: 112px;
+  resize: vertical;
+  line-height: 1.5;
+  padding: 12px 14px;
+  background:
+    linear-gradient(180deg, #ffffff 0%, #fdfefe 100%);
+  border-color: #ccd9e5;
+  box-shadow: inset 0 1px 2px rgba(25, 39, 53, 0.04);
+}
+
+.export-model-actions-card {
+  display: grid;
+  gap: 14px;
+}
+
+.export-model-fields {
+  display: grid;
+  grid-template-columns: minmax(240px, 1.1fr) minmax(260px, 1fr);
+  gap: 14px;
+}
+
+.export-model-field {
+  display: grid;
+  gap: 7px;
+  min-width: 0;
+}
+
+.export-model-field span {
+  font-weight: 700;
+  color: #394a5e;
+  font-size: 0.88rem;
+}
+
+.export-model-field input,
+.export-model-field select {
+  width: 100%;
+}
+
+.export-model-buttons {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 10px;
+}
+
+.export-model-buttons button {
+  min-height: 40px;
+  padding-inline: 16px;
+}
+
+.export-model-btn-primary {
+  --btn-bg-start: #ff9b32;
+  --btn-bg-end: #e67900;
+  --btn-border: #d97300;
+  --btn-shadow-soft: rgba(230, 121, 0, 0.18);
+  --btn-shadow-strong: rgba(230, 121, 0, 0.28);
+}
+
+.export-model-btn-repo {
+  --btn-bg-start: #2ea94f;
+  --btn-bg-end: #238a40;
+  --btn-border: #1b7435;
+  --btn-shadow-soft: rgba(35, 138, 64, 0.18);
+  --btn-shadow-strong: rgba(35, 138, 64, 0.28);
+}
+
+.export-model-btn-base {
+  --btn-bg-start: #4e95cf;
+  --btn-bg-end: #3d82be;
+  --btn-border: #2e6d9f;
+  --btn-shadow-soft: rgba(61, 130, 190, 0.18);
+  --btn-shadow-strong: rgba(61, 130, 190, 0.28);
+}
+
+.export-model-hint,
+.export-model-status {
+  margin-top: 4px;
+}
+
+.export-model-status {
+  color: #1f5e3a;
+  font-weight: 700;
+}
+
+@media (max-width: 900px) {
+  .export-model-fields {
+    grid-template-columns: 1fr;
+  }
+
+  .export-model-buttons button {
+    flex: 1 1 100%;
+  }
+}
+
 .section1-groups {
   display: grid;
   gap: 18px;
@@ -3172,6 +3309,18 @@ button.btn-upload-select {
   font-size: 0.83rem;
 }
 
+.modelo-observacao-badge {
+  margin-top: 10px;
+}
+
+.modelo-observacao-text {
+  margin-top: 6px;
+  color: #40586f;
+  font-size: 0.88rem;
+  line-height: 1.52;
+  white-space: pre-line;
+}
+
 .modelo-variaveis-box {
   padding: 9px 11px;
   border-radius: 11px;