Guía de Instalación

El ZIP de Systema v1.0 contiene estos ficheros. Todos van dentro de una carpeta en el servidor, por ejemplo public_html/systema/.

Crear la base de datos

El fichero config/settings.php es el cerebro de la instalación. Contiene las credenciales de BD, la contraseña de acceso al sistema y los datos de licencia. Tienes dos formas de crearlo:

Opción A — Desde el panel web (recomendado)

Accede a tudominio.com/systema/. Si no hay settings.php, el sistema redirige automáticamente a configuracion.php donde puedes introducir las credenciales de BD desde el navegador. El fichero se crea solo.

Opción B — Directamente por FTP

Crea el fichero config/settings.php manualmente con este contenido exacto:

<?php
return array (
  // ── Base de datos ─────────────────────────────
  'db_host'      => 'localhost',          // host MySQL de tu hosting
  'db_port'      => '3306',
  'db_user'      => 'tu_usuario_bd',      // usuario MySQL
  'db_pass'      => 'tu_password_bd',     // contraseña MySQL
  'db_name'      => 'systema_db',         // nombre de la BD

  // ── Acceso al sistema ─────────────────────────
  'password'     => 'TU_PASSWORD_ACCESO', // contraseña para entrar en Systema
  'admin_nombre' => 'Nombre Apellido',
  'admin_email'  => '[email protected]',

  // ── Licencia (se rellena automáticamente) ─────
  'licencia_secret' => 'Sy5t3m4_L1c_S3cr3t0_R4f3lG1l_2026_xK9mP2qW',
  'licencia_token'  => '',   // se inyecta automáticamente desde el panel de licencias
  'licencia_domain' => '',   // se rellena automáticamente
  'licencia_cache'  => 0,    // timestamp de última validación (0 = forzar validación)
);

Verificar que funciona

Accede a tudominio.com/systema/. Debe aparecer el login con el fondo de fotos rotativas y el formulario de contraseña. Si redirige a configuracion.php, las credenciales de BD son incorrectas o la BD no está creada.

Una vez dentro del sistema, ve a Configuración y rellena estas secciones en orden:

Datos Fiscales

Razón social, NIF/CIF, dirección completa, email, teléfono, IBAN y forma de pago. Estos datos aparecen en todas las facturas emitidas.

Email SMTP

Configura el servidor de correo para enviar facturas a clientes. Necesitas:

Usa el botón Test SMTP en Status para verificar la conexión antes de enviar facturas reales.

Plantilla PDF

Pega el HTML de tu plantilla de factura. Usa los marcadores {{numero}}, {{cliente_nombre}}, {{total}}, etc. Para activar el QR de VeriFactu añade {{qr_code}} donde quieras que aparezca.

Marcas

Crea al menos una marca emisora. La marca define el prefijo de numeración de facturas (ej: RG{YEAR}- → RG2026-0001) y el prefijo de presupuestos.

Interfaz UI — Zoom Nuevo v0.5.5

En Configuración → Interfaz UI puedes ajustar el zoom de la interfaz (70%–125%) para adaptarlo a tu pantalla. El valor se guarda en el servidor y en el navegador — no se pierde al limpiar caché.

dompdf no está incluido en el ZIP principal por su tamaño. Sin él, el visor HTML de facturas funciona pero la exportación a PDF no.

Opción A — Instaladores web (recomendado)

El ZIP incluye el fichero systema_PDF_install_dompdf-mm.v03.zip. Extráelo y encontrarás dos instaladores PHP. Súbelos a la raíz de Systema y ábrelos desde el navegador — instalan dompdf y Masterminds automáticamente.

Opción B — FTP manual

Descarga dompdf v2.0.4 y Masterminds html5-php v2.7.6 desde GitHub y súbelos a:

• vendor/dompdf/ — dompdf v2.0.4
• vendor/masterminds/ — html5-php v2.7.6

Systema v0.5.5 incluye un cron job para limpiar automáticamente los ZIPs de resultados anuales que han caducado (más de 14 días). Sin este cron los archivos se acumulan en disco indefinidamente.

Configurar en Plesk

/usr/bin/php -f /var/www/vhosts/SERVIDOR/DOMINIO/systema/modules/resultados/cleanup.php

¿Qué limpia el cron?

• Busca registros en resultados_anuales con zip_status = 'preparado' y zip_expires_at < NOW().
• Elimina los archivos T1.zip, T2.zip, T3.zip, T4.zip de assets/resultados/{año}/.
• Resetea zip_status = NULL para que puedas regenerar cuando quieras.

Systema v1.0 incorpora un sistema de licencias que te permite controlar qué instalaciones están activas. Si un cliente deja de pagar, puedes pausar su licencia desde el panel central y a los 7 días el sistema dejará de funcionar para él.

