- 🌐 Demonstração Online
- 🛠️ Stack Tecnológica
- 🏛️ Arquitetura do Sistema e Monorepo
- 🚀 Módulos e Detalhes Técnicos
- 🔐 Segurança e Conformidade
- 🧪 Estrutura de Testes Automatizados
- 🛠️ Qualidade de Código & CI/CD
- 🏁 Inicialização Local
- 🌱 Massa de Dados do Seed
- 📑 Documentação de Rotas
- 📸 Galeria de Telas (Preview)
O Atlas HRMS é um ecossistema corporativo completo de gerenciamento de recursos humanos e rastreamento de candidatos (ATS - Applicant Tracking System). Projetado sobre uma arquitetura de monorepo moderna e escalável, o sistema integra de ponta a ponta as rotinas operacionais de departamento pessoal, ponto eletrônico digital com banco de horas, gerenciamento de ausências por conformidade CLT, controle de cargos/departamentos estruturados e um portal público de vagas integrado.
Este repositório foi construído para servir como uma referência técnica de código limpo, aplicação estrita de segurança corporativa, testes automatizados e design system premium.
O projeto está configurado e publicado em ambiente de produção contínuo hospedado na nuvem do Render. Você pode acessar as instâncias ativas através dos links a seguir:
- Frontend da Aplicação (Web App): https://atlas-web-pt7t.onrender.com/pt/
- Backend da Aplicação & Documentação Interativa (API): https://atlas-api-iraw.onrender.com/docs
Warning
Aviso sobre Cold Start (Inicialização Tardia): As instâncias estão publicadas sob o plano de hospedagem gratuito da plataforma Render. Como resultado, se os serviços ficarem sem uso por alguns minutos, o servidor entra em modo de hibernação. Ao abrir qualquer uma das URLs pela primeira vez, poderá ocorrer um atraso de aproximadamente 30 a 50 segundos para que a instância do servidor seja reativada ("desperte"). As próximas interações funcionarão de forma instantânea.
A stack tecnológica do Atlas HRMS foi meticulosamente selecionada para simular um ambiente de desenvolvimento corporativo altamente produtivo, tipado e seguro:
- Next.js + Turborepo: A escolha do monorepo via Turborepo garante o compartilhamento nativo e imediato de tipos de domínio (
packages/types) entre o cliente e o servidor. O Next.js com App Router fornece SSR eficiente e carregamento otimizado de páginas públicas (ex: portal de vagas e formulário de inscrição). - NestJS + Prisma + PostgreSQL: No backend, o NestJS provê uma arquitetura modular robusta baseada em injeção de dependência e controle restrito de exceções. O Prisma ORM simplifica a modelagem relacional, aplicando integridade referencial física diretamente nas chaves do PostgreSQL.
- Segurança Corporativa Híbrida: O uso de tokens JWT em memória combinado com cookies HTTP-Only de renovação automática mitiga vulnerabilidades de XSS e CSRF. O controle fino via RBAC em decorators no NestJS protege as rotas operacionais do sistema.
- UploadThing, Resend & Scalar: A integração direta com o UploadThing Cloud possibilita o upload assíncrono seguro de PDFs diretamente do navegador para a nuvem. A comunicação transacional por e-mail é feita via Resend, enquanto a especificação OpenAPI da API é dinamicamente renderizada pelo Scalar.
- Docker: A containerização do banco PostgreSQL e dependências de infraestrutura por meio do Docker simplifica o provisionamento local, garantindo consistência total de ambientes de desenvolvimento, staging e produção.
O projeto está estruturado em um monorepo de alta performance orquestrado pelo Turborepo, garantindo isolamento de responsabilidades, cache inteligente e paralelização de tarefas. O fluxo de dados e a arquitetura de comunicação envolvem múltiplos módulos, autenticação híbrida, uploads assíncronos direct-to-cloud e persistência transacional:
graph TB
%% Nodes definition
User([Usuário / Candidato])
subgraph FrontendApp ["Web App (Next.js - apps/web)"]
LandingPage["Landing Page (Pública)"]
CareersPortal["Portal de Carreiras (Público)"]
DashboardPanel["Painel Administrativo (Privado)"]
ZustandStore["Zustand (Global State)"]
ReactQuery["TanStack Query (Cache/Mutações)"]
end
subgraph BackendAPI ["API Server (NestJS - apps/api)"]
AuthController["Auth Controller (JWT/Cookie/Lockout)"]
DashboardController["Dashboard Controller (Promise.all)"]
TimeCorrectionController["Time Attendance Controller (Banco de Horas)"]
RecruitmentController["ATS Controller (Kanban/Pipeline)"]
PrismaORM["Prisma ORM (Data Layer)"]
end
subgraph ThirdParty ["Serviços Externos (Direct Integrations)"]
UploadThing["UploadThing Cloud (Storage)"]
ResendMail["Resend API (Emails)"]
end
subgraph Database ["Camada de Dados"]
Postgres[(PostgreSQL)]
end
%% Relations
User -->|Navegação e Candidatura| CareersPortal
User -->|Painel Operacional| DashboardPanel
User -->|Acessa Landing Page| LandingPage
DashboardPanel -->|Gerencia Estado| ZustandStore
DashboardPanel -->|Queries Otimistas| ReactQuery
CareersPortal -->|Queries Otimistas| ReactQuery
ReactQuery -->|"Endpoints Privados (JWT)"| AuthController
ReactQuery -->|"Métricas Paralelas"| DashboardController
ReactQuery -->|"Ajuste de Ponto"| TimeCorrectionController
ReactQuery -->|"Movimentação Kanban"| RecruitmentController
CareersPortal -->|"Upload de PDF Direto"| UploadThing
RecruitmentController -->|"Consome PDF Link"| UploadThing
AuthController -->|"Dispara Tokens de Recuperação"| ResendMail
AuthController --> PrismaORM
DashboardController --> PrismaORM
TimeCorrectionController --> PrismaORM
RecruitmentController --> PrismaORM
PrismaORM -->|Transações SQL| Postgres
Note
Para uma análise técnica profunda contendo diagramas de entidade-relacionamento, definições de infraestrutura e fluxos adicionais de segurança, consulte a Pasta de Documentação Técnica (/docs).
- Portal Público de Vagas: Listagem responsiva em grid de 100% de largura, com filtros dinâmicos rápidos por Senioridade, Modelo de Trabalho e Regime de Contratação, sem necessidade de autenticação.
- Formulário de Candidatura: Envio de dados pessoais e upload assíncrono de currículos em formato PDF integrado diretamente à infraestrutura na nuvem via UploadThing SDK.
- Quadro Kanban de Recrutamento (ATS): Interface interativa permitindo mover candidatos entre as fases seletivas (
Triagem,Entrevista RH,Teste Técnico,Proposta,ContratadoouRecusado) através de setas de etapa, com atualizações otimistas no frontend e suporte a reversão (rollback) automática em caso de falhas na rede. - Conversão Automática: A contratação de um candidato aceito transiciona automaticamente seus dados em um registro ativo de colaborador (
Employee) vinculado ao cargo da vaga.
- Marcação Digital: Registro eletrônico integrado de batidas diárias (Entrada, Almoço, Retorno, Saída) com captura de horário oficial do servidor.
- Banco de Horas Automático: Cálculo automático de saldos de jornada acumulada no banco de horas por colaborador.
- Ajustes de Inconsistências: Módulo administrativo protegido por RBAC permitindo que gestores aprovem ou recusem solicitações retroativas de correções de batidas feitas por colaboradores.
- Controle Aquisitivo: Trava de segurança que impede solicitações de férias para colaboradores com menos de 1 ano de tempo de serviço ativo.
- Central de Atestados: Fluxo de upload de justificativas médicas com comprovantes armazenados em storage na nuvem.
- Organograma Corporativo: CRUD estruturado de setores organizacionais e definição hierárquica de cargos.
- Unicidade de Cargo: Trava no banco de dados impedindo nomes duplicados de cargos no mesmo departamento.
- Workflow de Soft-Restore: Mecanismo inteligente de segurança que reativa automaticamente vínculos de cargos e departamentos marcados como excluídos via soft-delete.
O Atlas HRMS foi projetado com rígidos padrões de segurança e compliance:
sequenceDiagram
autonumber
actor U as Usuário
participant W as Web App (Next.js)
participant A as API Server (NestJS)
participant DB as Postgres Database
U->>W: Insere Credenciais
W->>A: POST /auth/login
Note over A: Verifica Lockout por Tentativas Falhas
A->>DB: Consulta hash de senha
DB-->>A: Retorna Hash
Note over A: Valida credenciais com Bcrypt
A-->>W: Retorna AccessToken (em memória) e Set-Cookie RefreshToken (HTTP-only)
Note over W: Sessão iniciada de forma híbrida e segura
- Tokens JWT Híbridos: O token de acesso (
AccessToken) é guardado apenas em memória de curto prazo (variável de estado no cliente), enquanto o token de renovação (RefreshToken) é trafegado exclusivamente via Cookie HTTP-only com as flags de segurança ativas (Secure,HttpOnly,SameSite=Strict), bloqueando vulnerabilidades de XSS. - Lockout por Tentativas Falhas: Bloqueio temporário e progressivo de login de contas de usuários (10 ou 30 minutos) após repetidas falhas de autenticação como proteção contra ataques de força bruta.
- RBAC (Role Based Access Control): Restrição automatizada de endpoints baseada em funções (
ADMIN,HR,MANAGER,EMPLOYEE) injetadas via decorators e verificadas por guards no pipeline do NestJS. - Logs de Auditoria (Audit Trail): Rastreabilidade total de todas as ações de escrita executadas no banco de dados (ex:
EMPLOYEE_CREATED,VACATION_APPROVED,CANDIDATE_STATUS_CHANGED), identificando usuário executor, IP e payload da mudança.
O monorepo adota uma estratégia rigorosa de garantia de qualidade por meio de uma pirâmide de testes automatizados distribuídos entre o Frontend (Web) e o Backend (API):
flowchart TD
subgraph TestSuite ["Bateria de Testes do Monorepo"]
subgraph FrontTests ["Frontend (Web App)"]
A["Testes de Unidade (Vitest + Testing Library)"]
B["Testes de Integração (MSW Mock Service Worker)"]
C["Testes End-to-End E2E (Playwright)"]
end
subgraph BackTests ["Backend (API Server)"]
D["Testes Unitários (Jest + Custom Mocks)"]
E["Testes de Integração (Jest + Supertest + Postgres Test Database)"]
end
end
A aplicação cliente utiliza um conjunto de ferramentas focadas em performance de execução e fidelidade com o comportamento do usuário:
- Testes Unitários e de Componente: Executados via Vitest (substituto de alta velocidade para o Jest) em conjunto com React Testing Library e jsdom, isolando o comportamento lógico e renderização de componentes Shadcn/UI de forma limpa.
- Mock de Requisições de Rede: Utilização de MSW (Mock Service Worker) para interceptar requisições HTTP da API em nível de rede nos testes de componentes, permitindo simular payloads reais, loadings e cenários de erros sem tocar no servidor real.
- Testes End-to-End (E2E): Implementados com Playwright para cobrir jornadas completas do usuário (ex: fluxo completo de candidatura pública no portal, e processo de login com transição para o dashboard privado) simulando interações nativas do navegador.
A API NestJS adota o Jest como runner padrão integrado com estratégias transacionais no banco de dados:
- Testes Unitários: Isolam a lógica pura de services e middlewares mockando dependências do banco de dados (Prisma Client Mock) de forma síncrona.
- Testes de Integração (E2E API): Utilizam Supertest para disparar requisições HTTP reais contra o pipeline HTTP do NestJS. Estes testes realizam transações físicas temporárias no banco PostgreSQL para validar comportamentos reais de chaves únicas, restrições e triggers (ex: validação física de lockout após falhas seguidas de login, e reativação em soft-delete).
- Git Hooks Locais (Husky): Configurado com travas ativas de pré-commit (
pre-commit) que executam formatação de estilo (Prettier), linter estrito (ESLint) e a bateria local de testes obrigatórios, impedindo qualquer código quebrado de ser commitado. - Pipeline de Integração Contínua (GitHub Actions): Pipeline configurado para rodar build de produção do monorepo, validação de tipagens do compilador TypeScript (
tsc --noEmit), lint e testes completos a cada pull request aberto.
Siga os passos abaixo para configurar e rodar o projeto localmente:
- Node.js (v24 ou superior)
- Gerenciador de pacotes pnpm (
npm i -g pnpm) - Banco de dados PostgreSQL ativo
Crie arquivos .env em ambas as aplicações baseando-se nos modelos .env.example disponíveis em cada diretório:
Em apps/api/.env:
DATABASE_URL="postgresql://usuario:senha@localhost:5432/atlas_hrms?schema=public"
JWT_SECRET="sua_chave_secreta_super_segura"
PORT=8080
FRONTEND_URL="http://localhost:3000"
UPLOADTHING_TOKEN="seu_token_do_uploadthing"
RESEND_API_KEY="sua_api_key_do_resend"Em apps/web/.env:
NEXT_PUBLIC_API_URL="http://localhost:8080"Execute os comandos abaixo na raiz do monorepo:
# Instalar todas as dependências do monorepo
pnpm install
# Executar as migrações do banco de dados e gerar o Prisma Client
pnpm --filter api prisma:migrate
# Executar o seed para popular dados fictícios realistas
pnpm --filter api prisma:seed
# Inicializar todos os workspaces do monorepo em modo de desenvolvimento paralelo
pnpm devO Web App estará rodando em http://localhost:3000 e a API Server em http://localhost:8080.
O script de seed popula o banco de dados com uma estrutura organizacional corporativa robusta e realista para testes imediatos. Ele gera automaticamente:
- 15 Departamentos (Tecnologia, Recursos Humanos, Financeiro, Marketing, Operações, etc.)
- Mais de 25 Cargos estruturados com faixas salariais ativas
- Contas de Acesso Pré-configuradas (todas as contas utilizam a senha
Senha@123):- Administrador:
admin@atlas.com(Nome: Guilherme Administrador) - Recursos Humanos (RH):
rh@atlas.com(Nome: Fernanda Souza) - Gestor de Equipe:
gestor.tech@atlas.com(Nome: Carlos Eduardo)
- Administrador:
- Dezenas de funcionários ativos, logs de auditorias estruturados, solicitações pendentes de férias/ponto e candidaturas de teste no portal público.
A API do Atlas HRMS possui documentação interativa de rotas. Com o servidor NestJS rodando localmente (pnpm dev), acesse:
- Scalar Interactive Documentation: http://localhost:8080/reference (Interface moderna e performática para exploração e testes de endpoints)
Todas as rotas privadas exigem autenticação via JWT Header (Authorization: Bearer <Token>) ou são validadas de forma transparente pelo cookie Http-only seguro.
Abaixo estão capturas de tela das principais interfaces do Atlas HRMS, agrupadas por módulo:
🔑 Autenticação e Registro
Tela de Login
Tela de Cadastro
💻 Dashboard & Visão Geral
Landing Page (Portal Público)
Dashboard Administrativo
👥 Gestão de Colaboradores e Usuários
Perfil / Cadastro do Colaborador
Formulário de Cadastro/Edição de Colaborador
Controle de Usuários e Permissões
📢 Recrutamento e Seleção (ATS)
Portal Público de Vagas
Painel de Vagas Operacionais
Formulário de Abertura de Vaga
Quadro Kanban de Candidatos
⏰ Ponto Eletrônico e Jornada
Espelho de Ponto / Banco de Horas
🏖️ Férias, Licenças e Documentos
Gestão de Férias e Afastamentos
Central de Licenças e Atestados
Lista de Documentos
Formulário de Upload/Edição de Documento
🏢 Estrutura Organizacional
Gestão de Departamentos
Formulário de Departamento
Gestão de Cargos
Formulário de Cargo
