# 📚 Í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.**