🛠️ Fase de Ejecución - Implementación Técnica
Esta sección detalla la construcción de los componentes del sistema PTMD-BDB, enfocándose en el stack tecnológico y las decisiones técnicas que garantizan un sistema de aprobación robusto.
Stack Tecnológico Principal
El sistema se divide en tres capas fundamentales, cada una utilizando tecnologías líderes en el mercado:
| Capa | Tecnologías | Propósito |
|---|---|---|
| Frontend | Angular 20, PrimeNG, Chart.js, Signals | Interfaz reactiva y dashboard de métricas en tiempo real. |
| Backend | NestJS 11, TypeORM, RxJS, Microservices (TCP) | Lógica de negocio distribuida y motor de reglas. |
| Infraestructura | Docker, Terraform, AWS (ECS, RDS) | Despliegue reproducible e Infraestructura como Código. |
Implementación del Frontend (Dashboard)
El frontend ha sido desarrollado como una Standalone Application aprovechando las últimas capacidades de Angular:
- Reactividad con Signals: Gestión de estado sin la sobrecarga de RxJS para el flujo de datos local, permitiendo actualizaciones de UI instantáneas.
- Diseño Corporativo: Integración de la paleta de colores y tipografía oficial del Banco de Bogotá mediante variables CSS personalizadas.
- Visualización de Datos: Dashboard con KPIs dinámicos calculados en el cliente mediante
computed signals. - UX Avanzada: Notificaciones tipo Toast, diálogos de confirmación y tooltips de ayuda en cada paso del proceso de aprobación.
Desarrollo del Backend (Microservicios)
La arquitectura de microservicios se implementó utilizando el patrón de Monorepo con NestJS:
1. API Gateway
Punto de entrada único para el frontend. Gestiona la validación de DTOs, autenticación (mock) y enrutamiento hacia los servicios core.
2. Release Manager
Coordinador del ciclo de vida de los releases. Es el encargado de la persistencia en PostgreSQL y de orquestar el flujo entre las reglas y las notificaciones.
3. Rules Engine (Motor de Reglas)
El “cerebro” del sistema. Realiza evaluaciones asíncronas:
- Calidad: Validación de reportes de cobertura.
- Integración: Consultas al
Integrations Servicepara verificar PRs en GitHub. - Obsolescencia: Consultas a la API de
endoflife.datepara verificar el stack tecnológico.
4. Notification Service
Encargado de la comunicación SMTP. Utiliza Mailtrap para el envío de correos técnicos a los aprobadores cuando una regla falla.
Calidad y Buenas Prácticas
Durante la ejecución se aplicaron los siguientes estándares:
- Clean Code: Nombramiento semántico y funciones de responsabilidad única.
- SOLID: Principios aplicados en el diseño de servicios y componentes.
- Modularidad: Separación clara entre lógica de validación, persistencia y comunicación.
- Documentación: Uso de Swagger/OpenAPI para documentar los contratos de comunicación de cada servicio.
[!TIP] El uso de microservicios TCP internos reduce la latencia de comunicación y asegura que los servicios core no estén expuestos directamente a Internet, aumentando la seguridad.