gkachele-saas/codex/VERSIONADO_IA.md

Versionado IA - UB24 / Elementor

1) Objetivo

Definir un proceso de versionado auditable, reproducible y estable para el desarrollo del builder UB24.

2) Estado actual verificado

• Fecha de verificacion: 2026-02-22
• Rama activa: ai/ub24-builder-v1
• Upstream: origin/ai/ub24-builder-v1
• Divergencia local/remoto: 3 0
• Comando usado:
  • git rev-list --left-right --count ai/ub24-builder-v1...origin/ai/ub24-builder-v1

3) Politica de versionado

1. Commits atomicos por cambio funcional.
2. Mensajes bajo convencion semantica.
3. Reversion siempre definida por commit.
4. Cada bloque validado se empuja a remoto.
5. No mezclar cambios de infraestructura con cambios de UX en el mismo commit.

4) Convencion de commits

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

5) Flujo obligatorio por sesion

1. Verificar rama activa:
   • git branch --show-current
2. Actualizar referencias remotas:
   • git fetch origin --prune
3. Verificar divergencia:
   • git rev-list --left-right --count ai/ub24-builder-v1...origin/ai/ub24-builder-v1
4. Si no es 0 0, sincronizar antes de editar.
5. Al cerrar lote validado:
   • git add <archivos>
   • git commit -m "tipo(scope): mensaje"
   • git push origin ai/ub24-builder-v1

5.1) Metodo de ejecucion memorizado (obligatorio)

1. Misma rama activa (ai/ub24-builder-v1), sin ramas paralelas para fixes rapidos.
2. Control por hash/revert: si un intento falla, revert inmediato por commit.
3. Un archivo por fix cuando sea posible (evitar mezclar cambios laterales).
4. Validacion funcional inmediata despues de cada microcambio.
5. No commit/push sin orden explicita del usuario.

6) Protocolo de arranque local

• Comando canonico:
  • python -m demo.app
• URL canonica:
  • http://127.0.0.1:5001
• Builder:
  • http://127.0.0.1:5001/elementor/1
• Verificacion rapida:
  • Invoke-WebRequest http://127.0.0.1:5001/elementor/1 -UseBasicParsing

7) Criterios de estabilidad (no negociables)

1. No tocar funcionalidades estables sin requerimiento explicito.
2. Mantener una sola estrategia de layout y DnD por flujo.
3. Mantener una sola ruta de guardado activa:
   • /api/elementor/save
4. Validar guardado/publicacion antes de cerrar lote.
5. Evitar cambios amplios si un fix local resuelve el problema.

8) Registro de commits relevantes

Fecha	Commit	Tipo	Objetivo	Revert recomendado
2026-02-21	e83e915	fix	Estabilizar Drawer Pro, reset real de builder y restaurar tema restaurante editable + ancho	git revert e83e915
2026-02-14	cb99f26	chore	Crear rama y politica inicial de versionado IA	git revert cb99f26
2026-02-14	fe8657e	fix	Revertir commit no deseado y limpiar historial	git revert fe8657e
2026-02-14	22e564e	fix	Robustecer arranque local/theme load en Windows	git revert 22e564e
2026-02-14	1c04f04	feat	Mejora visual base (hero/features/cards/contact)	git revert 1c04f04
2026-02-14	7c5f671	fix	Limpieza preview/menu y ajustes de ancho	git revert 7c5f671
2026-02-14	dd98e9d	fix	Preview limpio y menu por modos	git revert dd98e9d
2026-02-15	1a5778b	refactor	Runtime unificado python -m demo.app + blueprint Elementor	git revert 1a5778b
2026-02-15	8ac360b	feat	Educacion V2 + correccion de anclas	git revert 8ac360b
2026-02-15	f6d8ab1	fix	Corregir wrapper SQLite para evitar fallo de arranque	git revert f6d8ab1
2026-02-15	b6fb4da	feat	API dedicada /api/elementor/save con opcion publicar	git revert b6fb4da
2026-02-15	c2ee81d	fix	Persistencia de bloques + feedback de publish	git revert c2ee81d
2026-02-15	e20f086	fix	Preview full-page y layout estable por secciones	git revert e20f086
2026-02-15	e5df6de	feat	Full width + soporte real de 2 columnas	git revert e5df6de
2026-02-15	a6089ee	feat	Drag inteligente por drop + preview en nueva pestana	git revert a6089ee
2026-02-15	f9f7d23	fix	Quitar layout global y forzar preview completo	git revert f9f7d23
2026-02-15	f363eef	fix	Correccion de texto/UI + modo libre + ?full=1	git revert f363eef
2026-02-16	6f14308	fix	Unificar layout y estabilizar redimension en canvas	git revert 6f14308

9) Decisiones funcionales vigentes

• Rubros oficiales permitidos:
  • restaurante
  • danza
  • cosmeticos
  • despachos
  • gimnasios
  • educacion
  • base_otro
• Preview final separada habilitada:
  • GET /elementor/<site_id>/preview-final
  • GET /ub24/<site_id>/preview-final
• Motor de reordenamiento seleccionado para DnD:
  • SortableJS (estrategia unica)

10) Pendientes priorizados

1. QA manual de cada icono/accion del menu superior en preview final (siguiente lote).
2. Footer global obligatorio con autoria del proyecto.
3. Watermark de autoria en codigo bajo convencion unica.
4. Flujo dual estable de preview (editor/pagina real).
5. Mejora de interaccion touch/capacitiva del builder.

11) Referencias cruzadas

• Historial funcional detallado: codex/HISTORIAL_CAMBIOS.md
• Arranque rapido local: codex/ARRANQUE_RAPIDO_UB24.md
• Flujo general del proyecto: codex/FLUJO_PROYECTO.md

12) Nota operativa

Este archivo define el estandar de trabajo. Cualquier cambio de proceso debe registrarse en un commit chore(versioning) y quedar reflejado aqui.