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

```bash
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

```bash
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

```bash
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:

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