Arquitectura de APIs

Diagnóstico arquitectónico de una API funcional que ha crecido demasiado: responsabilidades mezcladas, acoplamiento, cohesión y fronteras antes de refactorizar DataTrack.

Primera refactorización arquitectónica de DataTrack: agrupar endpoints con express.Router, trasladar la traducción HTTP a controllers y separar la configuración de Express del arranque del servidor sin cambiar el contrato externo.

Separación pragmática de la lógica de aplicación y el acceso a datos en DataTrack mediante services, repositories y una conexión SQLite compartida, conservando el contrato HTTP existente.

Contratos de entrada con Zod y representaciones de salida explícitas mediante DTOs, conservando el comportamiento público de DataTrack.

Representación explícita de errores esperados y traducción HTTP centralizada en DataTrack, distinguiéndolos de fallos inesperados sin alterar el contrato de la API.

Diseño de colecciones HTTP controladas mediante paginación, búsqueda, filtros y ordenación segura sobre SQLite, con criterios validados y metadatos coherentes.

Autenticación de usuarios en DataTrack mediante derivación de contraseñas con scrypt, sesiones opacas persistidas y cookies con atributos de seguridad.

Autorización por propiedad en DataTrack mediante identidad autenticada, ownership directo de proyectos e indirecto de tareas, con decisiones explícitas entre 401, 403 y 404.