clinica-veterinaria/docs/04-fase-saas/MGN-017-plans/README.md
rckrdmrd c4620ca4e9 [DOCS] feat: Add phase 04-SAAS and 05-IA documentation structure
- Update docs/_MAP.md with new phase references
- Add docs/04-fase-saas/ phase structure
- Add docs/05-fase-ia/ phase structure

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-16 00:28:18 -06:00

4.8 KiB

id title type status version created_date updated_date source
MGN-017-plans-vet Modulo Plans - Planes y Feature Gating Veterinario Module Draft 1.0.0 2026-01-13 2026-01-13 erp-core/MGN-017-plans

MGN-017: Modulo Plans - Planes y Feature Gating para Clinicas Veterinarias

Descripcion

El modulo Plans gestiona la definicion de planes de suscripcion para clinicas veterinarias, feature gating por plan, y enforcement de limites y cuotas especificos del dominio veterinario.

Normativas Aplicables

  • NOM-064-ZOO-2000: Lineamientos para prescripcion veterinaria
  • SENASICA: Requisitos de trazabilidad de vacunacion
  • Bienestar Animal: Consideraciones de capacidad por clinica

Objetivos

  1. Definicion de Planes Veterinarios - Planes con limites especificos para clinicas
  2. Feature Gating - Controlar acceso a funcionalidades (hospitalizacion, IA, etc.)
  3. Limites por Especie - Limites de mascotas por especie si aplica
  4. Control de Veterinarios - Limites de veterinarios activos por clinica
  5. Usage Tracking - Monitorear uso de vacunas, consultas, etc.

Planes Propuestos para Clinicas Veterinarias

Plan Precio/mes Mascotas Veterinarios API Calls/mes Features
Basico $499 MXN 100 2 1,000 Expedientes, Citas, Vacunacion
Profesional $999 MXN 500 5 10,000 + Hospitalizacion, Lab, WhatsApp
Clinica $1,999 MXN Ilimitadas 10 50,000 + IA, Reportes, Webhooks
Hospital $3,999 MXN Ilimitadas Ilimitados Ilimitados + Multi-sucursal, API, Soporte

Features por Plan

Feature Basico Profesional Clinica Hospital
expedientes Si Si Si Si
citas Si Si Si Si
vacunacion Si Si Si Si
cartilla_digital Si Si Si Si
desparasitacion Si Si Si Si
hospitalizacion No Si Si Si
laboratorio No Si Si Si
whatsapp_integration No Si Si Si
asistente_ia No No Si Si
reportes_avanzados No No Si Si
webhooks No No Si Si
multi_sucursal No No No Si
api_access No No No Si
custom_branding No No No Si
soporte_prioritario No No No Si

Limites por Plan

Limite Basico Profesional Clinica Hospital
mascotas_activas 100 500 Ilimitadas Ilimitadas
veterinarios 2 5 10 Ilimitados
auxiliares 2 5 15 Ilimitados
sucursales 1 1 3 Ilimitadas
storage_gb 1 5 25 100
ai_requests_dia 0 0 100 Ilimitados
whatsapp_mensajes_mes 0 1000 5000 Ilimitados

Arquitectura de Evaluacion

Request
   |
   v
+-------------------+
| FeatureService    |
+-------------------+
   |
   +---> 1. Check plan de clinica
   |         |
   |         v
   |     Obtener features del plan
   |
   +---> 2. Check limites
   |         |
   |         v
   |     Validar mascotas, veterinarios, etc.
   |
   +---> 3. Check usage
   |         |
   |         v
   |     Validar AI calls, WhatsApp, storage
   |
   v
Return permitido/denegado

Casos de Uso Veterinarios

Caso 1: Registro de Mascota

1. Recepcionista intenta registrar nueva mascota
2. Sistema verifica limite de mascotas_activas
3. Si excede limite:
   - Mostrar mensaje de upgrade
   - Sugerir dar de baja mascotas inactivas
4. Si dentro del limite: permitir registro

Caso 2: Activar Hospitalizacion

1. Veterinario intenta internar mascota
2. Sistema verifica feature hospitalizacion
3. Si plan = Basico:
   - Mostrar mensaje: "Hospitalizacion disponible desde Plan Profesional"
   - Boton de upgrade
4. Si plan >= Profesional: permitir ingreso

Caso 3: Usar Asistente IA

1. Veterinario envia consulta a asistente IA
2. Sistema verifica:
   - Feature asistente_ia habilitada (plan >= Clinica)
   - Limite ai_requests_dia no excedido
3. Si excede: sugerir upgrade o esperar al dia siguiente

Dependencias

Modulos Requeridos

  • MGN-001-tenants - Gestion de clinicas (tenant_id)
  • MGN-016-billing - Suscripciones y pagos

Modulos Dependientes

  • Todos los modulos veterinarios que requieran feature gating
  • MGN-020-ai-integration (limites de IA)
  • MGN-021-whatsapp-business (limites de mensajes)

Indices


Modulo: MGN-017-plans-vet | Version: 1.0.0 Propagado desde: erp-core/MGN-017-plans Adaptado para: Dominio veterinario Generado: 2026-01-13