Festivera Platform

Manual del Administrador

Panel superadmin · Marketing · DIAN · Organizadores · Sistema
Acceso restringido app.festivera.com/admin.html Septiembre 2026
Este manual es de uso exclusivo del equipo Festivera.

📋 Contenido

  1. Acceso al panel admin
  2. Resumen de marketing
  3. Suscriptores y campañas
  4. Gestión de organizadores
  5. Panel DIAN — Facturación Electrónica
  6. Configuración del sistema
  7. Supabase — Base de datos
  8. Seguridad y buenas prácticas

1. Acceso al panel admin

El panel de administración de Festivera es accesible únicamente para el equipo interno. No está disponible para organizadores ni operadores.

  1. 1Abre app.festivera.com/admin.html directamente (no desde el menú del dashboard).
  2. 2Inicia sesión con la cuenta de administrador Festivera: hola@festivera.com.
  3. 3El sistema valida que el email corresponda al administrador. Cualquier otra cuenta es rechazada.
Nunca compartas las credenciales de administrador. La cuenta da acceso a datos de todos los organizadores, suscriptores y transacciones de la plataforma.

2. Resumen de marketing

La vista principal del admin muestra el estado del sistema de email marketing de Festivera en tiempo real:

📬 Suscriptores activos

Total de personas con marketing_consent activo en la red. Se actualiza con cada compra de boleta.

📈 Crecimiento mensual

Nuevos suscriptores en los últimos 12 meses, visualizado como gráfico de barras.

📤 Emails enviados

Total de emails despachados en los últimos 30 días y número de campañas.

🎵 Por categoría

Distribución de suscriptores por preferencia musical (vallenato, rock, electrónica, etc.).

Para actualizar todos los datos, haz clic en "↺ Actualizar" en la esquina superior derecha.

3. Suscriptores y campañas

Ver suscriptores

En la sección Suscriptores verás el desglose completo: activos, dados de baja, sin preferencias, y por ciudad y categoría. Estos datos son de solo lectura desde el admin.

Historial de campañas

La sección Campañas muestra todos los emails enviados por la plataforma:

CampoSignificado
⚡ AutoCampaña generada automáticamente por el cron al detectar un evento nuevo
📧 ManualEnviada por el organizador desde su panel
AlcanceNúmero de suscriptores elegibles para esa campaña
Enviados / FallidosResultado real del envío vía Resend API
EstadoEn cola · Enviando · Completado · Error

Actividad por organizador

La sección Organizadores muestra cuántos eventos creó cada organizador, cuántos fueron promovidos por Festivera y cuántos emails generó su actividad.

4. Gestión de organizadores

Crear cuenta de organizador

  1. 1Ve a Supabase Dashboard → Authentication → Users y crea el usuario con el email del organizador.
  2. 2En User Metadata, configura: {"role": "organizer", "platform": "festivera"}.
  3. 3El organizador recibirá un email de confirmación para activar su cuenta.

Planes y límites

PlanAsistentes máx.FE DIANPrecio/mes
Demo50NoGratis
Starter500Add-on$149.000 COP
Pro5.000✅ Incluida$299.000 COP
EnterpriseSin límite✅ IncluidaNegociado

El plan se activa automáticamente cuando Bold confirma el pago del organizador vía webhook.

Desactivar una cuenta

Para suspender un organizador: en Supabase → Authentication → Users, busca el usuario y haz clic en "Ban user". Esto bloquea el acceso sin borrar sus datos ni eventos.

5. Panel DIAN — Facturación Electrónica

La sección DIAN / FE en el panel admin permite gestionar el software de facturación electrónica registrado ante la DIAN.

Tab Configuración

Muestra las credenciales DIAN almacenadas en Supabase (api_settings where service='dian'):

CampoValor actual
NIT Emisor900506927 (T&M Solutions S.A.S.)
Software ID12142bc5-... (Festivera)
TestSetId855f76ef-...
Ambientehabilitacion (→ produccion después de aprobación)

