Superadmin desacoplado

Licencias y autorización para tu app de facturación

Entrar al panel
MVP v1 listo para operar

Emite licencias inmutables y valida acceso con una API key por empresa.

El panel administrativo centraliza Empresas, Puntos, Proveedores, Licencias y API keys. La app consumidora solo necesita company_code + license_code para consultar validate-access.

Acceder al adminVer Swagger

Códigos inmutables

Empresa, punto, proveedor y licencia quedan protegidos tras el alta.

Validación segura

validate-access exige x-api-key y responde con allow, reason y nombres legibles.

Operación visible

Cada intento queda registrado en logs para soporte y auditoría.

Contrato de integración

validate-access

POST /api/validate-access
Header: x-api-key: <SUPERADMIN_API_KEY>
Body: {
  "company_code": "EMP-ALFA",
  "license_code": "A1B2-C3D4-E5F6-G7H8-J9K0"
}

Respuesta mínima: allow, reason, company_name, point_name, provider_name, license_status.

  • • Variables obligatorias en la app consumidora: SUPERADMIN_API_URL, SUPERADMIN_API_KEY, SUPERADMIN_API_TIMEOUT_SECONDS, SUPERADMIN_LICENSE_CODE.
  • • Si falta una variable crítica o la API no responde válidamente, el estado esperado es instalación ilegal.
  • • Autenticación privada del panel: Bearer JWT con email/password y soporte Google Auth.

Flujo operativo

Provisioning de datos

  1. 1. Alta de Empresa con company_code inmutable.
  2. 2. Alta de Punto con URL base de API y estado operativo.
  3. 3. Alta de Proveedor y emisión de Licencia con código autogenerado.
  4. 4. Generación de API key por empresa y entrega segura a la app de facturación.
  5. 5. Consulta de logs para validar accesos permitidos y bloqueos controlados.

Fuera de v1

Documentado para v2

  • • Gestión avanzada específica de proveedor LLM.
  • • Estadísticas y telemetría comercial detallada.