# 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-19`
- Rama activa: `ai/ub24-builder-v1`
- Upstream: `origin/ai/ub24-builder-v1`
- Divergencia local/remoto: `0 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`

## 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-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. Footer global obligatorio con autoria del proyecto.
2. Watermark de autoria en codigo bajo convencion unica.
3. Flujo dual estable de preview (editor/pagina real).
4. Correccion de menu superior en modo acordeon.
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.