# Workspace - Fábrica de Software con Agentes IA

## Visión General

Este workspace implementa una arquitectura integral para desarrollo de software gestionado por agentes de IA, con soporte para múltiples proyectos, reutilización de componentes y base de conocimiento compartida.

## Estructura Principal

```
~/workspace/
├── core/                    # Núcleo de la fábrica
│   ├── orchestration/       # Sistema de agentes unificado
│   ├── modules/             # Módulos de código reutilizables
│   └── standards/           # Estándares técnicos globales
│
├── projects/                # Proyectos/Productos
│   ├── erp-suite/           # Suite ERP (verticales)
│   ├── gamilit/             # Plataforma EdTech
│   ├── trading-platform/    # Bots de trading
│   ├── betting-analytics/   # Predicción apuestas
│   └── inmobiliaria-analytics/
│
├── customers/               # Implementaciones personalizadas
│   └── template/            # Template para nuevos clientes
│
├── knowledge-base/          # Base de conocimiento (RAG)
│   ├── patterns/            # Patrones de diseño
│   ├── reference/           # Código de referencia
│   ├── guides/              # Guías de integración
│   └── snippets/            # Snippets reutilizables
│
├── workspaces/              # Workspaces efímeros por tarea
│
└── devtools/                # Herramientas de desarrollo
    ├── scripts/             # Scripts de automatización
    ├── templates/           # Templates de proyectos
    └── docker/              # Configuración Docker
```

## Sistema de Agentes

El workspace utiliza el **Sistema NEXUS** para orquestación de agentes:

### Agentes Orquestadores
- **NEXUS-BACKEND** - NestJS, APIs, servicios
- **NEXUS-FRONTEND** - React, componentes, UI
- **NEXUS-DATABASE** - PostgreSQL, schemas, RLS
- **NEXUS-DEVOPS** - CI/CD, deployment
- **NEXUS-INTEGRATION** - Validación 3 capas
- **NEXUS-TESTING** - QA, tests E2E

### Principios de Orquestación
1. Cualquier agente puede orquestar a cualquier otro
2. Contexto completo en cada invocación
3. Fases anidadas: Análisis → Planeación → Validación → Ejecución
4. Pool compartido de 15 subagentes

## Inicio Rápido

### Clonar el workspace
```bash
# Clon completo con submodules (Odoo, etc.)
git clone --recurse-submodules https://github.com/rckrdmrd/workspace.git
cd workspace

# Ver guía de setup completa
cat SETUP.md
```

### Usar el script de desarrollo
```bash
# Ver comandos disponibles
./devtools/scripts/dev.sh help

# Ver estado del workspace
./devtools/scripts/dev.sh status

# Iniciar servicios Docker (PostgreSQL, Redis, etc.)
./devtools/scripts/dev.sh docker-up

# Iniciar un proyecto
./devtools/scripts/dev.sh start gamilit
./devtools/scripts/dev.sh start trading
./devtools/scripts/dev.sh start mecanicas

# Instalar todas las dependencias
./devtools/scripts/dev.sh install

# Ver asignación de puertos
./devtools/scripts/dev.sh ports
```

### Para trabajar en un proyecto existente
```bash
cd ~/workspace/projects/<proyecto>
npm install  # Instalar dependencias

# Leer el contexto del proyecto
cat orchestration/PROXIMA-ACCION.md
cat orchestration/00-guidelines/CONTEXTO-PROYECTO.md
```

### Para crear un nuevo proyecto
```bash
./devtools/scripts/bootstrap-project.sh <nombre> <tipo>
```

## Proyectos Activos

| Proyecto | Estado | Backend | Frontend |
|----------|--------|---------|----------|
| **Gamilit** | MVP 60% | NestJS :3000 | React :5173 |
| **Trading Platform** | 50% | Express :3001 | React :5174 |
| **ERP Suite** | 35% | Express :3010+ | React :5175 |
| **Mecánicas Diesel** | MVP 95% | Express :3011 | - |

## CI/CD

GitHub Actions configurados en `.github/workflows/`:
- **ci.yml** - Lint, test, build por proyecto
- **docker-build.yml** - Construcción de imágenes Docker

## Documentación

- **Sistema de Agentes:** `core/orchestration/README.md`
- **Directivas Globales:** `core/orchestration/directivas/`
- **Estándares:** `core/standards/`
- **Por Proyecto:** `projects/<proyecto>/docs/`

## Enlaces Útiles

- [Análisis de Implementación](/home/isem/docs-workspace/ANALISIS-IMPLEMENTACION-WORKSPACE.md)
- [Arquitectura de Orquestación](/home/isem/docs-workspace/ARQUITECTURA-ORQUESTACION-AGENTES.md)
- [Sugerencias y Mejores Prácticas](/home/isem/docs-workspace/SUGERENCIAS-MEJORES-PRACTICAS.md)

---
*Workspace creado: 2025-12-05*
*Basado en: Sistema NEXUS de Gamilit + Arquitectura Integral de Fábrica de Software*
