Cliente: Centrica
Arquitecto Líder: Carlos Alberto Torres Camargo
Estado: FASE 0 - REFINAMIENTO Y PIVOTE ESTRATÉGICO
Repositorio Central: /Documentation/centrica/
Guía de Navegación: GUIA_VISUAL_IMPLEMENTACION.md
Última Actualización: 23 de Enero, 2026 (Post-Inmersión)
Este documento sirve como la Fuente Única de Verdad (Single Source of Truth) para la evolución técnica del ERP Nebula. Está estructurado de manera incremental, agregando "Capítulos" a medida que el proyecto avanza por sus fases estratégicas.
Estado: ✅ COMPLETADO
Definición: Establece las reglas de juego, roles y fronteras de responsabilidad entre el Arquitecto y el Cliente.
Documento Detallado: ANALISIS_ALCANCE_ROL_ARQUITECTO.md
- Segregación de Funciones: El Arquitecto diseña ("Planos"), Infraestructura Centrica ejecuta ("Construcción").
- Validación Técnica: El Arquitecto audita el cumplimiento de la infraestructura entregada contra la especificación.
- Defensa de Rol: El Arquitecto actúa como Autoridad Normativa, no como sysadmin operativo.
- Madurez de Procesos: Adopción de un enfoque "Architecture-First" ante bloqueos de hardware. Ver
ROADMAP_PROCESOS.md.
Estado: ✅ COMPLETADO
Definición: Perfiles técnicos requeridos (Backend/Frontend/QA/DevOps) y alcance de responsabilidad del Arquitecto sobre el equipo (Validación Técnica vs Gestión Administrativa).
Documentos Detallados:
Estado: ✅ COMPLETADO
Definición: Baterías de evaluación Go/No-Go para filtro riguroso de candidatos.
Documentos:
Estado: ✅ COMPLETADO (V5.0)
Definición: Especificaciones de hardware, red y topología de servidores.
Documento Detallado: GUIA_REQUERIMIENTOS_INFRAESTRUCTURA.md
- Topología de 4 Nodos:
- NODE-00 (Tools): 16GB RAM. GitLab, Jenkins, Nexus. (Propiedad Intelectual).
- NODE-01 (Dev): 32GB RAM. Entorno volátil.
- NODE-02 (QA): 32GB RAM. Espejo de producción.
- NODE-03 (Prod): 48GB RAM. Misión crítica.
- Política "Docker-First": Todo el software debe correr contenerizado.
- Persistencia Híbrida:
- System DB: PostgreSQL (Mandatorio para Simappe).
- Business DB: Multi-Motor (Postgres/Oracle/SQL Server) para Nebula.
Estado: ✅ COMPLETADO (V4.0)
Definición: Perfiles técnicos, soft skills, pruebas de selección y alcance del arquitecto.
Documentos: Ver Capítulo 1.1 y 1.2
Estado: ✅ COMPLETADO (V4.0) - FASE 0 CERRADA
Definición: Patrones de diseño, estructura de microservicios y estándares de código para Nebula ERP.
Documento: ESTANDARES_DESARROLLO.md
- Gobernanza de código (Gatekeepers)
- GitFlow básico
- Coding rules (Java 25, Angular 21)
- Definition of Done
Documento: PATRON_ARQUITECTURA_BACKEND.md
- Estrategia Simappe vs Centrica
- Multi-tenancy transparente
- Flujo hexagonal
- Reglas de oro
Documento: PATRON_ARQUITECTURA_FRONTEND.md
- Angular 21 Standalone Components
- Signals + RxJS
- Screaming Architecture
- OnPush Strategy
Estado: ✅ COMPLETADO
Documentos:
GITFLOW_DETALLADO.md
- Flujos completos Feature/Release/Hotfix
- Conventional Commits
- SemVer estricto
- Workflows para bibliotecas core
PIPELINE_CICD.md
- Jenkinsfile templates (bibliotecas y microservicios)
- Stages: Build, Test, SonarQube, Docker, Deploy
- Estrategias de rollback
- Monitoreo y alertas
Estado: ✅ COMPLETADO
Definición: Diseño profundo de microservicios, modelo de datos y comunicación inter-servicios.
Documento: ARQUITECTURA_MICROSERVICIOS.md
- Diagramas C4 (Context, Container, Component)
- Microservicios Simappe (Gateway, Eureka, Config, OAuth2)
- Microservicios Nebula (Accounting, Billing, Inventory, Payroll, Treasury)
- Comunicación síncrona (REST) y asíncrona (Kafka)
- Seguridad, escalabilidad y observabilidad
Documento: MODELO_MULTITENANT_DATABASE_BASED.md
Documentos: INVENTARIO_GLOBAL_SERVICIOS.md y GUIA_USO_INVENTARIO_SERVICIOS.md
- Taxonomía de Librerías: NebulaCore (Lógica), NebulaShared (Interfaces), NebulaModel (DTOs).
- Servicios Transversales: Masters y File Storage.
- Microservicios de Negocio: Inventario (Catalog, Ops), Contabilidad (Core, Treasury), Facturación (Invoicing, DIAN), Nómina (Core, Settlement).
- Reglas de Granularidad: Anti-monolito y anti-nano-servicios.
Estado: ✅ COMPLETADO (Planificado)
Definición: Validación técnica de decisiones críticas antes de desarrollo completo.
Documento: PLAN_PRUEBAS_CONCEPTO.md
PoCs Definidos:
- Multi-Motor SQL (PostgreSQL/Oracle/SQL Server) - 1 semana
- Performance Multi-Tenancy (100+ tenants) - 3 días
- Integración DIAN (Facturación electrónica) - 1 semana
- Event-Driven Kafka (Eventos críticos) - 3 días
- Frontend Performance Angular (10K+ rows) - 2 días
Calendario: 3 semanas en Sprints 0.3
Estado: ✅ COMPLETADO
Definición: Plan maestro de fases, sprints y estimaciones de recursos.
Documento: PLAN_FASES_SPRINTS.md
Resumen de Fases:
- Fase 0: Arquitectura y PoCs (3 meses) ✅
- Fase 1: Core Contable (5 meses) - Usuarios, Multi-Tenancy, Terceros, Contabilidad
- Fase 2: Facturación y CRM (6 meses) - DIAN, Ventas, Inventarios, Compras
- Fase 3: Sector Público y Nómina (6 meses) - Tributario, Presupuestal, RRHH
- Fase 4: Especialización y Launch (4 meses) - POS, BI, Optimización
Estado: ✅ COMPLETADO (V1.0)
Definición: Herramientas para la gestión de incidencias, documentación de procesos y almacenamiento de requerimientos.
Documento Detallado: INVENTARIO_HERRAMIENTAS_DESARROLLO.md
Duración Total: 12-15 meses (Ruta B con Simappe)
Hitos de Aprobación:
- H0.4: Go/No-Go a Fase 1 (Semana 12)
- H1.4: Primer Asiento Contable
- H2.1: Primera Factura DIAN Producción
- H3.3: Nómina Liquidada
- H4.2: Go-Live Cliente Piloto
Estado: ✅ COMPLETADO (V1.0)
Definición: Estándares de Observabilidad, Estrategia de QA, Gestión de Secretos y Handoff UX/UI.
Documentos Detallados:
Estado: ✅ COMPLETADO (V1.0)
Definición: Protocolos de recuperación ante desastres y soporte operativo post-lanzamiento.
Documentos Detallados:
Estado: ✅ COMPLETADO (V1.0)
Definición: Canales oficiales de Slack, reglas de etiqueta y gestión de alertas.
Documento Detallado: DOCUMENTO_COMUNICACION_INTERNA.md
Estado: ✅ COMPLETADO
Definición: Arquitectura completa del Stack Simappe como base para Nebula ERP.
Documento Detallado: ARQUITECTURA_SIMAPPE_NEBULA.md
- Arquitectura de 2 Capas: Simappe (Infraestructura) + Nebula (Negocio)
- Multi-Tenancy DATABASE-BASED: Cada tenant = BD física independiente
- Multi-Motor SQL: PostgreSQL, Oracle, SQL Server, MySQL, MariaDB
- SimappeArchetype: Generación de microservicios con Maven
- Servicios Core Simappe:
- SimappeAdmin (PostgreSQL obligatorio, gestión centralizada)
- SimappeClient (configuraciones específicas por cliente)
- SimappeOauth2Server (autenticación JWT)
- SimappeGatewayServer (API Gateway con routing)
- SimappeEurekaServer (service discovery)
- SimappeConfigServer (configuración centralizada Git)
- Bibliotecas Compartidas:
- SimappeCommons (framework core, multi-tenancy)
- SimappeModel (DTOs de infraestructura)
- CentricaModel (DTOs de negocio Nebula)
- CentricaShared (clientes HTTP Nebula)
- Migraciones Flyway: Por motor SQL
- Configuración Nuevo Cliente: 6 pasos con onboarding completo
Estado: ✅ COMPLETADO
Definición: Ciclo de vida del desarrollo de software: GitFlow, CI/CD, versionado.
Documentos Detallados:
Estado: ✅ COMPLETADO
Definición: Plan de implementación, onboarding de tenants y flujo de desarrollo diario.
Documento: PLAN_IMPLEMENTACION_NEBULA.md
- Duración Total: 18 meses (vs 33 meses sin Simappe)
- Ahorro: 15 meses y $749M COP
- Fases:
- Fase 0 (3 semanas): 5 PoCs críticos
- Multi-Motor SQL (5 días)
- Performance Multi-Tenancy 100+ tenants (3 días)
- Integración DIAN facturación electrónica (5 días)
- Event-Driven Kafka (3 días)
- Frontend Performance Angular 10K+ rows (2 días)
- Fase 1 (15 semanas): Core Contable
- Plan de cuentas, asientos, terceros, cierre contable
- 4.8 FTEs promedio, $144M COP
- Fase 2 (20 semanas): Facturación y CRM
- Inventarios, facturación DIAN, ventas, CRM básico
- 9.8 FTEs promedio, $392M COP
- Fase 3 (16 semanas): Nómina y Tributario
- RRHH, liquidación nómina, PILA, declaraciones
- 6.8 FTEs promedio, $217M COP
- Fase 4 (16 semanas): Go-Live
- POS, Business Intelligence, cliente piloto
- 9.5 FTEs promedio, $304M COP
- Riesgos y Mitigaciones: Matriz detallada
- Criterios Go/No-Go por fase
- Gantt Textual con timeline visual
Documento: GUIA_CONFIGURACION_TENANT.md
- 6 Pasos para Onboarding:
- Crear base de datos física (PostgreSQL/Oracle/SQL Server)
- Registrar en
database_config_v2 (SimappeAdmin API)
- Ejecutar migraciones Flyway
- Crear Company + Customer + Usuario Admin
- Validar conexión y multi-tenancy
- Configuraciones adicionales (menús, consecutivos, notificaciones)
- Ejemplos SQL completos para 3 motores
- Encriptación de credenciales con Jasypt/Vault
- Validación y debugging de multi-tenancy
- Rollback procedures en caso de error
- Duración: 2-4 horas por tenant
Documento: FLUJO_DESARROLLO_NEBULA.md
- Ejemplo Completo: Crear entidad
Tercero (CRUD)
- 11 Pasos:
- Recibir ticket JIRA
- Crear DTO en
CentricaModel → PR → Merge → Deploy Nexus
- Actualizar dependencia en microservicio
- Crear Entity con JPA
- Crear Repository con queries custom
- Crear Component con lógica de negocio
- Crear Service (orquestación)
- Crear Controller REST
- Crear tests unitarios (>80% cobertura)
- Commit con Conventional Commits
- PR → Code Review → CI/CD → Deploy DEV
- Código Real Completo:
- DTO con validaciones Jakarta Bean Validation
- Entity con índices y constraints
- Repository con búsquedas custom
- Component con validación de NIT colombiano
- Service y Controller con Swagger
- Tests unitarios con Mockito
- Debugging Multi-Tenancy: Causas comunes y soluciones
Documento: PROCESO_OPERATIVO_FABRICA_SOFTWARE.md
- Roles y Responsabilidades: RACI Matrix completa (Arquitecto, Gatekeeper, Seniors, Juniors, QA, DevOps)
- Ciclo de Vida Historia de Usuario: 10 fases end-to-end desde ticket hasta producción
- Creación de Nuevo Microservicio: Proceso completo con SimappeArchetype + setup CI/CD
- Gobernanza de Modelo de Datos: ADR (Architecture Decision Records) para Entities core
- Reportería Obligatoria: Daily standup, Sprint review, Métricas DORA
- Definition of Done: Para historia, microservicio y release
- Aprobaciones Requeridas: Con SLA por tipo (24h-72h)
- Escalamiento de Decisiones: 4 niveles (Backend → Gatekeeper → Arquitecto → Equipo)
- Gestión de Deuda Técnica: Clasificación y ratio 80% features / 20% deuda
Estado: 📅 FUTURO (Post-Lanzamiento)
Definición: Estrategias de mantenimiento, evolución y nuevas versiones.
- Gestión de deuda técnica
- Roadmap de features post-MVP
- Estrategia de escalamiento global
| Versión |
Fecha |
Fase |
Descripción |
Aprobado Por |
| V1.0 |
27/12/2025 |
Previa |
Creación del Manifiesto. Inclusión de Caps 1 y 2. |
Arquitecto/Usuario |
| V2.0 |
27/12/2025 |
Fase 0 |
Adición Capítulos 4.4, 5, 6 y 7. Fase 0 cerrada. |
Arquitecto |
| V3.0 |
27/12/2025 |
Fase 0 FINALIZADA |
Adición Capítulos 5-7 completos. 25 documentos. |
Arquitecto |
| V4.0 |
23/01/2026 |
Fase 0 PIVOTE |
Inmersión profunda completada. Hoja de ruta de procesos formalizada. |
Arquitecto |
Documentos Entregados: 28 documentos técnicos
Capítulos:
- ✅ Gobernanza y Estrategia (Incluye Roadmap de Procesos)
- ✅ Infraestructura Física
- ✅ Equipo y Talento
- ✅ Arquitectura Software (Backend/Frontend/Estándares)
- ✅ Stack Simappe (Arquitectura 2 Capas, Multi-Motor SQL)
- ✅ SDLC y CI/CD (GitFlow, Jenkinsfile, SemVer)
- ✅ Implementación (Plan 18 meses, Onboarding Tenants, Workflow Desarrollo)
- ✅ Gestión de Conocimiento (Guía Adopción Wiki.js)
- ✅ Herramientas de Apoyo (MantisBT, Requerimientos HU/HT)
- ✅ Calidad y Operación (QA, Seguridad, Observabilidad)
- 📅 Ciclo de Vida (Post-Lanzamiento)
- ✅ Comunicaciones (Slack, Canales, Etiqueta)
Hito Crítico: 21 de Enero - Infraestructura pendiente de entrega. Se pivotó a madurez de procesos.
Próximo Paso: Presentación del Reporte de Horas (Enero 22-23) y aprobación de la Hoja de Ruta de Procesos.
Documento Maestro - Proyecto Nebula ERP - v4.0
| Version |
Fecha |
Autor |
Descripcion |
| 1.1.0 |
2026-03-04 |
Carlos Torres |
Revision, sanitizacion y publicacion en Wiki Arquitectura Centrica. |
| 1.0.0 |
2025-12-27 |
Carlos Torres |
Creacion del documento. |