workspace-v1/README.md
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

3.5 KiB

Workspace v1 - Multi-Project Development Environment

Version: 2.0.0 Fecha: 2025-12-18


Descripcion

Workspace unificado para desarrollo de multiples proyectos con arquitectura de 3 capas, sistema de orquestacion SIMCO/NEXUS, y governance centralizado.


Arquitectura

workspace-v1/
|
+-- control-plane/           # Governance y orquestacion
|     +-- registries/        # Puertos, dominios, BDs
|     +-- orchestration/     # SIMCO, agentes, directivas
|     +-- devtools/          # Scripts, docker, configs
|
+-- projects/                # Repositorios de productos
|     +-- gamilit/           # Gamificacion educativa
|     +-- erp-suite/         # ERP multi-vertical
|     +-- trading-platform/  # Trading
|     +-- betting-analytics/ # Betting analytics
|
+-- shared/                  # Recursos compartidos
      +-- libs/              # Librerias
      +-- infra/             # Infraestructura
      +-- knowledge-base/    # Documentacion

Proyectos

Proyecto Descripcion Status
Gamilit Plataforma de gamificacion educativa Development
ERP Suite ERP multi-vertical (construccion, mecanicas) Development
Trading Platform Plataforma de trading Planned
Betting Analytics Analisis de apuestas deportivas Planned

Quick Start

1. Inicializar Workspace

# Crear redes Docker
cd control-plane
./devtools/docker/networks/create-networks.sh

# Iniciar Traefik
cd devtools/docker/traefik
docker-compose -f docker-compose.traefik.yml up -d

2. Levantar un Proyecto

# Ejemplo: Gamilit
cd projects/gamilit/docker
docker-compose up -d

3. Validar Configuracion

cd control-plane
./devtools/scripts/validation/validate-all.sh

URLs de Desarrollo

Infraestructura

Servicio URL
Traefik Dashboard http://traefik.localhost:8080

Gamilit

Servicio URL
API http://api.gamilit.localhost
Web http://gamilit.localhost

ERP Suite

Servicio URL
Core API http://api.erp.localhost
Core Web http://erp.localhost
Construccion API http://api.construccion.erp.localhost
Mecanicas API http://api.mecanicas.erp.localhost

Trading

Servicio URL
API http://api.trading.localhost
Web http://trading.localhost

Betting

Servicio URL
API http://api.betting.localhost
Web http://betting.localhost

Sistema SIMCO/NEXUS

Directivas Principales

  • SIMCO-INICIALIZACION: Protocolo de carga de contexto
  • SIMCO-CREAR: Creacion de componentes
  • SIMCO-VALIDAR: Validacion pre-commit
  • SIMCO-SERVICE-DESCRIPTOR: Uso de descriptores

Agentes

Agente Rol
NEXUS-BACKEND APIs y logica
NEXUS-FRONTEND Interfaces UI
NEXUS-DATABASE Schemas y datos
NEXUS-DEVOPS Infraestructura
NEXUS-TECH-LEADER Arquitectura

Principios Clave

  1. Registry First: Todo puerto/dominio/BD debe estar registrado
  2. Descriptor First: Crear service.descriptor.yml antes del codigo
  3. Validacion Continua: Validar antes de commit
  4. Aislamiento: Cada proyecto en su red Docker
  5. Traefik Only: Solo puertos 80/443 publicos

Documentacion


Mantenido por: Tech-Leader Ultima actualizacion: 2025-12-18