🏠 Sistema de Seleção Habitacional

Sistema completo para seleção habitacional com processamento automático de documentos via OCR, desenvolvido para o Edital 001/2025 - Mombaça/CE.

🚀 Funcionalidades

📋 Gestão de Inscrições

• Formulário completo com dados do candidato
• Upload de múltiplos documentos (RG, CPF, CadÚnico, comprovantes)
• Processamento automático via OCR usando API Anthropic Claude
• Validação automática de requisitos do edital

🔍 Análise Inteligente

• Extração automática de dados dos documentos
• Verificação de requisitos obrigatórios:
  • CadÚnico atualizado
  • Renda familiar até R$ 759,00
  • Mínimo 5 anos de residência em Mombaça
  • Sem imóvel próprio
  • Sem benefício anterior

🏆 Sistema de Pontuação

• Critérios de prioridade:
  • Mãe solo: +15 pontos
  • Pessoa com deficiência: +20 pontos
  • Família com idosos: +10 pontos
  • Vulnerabilidade social: +15 pontos

📊 Classificação Automática

• Lista classificatória ordenada por pontuação
• Status automático: HABILITADO, INABILITADO ou PENDENTE
• Visualização detalhada de cada candidato

🛠️ Tecnologias Utilizadas

• React 18 - Interface de usuário
• TypeScript - Tipagem estática
• Tailwind CSS - Estilização
• Lucide React - Ícones
• Anthropic Claude API - Processamento OCR
• Firebase Firestore - Banco de dados em tempo real
• Vite - Build tool

📦 Instalação

1. Clone o repositório:

git clone https://github.com/seu-usuario/sistema-selecao-habitacional.git
cd sistema-selecao-habitacional

2. Instale as dependências:

npm install

3. Configure a API Key:

   • Obtenha uma API key da Anthropic
   • Configure a variável de ambiente ANTHROPIC_API_KEY

4. Execute o projeto:

npm run dev

🔧 Configuração

Variáveis de Ambiente

Crie um arquivo .env na raiz do projeto:

# Anthropic API Key
VITE_ANTHROPIC_API_KEY=sua_api_key_aqui

# Firebase Configuration
VITE_FIREBASE_API_KEY=sua_api_key_firebase
VITE_FIREBASE_AUTH_DOMAIN=seu_projeto.firebaseapp.com
VITE_FIREBASE_PROJECT_ID=seu_projeto_id
VITE_FIREBASE_STORAGE_BUCKET=seu_projeto.appspot.com
VITE_FIREBASE_MESSAGING_SENDER_ID=seu_sender_id
VITE_FIREBASE_APP_ID=seu_app_id

Configuração do Firebase

1. Crie um projeto no Firebase Console
2. Ative o Firestore Database
3. Configure as regras de segurança:

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /candidatos/{document} {
      allow read, write: if true; // Para desenvolvimento
    }
  }
}

4. Copie as credenciais do projeto para o arquivo .env

Estrutura do Projeto

sistema-selecao-habitacional/
├── sistema-upload-ocr.tsx    # Componente principal
├── src/
│   ├── firebase.ts          # Configuração Firebase
│   ├── hooks/
│   │   └── useFirestore.ts  # Hook para Firestore
│   ├── main.tsx             # Ponto de entrada
│   └── index.css            # Estilos globais
├── package.json              # Dependências
├── README.md                 # Documentação
├── .gitignore               # Arquivos ignorados
├── env.example              # Exemplo de variáveis
└── .env                     # Variáveis de ambiente

📱 Como Usar

1. Nova Inscrição

• Preencha os dados do candidato
• Marque os critérios de prioridade aplicáveis
• Faça upload dos documentos necessários
• Clique em "Processar Inscrição com OCR"

2. Visualizar Candidatos

• Acesse a aba "Candidatos"
• Veja todos os inscritos com status e pontuação
• Clique em um candidato para ver detalhes completos

3. Classificação

• Acesse a aba "Classificação"
• Veja apenas os candidatos habilitados
• Lista ordenada por pontuação (maior para menor)

🎯 Requisitos do Edital

Obrigatórios

• ✅ CadÚnico atualizado
• ✅ Renda familiar até R$ 759,00
• ✅ Mínimo 5 anos de residência em Mombaça/CE
• ✅ Sem imóvel próprio
• ✅ Sem benefício habitacional anterior

Critérios de Prioridade

• 🏆 Mãe solo (+15 pontos)
• ♿ Pessoa com deficiência (+20 pontos)
• 👴 Família com idosos (+10 pontos)
• 🆘 Vulnerabilidade social (+15 pontos)

🔒 Segurança

• Dados processados localmente
• API key protegida por variáveis de ambiente
• Validação de tipos com TypeScript
• Tratamento de erros robusto
• Dados persistidos no Firebase Firestore
• Sincronização em tempo real

📄 Licença

Este projeto está licenciado sob a MIT License - veja o arquivo LICENSE para detalhes.

🤝 Contribuição

1. Faça um fork do projeto
2. Crie uma branch para sua feature (git checkout -b feature/AmazingFeature)
3. Commit suas mudanças (git commit -m 'Add some AmazingFeature')
4. Push para a branch (git push origin feature/AmazingFeature)
5. Abra um Pull Request

📞 Suporte

Para suporte ou dúvidas, entre em contato através das issues do GitHub.

---

Desenvolvido para o Edital 001/2025 - Mombaça/CE 🏠✨