Documentación Técnica
Guía oficial para el despliegue, administración y mantenimiento del generador de identidad digital eTarjeta.ME.
1. Introducción
El SNHC Builder Pro v26.1 es una solución SaaS (Software as a Service) ligera diseñada para la generación masiva de tarjetas de presentación digitales (vCards) de alto rendimiento.
A diferencia de los CMS tradicionales, este sistema opera sin base de datos (SQL), utilizando una arquitectura basada en archivos JSON y estructuras de directorios estáticos, lo que garantiza una velocidad de carga superior y una portabilidad del 100%.
- Zero-Database: No requiere MySQL/MariaDB.
- SaaS Ready: Gestión de vencimientos y suspensiones automáticas.
- Atomic Backups: Generación de ZIPs portables por cliente.
- LucIA Engine: Motor de renderizado optimizado para SEO y UX.
2. Licencia de Uso y Propiedad Intelectual
El presente software, denominado comercialmente eTarjeta.ME / SNHC Builder, está protegido por las leyes internacionales de derechos de autor y tratados de propiedad intelectual.
SNHC PROPRIETARY SOFTWARE LICENSE AGREEMENT (EULA)
1. PROPIEDAD INTELECTUAL:
Todos los derechos de título, propiedad intelectual y derechos de autor sobre el código fuente, diseño, algoritmos (incluyendo el motor LucIA) y documentación de este software pertenecen exclusiva e inalienablemente a
SNHC SAS y a su desarrollador principal,
Abel Antonio Giraldo Vélez.
2. CONCESIÓN DE LICENCIA LIMITADA:
Al adquirir este software, se le otorga al usuario final ("El Licenciatario") una licencia
única, no exclusiva e intransferible para instalar y ejecutar el software en
un (1) solo dominio o proyecto web. La compra otorga el derecho de USO, no la
propiedad del código.
3. RESTRICCIONES DE USO:
Queda estrictamente prohibido al Licenciatario:
- a) Vender, revender, sublicenciar, alquilar o distribuir el código fuente, ya sea de forma total o parcial.
- b) Crear trabajos derivados con fines comerciales basados en este código (Clonación).
- c) Utilizar partes del código en otros proyectos sin autorización escrita de SNHC SAS.
- d) Eliminar, ocultar o modificar los avisos de copyright, marcas registradas o créditos de autoría ("Powered by", "Desarrollado por") ubicados en el pie de página (footer) o en los metadatos del código.
4. PROTECCIÓN CONTRA COPIA:
Este software puede incluir mecanismos técnicos de protección (Domain Lock) diseñados para prevenir el uso no autorizado. Cualquier intento de eludir, modificar o eliminar dichos mecanismos anulará automáticamente esta licencia y podrá dar lugar a acciones legales.
5. TERMINACIÓN:
Esta licencia es efectiva hasta su terminación. Sus derechos bajo esta licencia terminarán automáticamente sin previo aviso si usted incumple cualquiera de los términos mencionados.
3. Arquitectura del Sistema
El aplicativo se divide en dos componentes lógicos separados por seguridad:
Frontend (Landing Page)
El archivo index.php público actúa únicamente como una landing page informativa. No contiene
lógica de administración ni acceso al backend.
Backend (Core)
El núcleo del sistema reside en un archivo renombrado. Este script monolítico maneja la autenticación, el sistema de archivos y la generación de código.
4. Instalación y Despliegue
Paso 1: Estructura de Archivos
/public_html/
├── index.php // Landing Page Pública (eTarjeta.ME)
├── master.php // Panel de Administración Protegido
├── .htaccess // Reglas de seguridad
└── docs.html // Esta documentaciónPaso 2: Permisos de Escritura
El sistema necesita crear carpetas automáticamente. Asegúrese de ejecutar:
chmod -R 755 /var/www/html/5. Seguridad & Domain Lock
La versión v26.1 incluye un sistema de protección contra clonación no autorizada.
Configuración del Candado
Abra el archivo master.php y localice la línea 10. Debe configurar su dominio de producción.
// master.php - Línea 10
$dominio_permitido = "tudominio.com";
// Si el script detecta que no corre en tudominio.com, se bloquea.6. Ciclo de Vida (SaaS Mode)
El sistema implementa una lógica de "Auto-Kill" para tarjetas vencidas basada en timestamps.
- Cálculo: Al guardar, se genera una fecha de expiración.
- Verificación: Cada visita verifica la fecha actual contra la de vencimiento.
- Acción: Si vence, se bloquea la vista con un overlay CSS y mensaje de "Membresía Vencida".
7. Side Tag & "Black Label"
La etiqueta lateral siempre renderiza en #000 (Negro puro) con texto blanco para mantener
consistencia de marca premium y no puede ser modificada desde el panel para preservar la identidad
visual de la plataforma.
8. Sistema de Backup y Portabilidad
El dashboard permite la descarga de un archivo .ZIP atómico por cada tarjeta que incluye
todos los activos necesarios para una migración o restauración.