README.md

metadata

title: Mesa React Beta
emoji: 🌖
colorFrom: blue
colorTo: indigo
sdk: docker
app_port: 7860
pinned: false

MESA React Beta (FastAPI + React)

Rearquitetura do app MESA com:

• backend/ em FastAPI
• frontend/ em React (Vite)
• Reuso do core estatistico e de negocio original (elaboracao + visualizacao)

Estrutura

• backend/app/main.py: inicializacao da API
• backend/app/api/: rotas de sessao, elaboracao e visualizacao
• backend/app/services/: orquestracao dos fluxos
• backend/app/core/elaboracao: core de elaboracao reaproveitado
• backend/app/core/visualizacao: core de visualizacao reaproveitado
• frontend/src: interface React

Backend

cd backend
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

Frontend

cd frontend
npm install
npm run dev

Frontend: http://localhost:5173

Para apontar para outro backend:

VITE_API_BASE=http://localhost:8000 npm run dev

No build de producao servido pelo proprio backend, o frontend passa a usar a mesma origem (/api) por padrao.

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 (obrigatório para ler dataset privado e para gravar cadastros/edições em produção)

Base de Trabalhos Técnicos:

• Fora do HF Spaces, o app usa por padrão o banco SQLite local.
• Em runtime HF Spaces, o app usa por padrão o banco SQLite hospedado no dataset.
• Override opcional: TRABALHOS_TECNICOS_PROVIDER (local ou hf_dataset)
• Banco local: TRABALHOS_TECNICOS_DB_LOCAL_PATH
• Banco no dataset: TRABALHOS_TECNICOS_HF_REPO_ID, TRABALHOS_TECNICOS_HF_REVISION, TRABALHOS_TECNICOS_HF_PATH

Geração do banco local de Trabalhos Técnicos:

• Script: backend/scripts/build_trabalhos_tecnicos_db.py
• Planilha padrão de origem: ~/Downloads/AVALIANDOS_20260515_corrigido_v2.xlsx
• Exemplo: backend/.venv/bin/python backend/scripts/build_trabalhos_tecnicos_db.py
• Saída padrão: backend/local_data/trabalhos_tecnicos.sqlite3
• O arquivo SQLite local fica ignorado no git e deve ser enviado manualmente ao dataset gui-sparim/repositorio_mesa no caminho trabalhos_tecnicos/trabalhos_tecnicos.sqlite3.

Regra automática de provider:

• Em runtime HF Spaces (SPACE_ID/SPACE_AUTHOR_NAME/HF_SPACE_ID), o backend força hf_dataset.
• Fora do HF Spaces, o fallback continua local quando o provider não é informado.

No modo hf_dataset, o backend consulta a revisão atual do dataset e só sincroniza novamente quando detectar mudança de revisão.

Ao cadastrar trabalhos técnicos, o backend migra automaticamente bancos SQLite antigos do dataset que ainda não tenham as colunas de links usadas pela versão atual, preservando os registros existentes.

Login simples

O app exige autenticação para qualquer rota /api (exceto health e login).

• Endpoint de login: POST /api/auth/login com usuario e matricula
• O frontend usa token no header X-Auth-Token
• Usuários padrão: backend/app/core/auth/usuarios.json

Variáveis opcionais:

• APP_USERS_FILE para apontar um JSON alternativo de usuários
• APP_USERS_JSON para injetar o JSON via secret/variável de ambiente

Logs de auditoria

Logs são gravados em JSONL por escopo:

• auth
• repositorio
• trabalhos_tecnicos
• elaboracao
• visualizacao

Comportamento por ambiente:

• Local (MODELOS_REPOSITORIO_PROVIDER=local): logs desativados.
• Produção HF (MODELOS_REPOSITORIO_PROVIDER=hf_dataset): logs gravados e lidos no dataset, em logs/.

Variável opcional:

• APP_LOGS_MODE (auto/enabled/disabled) para forçar o modo de logs.