gkachele-saas/memoria/INDICE.md

📚 ÍNDICE DE DOCUMENTACIÓN - GKACHELE™

© 2025 GKACHELE™. Todos los derechos reservados.

🎯 IMPORTANTE: LEER SIEMPRE ESTA CARPETA ANTES DE HACER CAMBIOS

Esta carpeta contiene TODA la documentación del proyecto. SIEMPRE consulta estos archivos antes de modificar código.

---

📋 DOCUMENTOS PRINCIPALES

1. ⚠️ REGLA_IMPORTANTE.md - LEER PRIMERO

• 🚫 NUNCA mencionar "WordPress" en el código
• Reglas de branding y nomenclatura
• Reemplazos correctos
• LEER ANTES DE ESCRIBIR CUALQUIER CÓDIGO

2. 📖 MEMORIA_PROYECTO_COMPLETA.md

• Documentación completa del proyecto
• Arquitectura del sistema
• Flujos y rutas
• Estado actual
• Referencia principal del proyecto

3. 🔐 SISTEMA_ROLES.md

• Sistema de roles y permisos basado en DB
• Jerarquía de roles (administrator, editor, author, subscriber)
• Funciones helper: user_has_role(), user_can()
• Migración automática
• NUNCA hardcodear permisos

4. 👥 GESTION_USUARIOS.md

• Sistema de gestión de usuarios
• Ver usuarios registrados
• Eliminar usuarios (con cascada)
• Consultas SQL útiles
• Panel /admin

5. 🔌 COMO_CONECTAR_DB.md

• Cómo conectarse a la base de datos
• DB Browser for SQLite
• Scripts Python
• Consultas útiles
• Sincronización con Raspberry

6. 🖥️ MEMORIA_RASPBERRY_SAAS.md

• Configuración de Raspberry Pi
• Servicio systemd
• Nginx
• DuckDNS
• Deployment

7. 🔄 MEMORIA_SINCRONIZACION.md

• Sincronización entre local y Raspberry
• Scripts de actualización
• Cron jobs
• Verificación

8. 🔐 CREDENCIALES_CLIENTES.md

• Credenciales de acceso de clientes
• Usuario administrador
• ARCHIVO CONFIDENCIAL - Mantener privado

9. 🎯 METODOLOGIA_TRABAJO.md

• Regla: Primero funcionalidad, después limpieza
• Checklist de trabajo
• Principios de desarrollo

10. 📖 DOCUMENTACION_PROYECTO.md

• Documentación completa del proyecto
• ¿Qué estamos construyendo?
• Arquitectura técnica
• Flujo completo del sistema
• Estado actual

11. ❓ RESPUESTAS_PREGUNTAS.md

• Respuestas a preguntas frecuentes
• Python vs Docker
• VPS vs Raspberry Pi
• Acceso a base de datos
• Limitaciones por plan

12. 🇦🇷 OBJETIVOS_ARGENTINA.md

• Objetivos para lanzamiento en Argentina
• Criterio de éxito (Raspberry → VPS)
• Checklist pre-argentina
• Plan de acción completo

13. 🔄 GITEA_WORKFLOWS.md

• Integración Gitea
• Workflows automáticos
• Repositorios por cliente
• Integración con dashboard admin
• Despliegues automáticos

14. 🎯 FUNCIONALIDADES_COMPLETAS.md

• Flujo correcto del sistema
• Funcionalidades requeridas
• Estado actual
• Checklist funcionalidad

15. 🌐 SUBDOMINIOS_PAGOS.md

• Sistema de subdominios
• Integración pagos Nominalia
• Comodines para pagos
• Gestión de dominios

16. 📊 ESTADO_ACTUAL.md

• Estado actual del proyecto
• Hash actual
• Funcionando vs Pendiente
• Próximos pasos

17. 📝 HISTORIAL_CAMBIOS.md

• Historial de versiones
• Hash de cada cambio
• Log de funcionalidades

18. 🗂️ ESTRUCTURA_RUTAS.md

• Estructura de rutas acordada
• /customizer - Editar antes de publicar
• /admin - Panel del cliente
• /dashboard - Panel principal admin
• Flujo completo

19. 🎨 SISTEMA_TEMPLATES.md

• Sistema de templates estilo WordPress
• Cómo añadir nuevos templates fácilmente
• Estructura de carpetas y config.json
• Endpoints API para templates
• Uso en customizer

