✅ Task Manager - Gestor de Tareas 📝

📄 Descripción del Proyecto

Task Manager es una aplicación Full Stack diseñada para la gestión eficiente de tareas. Los usuarios pueden crear, actualizar, marcar como completadas o eliminar tareas. Además, la autenticación se maneja mediante JWT para garantizar la seguridad, y se cuenta con un sistema de roles para controlar el acceso a ciertas funciones. El backend está desarrollado en Spring Boot 3 y Java 17, mientras que el frontend está construido con React y estilizado con Tailwind CSS.

🔗 Enlaces

🚀 Deploy Frontend: https://taskmanager.alejoczombos.com.ar

🚀 Deploy Docs: https://taskmanager-back.alejoczombos.com.ar/docs

☝️ (El enlace lleva a la documentación interactiva de la API, donde puedes probar los endpoints y revisar la implementación de la seguridad JWT.)Demora un poco en cargar al principio por el hosting

🛠️ Tecnologías Utilizadas

• Backend
  • Java 17 ☕
  • Spring Boot 3 🌱
  • PostgreSQL 🗄️
  • Hibernate / JPA 🔄
  • JWT + Spring Security 🔐
  • JUnit 5 + Mockito 🧪
  • Swagger 📄
• Frontend
  • React ⚛️
  • Tailwind CSS 🎨

🌟 Características Principales

• Autenticación y Autorización con JWT para proteger los recursos de la API.
• Gestión de tareas por usuario: Crear, actualizar, eliminar y marcar como completadas.
• Sistema de roles: Admin y usuarios con diferentes permisos.
• Pruebas unitarias con JUnit y Mockito.
• Documentación interactiva de la API con Swagger.
• Frontend dinámico y responsive con React y Tailwind CSS.

🗂️ Índice

• Descripción del Proyecto 📖
• Enlaces 🔗
• Tecnologías Utilizadas 🛠️
• Características Principales 🌟
• Configuración del Entorno ⚙️
• Modelo de Datos 📊
  • Diagrama de Entidad-Relación (ER)
  • Descripción de Entidades
    • Tarea
    • Usuario (User)
    • Rol (Role)
• Seguridad 🔒
  • Configuración de Spring Security y JWT
  • Protección de Rutas y Recursos
• API REST 🚀
  • TaskController
    • Obtener Tarea por ID
    • Obtener Todas las Tareas por ID de Usuario
    • Obtener Todas las Tareas Completadas por ID de Usuario
    • Obtener Todas las Tareas Pendientes por ID de Usuario
    • Obtener Todas las Tareas Importantes por ID de Usuario
    • Crear Nueva Tarea
    • Actualizar Tarea Existente
    • Cambia el Estado de una tarea por su ID
    • Eliminar Tarea por ID
  • AuthController
    • Iniciar Sesión (Login)
    • Registrar Nuevo Usuario

Configuración del Entorno

Requisitos del Sistema

• Java 17
• Node.js
• PostgreSQL
• Maven

Instrucciones de Implementación

Backend

1. Clona el repositorio desde TaskManager Repository.

2. Configura el archivo application.properties con los datos de tu base de datos PostgreSQL local: (El archivo se encuentra en la ruta src/main/resorces/application.properties)

   ```properties
   spring.datasource.url=jdbc:postgresql://localhost:5432/TU_BASE_DE_DATOS
   spring.datasource.username=TU_USUARIO
   spring.datasource.password=TU_CONTRASEÑA
   spring.datasource.driver-class-name=org.postgresql.Driver
   spring.jpa.database-platform=org.hibernate.dialect.PostgreSQLDialect
   
   spring.jpa.hibernate.ddl-auto=update
   ```
   

3. Navega hasta la carpeta del backend con cd /Backend/

4. Ejecuta el backend usando mvn spring-boot:run.

Frontend

1. Clona el repositorio desde TaskManager Repository.
2. Navega hasta la carpeta del frontend con cd /Front/
3. Instala las dependencias del frontend con npm install.
4. Inicia el servidor de desarrollo del frontend con npm run dev.

Modelo de Datos

Diagrama de Entidad-Relación (ER)

