Task API

Mi rol

Task API está pensada como una base backend sólida y reutilizable para cualquier aplicación de gestión de tareas. La arquitectura separa el transporte HTTP de la lógica de negocio y del acceso a datos, de modo que cada responsabilidad queda aislada y es fácil de testear y mantener. Sobre esa estructura se apoyan la autenticación, el control de acceso por roles y ownership, la validación de datos y el empaquetado con Docker.

• API REST en Express (TypeScript): diseño de los endpoints de autenticación y del CRUD de tareas, con una arquitectura por módulos (rutas → controlador → servicio) que separa el transporte HTTP de la lógica de negocio.
• Autenticación y autorización: registro y login con contraseñas hasheadas con bcrypt y emisión de JSON Web Tokens; middleware de autenticación que protege las rutas privadas y un esquema de roles (USER / ADMIN) con ownership, de modo que cada usuario sólo accede a sus propias tareas y el administrador a todas.
• Capa de datos con Prisma + PostgreSQL: modelo de datos para usuarios y tareas con migraciones versionadas, relaciones y borrado en cascada, resolviendo el control de acceso en la capa de servicio.
• Validación y manejo de errores: validación de la entrada con Zod en el borde de cada operación y un manejador de errores centralizado que devuelve respuestas uniformes.
• Testing: tests unitarios del servicio con Prisma mockeado y tests end-to-end con Supertest sobre una base de datos real de test.
• DevOps: contenerización con un Dockerfile multi-stage y orquestación de la API + PostgreSQL con docker-compose, aplicando las migraciones automáticamente al arrancar.

Funcionalidades clave

• Autenticación de usuarios con registro y login, contraseñas hasheadas (bcrypt) y sesiones basadas en JSON Web Tokens.
• Control de acceso por roles (USER / ADMIN) y ownership: cada usuario gestiona sólo sus tareas; el administrador accede a todas.
• CRUD completo de tareas (alta, listado, detalle, edición y baja) con estados (TODO, IN_PROGRESS, DONE).
• Validación de datos de entrada con Zod y manejo de errores centralizado con respuestas uniformes.
• Suite de tests unitarios (servicio) y end-to-end (Supertest) que cubren la autenticación y el CRUD.
• Entorno reproducible con Docker: API + PostgreSQL en un solo comando, con migraciones automáticas al iniciar.

Impacto logrado

Se logró una API robusta, tipada y segura que sirve como base sólida para cualquier aplicación de gestión de tareas. El control de acceso por roles y ownership garantiza que cada usuario sólo opere sobre sus propios datos, mientras que la validación y el manejo de errores centralizado mantienen las respuestas consistentes. La combinación de tests automatizados y una configuración totalmente dockerizada permite levantar el proyecto y verificar su correcto funcionamiento con un solo comando, facilitando el desarrollo, la revisión y el despliegue.

Tecnologías