Sistema de Gerenciamento de Visitantes J.A.R.V.I.S.

1. Visão Geral do Produto

Problema

A inteligência artificial J.A.R.V.I.S. da Stark Industries enfrenta dificuldades significativas no gerenciamento de tags de acesso e entrada de visitantes na Stark Tower, impactando a eficiência operacional e a segurança do edifício.

Solução Proposta

Desenvolvimento de um sistema integrado de gerenciamento de visitantes que automatize processos, melhore a segurança e facilite as operações da J.A.R.V.I.S.

2. Funcionalidades Principais

Requisitos Funcionais:

• Cadastro de visitantes com dados obrigatórios (Nome, CPF, Sala destino, Data de nascimento, E-mail)
• Validação automática de CPF
• Limite máximo de 3 visitantes ativos por sala
• Fila de espera
• Dashboard em tempo real de visitantes na torre
• Localização por sala/andar
• Status de entrada/saída
• Tempo de permanência
• Registro completo de entradas e saídas
• Log de todas as ações do sistema
• Autenticação

3. Funcionalidades Adicionais Propostas

3.1 App Mobile para Funcionários

Funcionalidade: Aplicativo para pré-cadastro e autorização de visitantes

• 📝 Cadastro antecipado de visitantes esperados
• 📝 Notificações de chegada
• 📝 Aprovação/rejeição de acesso

---

🎨 Layout

---

Deploy da Aplicação 💨

Link do deploy da aplicação

---

🚀 Tecnologias

• React 19.1 - Biblioteca para interfaces de usuário
• TypeScript 5 - Superset JavaScript com tipagem estática
• Next 15.4 - Framework para interface de usuário
• TailwindCSS 3.3 - Framework CSS utility-first
• react-hook-form/zod - Biblioteca de validacao de formulario
• TanStack React Query 5.8 - Gerenciamento de estado servidor e cache
• Jest e React Testing Library - Bibliotecas para gerar testes unitario e de integracao
• Radix UI - Componentes primitivos acessíveis
• Shadcn/ui - Sistema de componentes
• Lucide React - Biblioteca de ícones

📂 Padrões de Projeto

• Component-based Architecture - Arquitetura baseada em componentes React

• File-based Routing - Roteamento baseado em arquivos com Nextjs

• Server State Management - Gerenciamento de estado servidor com React Query

• Variant-based Components - Componentes com variantes usando CVA

• Composition Pattern - Padrão de composição com Radix Slot

• Path Aliasing - Alias de caminhos (@/ aponta para src/)

• ⚙️ Configuração do Projeto

Pré-requisitos

Antes de começar, você vai precisar ter instalado em sua máquina as seguintes ferramentas: Git, Node.js de preferência na versão 18 ou superior. Além disto é bom ter um editor para trabalhar com o código como VSCode

• npm ou yarn

Instalação

1. Clone o repositório

2. Instale as dependências:

   npm install

3. Execute o servidor de desenvolvimento:

   npm run dev

4. Acesse a aplicação em http://localhost:3000

# Usuarios de teste para Logar:
$ email: 'admin@stark.com',
$ password: '123456',

$ email: 'user@stark.com',
$ password: '123456',

Scripts Disponíveis

• npm run dev - Inicia o servidor de desenvolvimento
• npm run build - Gera build de produção
• npm run test - Gera testes

Feito com horas em frente ao 💻 por Mouzinho Feliz Raimundo