workspace-v1/03-fase-shared-infra

FASE 3: SHARED INFRASTRUCTURE

Estado: Pendiente Duracion Estimada: 2-3 dias Agente Principal: DevOps-Agent Dependencias: Fase 1 y 2 completadas

---

OBJETIVO

Crear la infraestructura compartida que sera usada por todos los proyectos:

1. Configuracion de Docker networks aisladas
2. Configuracion de Traefik como reverse proxy
3. Templates de docker-compose por tipo de proyecto
4. Configuracion de ambientes (local, dev, staging, prod)

---

ALCANCE

Incluye

• Docker networks por proyecto y ambiente
• Traefik configuration con routing dinamico
• Templates de docker-compose.yml
• Variables de entorno por ambiente
• Scripts de setup para desarrollo local

No Incluye

• Configuracion de Kubernetes (futuro)
• CI/CD pipelines (definido en Fase 2, implementado por proyecto)
• Migracion de proyectos (Fase 4)

---

COMPONENTES A CREAR

3.1 Docker Networks

# Estructura de redes por proyecto
networks:
  # Red por proyecto y ambiente
  gamilit_local:
    name: gamilit_local
    driver: bridge

  gamilit_dev:
    name: gamilit_dev
    driver: bridge

  # Red compartida para infraestructura
  infra_shared:
    name: infra_shared
    driver: bridge
    # Traefik, monitoring, etc.

3.2 Traefik Configuration

control-plane/devtools/docker/traefik/
|
+-- traefik.yml              # Configuracion principal
+-- dynamic/
|     +-- routers.yml        # Routers dinamicos
|     +-- middlewares.yml    # Middlewares comunes
+-- certs/
      +-- README.md          # Instrucciones para certs

3.3 Docker Compose Templates

control-plane/devtools/docker/templates/
|
+-- docker-compose.base.yml       # Template base
+-- docker-compose.backend.yml    # Template para backend
+-- docker-compose.frontend.yml   # Template para frontend
+-- docker-compose.fullstack.yml  # Template completo
+-- docker-compose.ml.yml         # Template para ML services

3.4 Environment Configuration

control-plane/devtools/configs/
|
+-- env/
|     +-- .env.template           # Template con todas las variables
|     +-- .env.local.template     # Variables para local
|     +-- .env.dev.template       # Variables para development
|     +-- .env.staging.template   # Variables para staging
|     +-- .env.prod.template      # Variables para production
|
+-- scripts/
      +-- setup-local.sh          # Setup inicial para desarrollo
      +-- generate-env.sh         # Genera .env desde template

---

ESTRUCTURA OBJETIVO

control-plane/
|
+-- devtools/
|     +-- docker/
|     |     +-- traefik/
|     |     |     +-- traefik.yml
|     |     |     +-- dynamic/
|     |     |     |     +-- routers.yml
|     |     |     |     +-- middlewares.yml
|     |     |     +-- docker-compose.traefik.yml
|     |     |
|     |     +-- templates/
|     |     |     +-- docker-compose.base.yml
|     |     |     +-- docker-compose.backend.yml
|     |     |     +-- docker-compose.frontend.yml
|     |     |     +-- docker-compose.fullstack.yml
|     |     |
|     |     +-- networks/
|     |           +-- create-networks.sh
|     |           +-- networks.yml
|     |
|     +-- configs/
|     |     +-- env/
|     |     |     +-- .env.template
|     |     |     +-- .env.local.template
|     |     +-- scripts/
|     |           +-- setup-local.sh
|     |           +-- generate-env.sh
|     |
|     +-- scripts/
|           +-- bootstrap/
|                 +-- init-workspace.sh
|                 +-- init-project.sh

---

SUBFASES

3.1 Analisis

1. Revisar configuracion Docker actual de proyectos
2. Identificar puertos y dominios de ports/domains registry
3. Documentar requerimientos de red por proyecto

3.2 Planeacion

1. Disenar estructura de redes Docker
2. Disenar configuracion de Traefik
3. Crear templates de docker-compose
4. Definir variables de entorno por ambiente

3.3 Implementacion

1. Crear estructura de carpetas
2. Crear archivos de configuracion
3. Crear scripts de setup
4. Probar configuracion local

3.4 Validacion

1. Verificar que redes se crean correctamente
2. Verificar que Traefik rutea correctamente
3. Verificar que templates son usables
4. Documentar uso

---

DOCUMENTOS DE ESTA FASE

03-fase-shared-infra/
|
+-- README.md                      # Este archivo
|
+-- ANALISIS/
|     +-- 00-PLAN-ANALISIS.md
|     +-- 01-DOCKER-ACTUAL.md      # Estado actual de Docker en proyectos
|     +-- 02-REQUERIMIENTOS.md     # Requerimientos de red por proyecto
|
+-- PLANEACION/
|     +-- 00-TAREAS.md
|     +-- 01-DISENO-REDES.md
|     +-- 02-DISENO-TRAEFIK.md
|     +-- 03-TEMPLATES.md
|
+-- IMPLEMENTACION/
|     +-- 00-EJECUCION.md
|
+-- PROMPTS/
|     +-- PROMPT-DEVOPS-AGENT.md
|
+-- VALIDACION/
      +-- CHECKLIST.md

---

SIGUIENTE PASO

1. Completar Fase 1 y 2
2. Leer ANALISIS/00-PLAN-ANALISIS.md
3. Ejecutar analisis de Docker actual

---

Agente Responsable: DevOps-Agent