- 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>
162 lines
4.8 KiB
Markdown
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*
|