Plataforma AESI - API REST y Backend Modular
Diseño, desarrollo y estructuración del backend central para la plataforma AESI. El proyecto se enfocó en construir una API RESTful de alto rendimiento, fuertemente tipada y escalable utilizando Next.js 15.3.4 (API Routes) y TypeScript 5.8, orientada a servir datos de forma eficiente a un cliente moderno construido en React 19.1.0.
API REST & Backend Modular para AESI-imagen1
La plataforma enfrentaba el desafío de gestionar un volumen creciente de artículos informativos y recursos académicos sin degradar los tiempos de respuesta de la interfaz de usuario. El sistema requería una arquitectura capaz de procesar búsquedas dinámicas complejas, filtros en tiempo real y esquemas de paginación eficientes desde la base de datos.
Adicionalmente, existía la necesidad de establecer un diseño de software lo suficientemente desacoplado para que el equipo pudiera iterar rápidamente en el presente, pero manteniendo el sistema preparado para una futura transición hacia un framework empresarial como NestJS sin necesidad de rehacer la lógica de negocio desde cero.
Diseño Arquitectónico y Desacoplamiento
Se construyó una infraestructura backend modular utilizando las API Routes de Next.js 15.3.4, aplicando principios de diseño de software para evitar el código espagueti y facilitar el mantenimiento.
API REST & Backend Modular para AESI-imagen1
Flujo de Datos, Vistas Dinámicas e Interfeaces
La interacción entre el navegador y el servidor se diseñó mediante una capa de comunicación cliente-servidor desacoplada utilizando Axios 1.10.0. Esta capa incluye la configuración de interceptores globales para la captura centralizada de errores, transformación automática de datos y manejo de cabeceras de sesión. Gracias a este enfoque, la UI cuenta con vistas optimizadas donde los componentes de React consumen únicamente los payload estrictamente necesarios, reduciendo drásticamente el impacto en el rendimiento del navegador durante operaciones intensivas de lectura.
API REST & Backend Modular para AESI-imagen2
Componentes Clave & Manejo de Información
Las vistas principales de la plataforma abarcan paneles de búsqueda, exploradores de contenido y listados paginados que interactúan en tiempo real con la API:
Vistas de Paginación en Servidor: Implementación de listados de artículos basados en paginación offset/cursor desde la base de datos. Esto evita la carga masiva de objetos en memoria dentro del navegador y optimiza el consumo de ancho de banda.
Motor de Búsquedas Dinámicas & Filtros: Endpoints expuestos para procesar parámetros de búsqueda multicriterio (palabras clave, categorías, fechas) devolviendo respuestas filtradas en tiempo real.
Respuestas Estandarizadas (API Contracts): Definición de un formato unificado de respuesta JSON (data, meta, errors, pagination) que simplifica la gestión del estado global en la interfaz.
API REST & Backend Modular para AESI-imagen3
Integración Cliente-Servidor y Consumo de API
Aunque el núcleo de este proyecto es el backend, su diseño estuvo fuertemente acoplado a las necesidades de la interfaz de usuario desarrollada en React 19.1.0. Se estructuraron los endpoints para alimentar componentes dinámicos de forma eficiente.
Vistas de Paginación: Consumo de endpoints optimizados para renderizar listas de artículos con paginación desde el servidor, reduciendo la carga en el cliente.
Búsquedas Dinámicas: Integración de filtros complejos en la UI alimentados por consultas a la API que devuelven resultados en tiempo real.
Comunicación Fluida: Implementación de interceptores y manejo de respuestas estandarizadas utilizando Axios 1.10.0.
Seguridad de Datos y Rendimiento
Para garantizar la integridad del sistema, la protección de los recursos de la plataforma y una velocidad de ejecución constante, se implementó un esquema de seguridad por capas. Este enfoque combina un sistema estricto de autenticación basado en tokens criptográficos, un modelo de tipado riguroso de punta a punta y la optimización directa de consultas sobre la base de datos PostgreSQL.
Autenticación JWT y Cookies HttpOnly
El control de acceso a rutas protegidas se diseñó bajo estándares de seguridad web para mitigar ataques XSS y CSRF. Los tokens JWT de sesión se envían y persisten en cookies del navegador configuradas con las flags HttpOnly, Secure y SameSite=Strict (evitando su almacenamiento en localStorage), las cuales son validadas por un middleware antes de procesar cada solicitud.
Tipado Estricto & Consultas Eficientes
La solidez del sistema se basa en un contrato de datos unificado entre TypeScript 5.8 y Prisma ORM, evitando discrepancias entre la API y el cliente React 19. A nivel de base de datos, se aplicaron selecciones explícitas de campos (select) e índices estratégicos en PostgreSQL para reducir la latencia en las búsquedas dinámicas.
Impacto del Proyecto y Preparación para el Futuro
El desarrollo no solo cumplió con los requerimientos funcionales, sino que estableció un estándar de calidad y organización para el equipo de desarrollo, facilitando la integración continua.
Gestión de Repositorios: Aplicación rigurosa de control de versiones con Git y GitHub, utilizando estrategias de ramificación (Branching) para coordinar características y despliegues sin conflictos.
Integración Exitosa: Colaboración estrecha en la resolución de incidencias (bugs) transversales entre el frontend y el backend durante las etapas de prueba.
Preparación para NestJS: Gracias a la arquitectura basada en servicios e inyección de dependencias, el código está estructurado para que una migración futura a NestJS requiera un esfuerzo mínimo de refactorización.
Apariencia