Arquitectura del Sistema
Bienvenido a la documentación técnica oficial de eTarjeta.ME v28.4. Ha adquirido una suite de software de vanguardia para la creación descentralizada de identidades digitales, diseñada para operar en cualquier infraestructura web moderna.
El sistema opera sobre una arquitectura Server-Side Rendering (SSR) híbrida, libre de dependencias SQL pesadas.
PHP 8.x Engine JSON NoSQL Vanilla JS Glassmorphism UI
Nuestro núcleo propietario de procesamiento lógico. LucIA interpreta los inputs del usuario, valida la seguridad criptográfica y compila el código HTML/CSS final de la tarjeta en tiempo real (milisegundos).
Prescindimos de bases de datos relacionales lentas. Toda la información reside en estructuras
JSON ligeras y portables, lo que garantiza una velocidad de carga extrema y
facilidad de migración.
1. Despliegue en Servidor (Deploy)
El software es agnóstico a la infraestructura. Funciona en cualquier entorno LAMP/LEMP estándar, ya sea un hosting compartido, VPS o Cloud, sin depender de paneles de control propietarios.
Requisitos del Entorno
- Lenguaje: PHP 7.4 o superior (Compatible con JIT en PHP 8.2).
- Librerías Core:
json(Data Handling),curl(API Gateway),zip(OTA System). - Sistema de Archivos: Permisos estándar de escritura
755en el directorio raíz para la generación de activos.
Procedimiento de Instalación (Wizard)
- Descomprima el paquete
.zipen el directorio público de su servidor (ej:public_html). - Navegue a la ruta de instalación:
sudominio.com/setup.php. - El Asistente Inteligente verificará la integridad del servidor.
- Ingrese su Licencia de Producto. El sistema realizará un "Handshake" seguro con nuestra API central.
- Defina sus credenciales maestras de administración.
- Al finalizar, el archivo
setup.phpejecutará un protocolo de auto-eliminación para blindar el sistema.
2. Seguridad y Acceso
La gestión se centraliza en una ruta maestra protegida, separada del frontend público:
https://sudominio.com/master.php
Protocolos de Seguridad Implementados:
- Login Cinemático con Precarga: Interfaz de seguridad que realiza validaciones asíncronas con la API de licencias antes de desencriptar el dashboard administrativo.
- Domain Lock Technology: Su licencia queda vinculada criptográficamente al dominio de instalación. Cualquier intento de clonación del software en otro host activará el bloqueo inmediato.
- Sanitización de Inputs: Todos los datos ingresados pasan por filtros de limpieza profunda para prevenir inyecciones de código malicioso.
3. El Generador (Builder) - Especificaciones
A continuación se detalla la lógica técnica de cada componente del constructor de tarjetas.
A. Lógica Temporal (Vigencia)
Controla la caducidad del activo digital.
Mecánica: El sistema calcula el Unix Timestamp futuro basado en la
selección (1-12 meses). Si se elige "Indefinido", se asigna un valor superior al límite de
32-bit (Año 2038+).
Efecto: Al superarse el timestamp, el Motor LucIA inyecta una capa de bloqueo
(Overlay) sobre la tarjeta, impidiendo la interacción pública.
B. Identidad Corporativa
Se inyecta dinámicamente en la etiqueta h1 semántica y en el
title del documento para indexación en buscadores.
Admite rutas absolutas (HTTPS). El renderizado aplica propiedades CSS de
object-fit: contain para garantizar la proporción perfecta en cualquier viewport.
Se sugiere formato PNG/WEBP con canal alfa.
C. Interfaz de Usuario (Botones)
Genera un botón de alta prioridad visual con efecto "Shine" (barrido de luz CSS) para maximizar el CTR (Click Through Rate).
Componente flotante con posicionamiento absoluto (right: 0).
Utiliza transformaciones CSS para permanecer discreto y desplegarse suavemente al evento
hover. Ideal para soporte técnico o avisos secundarios.
D. Conectividad y Redes
El sistema emplea renderizado condicional: los nodos DOM vacíos son eliminados del árbol de renderizado para optimizar el peso del archivo final.
El input es procesado para eliminar caracteres no numéricos y se concatena con
el protocolo seguro https://wa.me/, permitiendo apertura directa de chat sin
agregar contacto.
Implementa la API Universal de Google Maps: maps.google.com/24.
Ventaja Técnica: Esta sintaxis específica activa el "Deep Linking", forzando la
apertura de la App nativa en iOS/Android y la versión web completa en escritorio, eliminando
errores 404.
E. Motor SEO y Estilo
Configura automáticamente las etiquetas og:title,
og:description y twitter:card. Esto asegura que al compartir el enlace
en redes sociales, se genere una tarjeta rica (Rich Snippet) con previsualización profesional.
Manipulación de variables CSS en tiempo real (:root). El modo
oscuro utiliza una paleta de grises profundos (#1c1c1e) calibrada para pantallas
OLED y eficiencia energética.
4. Panel de Control (Dashboard)
La interfaz administrativa es una SPA (Single Page Application) simulada que permite la gestión fluida de activos sin recargas de página.
Algoritmo que audita en tiempo real el Timestamp de vencimiento vs Hora del Servidor para determinar el estado: Activa, Vencida o Suspendida (Manual).
Sistema de conteo de visitas basado en archivos planos. Extremadamente rápido y respetuoso con la privacidad (GDPR compliant), sin cookies de terceros.
Herramientas de Gestión:
- Backup Engine: Utiliza la librería nativa
ZipArchivede PHP para compilar, comprimir y descargar el código fuente completo de una tarjeta en formato ZIP. - Kill Switch (Suspender): Interruptor manual que inyecta un archivo de bloqueo
(
suspended.txt) en el directorio de la tarjeta, desactivándola instantáneamente sin borrar datos.
5. Sistema de Actualizaciones (OTA)
eTarjeta.ME incluye un módulo de despliegue continuo Over-The-Air.
Al solicitar una actualización, su servidor establece un túnel seguro con
api.etarjeta.me. Si se detecta una nueva versión del kernel, se descarga el
paquete, se verifica la integridad y se parchean los archivos del sistema, preservando intactas
las tarjetas y configuraciones del usuario.
6. Aspectos Legales
Acuerdo de Licencia de Usuario Final (EULA)
LICENCIA DE SOFTWARE PROPIETARIO - VERSIÓN 28.4
SNHC SAS • Abel Antonio Giraldo Vélez
1. NATURALEZA DEL SOFTWARE
El Software es una herramienta de generación de contenido web estático basado en tecnologías PHP y NoSQL (JSON). Se entrega bajo un modelo "Self-Hosted" (Alojamiento Propio), otorgando al usuario control total sobre sus datos.
2. CONCESIÓN DE LICENCIA
SNHC SAS otorga una licencia no exclusiva, intransferible y revocable para instalar una copia del Software en un dominio raíz o subdominio verificado. Esta licencia faculta al titular para la generación ilimitada de tarjetas digitales dentro de dicha instalación.
3. PROPIEDAD INTELECTUAL
Todos los derechos de propiedad intelectual, incluyendo el código fuente backend, la arquitectura del Motor LucIA, los estilos CSS compilados y la lógica JS, son propiedad exclusiva de SNHC SAS. El Licenciatario adquiere derechos de uso, no de propiedad.
4. RESTRICCIONES TÉCNICAS
Queda estrictamente prohibido:
- Realizar ingeniería inversa, descompilar o desensamblar el código fuente ofuscado.
- Eludir ("Bypass") el sistema de validación de licencias o el bloqueo de dominio (Domain Lock).
- Revender, alquilar o sublicenciar el archivo instalador (
setup.php) o el núcleo administrativo (master.php). Nota: El usuario SÍ tiene derecho comercial absoluto sobre las tarjetas finales generadas.
5. EXCLUSIÓN DE GARANTÍAS (AS-IS)
El Software se proporciona "TAL CUAL". SNHC SAS no garantiza compatibilidad con configuraciones de servidor obsoletas o no estándar, ni se hace responsable por interrupciones derivadas de fallos en el hosting del cliente.
6. TERMINACIÓN
El incumplimiento de cualquiera de los términos anteriores resultará en la terminación inmediata de la licencia, la revocación de la llave API y el bloqueo remoto del acceso al sistema.