cda / README.md
github-actions
Sync from GitHub de3ca9b6f57913ea7bbc4e8a3b73a8d5f7844d2d
7ad8558
---
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:
```powershell
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:
```powershell
Set-ExecutionPolicy -Scope Process Bypass
.\run-dev.ps1
```
Se quiser instalar dependencias automaticamente:
```powershell
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