Probar conexión

  1. 1Haz clic en "🔌 Probar conexión".
  2. 2El sistema verifica el certificado .p12 (vigencia, NIT, algoritmo).
  3. 3Si muestra ✅ verde, el certificado está activo y el servidor DIAN responde.

Enviar Set de Pruebas

Solo funciona cuando el software "Festivera" está en estado Aceptado en el portal DIAN de habilitación. Si está "En proceso", primero llama al 01 8000 912 478 para activarlo.
  1. 1Confirma que la prueba de conexión sea verde.
  2. 2Haz clic en "▶ Enviar Set de Pruebas".
  3. 3El sistema genera y firma un XML UBL 2.1 (SETP990000001) y lo envía al WCF de habilitación DIAN.
  4. 4Si DIAN responde con TrackId, el documento fue recibido. Anota el TrackId.
  5. 5Repite hasta completar los 50 documentos requeridos (30 FE + 10 NC + 10 ND).

Tab Facturas

Lista todas las facturas enviadas a DIAN desde la plataforma, con estado (Aceptada / Rechazada / Pendiente) y botón de reintento unitario.

Si una factura es rechazada por DIAN, haz clic en "↺ Reintentar". El sistema recalcula el CUFE y la vuelve a enviar con los mismos datos.

6. Configuración del sistema

Crons de Hostinger

Dos crons corren continuamente en el servidor (configurar en Hostinger cPanel → Cron Jobs):

CronFrecuenciaArchivo
Detección de eventos nuevosCada 2 horasapi/create-daily-campaigns.php
Procesador de cola de emailsCada minutoapi/process-email-jobs.php

Integración Bold

Bold es el procesador de pagos de Festivera para Colombia. El webhook que recibe las notificaciones de pago está en:

https://app.festivera.com/api/bold-webhook.php

Token de verificación Bold: se configura en el portal Bold → Integraciones → Webhook URL.

Integración Resend (emails)

Todos los emails transaccionales y de marketing se envían vía Resend API. La API key se almacena en Supabase api_settings where service='resend'. Plan actual: Free (hasta 3.000 contactos).

7. Supabase — Base de datos

Toda la data de Festivera vive en Supabase. URL del proyecto: gpswnzcfyhxzldijgewa.supabase.co

Tablas principales

TablaContenido
profilesUsuarios registrados (organizadores, compradores)
eventsTodos los eventos de la plataforma
ticketsTipos de boleta por evento
ordersCompras realizadas
cashless_walletsPulseras y saldos
cashless_transactionsRecargas y consumos
email_subscribersLista de suscriptores de marketing
email_campaignsCola de campañas de email
dian_invoicesFacturas enviadas a la DIAN
api_settingsConfiguración de integraciones (Bold, DIAN, Resend, PayPal)
platform_plan_pricesPrecios y links de Bold por plan
Nunca hagas DELETE directo en tablas de órdenes o facturas sin respaldo. Usa UPDATE para marcar registros como inactivos en su lugar.

8. Seguridad y buenas prácticas

🔑 Credenciales sensibles

  • Admin token DIAN: Fstvr2025Wh
  • Supabase service key: solo en server-side PHP
  • Bold webhook secret: en Supabase api_settings

🚨 Reglas de seguridad

  • Nunca exponer service key en frontend
  • Revisar logs de bold-webhook mensualmente
  • Renovar certificado .p12 antes de 2027-08-19

Renovar certificado DIAN (.p12)

El certificado actual expira el 19 de agosto de 2027. Antes de esa fecha:

  1. 1Solicitar nuevo .p12 a la entidad certificadora (Andes SCD) con 30 días de anticipación.
  2. 2Subir el nuevo .p12 vía admin.html → DIAN/FE → "📁 Subir certificado".
  3. 3Actualizar la contraseña en Supabase api_settings.config.cert_password.
  4. 4Probar conexión para confirmar que el nuevo cert funciona.

Backup mensual

  1. 1Supabase → Settings → Database → Backups: descargar el backup mensual.
  2. 2Subir copia a Google Drive en la carpeta "Festivera / Backups DB".
  3. 3Hacer copia de los archivos del servidor Hostinger vía FTP (especialmente dian-data/).