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

162 lines
4.8 KiB
Markdown

---
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*