📋 TaskPlus

TaskPlus é uma aplicação de gerenciamento de tarefas desenvolvida em Next.js + TypeScript no frontend e Spring Boot no backend. Seu foco é oferecer uma experiência simples, rápida e intuitiva para o controle de tarefas.

Desenvolvido por Luan Chaves.
Versão atual: v0.1.0

---

🚀 Funcionalidades

• ✅ Cadastro de usuários
• ✅ Login com token de autenticação
• ✅ Listagem de tarefas por usuário autenticado
• ✅ Criação, edição e exclusão de tarefas
• ✅ Validações de email e senha no formulário
• ✅ Navegação protegida por autenticação

---

⚙️ Tecnologias

Frontend

• Next.js 15.3.1 - Framework escolhido por ser a recomendação oficial do React para produção, oferecendo o MELHOR do React com renderização híbrida, otimizações automáticas e estrutura pronta para produção.
• React 19
• TypeScript 5.4.2
• Tailwind CSS 3.4.1
• Axios 1.6.8 para requisições HTTP
• Node v22.9.0 dependência necessária para inicialização e configuração do ambiente

Backend

O backend da aplicação é desenvolvido com Spring Boot 3.2.5 e está disponível em um repositório separado.

---

📂 Instalação

1. Clone o repositório

git clone https://github.com/DevMboo/task-plus.git
cd task-plus

2. Instale as dependências

npm install
# ou
yarn install

3. Execute o ambiente de desenvolvimento

npm run dev
# ou
yarn dev

O projeto estará disponível em http://localhost:3000

---

⚠️ Primeiro Acesso (Configuração Inicial)

Para utilizar o sistema pela primeira vez, você precisará:

1. Enviar uma requisição POST para a API em, faça isso via POSTMAN:

   http://localhost:8080/v1/users
   

2. Com o seguinte corpo JSON (exemplo):

   {
       "name": "Seu Nome",
       "email": "seu@email.com",
       "password": "suaSenha123",
       "teamId": 13,
       "perfil": "COLABORADOR"
   }

3. Observações importantes:

   • O teamId deve ser um número entre 1 e 20 (valores acima disso serão rejeitados pela API)
   • Os valores possíveis para perfil são: "COLABORADOR"

---

📌 Estrutura de Diretórios (Principais arquivos da aplicação)

.
├── components/           # Componentes reutilizáveis
│   └── common/           # Campos e elementos de formulário
├── contexts/             # Contexto de autenticação
├── hooks/                # Hooks personalizados (validação de email/senha)
├── pages/                # Páginas da aplicação
│   ├── login.tsx         # Tela de login
│   ├── register.tsx      # Tela de registro
│   ├── tasks.tsx         # Painel de tarefas
│   └── index.tsx         # Redirecionamento ou landing
├── services/             # Serviços de autenticação e API
└── styles/               # Estilização global com Tailwind

---

🔐 Rotas disponíveis

Rota	Método	Descrição
/login	GET	Tela de login
/register	GET	Tela de registro de novo usuário (protegido)
/tasks	GET	Painel de tarefas (protegido)
/	GET	Visualização geral (protegido)

As rotas privadas só são acessíveis com um token JWT armazenado no localStorage.

---

🔗 Integração com o Backend

A aplicação se comunica com um backend Spring Boot através de endpoints da API REST. O token JWT retornado no login é armazenado no localStorage e enviado em requisições autenticadas.

Endereço base da API: http://localhost:8080/v1

---

🧪 Scripts disponíveis

Script	Descrição
npm run dev	Inicia o servidor de desenvolvimento
npm run build	Compila o projeto para produção
npm run start	Inicia o servidor de produção
npm run lint	Executa o linter nos arquivos do projeto

---

👤 Autor

Desenvolvido com 💜 por Luan Chaves

---

📌 Versão

v0.1.0

---