frontend-react/README.md

Analytical-Force — Painel (React)

Painel web do agente Analytical-Force. Substitui o antigo frontend.html (single-file) por um app React + Vite, mantendo o mesmo contrato com a API (FastAPI): a URL do Space e a X-API-Key continuam guardadas no localStorage do navegador — nenhum segredo fica embutido no build.

Telas

Dashboard, Oportunidades, Leads, Tarefas, Satisfação, Cancelamentos, Alertas, Tendências, Relatório e Configuração (incluindo o cadastro de e-mails em cópia — Cc — do relatório diário, persistido no Turso).

Desenvolvimento local

npm install
npm run dev

Abre em http://localhost:5173. Configure a URL da API e a X-API-Key na tela Configuração (mesmo comportamento do frontend.html anterior).

Build de produção

npm run build

Gera dist/. Em produção, o backend (FastAPI) serve esse dist/ como arquivos estáticos no mesmo container do Hugging Face Space — ver src/delivery/static_app.py e o Dockerfile na raiz do projeto (etapa de build Node + cópia do dist/ para a imagem final). Isso evita precisar de um segundo host/CORS: a API e o painel passam a responder na mesma porta.