O NaHora registra jornada de trabalho com identificação biométrica e prova de vivacidade, produzindo registros que satisfazem a Portaria MTP 671/2021 (REP-P) — NSR sequencial, AFD assinado digitalmente e comprovante ao trabalhador.
Os mecanismos usuais de marcação de ponto — crachá, PIN, planilha, app com geolocalização — são trivialmente fraudáveis: qualquer pessoa marca por qualquer outra. O empregador não consegue provar quem registrou, e o trabalhador não consegue contestar um registro que não fez.
Geolocalização não identifica ninguém. Ela diz onde, não quem — e vale dizer isso em voz alta em vez de vender o contrário: um funcionário que empresta o celular desbloqueado bate o ponto de outro, e o sistema não tem como perceber. O que ele faz é registrar de onde e de qual aparelho, sinalizar GPS falso quando detecta, e deixar o julgamento com o gestor. É uma barreira contra o oportunista, não contra o determinado.
Nada impede o registro do ponto. A Portaria 671, Art. 78 §1º, veda ao registrador mecanismos que restrinjam a marcação, e isso não abre exceção para sinal ruim nem para suspeita. GPS impreciso, sem rede, localização falsa detectada: em todos os casos a marcação é gravada, recebe NSR e entra no AFD — sinalizada, nunca recusada. O fraudador consegue marcar, mas fica marcado, rastreável e auditável. É o oposto de um sistema que apaga a prova de que alguém trabalhou.
E a consequência disso no app: funciona sem internet. Marcação vai para uma fila local e sobe quando houver rede, com a hora ancorada num relógio que mexer na data do celular não afeta.
┌─────────────────────┐
│ Flutter (Android) │ captura, orienta o enquadramento,
└──────────┬──────────┘ nunca decide quem é
│ HTTPS + SSE
▼
┌─────────────────────┐
│ ASP.NET Core 10 │ Minimal API · Vertical Slice · CQRS
│ Minimal API │
└──────────┬──────────┘
│
┌──────┼──────────────┬──────────────┐
▼ ▼ ▼ ▼
PostgreSQL MinIO RabbitMQ
17 anexos eventos
backend/src/
├── NaHora.Api/ endpoints, composição, middleware
├── NaHora.Features/ slices verticais (command, handler, endpoint)
├── NaHora.Domain/ entidades, value objects, regras, portas
├── NaHora.Infrastructure/ EF Core, MinIO, RabbitMQ, assinatura
└── NaHora.Shared/ primitivos sem dependência de domínio
Domain não referencia nenhum projeto — a regra é verificada por teste de
arquitetura que quebra o build. Cada slice é autocontido e não referencia outro
slice.
Frame → Detecção → Qualidade → Alinhamento → Liveness → Embedding
↓
Decisão ← Similaridade (cosseno) ────┘
↓
Verified | PendingReview | Disputed
Cada etapa é uma responsabilidade separada, testável isoladamente. Não existe um
método ValidateFace() que faça tudo.
| Camada | Escolha | Licença |
|---|---|---|
| Runtime | .NET 10 | MIT |
| API | ASP.NET Core Minimal API | MIT |
| CQRS + Mensageria | WolverineFX 6 | MIT |
| ORM | EF Core 10 + Npgsql | MIT |
| Banco | PostgreSQL 17 | PostgreSQL |
| Objetos | MinIO | AGPL-3.0 (serviço externo) |
| Broker | RabbitMQ | MPL-2.0 |
| Validação | FluentValidation | Apache-2.0 |
| Banco local (app) | Drift | MIT |
| Mapa | flutter_map + MapTiler | BSD-3 / plano gratuito |
| Frontend | Flutter + Riverpod | BSD-3 / MIT |
| Testes | xUnit v3, Shouldly, NSubstitute, Testcontainers | Apache-2.0 / MIT |
MediatR v13+ e MassTransit v9 passaram a ser comerciais (MassTransit em torno de US$ 400/mês). O Wolverine é MIT e cobre mediator local, RabbitMQ e outbox transacional num pacote só.
O servidor de tiles do OpenStreetMap proíbe uso comercial. O dado do OSM é livre; o serviço de tiles deles não é para produção — a política diz que o acesso pode ser cortado sem aviso. Um produto pago cujo mapa some não é economia. Daí o MapTiler, que tem licença comercial explícita.
É o mesmo erro que quase cometemos antes com os pesos do InsightFace: confundir "dado aberto" com "serviço gratuito para uso comercial".
Também estão fora: AutoMapper (comercial, e o projeto exige mapeamento manual),
FluentAssertions v8+ (comercial) e SixLabors.ImageSharp v3+ (licença paga acima
de US$ 1M de receita). Um teste de arquitetura falha o build se qualquer um deles
entrar no Directory.Packages.props.
| Ferramenta | Versão | Observação |
|---|---|---|
| .NET SDK | 10.0.400+ | |
| Flutter | 3.47+ | Canal stable |
| Android SDK | API 36 | Com command-line tools e licenças aceitas |
| JDK | 17 | Exigido pelo Gradle |
| Docker Desktop | 29+ | Para os testes de integração do backend |
As licenças do Android precisam ser aceitas uma vez:
flutter doctor --android-licensesSem elas o flutter build apk falha, e a mensagem não diz que o motivo é
licença.
cp .env.example .envAjuste o .env e suba os serviços:
docker compose up -d| Serviço | Endereço | Credenciais |
|---|---|---|
| PostgreSQL | localhost:5432 |
conforme .env |
| MinIO (API) | localhost:9000 |
conforme .env |
| MinIO (console) | http://localhost:9001 | conforme .env |
| RabbitMQ | localhost:5672 |
conforme .env |
| RabbitMQ (management) | http://localhost:15672 | conforme .env |
| Mailpit (SMTP) | localhost:1025 |
— |
| Mailpit (webmail) | http://localhost:8025 | — |
O Mailpit captura todo e-mail enviado em desenvolvimento. Nada sai da máquina, então um endereço digitado errado em teste não alcança uma pessoa real.
cd backend && dotnet run --project src/NaHora.Api| Endpoint | Descrição |
|---|---|
/health/live |
Processo vivo |
/health/ready |
PostgreSQL, MinIO, RabbitMQ, modelos, certificado |
/openapi/v1.json |
Especificação OpenAPI (desenvolvimento) |
/api/v1/system/info |
Informação de build e runtime |
cd frontend/nahora && flutter run -d android --dart-define=MAPTILER_KEY=sua-chaveCom um aparelho conectado por USB (depuração USB ligada) ou um emulador aberto.
flutter devices lista o que está disponível.
A chave do MapTiler entra por --dart-define e não é versionada. Sem ela o
app roda: o mapa cai para um cartão que mostra coordenada e precisão em texto,
porque nada no cliente pode impedir uma marcação.
O mapa é do MapTiler. Não Google Maps, e não os tiles públicos do OpenStreetMap — a política de uso deles proíbe uso comercial e o acesso pode ser cortado sem aviso.
A tela de marcação lê a localização duas vezes, e a segunda leitura é o ponto inteiro:
abre a tela
↓ lê a localização
mostra o mapa com o marcador
↓ a pessoa confirma
lê a localização de novo
↓ valida a precisão
grava a batida
A coordenada exibida pode ter minutos de idade quando o dedo encosta no botão. O que vale é onde a pessoa estava ao marcar, e é a coordenada relida que viaja para o servidor.
Latitude e longitude ficam gravadas, mas nenhuma listagem as devolve. Só a consulta de uma marcação específica responde com coordenada, e só quando a pessoa pede para ver no mapa — devolvê-las em toda listagem colocaria um mapa de onde a pessoa esteve no aparelho mais fácil de perder.
- Criar conta em https://cloud.maptiler.com/ (o plano gratuito serve para desenvolvimento).
- Em Account → API keys, copiar a chave criada por padrão ou criar uma nova.
- Restringir a chave por origem antes de usá-la em produção: em Allowed origins, listar apenas os domínios e o pacote Android do app. Uma chave sem restrição é uma chave que qualquer pessoa que abra o APK pode usar por conta da sua cota.
- Passar por
--dart-define=MAPTILER_KEY=...noflutter rune noflutter build. Nunca em arquivo versionado.
cd backend && dotnet test| Projeto | Cobre |
|---|---|
NaHora.UnitTests |
Domínio, regras, cálculo de jornada, decisão biométrica |
NaHora.ArchitectureTests |
Direção de dependência, isolamento de slices, licenças |
NaHora.IntegrationTests |
API completa com PostgreSQL, MinIO e RabbitMQ reais |
Testes de integração usam Testcontainers com bancos reais. Provider em
memória não tem timestamptz, jsonb, trigger nem FOR UPDATE — testar contra
ele validaria um sistema que não existe.
dotnet test roda em modo Microsoft.Testing.Platform, configurado no
global.json.
Dado biométrico é dado pessoal sensível (LGPD, Art. 5º II) e, ao contrário de uma senha, não pode ser trocado depois de vazar.
- Embeddings cifrados em repouso com AES-256-GCM
- Embedding, score de similaridade, score de liveness e thresholds nunca aparecem em resposta HTTP, WebSocket, log, evento ou arquivo exportado
- Frames processados em memória e descartados; nunca gravados em disco
- Evidências em bucket privado, acessíveis só por URL pré-assinada, com todo acesso auditado
- Consentimento biométrico específico e destacado (Art. 11), revogável com efeito imediato
- Retenção configurável por empresa, com mínimos legais impostos pelo sistema
AttendanceRecordeAuditLogsão append-only, com trigger no banco rejeitandoUPDATEeDELETE- Isolamento multiempresa em duas camadas: filtro global do EF Core e verificação explícita no handler
| Exigência | Situação |
|---|---|
| NSR sequencial sem lacunas | Contador transacional por empresa |
| Registro inalterável | Trigger no banco + hash encadeado |
| Vedação a restringir a marcação (Art. 78 §1º) | Toda marcação é registrada e classificada |
| Comprovante ao trabalhador (Art. 84) | PDF e texto |
| AFD no layout oficial | ISO-8859-1, CRC-16, assinatura CAdES |
| Assinatura ICP-Brasil (Art. 88) | Certificado e-CNPJ A1 |
Antes de produção: o layout do Anexo I deve ser lido da fonte oficial e o AFD gerado validado com ferramenta oficial ou homologada. Registro do REP-P junto ao MTE, atestado técnico e DPIA são obrigações do controlador, fora do escopo do software.
- Fundação — solução, DI automática, CQRS, testes, Docker
- Banco e infraestrutura — EF Core, migrations, RabbitMQ
- Autenticação — CPF + senha, JWT, refresh rotativo, permissões
- Observabilidade, outbox, rate limiting e resiliência
- Tempo real por SSE
- Design System e regras de token
- Marcação por geolocalização — captura, hora do servidor, GPS falso
- Modo offline — fila local e sincronização
- Histórico e mapa da marcação
- Ajuste de ponto pelo gestor — tratamento, justificativas, anexo
- Cerca da empresa — raio em que a marcação é aceita
- Comprovante do ajuste visível para o gestor ao decidir
- Jornada de trabalho e cálculo de horas
- Eventos de segurança e revisão
- Auditoria automática
- Exportação CSV e Excel
- AFD, AEJ e comprovante
A empresa define onde fica e com que raio. Uma marcação feita fora dele é registrada assim mesmo e sai sinalizada — a Portaria 671 veda ao REP mecanismos que restrinjam a marcação, e "longe demais" não é exceção. O que o raio compra é a diferença entre um ponto batido na portaria e um batido em casa, visível para quem aprova.
O raio é da empresa, não do produto: uma obra e um escritório não têm o mesmo tamanho, e um número fixo estaria errado para os dois.
Hoje a fila do gestor diz que existe um anexo, e não o mostra. Quem decide sobre um atestado precisa ver o atestado, senão está aprovando pelo nome de quem pediu.
A imagem vem por link assinado de curta duração, pela rota que já existe — a listagem continua sem devolver onde o arquivo está, para que uma fila não vire um jeito de paginar os atestados de alguém.
Projeto privado. Licenças de terceiros nas tabelas acima e em
models/README.md.