README.md

metadata

title: cda
emoji: 🏢
colorFrom: red
colorTo: blue
sdk: docker
app_port: 7860

Cadastro Imobiliario

Estrutura inicial para um sistema de cadastro de dados imobiliarios com:

• Backend em FastAPI
• Frontend em React + Vite
• Banco local SQLite para desenvolvimento
• Upload inicial de planilha para preview e importacao futura

Estrutura

• backend/: API e persistencia
• frontend/: interface web
• run-dev.ps1: sobe backend e frontend em desenvolvimento

Bases de dados locais

• backend/data/base/AUXILIAR_INSCRICOES.txt: base cadastral bruta, somente leitura
• backend/data/base/cadastro_base.db: base otimizada em SQLite, gerada automaticamente a partir do TXT
• backend/data/results/: area reservada para planilhas e arquivos gerados pelo sistema

Atualizacao da base cadastral

Quando o AUXILIAR_INSCRICOES.txt for atualizado, o sistema recria automaticamente o cadastro_base.db na proxima inicializacao da API.

Se quiser forcar a reconstrucao manualmente:

cd backend
.\.venv\Scripts\python.exe scripts\rebuild_cadastro_base.py

Campos iniciais

• titulo
• finalidade
• area_total
• area_privativa
• valor
• anuncio
• origem
• observacoes

Como rodar

No Windows PowerShell:

Set-ExecutionPolicy -Scope Process Bypass
.\run-dev.ps1

Se quiser instalar dependencias automaticamente:

Set-ExecutionPolicy -Scope Process Bypass
.\run-dev.ps1 -Install

URLs padrao

• Frontend: http://localhost:5173
• Backend: http://localhost:8000
• Docs da API: http://localhost:8000/docs

Deploy no Hugging Face Space

O projeto esta preparado para rodar em Docker Space, com o frontend buildado e servido pelo backend em porta unica.

• Space: https://huggingface.co/spaces/ESJL/cda
• Porta exposta no container: 7860
• Arquivo principal de deploy: Dockerfile

Proximos passos

• Ajustar o layout da planilha que voce vai enviar
• Adicionar mais campos do cadastro
• Implementar validacoes de negocio
• Criar autenticacao e perfis, se necessario