Flujo completo

Esta configuración se hace una sola vez en rafelgil.com y no se toca más.

1 · Crear la BD de licencias

En phpMyAdmin de rafelgil.com, crea una BD nueva llamada rafelgil_licencias (o el nombre que quieras). Importa el fichero licencias_bd.sql. Se crean dos tablas: licencias y licencias_log.

2 · Subir los ficheros del panel central

Sube estos tres ficheros a rafelgil.com/licencias/:

3 · Editar config.php

Abre licencias/config.php y rellena:

define('LIC_SECRET', 'Sy5t3m4_L1c_S3cr3t0_R4f3lG1l_2026_xK9mP2qW'); // NO cambiar

define('LIC_PANEL_PASS', '$2y$12$...');  // hash bcrypt de tu contraseña
// Contraseña por defecto: Systema2026! — CÁMBIALA

define('LIC_DB_HOST', 'localhost');
define('LIC_DB_NAME', 'rafelgil_licencias');
define('LIC_DB_USER', 'tu_usuario');
define('LIC_DB_PASS', 'tu_password');

4 · Cambiar la contraseña del panel

La contraseña por defecto es Systema2026!. Para cambiarla, genera un nuevo hash y sustitúyelo en config.php:

// Ejecuta esto en cualquier servidor PHP para generar el hash:
echo password_hash('TU_NUEVA_PASSWORD', PASSWORD_DEFAULT);

Pega el resultado en config.php como valor de LIC_PANEL_PASS.

5 · Verificar acceso al panel

Entra en https://rafelgil.com/licencias/. Debes ver el formulario de login. Introduce tu contraseña y verás el panel de gestión con la tabla de licencias vacía.

Acceso para clientes cloud — Login Landing

Los clientes en la modalidad cloud no necesitan recordar la URL de su instalación. Desde systemafacil.com, el cliente introduce su email y es redirigido automáticamente a su instalación. Este sistema funciona mediante LOGIN LANDING/lookup.php que consulta la URL de instalación en la base de datos central de licencias.

Este es el proceso completo cada vez que instalas Systema para un cliente nuevo.

'licencia_secret' => 'Sy5t3m4_L1c_S3cr3t0_R4f3lG1l_2026_xK9mP2qW',
'licencia_token'  => '',
'licencia_domain' => '',
'licencia_cache'  => 0,

Columnas del panel

Cuando un cliente deja de pagar

Si el cliente paga y quieres reactivar

Pulsa Activar en el panel. La próxima vez que el cliente intente entrar, la validación será exitosa y podrá acceder con normalidad. La caché se actualiza automáticamente.

Caducidad automática por fecha

Si configuraste una Fecha fin al crear la licencia, el servidor central la marca automáticamente como Expirada cuando se supera esa fecha. No necesitas hacer nada manualmente.

El módulo de Resultados permite generar cierres fiscales anuales y enviarlos al contable con un portal seguro de descarga. No requiere configuración adicional — funciona con la BD y SMTP ya configurados.

Requisitos previos

• dompdf instalado — es el motor que genera los PDFs de las facturas para los ZIPs.
• SMTP configurado — necesario para enviar el email al contable.
• Plantilla PDF configurada — debe existir en Configuración → Plantilla PDF.
• Carpeta assets/resultados/ con permisos de escritura — se crea automáticamente con mkdir() la primera vez. Si no se crea, crea la carpeta manualmente y dale permisos 755.
• Cron configurado (ver Paso 6) — para limpiar ZIPs caducados automáticamente.

Cómo generar el primer resultado

Novedades v0.5.6

• Editar resultado — click en cualquier fila de la lista abre el modal con los datos precargados. Permite cambiar email del contable, nombre, observaciones y estado.
• Botón descarga ZIP por trimestre — icono en la columna de acciones con dropdown hover que muestra T1/T2/T3/T4. Solo aparecen los trimestres que existen en disco.
• Generación compatible con hosting compartido — la generación del ZIP ya no requiere exec() ni pcntl. Compatible con Hostalia y cualquier hosting con PHP 7.4+ sin esas funciones.
• Email al contable rediseñado — mismo diseño visual que el email de facturas. Tabla de contenido con Excel, ZIPs y desglose trimestral.
• Nuevo endpoint modules/resultados/update.php — gestiona la edición de datos del resultado desde el panel.

ALTER TABLE requerido para v0.5.6

Si vienes de v0.5.5, ejecuta este SQL en phpMyAdmin antes de usar el módulo:

