rckrdmrd
789d1ab46b
Some checks failed
CI Pipeline / changes (push) Has been cancelled
CI Pipeline / core (push) Has been cancelled
CI Pipeline / trading-backend (push) Has been cancelled
CI Pipeline / trading-data-service (push) Has been cancelled
CI Pipeline / trading-frontend (push) Has been cancelled
CI Pipeline / erp-core (push) Has been cancelled
CI Pipeline / erp-mecanicas (push) Has been cancelled
CI Pipeline / gamilit-backend (push) Has been cancelled
CI Pipeline / gamilit-frontend (push) Has been cancelled
139 lines
4.5 KiB
Markdown
139 lines
4.5 KiB
Markdown
# 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*
|