Saltar al contenido principal

Usuarios, roles y membresías

Conceptos básicos​

PlexSub separa administración, acceso de cliente, suscripciones, integraciones y portal de soporte. Un usuario puede existir en PlexSub y además estar enlazado con servicios externos como Plex, Jellyfin, Seerr o proveedores de pago.

Ciclo recomendado de un usuario​

  1. Alta o invitación.
  2. Confirmación de identidad y correo.
  3. Asignación de acceso o suscripción.
  4. Provisionamiento en servicios multimedia.
  5. Uso normal del portal de cliente.
  6. Renovación, pausa, cancelación o baja.
  7. Revocación de accesos cuando corresponda.

Invitación​

PlexSub puede trabajar con flujos de invitación nativos y con Wizarr. En el registro de servicios:

  • Invitaciones nativas: beta, opcional y recomendado.
  • Wizarr: beta, dependiente de Plex.

Variables relacionadas:

  • WIZARR_URL
  • WIZARR_API_KEY
  • WIZARR_EXTERNAL_URL
  • WIZARR_DEFAULT_SERVER_IDS
  • WIZARR_DEFAULT_LIBRARY_IDS
  • WIZARR_INVITATION_EXPIRES_IN_DAYS
  • WIZARR_ACCESS_DURATION
  • WIZARR_ALLOW_DOWNLOADS
  • WIZARR_ALLOW_LIVE_TV
  • WIZARR_ALLOW_MOBILE_UPLOADS
  • WIZARR_UNLIMITED_ACCESS

Roles y permisos​

La documentación pública del repo no incluye una matriz completa de permisos por rol. Como regla de uso:

  • Reserva permisos de administración para personas de confianza.
  • Usa cuentas de cliente para acceso al portal.
  • No compartas cuentas admin.
  • Revisa permisos antes de activar proveedores de pago, invitaciones o acciones automáticas.

Membresías y renovaciones​

El módulo de suscripciones se usa para reflejar accesos, renovaciones y estado operativo. Un mes anterior no debería perder su historial porque un usuario renueve en un mes posterior; cada periodo debe conservar su estado propio.

Estados que un administrador debería poder revisar:

  • Activa.
  • Renovada.
  • Cancelada.
  • Caducada.
  • Pendiente de pago o revisión, si el flujo lo usa.

Baja o cancelación​

Antes de dar de baja a un usuario:

  1. Revisa su suscripción o contrato de acceso.
  2. Verifica si tiene pagos recientes.
  3. Comprueba servicios enlazados.
  4. Revoca acceso solo cuando corresponda.
  5. Conserva historial operativo necesario.
  6. Evita borrar cuentas externas si solo necesitas retirar acceso.

Buenas prácticas​

  • Usa usuarios de prueba para validar invitaciones y bajas.
  • Documenta qué proveedor manda en cada flujo: PlexSub, proveedor de pago, Seerr o servicio multimedia.
  • No dependas solo de memoria: revisa logs, estado de suscripción y diagnóstico.
  • No pegues capturas con correos, tokens o datos privados en documentación pública.