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