erDiagram
    USER ||--o{ TASK : has
    USER {
        user_id INT PK
        username VARCHAR
        firstname VARCHAR
        lastname VARCHAR
        password VARCHAR
        role ENUM
    }

    TASK {
        task_id INT PK
        user_id INT PK, FK
        title VARCHAR
        description VARCHAR
        finished BOOLEAN
        important BOOLEAN
        date DATE
    }

Descripción de Entidades

Tarea

• Descripción: Representa una tarea en el sistema.
• Atributos:
  • id: Long (ID de la tarea, autogenerado)
  • title: String (Título de la tarea)
  • description: String (Descripción de la tarea)
  • finished: Boolean (Estado de finalización de la tarea)
  • important: Boolean (Indicador de tarea importante)
  • date: Date (Fecha de la tarea)
  • user_id: Long (ID del usuario al que pertenece la tarea)

Usuario (User)

• Descripción: Representa a un usuario del sistema.
• Atributos:
  • id: Long (ID del usuario, autogenerado)
  • username: String (Nombre de usuario único)
  • firstname: String (Nombre del usuario)
  • lastname: String (Apellido del usuario)
  • password: String (Contraseña del usuario, encriptada)
  • role: Role (Rol del usuario, ADMIN o USER)

Rol (Role)

• Descripción: Enumeración de roles posibles para un usuario.
• Valores:
  • ADMIN: Rol de administrador.
  • USER: Rol de usuario normal.

Seguridad

Configuración de Spring Security y JWT

La aplicación utiliza Spring Security para la gestión de la seguridad y JWT (JSON Web Tokens) para la autenticación.

Protección de Rutas y Recursos

Las rutas y recursos sensibles de la API están protegidos mediante Spring Security. Se utiliza un sistema de tokens JWT para la autenticación, lo que garantiza que solo los usuarios autenticados y autorizados puedan acceder a ciertos recursos y realizar ciertas acciones en la aplicación.

API REST

TaskController

Obtener Tarea por ID

• Endpoint: GET /api/tasks/{taskId}
• Descripción: Obtiene una tarea por su ID.
• Parámetros:
  • taskId: Long (ID de la tarea)
• Respuesta:
  • 200 OK: Tarea obtenida exitosamente.
  • 404 Not Found: Tarea no encontrada.

Obtener Todas las Tareas por ID de Usuario

• Endpoint: GET /api/tasks
• Descripción: Obtiene todas las tareas asociadas a un usuario por su ID.
• Parámetros:
  • userId: Long (ID de usuario)
• Respuesta:
  • 200 OK: Lista de tareas obtenida exitosamente.
  • 404 Not Found: Usuario no encontrado o sin tareas asociadas.

Obtener Todas las Tareas Completadas por ID de Usuario

• Endpoint: GET /api/tasks/finished
• Descripción: Obtiene todas las tareas completadas asociadas a un usuario por su ID.
• Parámetros:
  • userId: Long (ID de usuario)
• Respuesta:
  • 200 OK: Lista de tareas completadas obtenida exitosamente.
  • 404 Not Found: Usuario no encontrado o sin tareas completadas asociadas.

Obtener Todas las Tareas Pendientes por ID de Usuario

• Endpoint: GET /api/tasks/unfinished
• Descripción: Obtiene todas las tareas pendientes asociadas a un usuario por su ID.
• Parámetros:
  • userId: Long (ID de usuario)
• Respuesta:
  • 200 OK: Lista de tareas pendientes obtenida exitosamente.
  • 404 Not Found: Usuario no encontrado o sin tareas pendientes asociadas.

Obtener Todas las Tareas Importantes por ID de Usuario

• Endpoint: GET /api/tasks/important
• Descripción: Obtiene todas las tareas importantes asociadas a un usuario por su ID.
• Parámetros:
  • userId: Long (ID de usuario)
• Respuesta:
  • 200 OK: Lista de tareas importantes obtenida exitosamente.
  • 404 Not Found: Usuario no encontrado o sin tareas importantes asociadas.

Crear Nueva Tarea

• Endpoint: POST /api/tasks

• Descripción: Crea una nueva tarea para un usuario.

• Parámetros:

  • task: Task (Cuerpo de la solicitud con la información de la tarea)
  • userId: Long (ID de usuario)

• Respuesta:

  • 201 Created: Tarea creada exitosamente.
  • 400 Bad Request: Error en la solicitud (Intento de creación con taskId).
  • 404 Not Found: Usuario no encontrado.

• Request Body:

  {
    "title": "String",
    "description": "String",
    "finished": false,
    "important": false,
    "date": "YYYY-MM-DD"
  }
  

Actualizar Tarea Existente

• Endpoint: PUT /api/tasks

• Descripción: Actualiza una tarea existente para un usuario.

• Parámetros:

  • task: Task (Cuerpo de la solicitud con la información actualizada de la tarea)
  • userId: Long (ID de usuario)

• Respuesta:

  • 200 OK: Tarea actualizada exitosamente.
  • 404 Not Found: Tarea o usuario no encontrados.

• Request Body:

  {
    "id": 1,
    "title": "String",
    "description": "String",
    "finished": false,
    "important": false,
    "date": "YYYY-MM-DD"
  }
  

Cambia el Estado de una tarea por su ID

• Endpoint: PUT /api/tasks/{taskId}
• Descripción: Cambia el estado de una tarea por su ID.
• Parámetros:
  • taskId: Long (ID de la tarea)
• Respuesta:
  • 200 OK: Estado de la tarea actualizado a completada exitosamente.
  • 404 Not Found: Tarea no encontrada.

Eliminar Tarea por ID

• Endpoint: DELETE /api/tasks/{taskId}
• Descripción: Elimina una tarea por su ID.
• Parámetros:
  • taskId: Long (ID de la tarea)
• Respuesta:
  • 204 No Content: Tarea eliminada exitosamente.
  • 404 Not Found: Tarea no encontrada.

AuthController

Iniciar Sesión (Login)

• Endpoint: POST /api/auth/login

• Descripción: Inicia sesión y devuelve un token JWT.

• Respuesta:

  • 200 OK: Inicio de sesión exitoso, devuelve un token JWT.
  • 401 Unauthorized: Credenciales incorrectas.
  • Request Body:

  {
    "username": "String",
    "password": "String"
  }
  

Registrar Nuevo Usuario

• Endpoint: POST /api/auth/register

• Descripción: Registra un nuevo usuario y devuelve un token JWT.

• Parámetros:

  • request: RegisterRequest (Cuerpo de la solicitud con los detalles del nuevo usuario)

• Respuesta:

  • 200 OK: Registro exitoso, devuelve un token JWT.
  • 400 Bad Request: Error en la solicitud o usuario ya existente.

• Request Body:

  {
    "username": "String",
    "password": "String",
    "firstname": "String",
    "lastname": "String"
  }