---
id: MGN-017-plans-vet
title: "Modulo Plans - Planes y Feature Gating Veterinario"
type: Module
status: Draft
version: 1.0.0
created_date: 2026-01-13
updated_date: 2026-01-13
source: 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

- [Requerimientos Funcionales](requerimientos/INDICE-RF-PLANS.md)
- [Especificaciones Tecnicas](especificaciones/INDICE-ET-PLANS.md)
- [Historias de Usuario](historias-usuario/INDICE-US-PLANS.md)
- [Trazabilidad](implementacion/TRACEABILITY.yml)

---

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