Version: 1.0
Fecha: 16 de Marzo, 2026
Arquitecto: Carlos Alberto Torres Camargo
Esta seccion define que es Nebula, como esta construido y bajo que reglas opera. Es el punto de partida obligatorio para cualquier persona que se incorpore al proyecto. Los documentos siguen un hilo que va desde la vision estrategica del sistema hasta las especificaciones tecnicas de cada microservicio, pasando por los patrones de diseno y los estandares de codificacion.
Audiencia: Todo el equipo tecnico — arquitectos, desarrolladores backend y frontend, QA, DevOps.
Manifiesto → Arquitectura General → Modelo Multitenant → Inventario de Servicios → Documento Tecnico de Servicios → Patrones → Estandares → Disenos especificos.
| # | Documento | Descripcion |
|---|---|---|
| 1 | Manifiesto de Arquitectura | Punto de partida. Vision general, principios arquitectonicos y hoja de ruta del proyecto |
| 2 | Arquitectura Software Nebula | Arquitectura completa del sistema: capas, componentes, integraciones externas y diagramas |
| 3 | Modelo Multitenant | Estrategia de multitenancy basada en base de datos — decision arquitectonica fundamental |
| 4 | Inventario Global de Servicios | Catalogo de todos los microservicios organizados por dominio de negocio |
| 5 | Guia de Uso del Inventario | Como interpretar y utilizar el inventario de servicios en el dia a dia |
| 6 | Documento Tecnico de Servicios | Especificacion tecnica exhaustiva de cada microservicio: endpoints, modelos, configuraciones y dependencias |
| 7 | Patron Backend | Patron de arquitectura para microservicios backend (capas, estructura de paquetes, convenciones) |
| 8 | Patron Frontend | Patron de arquitectura para aplicaciones frontend Angular (modulos, componentes, servicios) |
| 9 | Estandares de Desarrollo | Convenciones de codificacion, nombrado, estructura de commits y reglas del equipo |
| 10 | Estandares de Calidad y Operacion | Criterios de calidad, metricas de operacion y checklist de validacion |
| 11 | Guia Visual de Implementacion | Diagramas y flujos visuales que complementan los documentos anteriores |
| 12 | Diseno Log y Auditoria MongoDB | Diseno del sistema de logs y auditoria centralizada con MongoDB |
| 13 | Diseno Reporteria BI Multitenant | Arquitectura de reporteria y Business Intelligence con aislamiento multitenant |
| 14 | Estrategia Carga de Maestros | Estrategia para la migracion y carga inicial de datos maestros en nuevos tenants |
| 15 | Arquitectura Frontend Nebula | Nx Monorepo + Component Library separada (@nebula/ui-kit). 2 repos independientes, boundary enforcement, patrones Angular 21 |
| 16 | Reglas de Desarrollo de Servicios | Reglas obligatorias para desarrollo backend y frontend: naming, estructura, validaciones |
| 17 | Estandares Mapeo DTO-Entity | Convenciones para mapeo entre DTOs y entidades JPA |
| 18 | Diseno Nebula Common/Shared | Librerias compartidas entre microservicios: nebula-commons, nebula-models, nebula-shared. Incluye tabla de decision "que va donde", anatomia de cada library y anti-patrones observados (v2.0) |
| 19 | Matriz Roles y Permisos Core | Control de acceso basado en roles (RBAC) y permisos por modulo |
| 20 | Consulta Documentacion OpenAPI | Procedimiento oficial para obtener Bearer Token y consultar el contrato OpenAPI/Swagger de los servicios Nebula |
| 21 | ADR-001 Flat Record | Procedimiento para implementar los flat record |
| 22 | ADR-002 Division Libraries Nebula | Decision arquitectonica sobre separacion de responsabilidades entre nebula-commons, nebula-models, nebula-shared y propuesta de enforcement con nebula-arch-rules (ArchUnit) |
| 23 | ADR-003 Politica Entrega QA | Decision arquitectonica sobre el flujo formal de entrega a QA: 8 fases con gates explicitos, rol QA Lead formalizado, artefactos obligatorios (QA_HANDOFF, QA_EXECUTION_REPORT, QA_CLOSURE), SLAs y criterios de aprobacion |
| Version | Fecha | Autor | Descripcion |
|---|---|---|---|
| 1.4.0 | 2026-05-11 | Carlos Torres | Incorporacion del ADR-003 Politica Entrega QA (item 23). Formaliza el flujo de entrega a QA en 8 fases con gates A-G y artefactos obligatorios. |
| 1.3.0 | 2026-05-11 | Carlos Torres | Reescritura del documento de Diseno Nebula Common/Shared a v2.0 (item 18) e incorporacion del ADR-002 sobre division de libraries Nebula (item 22). |
| 1.2.0 | 2026-04-24 | Vanessa Luna | Se agrega documento ADR para flat record (item 21). |
| 1.1.0 | 2026-04-15 | Carlos Torres | Se agrega documento de consulta de documentacion OpenAPI (item 20). |
| 1.0.0 | 2026-03-16 | Carlos Torres | Creacion del indice de seccion |