admin/gkachele-saas
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore(versioning): unificar documentacion y protocolo de sincronizacion

Browse Source
This commit is contained in:
komkida91
2026-02-14 19:14:48 +01:00
parent 6d696c4c5d
commit 075dad6f1a
4 changed files with 355 additions and 154 deletions
Download Patch File Download Diff File Expand all files Collapse all files

261
codex/HISTORIAL_CAMBIOS.md Normal file
View File

@@ -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.
---

36
codex/MEMORIA_CODEX.md Normal file
View File

@@ -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`

69
codex/VERSIONADO_IA.md
View File

@@ -3,20 +3,18 @@
## Rama de trabajo ## Rama de trabajo
- `ai/ub24-builder-v1` - `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 ## Regla de trabajo
1. Cada cambio funcional se guarda en un commit separado. 1. Cada cambio funcional se guarda en un commit separado.
2. Cada commit se registra con su hash. 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 ## Convencion de mensaje
### 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
- `feat(builder): ...` - `feat(builder): ...`
- `fix(builder): ...` - `fix(builder): ...`
- `refactor(builder): ...` - `refactor(builder): ...`
@@ -27,6 +25,25 @@
2. Push continuo a `origin/ai/ub24-builder-v1`. 2. Push continuo a `origin/ai/ub24-builder-v1`.
3. Merge cuando validemos en local y Raspberry. 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 ### Correccion historial
- Commit: `fe8657e` - Commit: `fe8657e`
- Objetivo: revertir commit no deseado y mantener separacion de cambios. - Objetivo: revertir commit no deseado y mantener separacion de cambios.
@@ -45,22 +62,6 @@
- Revert: - Revert:
- `git revert 1c04f04` - `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) ### Ajustes Builder (limpieza + preview + ancho)
- Commit: `7c5f671` - 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. - 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). - Objetivo: mejorar vista previa (forzar modo limpio y restaurar estado), eliminar precarga automatica de bloques, y agregar modo de menu (horizontal/acordeon/ambos).
- Revert: - Revert:
- `git revert dd98e9d` - `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.

143
memoria/ESTADO_ACTUAL.md
View File

