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

2.3 KiB

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

Generado: 2026-01-04