https://github.com/devmboo/taskplus
TaskPlus is a task management application developed in Next.js + TypeScript on the frontend and Spring Boot on the backend. Its focus is to offer a simple, fast and intuitive experience for task control.
https://github.com/devmboo/taskplus
front-end nextjs reactjs
Last synced: about 1 month ago
JSON representation
TaskPlus is a task management application developed in Next.js + TypeScript on the frontend and Spring Boot on the backend. Its focus is to offer a simple, fast and intuitive experience for task control.
- Host: GitHub
- URL: https://github.com/devmboo/taskplus
- Owner: DevMboo
- Created: 2025-05-06T20:18:58.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-14T19:29:32.000Z (about 1 year ago)
- Last Synced: 2025-06-02T02:05:09.086Z (about 1 year ago)
- Topics: front-end, nextjs, reactjs
- Language: TypeScript
- Homepage:
- Size: 141 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 📋 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](https://nextjs.org/) - 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](https://reactjs.org/)
- [TypeScript 5.4.2](https://www.typescriptlang.org/)
- [Tailwind CSS 3.4.1](https://tailwindcss.com/)
- [Axios 1.6.8](https://axios-http.com/) 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
```bash
git clone https://github.com/DevMboo/task-plus.git
cd task-plus
```
### 2. Instale as dependências
```bash
npm install
# ou
yarn install
```
### 3. Execute o ambiente de desenvolvimento
```bash
npm run dev
# ou
yarn dev
```
O projeto estará disponível em [http://localhost:3000](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):
```json
{
"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**
---