238 lines
6.9 KiB
Markdown
238 lines
6.9 KiB
Markdown
# 📚 Í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.**
|