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

• Control Plane
• Directivas SIMCO
• Perfiles de Agentes

---

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