Operaciones internas

Esta sección es para el equipo de Sopinf Tech LLC — MSP admins, ingenieros de oncall, billing clerks y soporte. Cubre cómo operar SipSop en el día a día: compliance, infraestructura de facturación, uso del panel admin, configuración de autenticación, runbooks de incidentes y despliegue.

No es para clientes

El contenido para clientes está en Documentación del producto. El contenido de vendedores y comisiones está en Comisiones. Si un cliente pregunta sobre fees o facturas, dirigirlo a la documentación del producto o a la página pública /fees — no aquí.

Para quién es esta sección

Audiencia	Qué usan aquí
MSP admins (admin_msp)	Guía del panel admin, configuración de RBAC, gestión de tenants
Oncall / DevOps	Runbooks, deploy e infraestructura, monitoreo de BullMQ
Billing clerks (MSP sub-role billing_clerk)	Admin fees, compliance dashboard, reportes trimestrales
Soporte	Runbooks, panel admin, guía de impersonation

Qué hay en esta sección

Admin fees

El sistema de fees regulatorios y administrativos. Schema del catálogo de fees, cómo crear o actualizar fees, carrier mode (retail vs wholesale), invoice line items de Stripe, y el compliance dashboard. Empezá aquí cuando necesites agregar un fee nuevo o cambiar una tasa.

Compliance

Requisitos regulatorios de NJ/FCC, política de retención de datos para registros CDR y PII, arquitectura de Row Level Security, cobertura del audit log, y nuestro checklist SOC2-lite.

Panel admin

Guía paso a paso para cada ruta /admin/* del portal: tenants, leads, fees de facturación, cola de onboarding, roles, impersonation, códigos de descuento y comisiones. Incluye qué acciones están disponibles y qué rol es necesario.

Auth y RBAC

Modelo de organizaciones de Better Auth, los cuatro roles principales (admin_msp, client_admin, client_user, seller), sub-roles MSP (super_admin, billing_clerk, sales_rep, technician), permission keys, y cómo crear nuevos usuarios o dar acceso.

Runbooks

Playbooks operacionales para los incidentes más comunes: tenants past_due, fallos de webhooks de Stripe, CDR sync detenido, resets de contraseña, acceso al portal de vendedores, errores en statements, y backups de base de datos.

Deploy e infraestructura

Guía de despliegue desde cero: imágenes Docker, Azure Container Apps, secretos en Key Vault, configuración del BullMQ worker, variables de entorno, restricción de FreePBX read-only, CI/CD con GitHub Actions, y estrategia de migraciones.

Checklist operacional diario

Lo que un MSP admin debe revisar cada mañana:

1. Stripe dashboard — ¿algún pago fallido o past_due de la noche anterior? Revisar la lista de facturas fallidas y reintentar si es necesario.
2. BullMQ / Bull Board — ¿las cuatro colas de jobs (cdr-sync, billing-calc, invoice-gen, stripe-sync) están procesando normalmente? ¿Algún job stuck o fallido?
3. Sentry — ¿spike de errores overnight? ¿Algún nuevo tipo de error en los proyectos api o portal?
4. Estado del CDR sync — ir a /admin/dashboard → revisar totalCallsThisMonth. Si no se actualizó desde ayer, es posible que el job cdr-sync esté detenido (ver Runbooks).
5. Bandeja de soporte — ¿algún reclamo de facturación o problema de acceso de clientes que necesite escalación?

URLs clave (producción)

URL	Qué es
app.sipsop.net	Portal de clientes
app.sipsop.net/admin/dashboard	Dashboard MSP admin
pbx.sopinf.xyz	FreePBX — SOLO LECTURA. Nunca modificar la config
Stripe Dashboard	Gestión de suscripciones y pagos
Azure Portal	Container Apps, Key Vault, logs
Sentry	Error tracking (proyectos api + portal)