# 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

```bash
# 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

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

### 3. Validar Configuracion

```bash
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](./control-plane/README.md)
- [Directivas SIMCO](./control-plane/orchestration/directivas/)
- [Perfiles de Agentes](./control-plane/orchestration/agents/)

---

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