Sistema de Verificação da Abordagem da Fiscalização

Sistema web responsivo para o Sistema Confea/Crea que permite aos agentes fiscalizadores gerar QR Codes únicos durante fiscalizações e aos fiscalizados confirmar digitalmente o recebimento de orientações e esclarecimentos sobre procedimentos de abordagem.

🏗️ Arquitetura

• Frontend: React.js + TypeScript + Tailwind CSS
• Backend: Node.js + Express + TypeScript
• Banco de Dados: PostgreSQL
• Autenticação: JWT + bcrypt
• QR Code: qrcode.js
• PDF: jsPDF
• Notificações: Nodemailer

🚀 Instalação

Pré-requisitos

• Node.js 18+
• PostgreSQL 14+
• Docker (opcional)

Instalação Rápida

# Clone o repositório
git clone <repository-url>
cd sistema-verificacao-abordagem-fiscalizacao

# Instale todas as dependências
npm run install:all

# Configure as variáveis de ambiente
cp .env.example .env
# Edite o arquivo .env com suas configurações

# Execute o projeto
npm run dev

Instalação com Docker

# Build e execução com Docker
npm run docker:build
npm run docker:up

📁 Estrutura do Projeto

sistema-verificacao-abordagem-fiscalizacao/
├── backend/                 # API REST (Node.js + Express + TypeScript)
│   ├── src/
│   │   ├── controllers/     # Controladores da API
│   │   ├── models/         # Modelos do banco de dados
│   │   ├── routes/         # Rotas da API
│   │   ├── middleware/     # Middlewares customizados
│   │   ├── services/       # Lógica de negócio
│   │   ├── utils/          # Utilitários
│   │   └── config/         # Configurações
│   └── prisma/             # Schema e migrations do banco
├── frontend/               # Interface React (TypeScript + Tailwind)
│   ├── src/
│   │   ├── components/     # Componentes React
│   │   ├── pages/         # Páginas da aplicação
│   │   ├── hooks/         # Custom hooks
│   │   ├── services/      # Serviços de API
│   │   ├── utils/         # Utilitários
│   │   └── types/         # Tipos TypeScript
└── docs/                  # Documentação

🔧 Configuração

Variáveis de Ambiente

Crie um arquivo .env na raiz do projeto:

# Database
DATABASE_URL="postgresql://user:password@localhost:5432/fiscalizacao_db"

# JWT
JWT_SECRET="sua-chave-secreta-jwt"
JWT_EXPIRES_IN="24h"

# Server
PORT=3001
NODE_ENV=development

# Email (opcional)
SMTP_HOST=smtp.gmail.com
SMTP_PORT=587
SMTP_USER=seu-email@gmail.com
SMTP_PASS=sua-senha-app

# QR Code
QR_CODE_BASE_URL="http://localhost:3000/fiscal"

🎯 Funcionalidades Principais

Painel do Fiscal

• Login seguro com credenciais do Crea
• Geração de QR Code único para cada fiscalização
• Formulário de dados da fiscalização
• Visualização de confirmações recebidas
• Relatórios de procedimentos executados

Interface do Fiscalizado

• Acesso via QR Code sem necessidade de cadastro
• Visualização dos procedimentos de abordagem
• Confirmação digital de ciência dos direitos
• Assinatura digital simples (nome + CPF)
• Recebimento de comprovante por email

Sistema de Gestão

• Dashboard administrativo para supervisores
• Relatórios estatísticos de procedimentos
• Controle de qualidade das abordagens
• Exportação de dados para integração

🔒 Segurança e Compliance

• LGPD: Implementação completa da Lei Geral de Proteção de Dados
• Criptografia: Dados sensíveis criptografados
• Autenticação: JWT com expiração
• Validação: Sanitização de inputs e validação de dados
• Logs: Auditoria completa de ações

📊 Status do Projeto

• Fase 1: Fundação e Infraestrutura
• Fase 2: Core do Sistema
• Fase 3: Interface do Fiscalizado
• Fase 4: Dashboards e Relatórios
• Fase 5: Segurança e Otimização
• Fase 6: Deploy e Monitoramento

🤝 Contribuição

1. Fork o 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

📄 Licença

Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

📞 Suporte

Para suporte, envie um email para suporte@confea.gov.br ou abra uma issue no repositório.