chore(versioning): unificar documentacion y protocolo de sincronizacion

2026-02-14 19:14:48 +01:00
parent 6d696c4c5d
commit 075dad6f1a
4 changed files with 355 additions and 154 deletions
--- a/codex/HISTORIAL_CAMBIOS.md
+++ b/codex/HISTORIAL_CAMBIOS.md
@@ -0,0 +1,261 @@
+# 📝 Historial de Cambios - GKACHELE™
+
+**© 2025 GKACHELE™. Todos los derechos reservados.**
+
+## 🔄 Historial de Versiones
+
+### Hash: `gkachele-elementor-apple-20260209-v14`
+**Fecha:** 09 Febrero 2026  
+**Estado:** OK Fase 1
+
+#### Cambios:
+- OK Modo libre unico activo
+- OK Drag/resize con handles 8 puntos + Shift
+- OK Guías de snap
+- OK Touch (capacitivos)
+- OK Auto-height del canvas
+- OK Menu superior movible y redimensionable
+- OK Boton Alinear
+
+---
+
+### Hash: `gkachele-elementor-apple-20260209-v13`
+**Fecha:** 09 Febrero 2026  
+**Estado:** OK UX Builder
+
+#### Cambios:
+- OK Sidebar: solo drag (sin agregar por click)
+- OK Menu: acordeon responsive por tamanos de preview
+- OK Media: captions + fit (cover/contain) en imagen/galeria
+- OK Video: drag & drop (dataURL) o URL
+- OK Delete inline en bloques (icono en preview)
+- OK Free drag: links no bloquean movimiento
+- OK Boton atras (history.back)
+
+---
+
+### Hash: `gkachele-elementor-apple-20260209-v12`
+**Fecha:** 09 Febrero 2026  
+**Estado:** OK Responsive + fondos
+
+#### Cambios:
+- OK Menu responsive con acordeon en movil
+- OK Fondo: animacion de gradiente + GIF de fondo
+- OK Boton: estilos (primario/outline/ghost) y tamanos
+- OK Boton flotante WhatsApp (si hay numero)
+- OK Transiciones premium (botones/iconos/hover)
+- OK Modo libre: sin etiqueta ON, estado visual
+
+---
+
+### Hash: `gkachele-elementor-apple-20260209-v11`
+**Fecha:** 09 Febrero 2026  
+**Estado:** OK Mejoras UX/UI
+
+#### Cambios:
+- OK Mas tipografias en el inspector
+- OK Redes: estilos premium (pill/circulo/outline/minimal/solid) + iconos extra
+- OK Drag & drop de imagenes desde el preview (imagen y galeria)
+- OK Mapa: embed corregido (google.com/maps)
+- OK Contacto: mailto/tel
+- OK Calendario: vista tipo calendario (si no hay embed)
+- OK Resenas: estilos (card/quote/compacto)
+- OK Resize activo en ambos modos
+- OK Modo libre con tamanos mas controlados
+- OK Transiciones y hover premium en iconos
+
+---
+
+### Hash: `gkachele-elementor-apple-20260209-v10`
+**Fecha:** 09 Febrero 2026  
+**Estado:** OK Pendientes anotados
+
+#### Cambios:
+- OK Memoria actualizada para adaptacion a SaaS
+- OK Pendientes: color de texto, transiciones, colores de iconos
+- OK Pendientes: resize en modo libre, mapa direccion
+- OK Pendientes: tarjetas con 3 opciones y menu movil acordeon
+
+---
+
+
+### Hash: `gkachele-elementor-apple-20260209-v9`
+**Fecha:** 09 Febrero 2026  
+**Estado:** OK Ajustado
+
+#### Cambios:
+- OK Iconos de preview (movil/tablet/web)
+- OK Redes con iconos y tamano ajustable
+- OK Mapa sin API y boton scroll
+- OK Carga de logo/fondo por arrastre
+
+---
+
+
+### Hash: `gkachele-elementor-apple-20260209-v8`
+**Fecha:** 09 Febrero 2026  
+**Estado:** OK Ajustado
+
+#### Cambios:
+- OK Menu superior detecta secciones
+- OK Layout 2 columnas basico
+- OK Contador ilimitado en topbar
+- OK Botones de tamano preview
+
+---
+
+
+### Hash: `gkachele-elementor-apple-20260209-v7`
+**Fecha:** 09 Febrero 2026  
+**Estado:** OK Ajustado
+
+#### Cambios:
+- OK Fondos con gradiente y controles visibles
+- OK Tama?o de bloques por porcentaje
+- OK Topbar con contador y salto a bloques
+- OK Animaciones configurables
+
+---
+
+
+### Hash: `gkachele-elementor-apple-20260209-v6`
+**Fecha:** 09 Febrero 2026  
+**Estado:** OK Ajustado
+
+#### Cambios:
+- OK Modo libre (drag X/Y) con snapping
+- OK Boton de activacion en topbar
+- OK Posiciones guardadas por bloque
+
+---
+
+
+### Hash: `gkachele-elementor-apple-20260209-v5`
+**Fecha:** 09 Febrero 2026  
+**Estado:** OK Ajustado
+
+#### Cambios:
+- OK Componentes nuevos: tarjetas e iconos
+- OK Sidebar e inspector con configuracion de items
+- OK Render en preview y tema apple-pro
+
+---
+
+
+### Hash: `gkachele-elementor-apple-20260209-v4`
+**Fecha:** 09 Febrero 2026  
+**Estado:** OK Ajustado
+
+#### Cambios:
+- OK Editor de tipografias (texto y titulos) en el inspector
+- OK Paleta de colores (fondo, texto, secundario)
+- OK Preview con variables de estilo aplicadas
+- OK Animaciones sutiles en bloques (hover + entrada)
+
+---
+
+
+### Hash: `gkachele-builder-apple-20260208-v2`
+**Fecha:** 08 Febrero 2026  
+**Estado:** ✅ Ajustado
+
+#### Cambios:
+- ✅ Restaurado template del builder en `elementor/templates/elementor_builder.html`
+- ✅ Drag & drop funcional (agregar y reordenar en preview)
+- ✅ Inspector estable para editar bloques y ajustes del sitio
+
+---
+
+### Hash: `gkachele-elementor-apple-20260208-v3`
+**Fecha:** 08 Febrero 2026  
+**Estado:** ✅ Base de trabajo (congelada)
+
+#### Cambios:
+- ✅ Version base del builder para continuar mañana
+- ✅ Drag & drop estable en preview
+- ✅ Inspector con edicion de bloques
+- ✅ Fondo y video por URL en preview
+
+---
+
+### Hash: `gkachele-builder-apple-20260208-v1`
+**Fecha:** 08 Febrero 2026  
+**Estado:** ✅ En progreso
+
+#### Cambios:
+- ✅ Builder tipo drag & drop en ruta `/elementor/{site_id}`
+- ✅ Vista lienzo con bloques sobre la pagina (no lista)
+- ✅ Preview en vivo con marco estilo navegador
+- ✅ Tema `apple-pro` para paginas profesionales
+- ✅ Soporte de logo, fondo con imagen y video en ajustes
+- ✅ Redes sociales ampliadas (TikTok, YouTube, LinkedIn, X, Telegram)
+
+---
+
+### Hash: `gkachele-login-customizer-20250114-v3`
+**Fecha:** 14 Enero 2025 - 11:34  
+**Estado:** ✅ Funcionando
+
+#### Cambios:
+- ✅ **Login redirige correctamente a customizer**
+- ✅ Añadido debugging completo (backend + frontend)
+- ✅ Content-Type JSON explícito en respuesta
+- ✅ Flush=True en todos los prints
+- ✅ Console.log en frontend para debugging
+- ✅ Verificación de sitios del usuario antes de redirigir
+
+#### Funcionalidad:
+- Login → Busca primer sitio del usuario
+- Si tiene sitio → `/customizer/{site_id}`
+- Si no tiene sitio → `/dashboard`
+- Frontend recibe y procesa correctamente el redirect
+
+---
+
+### Hash: `gkachele-argentina-20250114-v2`
+**Fecha:** 14 Enero 2025 - 11:15
+
+#### Cambios:
+- Documentación objetivos Argentina
+- Gitea y workflows documentados
+- Subdominios y pagos documentados
+
+---
+
+### Hash: `gkachele-template-system-20250114-v1`
+**Fecha:** 14 Enero 2025 - 08:50
+
+#### Cambios:
+- Sistema modular de templates
+- Menús y widgets dinámicos
+- Sistema de roles basado en DB
+
+---
+
+**Ultima actualizacion:** 09 Febrero 2026
+
+---
+
+**© 2025 GKACHELE™. Todos los derechos reservados.**
+
+### Hash: `gkachele-builder-docs-20260208-v1`
+**Fecha:** 08 Febrero 2026  
+**Estado:** ✅ Documentado
+
+#### Cambios:
+- ✅ Guía rápida del builder en `memoria/BUILDER_ELEMENTOR.md`
+- ✅ Entrada en índice de documentación
+
+---
+
+### Hash: `gkachele-docs-sync-20260214-v1`
+**Fecha:** 14 Febrero 2026
+**Estado:** OK Documentacion unificada
+
+#### Cambios:
+- Fuente vigente consolidada en `codex/*`.
+- `codex/VERSIONADO_IA.md` actualizado con protocolo fijo de sync local/remoto.
+- `codex/MEMORIA_CODEX.md` actualizado con punto exacto (rama, commit, version base, estado sync).
+- `memoria/ESTADO_ACTUAL.md` marcado como historico para evitar decisiones con contexto 2025.
+
+---
--- a/codex/MEMORIA_CODEX.md
+++ b/codex/MEMORIA_CODEX.md
@@ -0,0 +1,36 @@
+# Memoria Codex - GKACHELE
+
+**Fecha de corte:** 14 Febrero 2026
+
+## Fuente de verdad (estado IA)
+- `codex/VERSIONADO_IA.md`
+- `codex/BUILDER_ELEMENTOR_VERSION.md`
+- `codex/HISTORIAL_CAMBIOS.md`
+
+## Punto exacto
+- Rama activa: `ai/ub24-builder-v1`
+- Commit HEAD: `6d696c4`
+- Version base builder: `gkachele-elementor-templates-20260210-v21`
+- Estado de sync local/remoto al corte: `0/0`
+
+## Estado actual funcional
+- Builder visual operativo en `/elementor/<site_id>`.
+- Drag/drop y resize fluido en canvas.
+- Inspector para estilos y contenido.
+- Modo libre con snapping.
+- Preview limpio y menu por modos (horizontal/acordeon/ambos).
+
+## Pendientes inmediatos
+- Cargar bloques reales por plantilla de rubro (no solo look-and-feel).
+- Definir persistencia de resenas al publicar.
+- Integrar calendario real (Calendly/Google).
+- Consolidar puente Builder -> SaaS (`/customizer/<id>`).
+
+## Flujo operativo memorizado
+1. Construir y validar local en `http://127.0.0.1:5001`.
+2. Guardar cambios en commits atomicos.
+3. Push a `origin/ai/ub24-builder-v1` en cada lote validado.
+4. Actualizar hash y estado en `codex/VERSIONADO_IA.md`.
+
+## Comando de arranque
+- `python -m demo.app` desde `c:\word`
--- a/codex/VERSIONADO_IA.md
+++ b/codex/VERSIONADO_IA.md
@@ -3,20 +3,18 @@
 ## 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 reversión rápida.
+3. Cada commit debe incluir comando de reversion rapida.
+4. La rama debe quedar sincronizada con remoto al cerrar bloque de trabajo.

-## Registro de hashes
-### Baseline
- Commit: `cb99f26`
- Objetivo: crear rama y política de versionado para trabajo IA.
- Revert:
-  - `git revert <hash>`
-  - o volver a commit previo: `git reset --hard <hash_anterior>` (solo si se aprueba explícitamente)
-
-## Convención de mensaje
+## Convencion de mensaje
 - `feat(builder): ...`
 - `fix(builder): ...`
 - `refactor(builder): ...`
@@ -27,6 +25,25 @@
 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.
@@ -45,22 +62,6 @@
 - Revert:
  - `git revert 1c04f04`

-## 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.
-
-## Control de rama (local/remoto)
- Rama local activa: `ai/ub24-builder-v1`
- Upstream remoto: `origin/ai/ub24-builder-v1`
- Estado al registrar: local `ahead 5`
- Politica: seguir commits atomicos y luego `git push origin ai/ub24-builder-v1` por lote validado.
-
-## 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.
-
 ### 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.
@@ -72,3 +73,19 @@
 - 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`
+
+## 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.
+
+## 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.