SuperAdmin — Vitrina (HelpU App)

Operación de Vitrina desde la consola gestora HelpU App. Requiere rol SuperAdmin o Soporte según la pantalla. No se impersona la sesión del admin de la tienda: se gestiona el tenant vía API interna.

v0.1.0 · 31 de agosto de 2026

1. Menú Vitrina en App

En la consola (app.helpu.com.co) el menú lateral incluye el bloque Vitrina con:

Pantalla	Ruta	Uso
Planes	`/catalogo/vitrina`	Catálogo Starter, Pro, Demo, Enterprise
Tarifas	`/catalogo/vitrina/tarifas`	Rangos por productos activos y precios
Tiendas	`/empresas/vitrina`	Listado de tenants, métricas y edición
Demos	`/empresas/vitrina/demos`	Demos pendientes o activas (self-service y WS)
Suscripciones	`/empresas/vitrina/suscripciones`	Vigencias, pagos y renovaciones

2. Tiendas (`/empresas/vitrina`)

Listado de negocios provisionados en VitrinaApp. Búsqueda por nombre, NIT o slug.

Editar tienda (/empresas/vitrina/tienda/{id}): plan, productos contratados, vigencia, estado comercial.
Estados comerciales: demo, activo, suspendido, cancelado.
Suspender: tienda pública en solo lectura; admin sin escritura.
Reactivar: restaura compras y panel editable.
Enlace al panel del negocio (/admin/login) solo desde el listado de Tiendas (no en demos ni suscripciones).

Solo SuperAdmin puede ejecutar acciones de escritura; Soporte suele tener acceso de consulta.

3. Demos

Origen de las demos:

Self-service: formulario /registro en VitrinaApp → POST /api/demos con producto=vitrina.
Checkout trial o alta manual desde consola (mismo WS).

La bandeja muestra NIT, correo, slug y días restantes. Tras 30 días el cron vitrina:procesar-vencimientos suspende la tienda si no hay plan de pago.

4. Suscripciones y pagos

Los pagos Wompi del sitio PW confirman vía POST /api/pagos/confirmar. App registra en vitrina_pagos y activa el tenant en VitrinaApp (activar=true).

Renovaciones y vencimientos: comando diario vitrina:procesar-vencimientos (App + VitrinaApp).
Planes Enterprise o >500 productos: requiere_cotizacion; no se confirma pago self-service.

5. Catálogo comercial

Misma mecánica que Huella/Habitta: planes en bd_helpu, precios por rango en tarifas, métrica = productos activos.

El sitio PW (vitrina.php) consume GET /api/planes?producto=vitrina y GET /api/cotizar.

6. Conexión técnica

Variable App	Uso
`VITRINA_APP_URL`	Base HTTPS de VitrinaApp (API interna)
`HELPU_WS_TOKEN`	Mismo token en VitrinaApp para `/api/internal/*`
`DB_VITRINA_DATABASE`	Solo fallback local (SQLite); no usar en producción