README.md

metadata

title: Sistema de Geração Textual para Laudos
emoji: 📄
colorFrom: green
colorTo: yellow
sdk: docker
pinned: false

Sistema de Geração de Laudos (FastAPI + React)

Aplicação para geração de laudos de avaliação imobiliária com backend em FastAPI e frontend em React.

Arquitetura

• backend/app/: API FastAPI
• frontend/: SPA React (Vite)
• document/, models/, extractors/, utils/: regras de negócio, geração DOCX, modelos .dai, anexos e extração de PDF

Rodando em desenvolvimento local

1) Backend

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python app.py

Backend disponível em http://localhost:8000.

2) Frontend

cd frontend
npm install
npm run dev

Frontend disponível em http://localhost:5173.

Variáveis de ambiente úteis

Backend:

• HOST (default: 0.0.0.0)
• PORT (default: 8000 em dev local)
• CORS_ORIGINS (default: http://localhost:5173,http://127.0.0.1:5173)
• ENABLE_DUMMY_DATA (true/false, default: true)
• DEFAULT_FILL_DUMMY (true/false, default: false)

Frontend:

• VITE_API_BASE_URL (opcional em dev; default já aponta para http://localhost:8000)

Build de produção

cd frontend
npm run build

Com frontend/dist presente, o FastAPI passa a servir o frontend estático no mesmo host.

Deploy no Hugging Face Spaces (Docker)

Este repositório inclui Dockerfile para Spaces com Docker SDK.

• Builda o frontend em estágio Node
• Sobe API FastAPI na porta 7860 (ou PORT informado pelo ambiente)

Comando de execução no container:

uvicorn backend.app.main:app --host 0.0.0.0 --port ${PORT:-7860}