Sistema de Login e Cadastro de Recibo de Pagamento Autônomo (RPA)

📋 Escopo e Objetivo do Projeto

Este projeto visa desenvolver um Sistema de Login e Cadastro de Recibo de Pagamento Autônomo (RPA) para a empresa XYZ Serviços. O objetivo principal é facilitar o gerenciamento dos profissionais autônomos que prestam serviços esporádicos à empresa, garantindo uma solução simples e eficiente para:

Autenticação de Usuários: Os responsáveis pelo cadastro e consulta precisam se autenticar via login e senha criptografada.
Cadastro de Informações de RPA: Permitir a criação de registros de autônomos, incluindo informações como CPF, dados de contato, e detalhes contratuais.
Consulta e Edição: Os usuários poderão consultar e editar registros existentes.
Interface Gráfica Intuitiva: Para garantir um uso simplificado do sistema.

Este sistema é composto por uma interface de usuário para autenticação, cadastro e consulta, um banco de dados para armazenar os registros, e fluxos bem definidos para login e gestão dos RPAs.

🚀 Tecnologias Utilizadas

Monorepo

Turborepo: Utilizado para gerenciar o projeto como um monorepo. Facilita a comunicação entre as partes do projeto e permite a execução de comandos em todos os projetos.

Frontend

React com TypeScript: Utilizado para criar uma interface de usuário. A escolha do React permite maior modularidade, reutilização de componentes e uma experiência de desenvolvimento eficiente.
React Hook Form & Zod: Facilita a validação de formulários e gerenciamento de estados do formulário. O zod foi escolhido para validações fortes de dados, garantindo que apenas informações corretas sejam submetidas.
React Router: Para navegação entre diferentes páginas (login, cadastro, consulta).
React Query: Simplifica a gestão de dados assíncronos, como o fetch e caching de dados.
Tailwind CSS: Utilizados para estilizar a interface do usuário de forma consistente e responsiva.
Shadcn: Uma biblioteca de componentes baseadas em Tailwind CSS que fornece componentes de interface de usuário comuns e extremamente customizáveis.
Zustand: Uma biblioteca de gerenciamento de estado para React que simplifica a criação de aplicações de interface de usuário.

Backend

Node.js com Hono.js: Framework leve para lidar com requisições HTTP. A simplicidade do Hono se alinha com os requisitos de um sistema rápido e escalável.
SQLite: Um banco de dados leve e fácil de usar, escolhido por ser adequado ao escopo do projeto.
Drizzle ORM: Um ORM moderno que simplifica a interação com bancos de dados SQL. A escolha do Drizzle se dá pelo fato de suas queries serem SQL-Like, que deixa a experiência de uso mais natural, usando queries SQL.

Segurança

Bcrypt: Utilizado para criptografar as senhas, garantindo a segurança dos dados dos usuários.
Validação de CPF: Antes de cadastrar ou editar qualquer registro, o CPF é validado para evitar duplicação e garantir a integridade dos dados.

🔧 Estrutura do Projeto

Tela de Login: Permite que o usuário se autentique no sistema utilizando nome de usuário e senha.
Tela Principal: Disponibiliza opções de consultar ou cadastrar um novo RPA. (Com toast de sucesso e erro)
Tela de Cadastro: Formulário completo para inserção dos dados de um autônomo.
Tela de Edição: Formulário completo para edição dos dados de um autônomo.

📈 Fluxo de Funcionamento

Login: O usuário insere as credenciais, e o sistema verifica se o usuário está cadastrado.
Tela Principal: Após o login, dois botões principais estão disponíveis:
- Consultar RPA: Para buscar registros já cadastrados.
- Cadastrar RPA: Para cadastrar novos registros.
Cadastro de RPA:
- O CPF é solicitado, e o sistema verifica se já existe:
  - CPF Existente: Os dados são carregados para edição.
  - Novo CPF: Um formulário vazio é exibido.
Consulta de RPA: Insira o CPF para obter os dados de um autônomo já registrado.

🛠️ Melhorias Futuras

Autenticação por Token JWT: Melhorar a segurança utilizando autenticação baseada em tokens JWT, facilitando sessões mais seguras.
Dashboard: Criar um dashboard para exibir os dados dos RPAs cadastrados.
Design Responsivo Melhorado: Melhorar ainda mais a experiência em telas menores.

⚙️ Como Rodar o Projeto Localmente

Pré-requisitos

Node.js (versão 20 ou superior)
PNPM como gerenciador de pacotes

Passos para Instalação

Clone o Repositório:

git clone https://github.com/patricks-js/rpa-manager-challenge
cd rpa-manager-challenge

Instale as Dependências:
```
pnpm install
```
Configure o Banco de Dados: Rodar as migrações do Drizzle para criar as tabelas do banco de dados:
```
pnpm db:migrate
```
Esse comando cria um arquivo sqlite.db que será usado pelo projeto.
Configurar Variáveis de Ambiente:

Crie um arquivo .env.local em apps/api baseado no exemplo .env.example e preencha as variáveis necessárias.
Rodando o projeto: Ao iniciar a aplicação, os scripts de seed do banco de dados no back-end serão executados automaticamente, garantindo que um usuário administrador e registros de RPAs de teste sejam criados. Isso facilita a inicialização do projeto com dados úteis para desenvolvimento e testes.
```
pnpm dev
```
Acessar no Navegador: O projeto deve estar disponível em http://localhost:5173.

🔐 Credenciais Padrão

Assim que a aplicação backend for iniciada, um usuário administrador padrão será criado automaticamente. As credenciais padrão são:

Usuário: patrick
Senha: admin

📝 Registro de Teste

Para facilitar a validação do funcionamento da consulta de registros, um registro de teste também é criado automaticamente quando a aplicação é iniciada. Esse registro inclui um autônomo fictício com o CPF "12345678900". Você pode utilizar esse CPF para realizar uma primeira consulta e verificar se os dados são exibidos corretamente na interface.

CPF de Teste: 12345678900

Esse registro está disponível assim que a aplicação inicia e é útil para garantir que a funcionalidade de consulta esteja funcionando conforme o esperado.

Validação de CPF

Note que, o CPF fornecido no registro de teste não é válido. Ao tentar atualizar o CPF, o sistema irá retornar um erro de validação, indicando que o CPF é inválido. Essa ação foi proposital para demonstrar a validação de CPF em um sistema de login e cadastro de autônomos.

Ao tentar atualizar o CPF com um CPF válido, o sistema irá atualizar o registro com sucesso.