# 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
```bash
./devtools/scripts/git/clone-workspace.sh
```

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

---

## 6. Comandos Comunes

### Clonar
```bash
git clone --recurse-submodules git@gitea-server:rckrdmrd/workspace-v1.git
```

### Nueva feature
```bash
git checkout develop
git checkout -b feature/EPIC-XXX-desc
```

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

---

**Generado:** 2026-01-04