20. ✏️ EDITOR_VISUAL_PREVIEW.md

• Análisis: Edición en preview vs sidebar
• Click to edit en preview (como WordPress)
• Sincronización bidireccional
• Plan de implementación híbrido
• Hash: gkachele-editor-visual-20250114-1425

21. 🧩 SISTEMA_BLOQUES_EDITABLES.md

• Sistema de bloques añadibles/eliminables
• Drag & drop para reordenar
• Videos, imágenes, texto, redes sociales, mapas
• Iconos SVG para redes sociales
• Mapa embed sin API key
• Hash: gkachele-bloques-editables-20250115-001

22. 📋 PENDIENTES_MEJORAS.md

• Lista de mejoras pendientes
• Bugs a arreglar
• Funcionalidades por implementar
• Prioridades y checklist
• Hash: gkachele-pendientes-20250115-004

23. 🚨 PROBLEMAS_CRITICOS_CUSTOMIZER.md

• PROBLEMAS CRÍTICOS DEL CUSTOMIZER
• Análisis completo de problemas
• Cómo funciona WordPress Customizer
• Plan para rehacer completamente
• LEER ANTES DE TRABAJAR EN CUSTOMIZER
• Hash: gkachele-problemas-customizer-20250115-001

24. 🎯 CUSTOMIZER_WORDPRESS_COMPLETO.md

• DEMO COMPLETO DE WORDPRESS CUSTOMIZER
• Todas las funcionalidades implementadas
• Paneles, secciones, controles (toggles, sliders, repeaters, etc.)
• Sistema de guardado correcto
• Diseño visual exacto WordPress
• ARCHIVO DEMO: customizer-wordpress-COMPLETO.html
• LEER PARA ADAPTAR AL CUSTOMIZER REAL
• Hash: gkachele-customizer-wordpress-completo-20250115-001

25. 🎯 OBJETIVO_CUSTOMIZER_ADAPTADO.md

• OBJETIVO CLARO: CUSTOMIZER ADAPTADO
• Similar a WordPress pero con branding GKACHELE™
• AUTOMATIZADO (procesos automáticos)
• Ver WordPress y solo ADAPTARLO (no copiar)
• Principios: Similar no igual, Automatizado, Adaptar no copiar
• LEER ANTES DE EMPEZAR A IMPLEMENTAR
• Hash: gkachele-objetivo-customizer-adaptado-20250115-001

---

🎯 PRINCIPIOS DEL PROYECTO

1. Todo en Base de Datos: Sin lógica hardcodeada
2. Sistema Multi-tenant: Todos los clientes en main.db
3. Roles Dinámicos: Basados en DB, no hardcodeados
4. Branding GKACHELE™: Sin referencias a otros sistemas
5. Modular: Código organizado y reutilizable

---

📍 ESTRUCTURA DEL PROYECTO

c:\word\
├── demo/                    # Código del SaaS
│   ├── app.py              # Flask backend
│   ├── database/           # main.db (multi-tenant)
│   ├── themes/             # Templates
│   ├── templates/          # HTML templates
│   └── static/             # CSS, JS
├── memoria/                 # 📚 TODA LA DOCUMENTACIÓN AQUÍ
│   ├── INDICE.md           # Este archivo
│   ├── REGLA_IMPORTANTE.md # ⚠️ LEER PRIMERO
│   ├── MEMORIA_PROYECTO_COMPLETA.md
│   ├── SISTEMA_ROLES.md
│   ├── GESTION_USUARIOS.md
│   ├── COMO_CONECTAR_DB.md
│   ├── MEMORIA_RASPBERRY_SAAS.md
│   └── MEMORIA_SINCRONIZACION.md
└── backups/                 # Backups del proyecto

---

✅ CHECKLIST ANTES DE HACER CAMBIOS

• Leer REGLA_IMPORTANTE.md (nunca mencionar WordPress)
• Consultar MEMORIA_PROYECTO_COMPLETA.md para entender arquitectura
• Verificar SISTEMA_ROLES.md si toca permisos
• Revisar documentación relevante según el cambio
• Verificar que no haya lógica hardcodeada
• Asegurar que todo esté basado en DB

---

🔄 ACTUALIZACIÓN

Última actualización: 14 Enero 2025
Hash: gkachele-docs-consolidated-20250114

---

© 2025 GKACHELE™. Todos los derechos reservados.