# Subrepositorios del Workspace

**Fecha:** 2026-01-07
**Version:** 1.3

---

## Arquitectura de Repositorios

Este workspace utiliza una arquitectura de repositorios donde cada proyecto puede tener su propio repositorio independiente.

### Repositorio Principal

| Campo | Valor |
|-------|-------|
| **Nombre** | workspace-v1 |
| **Path Local** | `/home/isem/workspace-v1` |
| **Remote SSH** | `git@gitea-server:rckrdmrd/workspace-v1.git` |
| **Remote HTTP** | `http://72.60.226.4:3000/rckrdmrd/workspace-v1` |

---

## GAMILIT - Workspace Independiente

### Configuracion

| Campo | Valor |
|-------|-------|
| **Path Local** | `projects/gamilit` |
| **Tipo** | Submodulo Git |
| **Remote HTTPS** | `https://github.com/rckrdmrd/gamilit-workspace.git` |
| **Remote SSH** | `git@github.com:rckrdmrd/gamilit-workspace.git` |
| **Referencia** | `/home/isem/workspace-old/wsl-ubuntu/workspace/workspace-gamilit/gamilit/projects/gamilit` |

### Estructura

Gamilit es un **workspace completo** SIN subrepositorios. Contiene:

```
projects/gamilit/
├── apps/
│   ├── backend/          # NestJS API (NO es subrepositorio)
│   ├── frontend/         # React App (NO es subrepositorio)
│   ├── database/         # DDL y Scripts (NO es subrepositorio)
│   └── devops/           # Scripts DevOps (NO es subrepositorio)
├── docs/                 # Documentacion (incluye contenido de niveles superiores)
├── orchestration/        # Sistema NEXUS (incluye contenido de niveles superiores)
├── scripts/              # Scripts de produccion
├── k8s/                  # Configuracion Kubernetes
└── ...
```

### Reglas Especiales

1. **Sin subrepositorios**: Todo el contenido de `apps/` es parte del mismo repositorio
2. **Solo ignora node_modules**: Los archivos de codigo van al repo
3. **Workspace autocontenido**: Contiene su propia documentacion y orchestration
4. **Deployment directo**: Se clona directamente en produccion

### Servidor de Produccion

| Campo | Valor |
|-------|-------|
| **IP** | 74.208.126.102 |
| **Path** | `/home/isem/workspace/workspace-gamilit/gamilit/projects/gamilit` |
| **Backend** | Puerto 3006 (PM2 cluster x2) |
| **Frontend** | Puerto 3005 (PM2 fork) |
| **Database** | PostgreSQL :5432, `gamilit_platform` |

---

## Proyectos con Repositorios en Gitea

Los siguientes proyectos tienen repositorios independientes en `http://72.60.226.4:3000/rckrdmrd/`.
Estan ignorados en el `.gitignore` del workspace principal.

Estos proyectos SI pueden tener subrepositorios para sus apps (backend, frontend, database).

### Familia ERP

| Proyecto | Path Local | Repositorio |
|----------|------------|-------------|
| **erp-suite** | `projects/erp-suite` | `http://72.60.226.4:3000/rckrdmrd/erp-suite.git` |
| **erp-core** | `projects/erp-core` | `http://72.60.226.4:3000/rckrdmrd/erp-core.git` |
| **erp-construccion** | `projects/erp-construccion` | `http://72.60.226.4:3000/rckrdmrd/erp-construccion.git` |
| **erp-clinicas** | `projects/erp-clinicas` | `http://72.60.226.4:3000/rckrdmrd/erp-clinicas.git` |
| **erp-retail** | `projects/erp-retail` | `http://72.60.226.4:3000/rckrdmrd/erp-retail.git` |
| **erp-mecanicas-diesel** | `projects/erp-mecanicas-diesel` | `http://72.60.226.4:3000/rckrdmrd/erp-mecanicas-diesel.git` |
| **erp-vidrio-templado** | `projects/erp-vidrio-templado` | `http://72.60.226.4:3000/rckrdmrd/erp-vidrio-templado.git` |

### Otros Proyectos

| Proyecto | Path Local | Repositorio |
|----------|------------|-------------|
| **trading-platform** | `projects/trading-platform` | `http://72.60.226.4:3000/rckrdmrd/trading-platform.git` |
| **betting-analytics** | `projects/betting-analytics` | `http://72.60.226.4:3000/rckrdmrd/betting-analytics.git` |
| **inmobiliaria-analytics** | `projects/inmobiliaria-analytics` | `http://72.60.226.4:3000/rckrdmrd/inmobiliaria-analytics.git` |
| **platform_marketing_content** | `projects/platform_marketing_content` | `http://72.60.226.4:3000/rckrdmrd/platform_marketing_content.git` |

### Proyectos Nuevos (2026-01-07)

| Proyecto | Path Local | Repositorio | Subrepositorios |
|----------|------------|-------------|-----------------|
| **michangarrito** | `projects/michangarrito` | `http://72.60.226.4:3000/rckrdmrd/michangarrito.git` | backend, frontend, mobile, database, mcp-server, whatsapp |
| **template-saas** | `projects/template-saas` | `http://72.60.226.4:3000/rckrdmrd/template-saas.git` | backend, frontend, database |
| **clinica-dental** | `projects/clinica-dental` | `http://72.60.226.4:3000/rckrdmrd/clinica-dental.git` | database |
| **clinica-veterinaria** | `projects/clinica-veterinaria` | `http://72.60.226.4:3000/rckrdmrd/clinica-veterinaria.git` | database |

### Estructura con Subrepositorios (para proyectos Gitea)

Los proyectos en Gitea pueden usar esta estructura de subrepositorios:

