rckrdmrd 66161b1566 feat: Workspace-v1 complete migration with NEXUS v3.4

Sistema NEXUS v3.4 migrado con:

Estructura principal:
- core/orchestration: Sistema SIMCO + CAPVED (27 directivas, 28 perfiles)
- core/catalog: Catalogo de funcionalidades reutilizables
- shared/knowledge-base: Base de conocimiento compartida
- devtools/scripts: Herramientas de desarrollo
- control-plane/registries: Control de servicios y CI/CD
- orchestration/: Configuracion de orquestacion de agentes

Proyectos incluidos (11):
- gamilit (submodule -> GitHub)
- trading-platform (OrbiquanTIA)
- erp-suite con 5 verticales:
  - erp-core, construccion, vidrio-templado
  - mecanicas-diesel, retail, clinicas
- betting-analytics
- inmobiliaria-analytics
- platform_marketing_content
- pos-micro, erp-basico

Configuracion:
- .gitignore completo para Node.js/Python/Docker
- gamilit como submodule (git@github.com:rckrdmrd/gamilit-workspace.git)
- Sistema de puertos estandarizado (3005-3199)

Generated with NEXUS v3.4 Migration System
EPIC-010: Configuracion Git y Repositorios

2026-01-04 03:37:42 -06:00

2.5 KiB

Raw Permalink Blame History

ADR-001: Stack Tecnológico

Estado: Aceptada
Fecha: 2025-11-23
Responsable: Architecture-Analyst

Contexto

Necesitamos definir el stack tecnológico para el ERP Genérico que sea:

Moderno y mantenible
Escalable para múltiples proyectos
Con ecosistema maduro y soporte a largo plazo

Decisión

Backend: Node.js 20+ LTS + Express 4.18+ + TypeScript 5+
Frontend: React 18+ + Vite 5+ + TypeScript 5+
Database: PostgreSQL 15+ + PostGIS
Mobile: React Native (futuro)

Justificación

Referencia a Gamilit

Stack probado en producción (2+ años)
Node.js 20 LTS (soporte hasta 2026)
TypeScript garantiza type safety completo
Vite build tool moderno (HMR rápido)
PostgreSQL 15 con mejoras de performance

Referencia a Odoo

Odoo usa Python, pero Node.js tiene ecosistema más amplio para APIs
PostgreSQL es el mismo RDBMS que usa Odoo (probado a escala)

Referencia a ERP Construcción

Ya usa Node.js + Express + PostgreSQL
Migración será más sencilla
Equipo ya tiene experiencia

Consecuencias

Positivas

Ecosistema maduro (npm, TypeScript, React)
Reutilización de conocimiento del equipo
Type safety completo (reduce bugs 40%)
Performance excelente (Node.js async I/O)
PostgreSQL altamente escalable

Negativas

Node.js single-threaded (mitigado con clustering)
JavaScript puede ser permisivo (mitigado con TypeScript strict mode)

Alternativas Consideradas

1. Python + Django + PostgreSQL

Pros: Más cercano a Odoo, bueno para data science
Contras: Equipo no tiene experiencia, ecosistema frontend limitado
Rechazada: Curva de aprendizaje alta

2. Java + Spring Boot + PostgreSQL

Pros: Enterprise-grade, muy robusto
Contras: Verbose, lento desarrollo, equipo no tiene experiencia
Rechazada: Overhead de desarrollo alto

Implementación

Acciones Requeridas

Configurar proyecto con Node.js 20 LTS
Setup TypeScript con strict mode
Configurar React 18 + Vite
Setup PostgreSQL 15 + PostGIS

Criterios de Aceptación

Build exitoso sin errores TypeScript
HMR funcional en <1s
PostgreSQL con extensiones necesarias

Riesgos y Mitigación

Riesgo: Problemas de performance con Node.js single-threaded
- Mitigación: Usar clustering, workers threads para tareas pesadas

Referencias

Notas Adicionales

Stack compatible con despliegue en Docker/Kubernetes.

2.5 KiB Raw Permalink Blame History