workspace-v1/orchestration/referencias/REPOSITORY-STRUCTURE.md
rckrdmrd d6c684611f feat(EPIC-010): Add git management scripts and documentation
- clone-workspace.sh: Clone workspace with submodules
- sync-submodules.sh: Sync submodules to latest
- REPOSITORY-STRUCTURE.md: Complete repo documentation

Sprint 4 of EPIC-010 completed
2026-01-04 03:40:52 -06:00

121 lines
2.3 KiB
Markdown

# 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