66161b1566
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
156 lines
3.5 KiB
Markdown
156 lines
3.5 KiB
Markdown
# 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
|