MGN-015: Billing y Suscripciones

Descripción del Módulo

El módulo de Billing y Suscripciones gestiona todo el ciclo de vida comercial de la plataforma SaaS, incluyendo la definición de planes, gestión de suscripciones, cobros automáticos, facturación, y monitoreo de uso. También soporta un modo single-tenant para instalaciones on-premise.

Requerimientos Funcionales

ID	Nombre	Prioridad	Story Points	Estado
RF-MGN-015-001	Gestión de Planes de Suscripción	P0	8	Definido
RF-MGN-015-002	Gestión de Suscripciones de Tenant	P0	13	Definido
RF-MGN-015-003	Gestión de Métodos de Pago	P0	8	Definido
RF-MGN-015-004	Facturación y Cobros	P0	13	Definido
RF-MGN-015-005	Registro de Uso y Métricas	P1	8	Definido
RF-MGN-015-006	Modo Single-Tenant	P1	5	Definido
RF-MGN-015-007	Pricing por Usuario (Per-Seat)	P0	13	Definido

Total Story Points: 68

Dependencias

Dependencias Internas

MGN-001 (Autenticación): Gestión de tenants y usuarios
MGN-002 (Core): Configuraciones del sistema
MGN-004 (Financiero): Generación de asientos contables por cobros de suscripción
MGN-014 (Mensajería): Notificaciones de eventos y auditoría de cambios

Dependencias Externas

Gateway de pagos (Stripe, Conekta, MercadoPago)
PAC para CFDI (Facturama, SW Sapien)
Servicio de email para notificaciones

Es Dependencia de (Bloqueante para)

MGN-016 (Pagos): Feature flags de integraciones habilitadas
MGN-017 (WhatsApp): Feature flags de canales habilitados
MGN-018 (AI Agents): Control de consumo de tokens y límites

Diagrama de Dependencias entre RFs

RF-001 (Planes)
    │
    ▼
RF-002 (Suscripciones) ──────► RF-006 (Single-Tenant)
    │
    ▼
RF-003 (Métodos Pago)
    │
    ▼
RF-004 (Facturación)
    │
    ▼
RF-005 (Uso/Métricas)

Actores del Módulo

Actor	Descripción	RFs Relacionados
Super Admin	Administrador de plataforma SaaS	RF-001
Tenant Owner	Propietario de organización	RF-002, RF-003, RF-004, RF-005
Sistema	Procesos automáticos	RF-002, RF-004, RF-005
Gateway	Procesador de pagos externo	RF-003, RF-004

Entidades Principales

billing.subscription_plans - Definición de planes disponibles
billing.subscriptions - Suscripciones activas por tenant
billing.tenant_owners - Propietarios de cuenta
billing.payment_methods - Métodos de pago tokenizados
billing.invoices - Facturas generadas
billing.invoice_lines - Líneas de detalle de factura
billing.payments - Registro de pagos/transacciones
billing.usage_records - Métricas de uso por período
billing.coupons - Cupones de descuento
billing.coupon_redemptions - Cupones aplicados
billing.subscription_history - Historial de cambios

Modos de Operación

SaaS Multi-Tenant

Múltiples organizaciones en una instancia
Billing y cobros automáticos activos
Límites según plan contratado
Registro público de nuevos tenants

Single-Tenant On-Premise

Una organización por instancia
Billing deshabilitado/oculto
Sin límites de uso
Branding personalizable

Notas de Implementación

Seguridad de Pagos: Nunca almacenar datos sensibles de tarjetas; usar tokenización del gateway
CFDI: Requerido para clientes mexicanos con RFC
Reintentos: Política de 3 intentos (días 1, 3, 7) antes de suspender
Histórico: Mantener facturas y registros por 5 años mínimo
Caché: Uso actual en Redis para validaciones rápidas de límites

4.0 KiB Raw Permalink Blame History