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:

Visita a la Landing Page (/):
- Un cliente potencial visita la página principal del servicio.
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.
Registro de Cliente (/register):
- El cliente finaliza su registro en la plataforma.
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.
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.
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.
Aprobación o Rechazo Manual:
- Revisas el sitio del cliente. Desde tu dashboard, decides si apruebas o rechazas la solicitud de publicación.
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.
Visualización Pública del Sitio:
- El sitio web aprobado y publicado es ahora accesible para cualquier usuario de internet en su dominio asignado.

3.9 KiB Raw Blame History