gkachele-saas/codex/VERSIONADO_IA.md

Versionado IA - UB24/Elementor

Rama de trabajo

• ai/ub24-builder-v1

Estado de sincronizacion (14 Febrero 2026)

• Local: ai/ub24-builder-v1
• Remoto: origin/ai/ub24-builder-v1
• Divergencia verificada: 0/0 (sin commits pendientes entre local y remoto)

Regla de trabajo

1. Cada cambio funcional se guarda en un commit separado.
2. Cada commit se registra con su hash.
3. Cada commit debe incluir comando de reversion rapida.
4. La rama debe quedar sincronizada con remoto al cerrar bloque de trabajo.

Convencion de mensaje

• feat(builder): ...
• fix(builder): ...
• refactor(builder): ...
• chore(versioning): ...

Flujo con Gitea

1. Trabajo local en ai/ub24-builder-v1.
2. Push continuo a origin/ai/ub24-builder-v1.
3. Merge cuando validemos en local y Raspberry.

Protocolo fijo de sincronizacion (siempre)

1. Verificar rama activa: git branch --show-current
2. Actualizar referencias remotas: git fetch origin --prune
3. Medir divergencia: git rev-list --left-right --count ai/ub24-builder-v1...origin/ai/ub24-builder-v1
4. Si el resultado no es 0 0, sincronizar antes de continuar.
5. Despues de cada lote validado:
   • git add <archivos>
   • git commit -m "tipo(scope): mensaje"
   • git push origin ai/ub24-builder-v1
6. Registrar hash y objetivo en este archivo y en codex/HISTORIAL_CAMBIOS.md.

Registro de hashes

Baseline

• Commit: cb99f26
• Objetivo: crear rama y politica de versionado para trabajo IA.
• Revert:
  • git revert <hash>
  • git reset --hard <hash_anterior> (solo con aprobacion explicita)

Correccion historial

• Commit: fe8657e
• Objetivo: revertir commit no deseado y mantener separacion de cambios.
• Revert:
  • git revert fe8657e

Fix local Elementor

• Commit: 22e564e
• Objetivo: robustecer arranque local y carga de themes en Windows (BOM + logs seguros).
• Revert:
  • git revert 22e564e

Fase 1 Builder (visual pro)

• Commit: 1c04f04
• Objetivo: consolidar estilos reutilizables y subir calidad visual en hero, features, cards y contact del preview.
• Revert:
  • git revert 1c04f04

Ajustes Builder (limpieza + preview + ancho)

• Commit: 7c5f671
• Objetivo: quitar texto en barra Apple, limpiar menu vacio, preview local funcional sin salir de builder, ancho desktop al 100%, control de ancho por bloque y descripcion en bloque video.
• Revert:
  • git revert 7c5f671

Ajustes Builder (preview limpio + menu modos)

• Commit: dd98e9d
• Objetivo: mejorar vista previa (forzar modo limpio y restaurar estado), eliminar precarga automatica de bloques, y agregar modo de menu (horizontal/acordeon/ambos).
• Revert:
  • git revert dd98e9d

Runtime unificado (app + elementor)

• Commit: 1a5778b
• Objetivo: unificar arranque con python -m demo.app y registrar blueprint de Elementor en runtime principal.
• Revert:
  • git revert 1a5778b

Fix SQLite wrapper (arranque sin error SQL)

• Commit: f6d8ab1
• Objetivo: evitar conversiones SQL invalidas en SQLite que rompian inicializacion y generaban reintentos.
• Revert:
  • git revert f6d8ab1

API Elementor save/publish

• Commit: b6fb4da
• Objetivo: agregar endpoint dedicado /api/elementor/save para guardar builder con opcion de publicar.
• Revert:
  • git revert b6fb4da

Builder persistencia y feedback de publicacion

• Commit: c2ee81d
• Objetivo: mantener bloques cargados al entrar, normalizar bloques sin id y mostrar estado de guardado/publicacion en topbar.
• Revert:
  • git revert c2ee81d

Preview full-page + layout estable

• Commit: e20f086
• Objetivo: hacer que vista previa ocupe pagina completa y forzar layout por secciones (sin modo libre por defecto) para alinear bloques.
• Revert:
  • git revert e20f086

Full width + dos columnas por bloque

• Commit: e5df6de
• Objetivo: expandir ancho util del canvas y habilitar 2 columnas reales con toggle "Ancho completo" por bloque.
• Revert:
  • git revert e5df6de

Drag inteligente columnas + preview completo

• Commit: a6089ee
• Objetivo: permitir decidir 1 o 2 columnas moviendo bloques al soltar (centro=ancho completo, lados=media columna) y agregar opcion de preview completo en nueva pestana.
• Revert:
  • git revert a6089ee

URL local canonica (unificada)

• Base local: http://127.0.0.1:5001
• Builder local: http://127.0.0.1:5001/elementor/1
• Regla: usar siempre 127.0.0.1 (no localhost) en scripts, pruebas y documentacion local.

Arranque rapido local (Windows)

1. Desde c:\word, ejecutar:
   • python -m demo.app
2. Abrir:
   • http://127.0.0.1:5001/elementor/1
3. Verificacion rapida:
   • Invoke-WebRequest http://127.0.0.1:5001/elementor/1 -UseBasicParsing

Notas:

• En el primer arranque puede tardar unos segundos adicionales por inicializacion de DB.
• Logs:
  • c:\word\logs_demo_app.txt
  • c:\word\logs_demo_app.err

Control de rama (local/remoto)

• Rama local activa: ai/ub24-builder-v1
• Upstream remoto: origin/ai/ub24-builder-v1
• Estado al registrar: en sync (0/0) al 14 Febrero 2026
• Politica: commits atomicos + push por lote validado + verificacion de divergencia al inicio y al cierre.

Fases memorizadas (builder)

1. Fase 1 (UI Pro base): navbar premium, hero premium, sistema de espaciado/grid, pulido visual consistente.
2. Fase 2 (estructura): separar renderers por bloque y reducir inline styles para automatizacion.
3. Fase 3 (presets): presets por rubro + reglas responsive + variantes exportables.