ClickConvert Framework 1.0.1

2. Metodología & Workflow

User Centric Approach: Market Fit al Despliegue

Antes del desarrollo, se realiza un estudio de necesidades del mercado para asegurar el Market Fit. Esto define la propuesta de arquitectura UX-CRO optimizada para la conversión final.

ClickFlow: El embudo dinámico

La arquitectura implementa el concepto "ClickFlow", un flujo de funnel dinámico que se adapta según el mercado y el usuario.

1. Landing Page UX-CRO: Optimizada con una sola imagen principal (Hero Image) y velocidad de carga >98%.
2. Captación Inicial: Formularios cortos (nombre/mail) para reducir la fricción inicial.
3. Cualificación Step-up: Inyección dinámica de campos y flujos de "calentamiento" (FAQs, artículos, necesidades).
4. Nurturing: Automatización inbound para convertir el lead en cliente final.

Ecosistema: Landing + Workzone + CRO

Centro de mando distribuido con trazabilidad total del lead. Integra la landing optimizada con el ERP "Workzone" para un control absoluto del flujo de captación y ventas.

3. Core Architecture (Frontend)

Arquitectura Full-stack propia (Ad-hoc) basada en el patrón Modelo-Vista-Controlador (MVC) desacoplado. Separa la lógica de negocio en /classes y la presentación en /themes.

Stack Tecnológico

• PHP 7.4+ Tipado estricto e inyección de dependencias manual.
• MySQL 8.0 / MariaDB Abstracción nativa con mysqli.
• JS Nativo (ES6) Manipulación del DOM sin frameworks pesados.
• Custom Classes Objetos de negocio: Project, Author, Page, Post.

Gestión de Datos & DB Abstraction

Utiliza una clase DB personalizada que encapsula mysqli, implementando Prepared Statements y un sistema de prefijos de tablas (PREFIX_DB) para seguridad y coexistencia de bases de datos.

// Estándar de seguridad en ClickConvert
$db->prepare("SELECT lead_id FROM leads WHERE email = ? AND status = 'active'");
$db->bind("s", $userEmail);
$result = $db->execute();

Routing System: Enrutamiento Dinámico

Sistema de URL Rewriting que procesa peticiones mediante la constante global URL_ACTUAL. Permite la resolución de slugs amigables para contenido multi-idioma de forma dinámica sin dependencias externas.

i18n: Motor de Internacionalización Nativo

Detección y validación de idioma a través de sesiones y parámetros GET. Carga dinámicamente archivos de traducción desde /langs/ y ajusta las constantes globales de la aplicación según el contexto del usuario.

4. Workzone (Backend ERP)

El directorio /workzone constituye el núcleo administrativo. Su arquitectura modular garantiza la integridad de los datos mediante una secuencia crítica de inicialización.

Autenticación & RBAC

Uso de checkSession.php para validar tokens de sesión y vinculación con User-Agent. El modelo RBAC (checkPermissions.php) restringe vistas y acciones según el rol administrativo.

Arquitectura de Controladores AJAX

Gestión asíncrona total. Los controladores en /actions (como ContactSend.php o ProjectUpdate.php) verifican el origen ($fromAjaxRequest) antes de devolver respuestas JSON serializadas.

Logging & Auditoría Interna

Implementación de la función addRegLog() para trazabilidad total de eventos críticos: inicios de sesión, errores en formularios y actualizaciones de proyectos, almacenados en la ruta LOGS_URL.

Server Tuning & Optimización

Configuración específica de php.ini para alta carga:

• memory_limit: 256M para procesos pesados.
• max_input_vars: 12.000 para gestión masiva de datos.
• execution_time: 120s para tareas de mantenimiento y sincronización.

5. Integraciones y APIs

Marketing Automation: Mailchimp Sync

Sincronización automatizada de leads y suscripciones mediante API nativa:

• Uso de MAILCHIMP_TOKEN_ID_API para autenticación segura.
• Segmentación automática mediante MAILCHIMP_TOKEN_ID_LIST.
• Controlador NewsletterSend.php con lógica de validación doble.

Tracking & Analytics: GTM & Google Ads

Inyección dinámica de scripts (META_HEAD, BODY, FOOTER) gestionados desde base de datos. Incluye un sistema de reemplazo de caracteres (-c0m1ll4d0bl3-) para asegurar que el JavaScript de Google se renderice sin errores de sintaxis.

SMTP & Nurturing: Email Transaccional

Configuración de servidor SMTP dedicado (puerto 587) para el flujo de "calentamiento". Control de intervalos mediante DAYS_REST_SENDING_AUTOEMAIL para reenvíos automáticos cada 3 días.

6. Features Avanzadas

Step-up Profiling (Cualificación Progresiva)

Lógica técnica avanzada en Projects.class.php que vincula el lead inicial con datos complejos (presupuesto, calidades) tras la captación básica. Captura datos críticos solo cuando el interés del usuario es máximo.

Seguridad Anti-Exploit Agresiva

Protección Activa Sanitización rigurosa en MySQL.class.php y Contacts.class.php:

• Limpieza Agresiva: Uso de str_ireplace para eliminar comillas y keywords peligrosas antes de la DB.
• Control de Longitud: Limitación estricta de campos (ej. substr($id, 0, 40)) contra ataques de desbordamiento.

SEO Técnico & Relaciones Semánticas

Generación dinámica de etiquetas hreflang en Langs.class.php. El sistema asocia slugs multi-idioma (ej: "Contacto" <-> "Contacte") para mantener el contexto SEO al cambiar de idioma.

Behavioral Tracking & Scoring

Registro de visualizaciones vinculado a IP e idSession mediante addViewTypePost. Permite analizar qué contenido ha consumido un lead antes de pedir presupuesto para realizar un nurturing quirúrgico.

User Experience: Client Portal

Construcción de emails con inyección de identidad. Cada lead recibe un enlace único (MAIN_URL.URL_PROJECT.'/'.$idContact) que da acceso a su zona privada de proyecto, elevando la percepción de marca y profesionalidad.