workspace-v1/04-fase-proyectos/gamilit/ANALISIS/00-PLAN-ANALISIS.md

GAMILIT - PLAN DE ANALISIS

Proyecto: Gamilit Platform Fase: 4.1 - Migracion de Gamilit Estado: Pendiente Prioridad: P0 (Proyecto Modelo) Agente Principal: Tech-Leader + Backend-Agent + Frontend-Agent

---

OBJETIVO

Migrar Gamilit al nuevo modelo de repositorio independiente, creando:

1. Estructura de carpetas standalone
2. Service descriptors para cada servicio
3. Docker compose con redes aisladas
4. Integracion con registries del Control Plane

---

INFORMACION DEL PROYECTO

Datos Generales

Campo	Valor
Nombre	Gamilit Platform
Tipo	Plataforma SaaS de gamificacion educativa
Estado MVP	60% completado
Stack Backend	NestJS + TypeScript
Stack Frontend	React + TypeScript
Base de Datos	PostgreSQL
Servicios	API, Web, WebSocket

Ubicacion Actual

/home/adrian/Documentos/workspace/projects/gamilit/
|
+-- backend/
+-- frontend/
+-- database/
+-- docker/
+-- docs/
+-- orchestration/

---

TAREAS DE ANALISIS

Tarea A1: Inventario de Archivos

OBJETIVO: Listar todos los archivos del proyecto actual

PASOS:
1. Ejecutar find en directorio del proyecto
2. Clasificar por tipo (codigo, config, docs)
3. Identificar archivos a migrar vs regenerar
4. Documentar en 01-INVENTARIO-ACTUAL.md

COMANDO:
find /home/adrian/Documentos/workspace/projects/gamilit -type f \
  -not -path "*node_modules*" \
  -not -path "*.git*" | sort

Tarea A2: Analisis de Servicios

OBJETIVO: Identificar y documentar cada servicio

PASOS:
1. Identificar servicios en backend/ y frontend/
2. Para cada servicio:
   - Puerto actual
   - Endpoints principales
   - Dependencias
   - Variables de entorno requeridas
3. Documentar en 02-SERVICIOS.md

SERVICIOS ESPERADOS:
- gamilit-api (Backend NestJS)
- gamilit-web (Frontend React)
- gamilit-ws (WebSocket server, si existe)

Tarea A3: Analisis de Base de Datos

OBJETIVO: Documentar estructura de BD

PASOS:
1. Identificar schemas/tablas
2. Identificar DDL scripts
3. Identificar migraciones
4. Verificar contra databases.registry.yml
5. Documentar en 03-DATABASE.md

Tarea A4: Analisis de Docker

OBJETIVO: Documentar configuracion Docker actual

PASOS:
1. Leer docker-compose.yml actual
2. Identificar:
   - Servicios definidos
   - Puertos expuestos
   - Volumenes
   - Redes
3. Comparar con ports.registry.yml
4. Documentar cambios necesarios

Tarea A5: Analisis de Dependencias

OBJETIVO: Mapear dependencias del proyecto

PASOS:
1. Leer package.json de backend
2. Leer package.json de frontend
3. Identificar dependencias compartidas
4. Identificar dependencias externas (APIs, servicios)
5. Documentar en 04-DEPENDENCIAS.md

---

ESTRUCTURA OBJETIVO

gamilit-platform/                    # Nuevo repo
|
+-- apps/
|     +-- backend/
|     |     +-- service.descriptor.yml
|     |     +-- src/
|     |     +-- package.json
|     |     +-- Dockerfile
|     |     +-- tsconfig.json
|     |
|     +-- frontend/
|     |     +-- service.descriptor.yml
|     |     +-- src/
|     |     +-- package.json
|     |     +-- Dockerfile
|     |
|     +-- database/
|           +-- ddl/
|           +-- seeds/
|           +-- migrations/
|
+-- docker/
|     +-- docker-compose.yml
|     +-- docker-compose.dev.yml
|     +-- docker-compose.prod.yml
|     +-- .env.example
|
+-- orchestration/                   # Migrado de projects/gamilit/orchestration
|     +-- inventarios/
|     +-- trazas/
|     +-- 00-guidelines/
|
+-- docs/
|
+-- .github/
|     +-- workflows/
|
+-- package.json                     # Root (workspaces)
+-- README.md

---

VERIFICACIONES CONTRA REGISTRIES

ports.registry.yml

# Verificar que estos puertos estan asignados:
gamilit:
  api: 3000      # Debe coincidir con backend
  web: 3001      # Debe coincidir con frontend
  websocket: 3002  # Si aplica

domains.registry.yml

# Verificar dominios asignados:
gamilit:
  local:
    api: api.gamilit.localhost
    web: gamilit.localhost
  development:
    api: api.gamilit.dev.example.com
    web: gamilit.dev.example.com

databases.registry.yml

# Verificar BD asignada:
gamilit:
  database: gamilit_db
  roles:
    owner: gamilit_owner
    runtime: gamilit_app
    migrator: gamilit_migrator

---

CRITERIOS DE COMPLETITUD

El analisis esta completo cuando:

1. Inventario de archivos documentado
2. Servicios identificados y documentados
3. Base de datos analizada
4. Docker compose actual analizado
5. Dependencias mapeadas
6. Verificacion contra registries completada
7. Estructura objetivo definida

---

SIGUIENTE PASO

Una vez completado el analisis:

1. Revisar PLANEACION/00-TAREAS.md
2. Validar plan contra analisis
3. Proceder a implementacion

---

Responsable: Tech-Leader