```
projects/[proyecto]/
├── .gitmodules           # Define subrepositorios
├── apps/
│   ├── backend/          # Subrepositorio -> [proyecto]-backend.git
│   ├── frontend/         # Subrepositorio -> [proyecto]-frontend.git
│   └── database/         # Subrepositorio -> [proyecto]-database.git
├── docs/
└── orchestration/
```

---

## Configuracion SSH

### Para Gitea (72.60.226.4)

```
# ~/.ssh/config
Host gitea-server
    HostName 72.60.226.4
    Port 22
    User git
    IdentityFile ~/.ssh/id_ed25519
    IdentitiesOnly yes
```

### Para GitHub

```
# ~/.ssh/config
Host github.com
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_ed25519
    IdentitiesOnly yes
```

---

## Comandos Utiles

### Gamilit (GitHub)

```bash
# Actualizar submodulo
cd /home/isem/workspace-v1
git submodule update --remote projects/gamilit

# Trabajar dentro de gamilit
cd /home/isem/workspace-v1/projects/gamilit
git pull origin master
git add -A
git commit -m "mensaje"
git push origin master

# Actualizar referencia en workspace-v1
cd /home/isem/workspace-v1
git add projects/gamilit
git commit -m "chore: actualizar submodulo gamilit"
```

### Proyectos Gitea

```bash
# Clonar un proyecto
cd /home/isem/workspace-v1/projects
git clone http://72.60.226.4:3000/rckrdmrd/[PROYECTO].git

# Inicializar subrepositorios (si aplica)
cd [PROYECTO]
git submodule update --init --recursive
```

### Ver estado de todos los repositorios

```bash
# Workspace principal
git -C /home/isem/workspace-v1 status

# Gamilit
git -C /home/isem/workspace-v1/projects/gamilit status
```

---

## Notas Importantes

1. **gamilit** es especial:
   - Es un workspace independiente sin subrepositorios
   - Se despliega directamente en produccion
   - Contiene docs y orchestration propios (redundantes con workspace)
   - Usa GitHub (no Gitea)

2. **Otros proyectos** (ERP, trading, etc.):
   - Usan Gitea como servidor Git
   - Pueden tener subrepositorios para sus apps
   - No se incluyen en el repositorio workspace-v1

3. **Sincronizacion**:
   - Desarrollo activo de gamilit: `/home/isem/workspace/projects/gamilit`
   - Referencia de produccion: `/home/isem/workspace-old/.../gamilit`
   - Submodulo en workspace-v1: `/home/isem/workspace-v1/projects/gamilit`

---

## Estado Actual de Repositorios en Gitea

### Repositorios Existentes (2026-01-04)

| Repositorio | Tipo | Estado |
|-------------|------|--------|
| workspace | Principal | Activo |
| workspace-v1 | Principal | Activo |
| erp-construccion-backend | Subrepositorio | Activo |
| erp-construccion-frontend-web | Subrepositorio | Activo |
| erp-construccion-frontend-mobile | Subrepositorio | Activo |
| erp-construccion-database | Subrepositorio | Activo |
| erp-mecanicas-diesel-backend | Subrepositorio | Activo |
| erp-mecanicas-diesel-frontend-web | Subrepositorio | Activo |
| erp-mecanicas-diesel-database | Subrepositorio | Activo |
| erp-core-backend | Subrepositorio | Activo |
| erp-core-frontend-web | Subrepositorio | Activo |
| erp-core-database | Subrepositorio | Activo |

### Repositorios Creados (2026-01-07)

Los siguientes repositorios fueron creados via API:

| Repositorio | Tipo | Estado |
|-------------|------|--------|
| michangarrito | Principal | ✅ Creado |
| michangarrito-backend | Subrepositorio | ✅ Creado |
| michangarrito-frontend | Subrepositorio | ✅ Creado |
| michangarrito-mobile | Subrepositorio | ✅ Creado |
| michangarrito-database | Subrepositorio | ✅ Creado |
| michangarrito-mcp-server | Subrepositorio | ✅ Creado |
| michangarrito-whatsapp | Subrepositorio | ✅ Creado |
| template-saas | Principal | ✅ Creado |
| template-saas-backend | Subrepositorio | ✅ Creado |
| template-saas-frontend | Subrepositorio | ✅ Creado |
| template-saas-database | Subrepositorio | ✅ Creado |
| clinica-dental | Principal | ✅ Creado |
| clinica-dental-database | Subrepositorio | ✅ Creado |
| clinica-veterinaria | Principal | ✅ Creado |
| clinica-veterinaria-database | Subrepositorio | ✅ Creado |

### Repositorios Pendientes de Crear

Los siguientes repositorios principales necesitan crearse via API o web de Gitea:

- erp-suite (principal)
- erp-core (principal)
- erp-construccion (principal)
- erp-clinicas (principal)
- erp-retail (principal)
- erp-mecanicas-diesel (principal)
- erp-vidrio-templado (principal)
- trading-platform (principal)
- betting-analytics (principal)
- inmobiliaria-analytics (principal)
- platform-marketing-content (principal)

---

## Scripts de Gestion

### Crear repositorios en Gitea

```bash
# Requiere token de API de Gitea
./scripts/create-gitea-repos-api.sh <GITEA_TOKEN>

# Para obtener el token:
# 1. Ir a http://72.60.226.4:3000/rckrdmrd
# 2. Settings -> Applications -> Generate New Token
# 3. Dar permisos de 'repo' y 'write:repository'
```

### Push de todos los proyectos

```bash
# Despues de crear los repositorios
./scripts/push-all-projects.sh
```

### Configurar repositorios locales

```bash
# Configura remotes en cada proyecto
./scripts/create-gitea-repos.sh
```

---

*Generado por NEXUS v3.4 - Sistema de Orquestacion*