ALTER TABLE `resultados_anuales`
  ADD COLUMN `email_tracking_id` VARCHAR(64) NULL AFTER `enviado_at`,
  ADD COLUMN `email_abierto`     TINYINT(1)  NOT NULL DEFAULT 0 AFTER `email_tracking_id`,
  ADD COLUMN `email_abierto_at`  DATETIME    NULL AFTER `email_abierto`;

VeriFactu Fase A genera un QR en cada factura que apunta a un visor en el propio servidor donde el cliente o Hacienda pueden verificar la factura.

https://tudominio.com/systema/modules/facturacion/pdf_render.php

Una vez instalado, accede a tudominio.com/systema/status.php y pulsa REFRESH. El panel escanea 9 sectores del sistema y te dice exactamente qué está bien y qué no.

El login redirige a configuracion.php

Las credenciales de BD en settings.php son incorrectas o la BD no está creada. Verifica db_host, db_user, db_pass y db_name. En algunos hostings el host no es localhost sino algo como PMYSQL112.dns-servicio.com.

La exportación PDF no funciona

dompdf no está instalado. Verifica en status.php → Sector E. Instala dompdf siguiendo el Paso 5.

El login muestra "Licencia caducada"

Causas posibles:

• El token no se inyectó — comprueba que licencia_token en settings.php no está vacío.
• El licencia_secret en settings.php no coincide con el LIC_SECRET del servidor central.
• La licencia está pausada en el panel central.
• Han pasado más de 7 días desde la última validación y la licencia está pausada.

La inyección del token falla

Comprueba que activate.php está en la raíz de Systema y que la URL introducida en el panel es exactamente https://dominio.com/systema (sin barra final, con https). Si el hosting del cliente bloquea llamadas entrantes, inyecta el token manualmente en settings.php.

El envío de emails no funciona

Usa el botón SMTP HANDSHAKE en status.php para verificar conectividad TCP, y luego TEST SEND EMAIL para verificar autenticación completa. El email de prueba llega a tu dirección email_from configurada.

El QR de VeriFactu aparece roto en el PDF

La extensión GD no está instalada (necesaria para generar el QR), o la verifactu_qr_base_url en Configuración no está bien configurada. Verifica ambas cosas en status.php.

Índices en rojo en status.php → Sector B

Usa el botón REINDEX ALL v0.5 en el Sector B del panel de status. Confirma en el modal de confirmación. Los índices se recrean automáticamente.

El estado del resultado se queda en "Procesando" v0.5.5

El generate.php falló silenciosamente. Causas habituales:

• Sin plantilla PDF — ve a Configuración → Plantilla PDF y comprueba que hay HTML guardado.
• dompdf no instalado — verifica en status.php → Sector E.
• Sin permisos en assets/resultados/ — crea la carpeta manualmente y dale permisos 755.
• Timeout de PHP — verifica que max_execution_time en status.php → Sector G sea ≥ 300s.

Para depurar, accede directamente a: tudominio.com/systema/modules/resultados/generate.php?id=1 y observa si hay error.

Los ZIPs del resultado no se descargan v0.5.5

El estado es "Preparado" pero los botones de descarga no aparecen en el portal del contable. Comprueba que los archivos T1.zip-T4.zip existen en assets/resultados/{año}/ vía FTP. Si no existen, regenera el resultado.

El cron de limpieza da error v0.5.5

Verifica que la ruta en el cron es correcta. La ruta completa en Hostalia/Plesk suele ser /var/www/vhosts/XXXXX.servicio-online.net/tudominio.com/systema/modules/resultados/cleanup.php. Usa el botón "Ejecutar ahora" en la tarea programada para ver la salida y confirmar que la ruta es correcta.

El email al contable da error 500 v0.5.6

Los campos SMTP en BD deben llamarse usuario, password, puerto y cifrado. Si actualizas desde v0.5.5, verifica en Configuración → SMTP que los datos están guardados. El botón SMTP HANDSHAKE en status.php confirma la conectividad.

El enlace del email al contable da 404 v0.5.6

El sistema generaba URLs con /modules/resultado_publico.php en lugar de /resultado_publico.php. Actualiza modules/resultados/send.php a v0.5.6 para corregirlo.

El estado del resultado se queda en «Procesando» en hosting sin exec() v0.5.6

En hostings compartidos como Hostalia, exec() y pcntl_fork() están desactivados. La v0.5.6 resuelve esto generando el ZIP en el mismo proceso PHP. Actualiza modules/resultados/create.php a v0.5.6.

El Sector J de status.php muestra archivos en rojo v0.5.6

Algún archivo del core no está en el servidor. El Sector J lista los 94 archivos con indicador verde/rojo en tiempo real. Sube los archivos en rojo por FTP y recarga la página.