HelpU App — Consola gestora
HelpU App es la única consola gestora de Huella, Habitta y Vitrina: catálogo comercial, empresas cliente, demos, suscripciones, avisos, usuarios del producto, finanzas FE del tenant y operación de asambleas Habitta. Es instalable en móvil (PWA): botón Instalar en login y en el menú de usuario; sin branding por NIT (a diferencia de Huella/Habitta).
1. Roles (solo en App)
| Rol | Alcance |
|---|---|
| SuperAdmin | Plataforma completa: HelpU + Huella + Habitta + Vitrina + FE + PQRS + RRHH interno. |
| Soporte | Clientes HelpU: PQRS de la plataforma. Sin SuperAdmin de producto. |
| SuperAsamblea | Planes de asamblea y operación de asambleas Habitta (todos los conjuntos). |
2. Arquitectura
- Tres sistemas, tres bases, tres logins. App no impersona sesiones de producto.
- BD
bd_helpu+ conexionesDB_HUELLA_*/DB_HABITTA_*/DB_VITRINA_*(planeada). - El mostrador comercial (alta empresa, confirmar pago Wompi, temas, geo) escribe directo en las BD de producto. No hay proxy HTTP ni API pública de mostrador en Huella/Habitta.
- FE (Factus/Siigo) solo se llama desde App WS. Las apps usan
HelpuWsFacturadorAdapter. - Sitio comercial PW llama App con
HELPU_WS_URL+HELPU_WS_TOKEN(nunca el token en el navegador).
3. Menú HelpU
| Módulo | Uso |
|---|---|
| Usuarios | Cuentas de consola asociadas a empleado HelpU. |
| PQRS | Tickets de clientes sobre HelpU (consola, WS o formulario PW). |
| RRHH | Empleados internos HelpU. |
| Facturación | Config Factus/Siigo de la gestora y documentos HEL-… |
4. Capas PQRS
| Capa | Quién | Sobre qué | Dónde |
|---|---|---|---|
| HelpU App | Cliente / Soporte | La plataforma HelpU | Consola /pqrs y WS POST /api/pqrs |
| Sitio PW | Cliente Huella/Habitta (NIT) | HelpU / contratación / sitio | /pw/pqrs.php → consulta NIT → WS canal=web |
| Huella | Estudiante (alumno) | El colegio | Portal en Huella; atiende RRHH. Web externa: POST /api/huella/pqrs (App, Basic Admin) |
| Habitta | Propietario / residente | El conjunto | Portal en Habitta; atiende Conjunto. Web externa: /api/habitta/* (App, Basic Admin) |
5. SuperAdmin por producto
Mismas pantallas que antes vivían en Huella/Habitta, ahora en App: catálogo de planes, empresas, demos, suscripciones, avisos, auditoría, usuarios/roles del tenant, finanzas (clientes, conceptos, documentos).
Rutas típicas: /catalogo/{huella|habitta|vitrina}, /empresas/{producto}, /empresas/vitrina, /finanzas/….
Vitrina: manual SuperAdmin · integración · API técnica.
6. SuperAsamblea
Planes de asamblea (add-on de Habitta; no reemplazan el plan app), solicitudes de cupo, convocatorias, asistencia, logística y ejecución. Todo multi-conjunto desde App. El conjunto solo ve su propia asamblea; el propietario vota en rutas públicas de Habitta.
Comercial (sitio PW / WS): sin plan de pago vigente solo se vende el plan de 1 asamblea (al pagar puede asignarse demo de plataforma); con plan de pago vigente, planes 1 / 3 / 5. Los cupos se conservan si vence el demo o el plan; operar requiere Habitta usable. Detalle legal en términos y condiciones.
7. Facturación electrónica
Credenciales por petición (no se guardan en App). Prefijos de referencia:
colegios HUE{empresa}-{dc}, conjuntos HAB{empresa}-{dc},
planes HelpU HEL-{dc}.
Detalle de endpoints en el manual de API.
8. Usuarios de desarrollo
Clave por defecto HELPU_ADMIN_PASSWORD (si no está en .env: password).
| Rol | Correo |
|---|---|
| SuperAdmin | superadmin@helpu.com.co |
| Soporte | soporte@helpu.com.co |
| SuperAsamblea | asamblea@helpu.com.co |
9. Qué no hace App
- No opera el colegio ni el conjunto (eso es Huella / Habitta).
- No recibe el formulario PQRS del alumno ni del residente.
- No expone un endpoint PQRS anónimo: PW usa el token de servidor.