📋 Sobre o Projeto
Sistema web completo de controle de ponto eletrônico desenvolvido para o Colégio Attos para gestão de até 60 funcionários, implementando registro de jornada de trabalho com tecnologias modernas e recursos avançados de segurança e automação.
Projeto em Produção - Atualmente em uso pelo Colégio Attos gerenciando mais de 60 funcionários diariamente
🎯 Objetivos
Criar uma solução robusta e escalável para substituir sistemas tradicionais de ponto, oferecendo:
- Registro de ponto com geolocalização e reconhecimento facial
- Gestão automatizada de jornadas e horários de almoço
- Relatórios detalhados e exportação de dados
- Interface intuitiva para funcionários e administradores
- Sistema de justificativas (atestados médicos, declarações)
Desafio
O Colégio Attos precisava de uma solução moderna para substituir o sistema de ponto tradicional, que apresentava diversos problemas: registros manuais propensos a erros, falta de auditoria, dificuldade em gerar relatórios e ausência de controle automatizado de jornadas. A instituição necessitava de um sistema que garantisse a autenticidade dos registros através de tecnologias como reconhecimento facial e geolocalização, além de automatizar processos como registro de horários de almoço para toda sua equipe de funcionários.
Solução
Desenvolvemos um sistema web progressivo (PWA) com Next.js 14 e Firebase, implementando recursos avançados de segurança e automação:
⚙️ Funcionalidades para Funcionários
- Registro de Ponto com Validação: Entrada, Saída, Almoço (saída/volta) com geolocalização obrigatória e reconhecimento facial para confirmar identidade
- Detecção Automática de Atrasos: Sistema com tolerância configurável que identifica e registra atrasos automaticamente
- Almoço Automático Inteligente: Configuração individual de horários com registro automático em horário pré-definido e recuperação retroativa
- Dashboard Personalizado: Visualização em tempo real dos registros do dia, calculadora de horas trabalhadas e histórico com filtros
- Sistema de Justificativas: Upload de atestados médicos e declarações com suporte para imagens (JPG/PNG) e PDF, incluindo compressão automática
⚙️ Funcionalidades para Administradores
- Gestão Completa de Usuários: Cadastro com dados completos (CPF, matrícula, departamento), múltiplos perfis e sistema de unidades (multi-empresa)
- Controle de Registros: Visualização de todos os pontos batidos, filtros por data e funcionário, edição com histórico de modificações
- Relatórios e Análises: Relatórios diários, semanais e mensais com cálculo automático de horas, detecção de atrasos e exportação em PDF/CSV
- Aprovação de Justificativas: Fila de documentos pendentes, visualização de arquivos anexados e histórico completo
🚀 Tecnologias Utilizadas
💡 Diferenciais Técnicos
🔒 Segurança Robusta
- Autenticação Firebase com proteção de rotas
- Reconhecimento facial com 75% de confiança mínima
- Validação de geolocalização obrigatória
- Histórico completo de modificações (quem, quando, o quê)
🤖 Automações Inteligentes
- Almoço automático com horários personalizados
- Recuperação retroativa de registros perdidos
- Cálculo automático de horas trabalhadas
- Validação de sequência de registros (entrada → almoço → volta → saída)
🎯 Detecção de Atrasos
- Tolerância configurável por funcionário (5-30 min)
- Notificação visual de atraso ao registrar ponto
- Registro separado de atrasos para RH
- Relatórios específicos de pontualidade
💪 Desafios Superados
Limitação de Plano Firebase (Spark/Free)
Problema: Impossibilidade de usar Cloud Functions no plano gratuito.
Solução: Implementação de verificação periódica no frontend com recuperação retroativa, permitindo registros automáticos mesmo com navegador fechado.
Reconhecimento Facial no Navegador
Problema: Processamento pesado de modelos ML no cliente.
Solução: Carregamento lazy de modelos com cache local e utilização do TinyFaceDetector para otimizar performance.
Query de Registros Históricos
Problema: Limite de 100 registros causava perda de dados antigos.
Solução: Query otimizada com filtro de data no Firestore e separação de queries por contexto.
Geolocalização em Dispositivos Móveis
Problema: Timeout e precisão variável em diferentes dispositivos.
Solução: Configuração de timeout de 15s com fallback gracioso e cache de 1 minuto para evitar múltiplas solicitações.
Meu Papel
Como desenvolvedor full-stack responsável pelo projeto:
- Desenvolvimento completo da aplicação web com Next.js 14 e TypeScript
- Implementação do sistema de reconhecimento facial com Face-api.js
- Integração com Firebase (Firestore, Authentication, Storage)
- Desenvolvimento dos algoritmos de automação de registros e detecção de atrasos
- Criação de interface responsiva com Tailwind CSS
- Implementação do sistema de relatórios e exportação de dados
- Otimização de performance e queries no Firestore
- Treinamento de usuários e administradores
- Suporte técnico e manutenção contínua
📈 Resultados
Sistema implantado e em uso ativo no Colégio Attos desde 2025:
- ✅ 60+ funcionários utilizando diariamente o sistema
- ✅ Redução de 90% em erros de registro manual
- ✅ Automatização completa de horários de almoço
- ✅ Auditoria completa com histórico de modificações
- ✅ Interface responsiva (desktop, tablet, mobile)
- ✅ Tempo de resposta < 2s para registros de ponto
- ✅ Economia de 15+ horas mensais do RH em processos manuais
- ✅ 100% de disponibilidade desde a implantação
🔄 Evolução: Migração para Vercel + Supabase + PostgreSQL
Atualização 2026 — O sistema foi migrado com sucesso do Firebase para uma stack mais robusta: Vercel + Supabase + PostgreSQL
Por que migrar?
Apesar do Firebase ter sido uma excelente escolha para o MVP e a versão inicial, a evolução do sistema evidenciou limitações que motivaram a migração:
- Banco de dados relacional: o modelo NoSQL do Firestore criava complexidade desnecessária para dados intrinsecamente relacionais (funcionários, registros, justificativas)
- Custo vs. escalabilidade: o plano Blaze do Firebase cobrava por leitura/escrita; o Supabase oferece um tier gratuito mais generoso com PostgreSQL real
- Queries poderosas: SQL nativo com JOINs, agregações e CTEs substituiu as limitadas queries do Firestore
- Infraestrutura unificada: Vercel para deploy do Next.js + Supabase para banco, auth e storage — stack coesa e moderna
- Limitação de Cloud Functions: o plano gratuito do Firebase não permitia funções serverless; a Vercel resolveu isso nativamente
🆕 Nova Stack (V2 — 2026)
✅ Ganhos com a Migração
- Performance: queries SQL com índices são significativamente mais rápidas para relatórios complexos
- Confiabilidade: PostgreSQL é battle-tested para dados transacionais como registros de ponto
- Row Level Security (RLS): segurança implementada diretamente no banco via Supabase
- Realtime nativo: Supabase Realtime substituiu os listeners do Firestore com mais controle e previsibilidade
- Integridade referencial: foreign keys e constraints garantem a consistência dos dados
- Deploy simplificado: integração nativa Vercel + Supabase com variáveis de ambiente automáticas
- Custo reduzido: stack open-source com tier gratuito muito mais generoso
🔮 Próximas Melhorias
- Sistema de notificações push
- Aplicativo mobile nativo (React Native)
- Integração com folha de pagamento
- Dashboard com Business Intelligence