GKACHELE™ Agent - Configuración del Asistente y Documentación del Proyecto

Este archivo define las reglas, el contexto y el flujo principal para el asistente de IA (y cualquier desarrollador) trabajando en el ecosistema GKACHELE™.

🎯 Misión del Proyecto

GKACHELE™ es un sistema SaaS modular para la creación y gestión de sitios web, enfocado en la flexibilidad, el control de versiones mediante Gitea y el despliegue optimizado en Raspberry Pi/Linux.

⚠️ REGLAS CRÍTICAS (NUNCA ROMPER)

1. Prohibición de Referencias Externas

• NUNCA mencionar "WordPress", "wordpress", "WP" o "wp-" en el código fuente.
• Este es un sistema propio e independiente.
• Reemplazos:
  • "WordPress" -> "GKACHELE™" o "Sistema Modular".
  • "wp-admin" -> "/dashboard".
  • "wp_options" -> "tabla settings".

2. Metodología GKACHELE™

• Prioridad 1: Funcionalidad. Hacer que el código funcione y sea verificado en producción (Raspberry).
• Prioridad 2: Limpieza. Refactorizar y optimizar SOLO después de que la funcionalidad sea confirmada.
• Flujo: Funcionalidad -> Probar -> Funciona -> Limpieza -> Documentar.

🛠️ Skills & Infraestructura

Gestión de Repositorios (Gitea)

• Uso de gitea_connector.py para automatizar la creación de organizaciones y repositorios por cliente.
• Workflows de auto-commit y auto-deploy tras cambios en el customizer.

Infraestructura (Raspberry Pi & Docker)

• Despliegue mediante docker-compose.
• Scripts de sincronización: sync-to-raspberry.sh, update-code-pi.sh.
• Dominios gestionados via DuckDNS.

📝 Guías de Trabajo para el Agente

• Análisis antes de actuar: Siempre revisar la carpeta memoria/ antes de realizar cambios estructurales.
• Verificación de reglas: Antes de cada commit, realizar un grep para asegurar que no se colaron referencias prohibidas.
• Persistencia: Actualizar task.md y la memoria del proyecto tras completar hitos importantes.

---

🔄 Flujo Principal de la Aplicación GKACHELE™

Este es el proceso completo, desde un nuevo visitante hasta un sitio web publicado:

1. Visita a la Landing Page (/):

   • Un cliente potencial visita la página principal del servicio.

2. Solicitud de Plan y Configuración Inicial:

   • Desde la Landing Page, el cliente selecciona un plan (Base, Pro, Premium).
   • Rellena un formulario emergente (menú desplegable) con información inicial (nombre, email, rubro, etc.).
   • Este proceso redirige al usuario a la página de registro con los datos pre-cargados.

3. Registro de Cliente (/register):

   • El cliente finaliza su registro en la plataforma.

4. Creación del Sitio en Borrador (/customizer):

   • Una vez registrado y/o logueado, el cliente es dirigido al "Customizer". Aquí puede diseñar y personalizar su sitio web, que permanece en estado de borrador y no es público.

5. Envío de Solicitud de Publicación:

   • Cuando el cliente considera que su sitio en borrador está listo, lo envía para tu revisión y aprobación.

6. Revisión en el Dashboard del Administrador (/dashboard):

   • Tú, como administrador del sistema, recibes esta solicitud en tu panel principal. Aquí puedes ver todos los sitios pendientes de aprobación.

7. Aprobación o Rechazo Manual:

   • Revisas el sitio del cliente. Desde tu dashboard, decides si apruebas o rechazas la solicitud de publicación.

8. Panel de Cliente (/admin) y Publicación del Sitio:

   • Si la solicitud es aprobada, el sitio web del cliente se publica, y se habilita un panel de administración específico para ese cliente (/admin), desde donde puede gestionar su sitio en línea.

9. Visualización Pública del Sitio:

   • El sitio web aprobado y publicado es ahora accesible para cualquier usuario de internet en su dominio asignado.

---

© 2025 GKACHELE™. Todos los derechos reservados.