@@ -1,133 +1,20 @@
# 📊 Estado Actual del Proyecto - GKACHELE™ # Estado Actual del Proyecto - GKACHELE
**© 2025 GKACHELE™. Todos los derechos reservados.** **Fecha de actualizacion:** 14 Febrero 2026
## 🎯 Hash Actual ## Aviso
Este archivo queda como referencia historica del ciclo 2025 (customizer inicial).
**Hash:** `gkachele-customizer-wordpress-adaptado-20250115-002` ## Fuente vigente de estado IA/UB24
**Fecha:** 15 Enero 2025 - `codex/VERSIONADO_IA.md`
**Estado:** ✅ **Demo WordPress completo creado - Listo para copiar y adaptar** - `codex/MEMORIA_CODEX.md`
- `codex/BUILDER_ELEMENTOR_VERSION.md`
- `codex/HISTORIAL_CAMBIOS.md`
--- ## Estado vigente resumido
- Rama activa: `ai/ub24-builder-v1`
- Builder UB24 en evolucion activa (ciclo 2026).
- Estado local/remoto verificado en sincronizacion al corte.
## ✅ FUNCIONANDO ## Nota operativa
No usar este archivo como fuente principal para decisiones de desarrollo actuales.
### Flujo Completo:
1. ✅ **Landing** - Funciona correctamente
2. ✅ **Registro** - Crea usuario + sitio automático
3. ✅ **Login** - Redirige DIRECTAMENTE a `/customizer/{site_id}`
4. ✅ **Customizer** - Personalización funcional
- Cambiar contenido
- Cambiar colores
- Cambiar tipografía
- **✅ Añadir bloques (video, imagen, texto, redes sociales, mapa)**
- **✅ Eliminar bloques**
- **✅ Ver lista de bloques añadidos**
- Guardar cambios (draft)
- Enviar solicitud (pending)
5. ✅ **Dashboard Cliente** - `/dashboard` - Ve sus sitios
6. ✅ **Dashboard Admin** - `/admin` - Gestión completa
- Ver usuarios
- Eliminar usuarios
- Ver solicitudes
- Aprobar/rechazar sitios
### Sistema de Base de Datos:
- ✅ Multi-tenant en `main.db`
- ✅ Tablas: users, sites, menus, widgets, content, settings, requests, media
- ✅ Sistema de roles basado en DB (administrator, editor, author, subscriber)
- ✅ Filtrado por `user_id` (cada cliente solo ve sus datos)
### Templates:
- ✅ Sistema modular (_gkachele/header.php, footer.php, sidebar.php)
- ✅ Menús dinámicos (header, footer, sidebar)
- ✅ Widgets dinámicos
- ✅ Temas: restaurante-moderno, restaurante-elegante, gimnasio-claro
---
## ⚠️ PENDIENTE
### Funcionalidades Core:
- [x] **Añadir bloques (COMPLETADO)**
- [x] **Eliminar bloques (COMPLETADO)**
- [x] **Lista de bloques en sidebar (COMPLETADO)**
- [ ] Editar contenido de bloques existentes
- [ ] Mover bloques (drag & drop) en customizer
- [ ] Editar inline (contenteditable)
- [ ] UI completa para gestionar menús desde customizer
### Infraestructura:
- [ ] Subdominios automáticos
- [ ] Integración pagos Nominalia
- [ ] Gitea y workflows
- [ ] Control de versiones Git
### Mejoras:
- [ ] Landing optimizada para Argentina
- [ ] Limitaciones por plan
- [ ] Sistema de actividad/logs
- [ ] Mejorar UI/UX
---
## 🚀 PRÓXIMOS PASOS
1. **Probar con 1 rubro completo** (restaurante)
2. **Mejorar customizer** (mover bloques, editar inline)
3. **Gitea y workflows** (despliegues automáticos)
4. **Subdominios** (con tu dominio)
5. **Pagos Nominalia** (comodines)
---
## 📍 DEPLOYMENT
### Actual: Raspberry Pi 3
- ✅ Funcionando
- ✅ Login → Customizer funciona
- ✅ Todo operativo
### Futuro: VPS
- Si funciona 1 rubro bien → Migrar a VPS
- Mismo código
- Más recursos
- Dominio propio
---
## 🔄 ÚLTIMA ACTUALIZACIÓN
**Hash:** `gkachele-customizer-wordpress-adaptado-20250115-002`
**Fecha:** 15 Enero 2025
**Logro:** ✅ **Demo WordPress completo creado - Listo para copiar y adaptar**
### Cambios en este Hash:
- ✅ Creado demo completo WordPress: `customizer-wordpress-COMPLETO.html`
- ✅ Todas las funcionalidades de WordPress implementadas (paneles, toggles, sliders, repeaters, etc.)
- ✅ Documentación completa: `CUSTOMIZER_WORDPRESS_COMPLETO.md`
- ✅ Objetivo claro documentado: `OBJETIVO_CUSTOMIZER_ADAPTADO.md`
- ✅ Identificados problemas críticos: `PROBLEMAS_CRITICOS_CUSTOMIZER.md`
### Plan para Próxima Sesión:
1. **COPIAR WordPress** (demo completo)
2. **AUTOMATIZAR** procesos (guardado, preview, etc.)
3. **CAMBIAR branding** a GKACHELE™ (logo, nombres, colores)
4. **ADAPTAR** funcionalidades con lo que ya sabemos
5. **INTEGRAR** con backend Flask existente
### Archivos Creados:
- `customizer-wordpress-COMPLETO.html` - Demo completo independiente
- `CUSTOMIZER_WORDPRESS_COMPLETO.md` - Documentación completa
- `OBJETIVO_CUSTOMIZER_ADAPTADO.md` - Objetivo claro
- `PROBLEMAS_CRITICOS_CUSTOMIZER.md` - Problemas identificados
### Estado:
- ✅ Demo WordPress completo (funcional, independiente)
- ✅ Documentación completa
- ✅ Objetivo claro definido
- ⏳ Pendiente: Copiar y adaptar al customizer real
---
**© 2025 GKACHELE™. Todos los derechos reservados.**