workspace-v1/orchestration/referencias/REPOSITORY-STRUCTURE.md

Estructura de Repositorios - Workspace-v1

Version: 1.0.0 Fecha: 2026-01-04 Sistema: NEXUS v3.4 EPIC: EPIC-010

---

1. Vision General

workspace-v1/                    # Repositorio principal (Gitea)
├── .git/
├── .gitignore
├── .gitmodules                  # Define submodule gamilit
├── core/                        # Sistema SIMCO y catalogo
├── shared/                      # Recursos compartidos
├── orchestration/               # Orquestacion de agentes
├── devtools/                    # Herramientas de desarrollo
├── control-plane/               # Control de servicios
└── projects/
    ├── gamilit/                 # SUBMODULE -> GitHub
    ├── trading-platform/
    ├── erp-suite/
    └── ...

---

2. Repositorios Remotos

Gitea (Principal)

Campo	Valor
URL Web	http://72.60.226.4:3000
Usuario	rckrdmrd
URL SSH	git@gitea-server:rckrdmrd/workspace-v1.git

GitHub (gamilit)

Campo	Valor
Usuario	rckrdmrd
Repositorio	gamilit-workspace
URL SSH	git@github.com:rckrdmrd/gamilit-workspace.git

---

3. Submodules

gamilit

• Path: projects/gamilit
• URL: git@github.com:rckrdmrd/gamilit-workspace.git
• Branch: main
• Razon: Servidor productivo separado

---

4. Estrategia de Branches

Branch	Proposito
main	Produccion estable
develop	Integracion
feature/*	Desarrollo
hotfix/*	Fixes urgentes

---

5. Scripts de Gestion

clone-workspace.sh

./devtools/scripts/git/clone-workspace.sh

sync-submodules.sh

./devtools/scripts/git/sync-submodules.sh [--commit]

---

6. Comandos Comunes

Clonar

git clone --recurse-submodules git@gitea-server:rckrdmrd/workspace-v1.git

Nueva feature

git checkout develop
git checkout -b feature/EPIC-XXX-desc

Actualizar submodule

git submodule update --remote projects/gamilit

---

7. SSH Config

Host gitea-server
    HostName 72.60.226.4
    User git
    IdentityFile ~/.ssh/id_ed25519

Host github.com
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_ed25519

---

8. MCP Servers (Repositorios Independientes)

Los MCP servers son proyectos con repositorios independientes que se clonan despues de clonar workspace-v1. No son submodules para permitir desarrollo independiente y flexibilidad.

Estructura

core/mcp-servers/
├── README.md              # SE VERSIONA con workspace
├── _registry.yml          # SE VERSIONA - lista de MCP
├── internal/
│   ├── .gitkeep           # SE VERSIONA
│   ├── rag-knowledge/     # REPO INDEPENDIENTE - se clona
│   └── scrum-taiga/       # REPO INDEPENDIENTE - se clona
├── external/              # SE VERSIONA
└── templates/             # SE VERSIONA

Clonacion de MCP Servers

# 1. Despues de clonar workspace-v1
cd /home/isem/workspace-v1/core/mcp-servers/internal

# 2. Clonar RAG Knowledge Base (recomendado)
git clone git@gitea-server:rckrdmrd/mcp-rag-knowledge.git rag-knowledge
cd rag-knowledge && npm install && cd ..

# 3. Clonar SCRUM Taiga (opcional)
git clone git@gitea-server:rckrdmrd/mcp-scrum-taiga.git scrum-taiga
cd scrum-taiga && npm install && cd ..

MCP Servers Disponibles

MCP Server	Repositorio	Prioridad
rag-knowledge	mcp-rag-knowledge.git	MAXIMA
scrum-taiga	mcp-scrum-taiga.git	ALTA

Por que NO son submodules?

1. Flexibilidad: Actualizacion independiente del workspace
2. Desarrollo: Ciclos de vida propios
3. Reutilizacion: Pueden usarse en otros contextos
4. Simplicidad: Sin complejidad de submodules anidados

Ver core/mcp-servers/_registry.yml para lista completa e instrucciones.

---

9. Flujo Completo de Clonacion

# 1. Clonar workspace principal con submodules
git clone --recurse-submodules git@gitea-server:rckrdmrd/workspace-v1.git
cd workspace-v1

# 2. Verificar submodule gamilit
git submodule status

# 3. Clonar MCP servers necesarios
cd core/mcp-servers/internal
git clone git@gitea-server:rckrdmrd/mcp-rag-knowledge.git rag-knowledge

# 4. Instalar dependencias de MCP
cd rag-knowledge && npm install

# 5. Volver al workspace
cd /home/isem/workspace-v1

# 6. Verificar estructura
ls -la core/mcp-servers/internal/

---

Generado: 2026-01-04 Actualizado: 2026-01-04 (EPIC-013)