[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>
This commit is contained in:
parent
b886cfe1ac
commit
c4620ca4e9
187
docs/04-fase-saas/MGN-016-billing/README.md
Normal file
187
docs/04-fase-saas/MGN-016-billing/README.md
Normal file
@ -0,0 +1,187 @@
|
||||
---
|
||||
id: MGN-016-billing-vet
|
||||
title: "Modulo Billing - Facturacion Veterinaria"
|
||||
type: ModuleOverview
|
||||
status: Draft
|
||||
version: 1.0.0
|
||||
created_date: 2026-01-13
|
||||
updated_date: 2026-01-13
|
||||
module: billing
|
||||
priority: P0
|
||||
source: erp-core/MGN-016-billing
|
||||
---
|
||||
|
||||
# MGN-016: Billing - Sistema de Facturacion para Clinicas Veterinarias
|
||||
|
||||
## Resumen Ejecutivo
|
||||
|
||||
El modulo Billing implementa el sistema de facturacion y suscripciones para clinicas veterinarias, integrando Stripe Billing como proveedor de pagos. Permite gestionar suscripciones mensuales y anuales para clinicas, facturacion de servicios veterinarios y paquetes de bienestar animal.
|
||||
|
||||
---
|
||||
|
||||
## Normativas Aplicables
|
||||
|
||||
- **NOM-064-ZOO-2000**: Lineamientos para la clasificacion y prescripcion de productos farmaceuticos veterinarios
|
||||
- **SENASICA**: Servicio Nacional de Sanidad, Inocuidad y Calidad Agroalimentaria
|
||||
- **SAT**: Facturacion electronica (CFDI) para servicios veterinarios
|
||||
|
||||
---
|
||||
|
||||
## Objetivos
|
||||
|
||||
### Objetivo Principal
|
||||
|
||||
Implementar un sistema de billing completo para clinicas veterinarias que permita:
|
||||
- Suscripciones mensuales y anuales para clinicas
|
||||
- Facturacion de servicios (consultas, cirugia, hospitalizacion)
|
||||
- Facturacion de productos (medicamentos, alimentos, accesorios)
|
||||
- Paquetes de vacunacion y desparasitacion
|
||||
- Planes de bienestar por mascota
|
||||
|
||||
### Objetivos Secundarios
|
||||
|
||||
- Sincronizacion bidireccional con Stripe via webhooks
|
||||
- Soporte para periodos de prueba (14 dias)
|
||||
- Manejo de pagos fallidos y dunning
|
||||
- Historial de facturas por propietario de mascota
|
||||
- Facturacion recurrente para planes de bienestar
|
||||
|
||||
---
|
||||
|
||||
## Planes para Clinicas Veterinarias
|
||||
|
||||
| Plan | Precio/mes | Mascotas | Veterinarios | Funcionalidades |
|
||||
|------|-----------|----------|--------------|-----------------|
|
||||
| **Basico** | $499 MXN | 100 | 2 | Expedientes, Citas, Vacunacion basica |
|
||||
| **Profesional** | $999 MXN | 500 | 5 | + Hospitalizacion, Laboratorio, WhatsApp |
|
||||
| **Clinica** | $1,999 MXN | Ilimitadas | 10 | + IA, Reportes avanzados, Integraciones |
|
||||
| **Hospital** | $3,999 MXN | Ilimitadas | Ilimitados | + Multi-sucursal, API, Soporte prioritario |
|
||||
|
||||
---
|
||||
|
||||
## Servicios Facturables
|
||||
|
||||
### Consultas y Atencion
|
||||
|
||||
| Servicio | Precio Sugerido | Notas |
|
||||
|----------|----------------|-------|
|
||||
| Consulta general | $350-500 MXN | Todas las especies |
|
||||
| Consulta de emergencia | $500-800 MXN | 24/7 |
|
||||
| Vacunacion (aplicacion) | $150-300 MXN | + costo de vacuna |
|
||||
| Desparasitacion | $100-200 MXN | + costo de producto |
|
||||
|
||||
### Hospitalizacion
|
||||
|
||||
| Servicio | Precio Sugerido | Notas |
|
||||
|----------|----------------|-------|
|
||||
| Hospitalizacion canino/dia | $400-800 MXN | Segun tamano |
|
||||
| Hospitalizacion felino/dia | $300-500 MXN | |
|
||||
| Hospitalizacion exotico/dia | $500-1000 MXN | Requiere equipo especial |
|
||||
|
||||
### Cirugia
|
||||
|
||||
| Servicio | Precio Sugerido | Notas |
|
||||
|----------|----------------|-------|
|
||||
| Esterilizacion canino macho | $800-1500 MXN | Segun peso |
|
||||
| Esterilizacion canino hembra | $1200-2500 MXN | Segun peso |
|
||||
| Esterilizacion felino | $600-1200 MXN | |
|
||||
| Limpieza dental | $800-1500 MXN | + anestesia |
|
||||
|
||||
---
|
||||
|
||||
## Paquetes de Bienestar
|
||||
|
||||
### Plan Cachorro/Gatito
|
||||
|
||||
Paquete anual para mascotas de 0-1 anio:
|
||||
- 4 consultas de seguimiento
|
||||
- Esquema completo de vacunacion
|
||||
- 4 desparasitaciones
|
||||
- Esterilizacion incluida
|
||||
- **Precio:** $3,500-4,500 MXN/anio
|
||||
|
||||
### Plan Adulto
|
||||
|
||||
Paquete anual para mascotas de 1-7 anios:
|
||||
- 2 consultas de chequeo
|
||||
- Vacunas anuales de refuerzo
|
||||
- 2 desparasitaciones
|
||||
- Limpieza dental con 20% descuento
|
||||
- **Precio:** $2,000-3,000 MXN/anio
|
||||
|
||||
### Plan Senior
|
||||
|
||||
Paquete anual para mascotas mayores de 7 anios:
|
||||
- 4 consultas de seguimiento
|
||||
- Vacunas anuales de refuerzo
|
||||
- 4 desparasitaciones
|
||||
- Examenes geriatricos (sangre, orina)
|
||||
- **Precio:** $4,000-5,500 MXN/anio
|
||||
|
||||
---
|
||||
|
||||
## Arquitectura
|
||||
|
||||
### Flujo de Pago de Suscripcion
|
||||
|
||||
```
|
||||
1. Clinica selecciona plan en frontend
|
||||
|
|
||||
2. Frontend llama POST /billing/checkout
|
||||
|
|
||||
3. Backend crea Checkout Session en Stripe
|
||||
|
|
||||
4. Clinica completa pago en Stripe
|
||||
|
|
||||
5. Stripe envia webhook: checkout.session.completed
|
||||
|
|
||||
6. Backend activa suscripcion de clinica
|
||||
|
|
||||
7. Clinica puede registrar mascotas y facturar
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Dependencias
|
||||
|
||||
### Modulos Prerequisito
|
||||
|
||||
| Modulo | Tipo | Descripcion |
|
||||
|--------|------|-------------|
|
||||
| MGN-001-auth | Requerido | Autenticacion JWT |
|
||||
| MGN-002-users | Requerido | Usuario veterinario/propietario |
|
||||
| MGN-004-tenants | Requerido | Contexto multi-tenant (por clinica) |
|
||||
|
||||
### Servicios Externos
|
||||
|
||||
| Servicio | Proposito | Requerido |
|
||||
|----------|-----------|-----------|
|
||||
| Stripe | Billing y pagos | Si |
|
||||
| SAT | CFDI (factura electronica) | Opcional |
|
||||
|
||||
---
|
||||
|
||||
## Seguridad
|
||||
|
||||
| Medida | Implementacion |
|
||||
|--------|----------------|
|
||||
| PCI Compliance | No almacenar datos de tarjeta (Stripe) |
|
||||
| Webhook Signature | Verificar Stripe-Signature header |
|
||||
| Datos Sensibles | Encriptar informacion financiera de propietarios |
|
||||
| Audit Trail | Log de todos los pagos y cambios de plan |
|
||||
|
||||
---
|
||||
|
||||
## Indices
|
||||
|
||||
- [Requerimientos Funcionales](requerimientos/INDICE-RF-BILLING.md)
|
||||
- [Especificaciones Tecnicas](especificaciones/INDICE-ET-BILLING.md)
|
||||
- [Historias de Usuario](historias-usuario/INDICE-US-BILLING.md)
|
||||
- [Trazabilidad](implementacion/TRACEABILITY.yml)
|
||||
|
||||
---
|
||||
|
||||
*Modulo: MGN-016-billing-vet | Version: 1.0.0 | Estado: Draft*
|
||||
*Propagado desde: erp-core/MGN-016-billing*
|
||||
*Adaptado para: Dominio veterinario*
|
||||
*Actualizado: 2026-01-13*
|
||||
48
docs/04-fase-saas/MGN-016-billing/_MAP.md
Normal file
48
docs/04-fase-saas/MGN-016-billing/_MAP.md
Normal file
@ -0,0 +1,48 @@
|
||||
# MGN-016: Billing - Mapa del Modulo
|
||||
|
||||
**Modulo:** MGN-016-billing
|
||||
**Proyecto:** clinica-veterinaria
|
||||
**Fecha:** 2026-01-13
|
||||
|
||||
---
|
||||
|
||||
## Estructura
|
||||
|
||||
```
|
||||
MGN-016-billing/
|
||||
├── README.md <- Vision general
|
||||
├── _MAP.md <- ESTE ARCHIVO
|
||||
├── requerimientos/
|
||||
│ └── INDICE-RF-BILLING.md <- Indice de requerimientos
|
||||
├── especificaciones/
|
||||
│ └── INDICE-ET-BILLING.md <- Indice de especificaciones
|
||||
├── historias-usuario/
|
||||
│ └── INDICE-US-BILLING.md <- Indice de historias
|
||||
└── implementacion/
|
||||
└── TRACEABILITY.yml <- Trazabilidad
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Documentos
|
||||
|
||||
| Documento | Descripcion | Estado |
|
||||
|-----------|-------------|--------|
|
||||
| [README.md](./README.md) | Vision general del modulo | Draft |
|
||||
| [requerimientos/](./requerimientos/) | Requerimientos funcionales | Pendiente |
|
||||
| [especificaciones/](./especificaciones/) | Especificaciones tecnicas | Pendiente |
|
||||
| [historias-usuario/](./historias-usuario/) | User stories | Pendiente |
|
||||
| [implementacion/](./implementacion/) | Trazabilidad | Pendiente |
|
||||
|
||||
---
|
||||
|
||||
## Navegacion
|
||||
|
||||
| Destino | Enlace |
|
||||
|---------|--------|
|
||||
| Fase | [04-fase-saas](../) |
|
||||
| Siguiente modulo | [MGN-017-plans](../MGN-017-plans/) |
|
||||
|
||||
---
|
||||
|
||||
*Mapa generado: 2026-01-13*
|
||||
161
docs/04-fase-saas/MGN-017-plans/README.md
Normal file
161
docs/04-fase-saas/MGN-017-plans/README.md
Normal file
@ -0,0 +1,161 @@
|
||||
---
|
||||
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*
|
||||
49
docs/04-fase-saas/MGN-017-plans/_MAP.md
Normal file
49
docs/04-fase-saas/MGN-017-plans/_MAP.md
Normal file
@ -0,0 +1,49 @@
|
||||
# MGN-017: Plans - Mapa del Modulo
|
||||
|
||||
**Modulo:** MGN-017-plans
|
||||
**Proyecto:** clinica-veterinaria
|
||||
**Fecha:** 2026-01-13
|
||||
|
||||
---
|
||||
|
||||
## Estructura
|
||||
|
||||
```
|
||||
MGN-017-plans/
|
||||
├── README.md <- Vision general
|
||||
├── _MAP.md <- ESTE ARCHIVO
|
||||
├── requerimientos/
|
||||
│ └── INDICE-RF-PLANS.md <- Indice de requerimientos
|
||||
├── especificaciones/
|
||||
│ └── INDICE-ET-PLANS.md <- Indice de especificaciones
|
||||
├── historias-usuario/
|
||||
│ └── INDICE-US-PLANS.md <- Indice de historias
|
||||
└── implementacion/
|
||||
└── TRACEABILITY.yml <- Trazabilidad
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Documentos
|
||||
|
||||
| Documento | Descripcion | Estado |
|
||||
|-----------|-------------|--------|
|
||||
| [README.md](./README.md) | Vision general del modulo | Draft |
|
||||
| [requerimientos/](./requerimientos/) | Requerimientos funcionales | Pendiente |
|
||||
| [especificaciones/](./especificaciones/) | Especificaciones tecnicas | Pendiente |
|
||||
| [historias-usuario/](./historias-usuario/) | User stories | Pendiente |
|
||||
| [implementacion/](./implementacion/) | Trazabilidad | Pendiente |
|
||||
|
||||
---
|
||||
|
||||
## Navegacion
|
||||
|
||||
| Destino | Enlace |
|
||||
|---------|--------|
|
||||
| Fase | [04-fase-saas](../) |
|
||||
| Modulo anterior | [MGN-016-billing](../MGN-016-billing/) |
|
||||
| Siguiente modulo | [MGN-018-webhooks](../MGN-018-webhooks/) |
|
||||
|
||||
---
|
||||
|
||||
*Mapa generado: 2026-01-13*
|
||||
177
docs/04-fase-saas/MGN-018-webhooks/README.md
Normal file
177
docs/04-fase-saas/MGN-018-webhooks/README.md
Normal file
@ -0,0 +1,177 @@
|
||||
# MGN-018: Webhooks Veterinarios
|
||||
|
||||
**Modulo:** MGN-018
|
||||
**Nombre:** Webhooks Outbound para Clinicas Veterinarias
|
||||
**Fase:** 04 - SaaS
|
||||
**Estado:** Draft
|
||||
**Ultima actualizacion:** 2026-01-13
|
||||
|
||||
---
|
||||
|
||||
## Descripcion
|
||||
|
||||
Sistema de webhooks outbound para notificar eventos veterinarios a sistemas externos. Permite a las clinicas registrar endpoints HTTP para recibir notificaciones automaticas cuando ocurren eventos como vacunaciones, citas, hospitalizaciones, etc.
|
||||
|
||||
---
|
||||
|
||||
## Funcionalidades Principales
|
||||
|
||||
1. **Registro de Endpoints** - CRUD de endpoints webhook por clinica
|
||||
2. **Firma HMAC-SHA256** - Firma criptografica de payloads para verificacion
|
||||
3. **Reintentos con Backoff** - Politica de reintentos exponencial (1min -> 6h)
|
||||
4. **Dead Letter Queue** - Almacenamiento de entregas fallidas
|
||||
5. **Delivery Logs** - Historial completo de entregas
|
||||
|
||||
---
|
||||
|
||||
## Eventos Veterinarios Disponibles
|
||||
|
||||
| Categoria | Eventos |
|
||||
|-----------|---------|
|
||||
| **Mascotas** | `mascota.registrada`, `mascota.actualizada`, `mascota.fallecida` |
|
||||
| **Vacunacion** | `vacuna.aplicada`, `vacuna.proxima`, `vacuna.vencida` |
|
||||
| **Desparasitacion** | `desparasitacion.aplicada`, `desparasitacion.proxima` |
|
||||
| **Citas** | `cita.agendada`, `cita.confirmada`, `cita.cancelada`, `cita.completada` |
|
||||
| **Hospitalizacion** | `hospitalizacion.ingreso`, `hospitalizacion.evolucion`, `hospitalizacion.alta` |
|
||||
| **Laboratorio** | `laboratorio.muestra_recibida`, `laboratorio.resultados_listos` |
|
||||
| **Cirugia** | `cirugia.programada`, `cirugia.iniciada`, `cirugia.completada` |
|
||||
| **Facturacion** | `factura.emitida`, `factura.pagada` |
|
||||
|
||||
---
|
||||
|
||||
## Casos de Uso Veterinarios
|
||||
|
||||
### Integracion con SENASICA
|
||||
|
||||
- Notificar vacunacion de rabia para registro oficial
|
||||
- Reportar brotes de enfermedades
|
||||
- Trazabilidad de lotes de vacunas
|
||||
|
||||
### Integracion con Laboratorios
|
||||
|
||||
- Recibir resultados de analisis
|
||||
- Actualizar expediente automaticamente
|
||||
- Notificar al propietario
|
||||
|
||||
### Notificaciones a Propietarios
|
||||
|
||||
- Recordatorios de vacunacion via email/SMS
|
||||
- Confirmacion de citas
|
||||
- Alta de hospitalizacion
|
||||
|
||||
### Sincronizacion con CRM
|
||||
|
||||
- Actualizar datos de propietarios
|
||||
- Historial de servicios
|
||||
- Preferencias de comunicacion
|
||||
|
||||
---
|
||||
|
||||
## Payload de Ejemplo
|
||||
|
||||
### Evento: vacuna.aplicada
|
||||
|
||||
```json
|
||||
{
|
||||
"event": "vacuna.aplicada",
|
||||
"timestamp": "2026-01-13T10:30:00Z",
|
||||
"clinica_id": "vet-clinica-001",
|
||||
"data": {
|
||||
"mascota": {
|
||||
"id": "pet-123",
|
||||
"nombre": "Max",
|
||||
"especie": "canino",
|
||||
"raza": "Labrador"
|
||||
},
|
||||
"propietario": {
|
||||
"id": "owner-456",
|
||||
"nombre": "Juan Perez",
|
||||
"telefono": "+5255123456"
|
||||
},
|
||||
"vacuna": {
|
||||
"id": "vac-789",
|
||||
"nombre": "Rabia",
|
||||
"lote": "LOT-2026-001",
|
||||
"fecha_aplicacion": "2026-01-13",
|
||||
"fecha_proxima": "2027-01-13",
|
||||
"veterinario": "Dr. Garcia"
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Evento: hospitalizacion.ingreso
|
||||
|
||||
```json
|
||||
{
|
||||
"event": "hospitalizacion.ingreso",
|
||||
"timestamp": "2026-01-13T14:00:00Z",
|
||||
"clinica_id": "vet-clinica-001",
|
||||
"data": {
|
||||
"mascota": {
|
||||
"id": "pet-123",
|
||||
"nombre": "Luna",
|
||||
"especie": "felino"
|
||||
},
|
||||
"hospitalizacion": {
|
||||
"id": "hosp-001",
|
||||
"motivo": "Cirugia de esterilizacion",
|
||||
"fecha_ingreso": "2026-01-13T14:00:00Z",
|
||||
"veterinario_responsable": "Dra. Martinez",
|
||||
"estado": "estable"
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Normativas y Cumplimiento
|
||||
|
||||
### SENASICA
|
||||
|
||||
- Eventos de vacunacion deben incluir lote y fabricante
|
||||
- Trazabilidad de vacunas de rabia obligatoria
|
||||
- Formato compatible con sistema de notificacion oficial
|
||||
|
||||
### Bienestar Animal
|
||||
|
||||
- Eventos de hospitalizacion incluyen estado del paciente
|
||||
- Registro de condiciones de internamiento
|
||||
- Trazabilidad de tratamientos
|
||||
|
||||
---
|
||||
|
||||
## Disponibilidad por Plan
|
||||
|
||||
| Plan | Webhooks | Eventos | Retenciones |
|
||||
|------|----------|---------|-------------|
|
||||
| Basico | No | - | - |
|
||||
| Profesional | No | - | - |
|
||||
| Clinica | Si | Todos | 30 dias |
|
||||
| Hospital | Si | Todos | 90 dias |
|
||||
|
||||
---
|
||||
|
||||
## Dependencias
|
||||
|
||||
**Este modulo depende de:**
|
||||
- MGN-001 Auth (autenticacion de administradores)
|
||||
- MGN-004 Tenants (aislamiento por clinica)
|
||||
- MGN-017 Plans (feature gating - solo Clinica/Hospital)
|
||||
|
||||
---
|
||||
|
||||
## Indices
|
||||
|
||||
- [Requerimientos](./requerimientos/INDICE-RF-WEBHOOKS.md)
|
||||
- [Especificaciones](./especificaciones/INDICE-ET-WEBHOOKS.md)
|
||||
- [Historias de Usuario](./historias-usuario/INDICE-US-WEBHOOKS.md)
|
||||
- [Trazabilidad](./implementacion/TRACEABILITY.yml)
|
||||
|
||||
---
|
||||
|
||||
*Modulo: MGN-018-webhooks-vet*
|
||||
*Propagado desde: erp-core/MGN-018-webhooks*
|
||||
*Adaptado para: Dominio veterinario*
|
||||
*Fecha: 2026-01-13*
|
||||
50
docs/04-fase-saas/MGN-018-webhooks/_MAP.md
Normal file
50
docs/04-fase-saas/MGN-018-webhooks/_MAP.md
Normal file
@ -0,0 +1,50 @@
|
||||
# MGN-018: Webhooks - Mapa del Modulo
|
||||
|
||||
**Modulo:** MGN-018-webhooks
|
||||
**Proyecto:** clinica-veterinaria
|
||||
**Fecha:** 2026-01-13
|
||||
|
||||
---
|
||||
|
||||
## Estructura
|
||||
|
||||
```
|
||||
MGN-018-webhooks/
|
||||
├── README.md <- Vision general
|
||||
├── _MAP.md <- ESTE ARCHIVO
|
||||
├── requerimientos/
|
||||
│ └── INDICE-RF-WEBHOOKS.md <- Indice de requerimientos
|
||||
├── especificaciones/
|
||||
│ └── INDICE-ET-WEBHOOKS.md <- Indice de especificaciones
|
||||
├── historias-usuario/
|
||||
│ └── INDICE-US-WEBHOOKS.md <- Indice de historias
|
||||
└── implementacion/
|
||||
└── TRACEABILITY.yml <- Trazabilidad
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Eventos Veterinarios
|
||||
|
||||
| Evento | Descripcion |
|
||||
|--------|-------------|
|
||||
| `mascota.registrada` | Nueva mascota en el sistema |
|
||||
| `vacuna.aplicada` | Vacuna aplicada a mascota |
|
||||
| `vacuna.proxima` | Recordatorio de vacuna pendiente |
|
||||
| `cita.agendada` | Cita programada |
|
||||
| `hospitalizacion.ingreso` | Mascota internada |
|
||||
| `hospitalizacion.alta` | Mascota dada de alta |
|
||||
|
||||
---
|
||||
|
||||
## Navegacion
|
||||
|
||||
| Destino | Enlace |
|
||||
|---------|--------|
|
||||
| Fase | [04-fase-saas](../) |
|
||||
| Modulo anterior | [MGN-017-plans](../MGN-017-plans/) |
|
||||
| Siguiente modulo | [MGN-019-feature-flags](../MGN-019-feature-flags/) |
|
||||
|
||||
---
|
||||
|
||||
*Mapa generado: 2026-01-13*
|
||||
165
docs/04-fase-saas/MGN-019-feature-flags/README.md
Normal file
165
docs/04-fase-saas/MGN-019-feature-flags/README.md
Normal file
@ -0,0 +1,165 @@
|
||||
---
|
||||
id: MGN-019-fflags-vet
|
||||
title: Sistema de Feature Flags Veterinarios
|
||||
type: Module
|
||||
status: Draft
|
||||
priority: P1
|
||||
version: 1.0.0
|
||||
created_date: 2026-01-13
|
||||
updated_date: 2026-01-13
|
||||
source: erp-core/MGN-019-feature-flags
|
||||
---
|
||||
|
||||
# MGN-019: Sistema de Feature Flags para Clinicas Veterinarias
|
||||
|
||||
## Descripcion
|
||||
|
||||
Sistema propio de feature flags para control granular de funcionalidades veterinarias por clinica y plan. Permite toggle de features sin redeploy, rollout gradual por porcentaje de clinicas, y override manual por clinica.
|
||||
|
||||
## Normativas Aplicables
|
||||
|
||||
- **NOM-064-ZOO-2000**: Features relacionadas con prescripcion
|
||||
- **SENASICA**: Features de reportes oficiales
|
||||
- **Bienestar Animal**: Features de hospitalizacion
|
||||
|
||||
## Objetivos
|
||||
|
||||
- Toggle features veterinarias sin necesidad de redeploy
|
||||
- Flags configurables por clinica y por plan
|
||||
- Gradual rollout (porcentaje de clinicas)
|
||||
- A/B testing de funcionalidades
|
||||
- Override manual por clinica con expiracion opcional
|
||||
|
||||
## Feature Flags Veterinarios
|
||||
|
||||
### Core - Disponibles en todos los planes
|
||||
|
||||
| Flag | Descripcion | Default |
|
||||
|------|-------------|---------|
|
||||
| `expediente_digital` | Expediente clinico digital | ON |
|
||||
| `cartilla_vacunacion` | Cartilla de vacunacion digital | ON |
|
||||
| `agenda_citas` | Sistema de citas | ON |
|
||||
| `registro_mascotas` | Registro de pacientes | ON |
|
||||
|
||||
### Profesional - Plan Profesional+
|
||||
|
||||
| Flag | Descripcion | Default |
|
||||
|------|-------------|---------|
|
||||
| `hospitalizacion` | Modulo de internamiento | OFF (plan < Profesional) |
|
||||
| `laboratorio` | Integracion con laboratorios | OFF (plan < Profesional) |
|
||||
| `whatsapp_notifications` | Notificaciones WhatsApp | OFF (plan < Profesional) |
|
||||
| `control_vacunas` | Recordatorios automaticos de vacunas | OFF (plan < Profesional) |
|
||||
|
||||
### Clinica - Plan Clinica+
|
||||
|
||||
| Flag | Descripcion | Default |
|
||||
|------|-------------|---------|
|
||||
| `asistente_ia` | Asistente veterinario IA | OFF (plan < Clinica) |
|
||||
| `reportes_avanzados` | Analytics y dashboards | OFF (plan < Clinica) |
|
||||
| `webhooks_outbound` | Webhooks a sistemas externos | OFF (plan < Clinica) |
|
||||
| `telemedicina` | Consultas remotas | OFF (plan < Clinica) |
|
||||
|
||||
### Hospital - Plan Hospital
|
||||
|
||||
| Flag | Descripcion | Default |
|
||||
|------|-------------|---------|
|
||||
| `multi_sucursal` | Gestion multi-sede | OFF (plan < Hospital) |
|
||||
| `api_publica` | Acceso a API REST | OFF (plan < Hospital) |
|
||||
| `custom_branding` | Personalizacion de marca | OFF (plan < Hospital) |
|
||||
| `senasica_integration` | Reportes automaticos SENASICA | OFF (plan < Hospital) |
|
||||
|
||||
### Experimentales (Rollout Gradual)
|
||||
|
||||
| Flag | Descripcion | Rollout % |
|
||||
|------|-------------|-----------|
|
||||
| `nueva_ui_expediente` | Nueva interfaz de expediente | 10% |
|
||||
| `ia_diagnostico_apoyo` | IA de apoyo diagnostico | 5% |
|
||||
| `telemedicina_video` | Videollamadas con propietarios | 15% |
|
||||
| `integracion_wearables` | Collares inteligentes | 0% (beta cerrada) |
|
||||
|
||||
## Arquitectura de Evaluacion
|
||||
|
||||
```
|
||||
Request a funcionalidad veterinaria
|
||||
|
|
||||
v
|
||||
+-------------------+
|
||||
| FeatureFlagService|
|
||||
+-------------------+
|
||||
|
|
||||
+---> 1. Check override de clinica
|
||||
| |
|
||||
| v (si existe)
|
||||
| Return override value
|
||||
|
|
||||
+---> 2. Check plan de clinica
|
||||
| |
|
||||
| v (si feature en plan)
|
||||
| Return plan value
|
||||
|
|
||||
+---> 3. Check rollout %
|
||||
| |
|
||||
| v
|
||||
| Evaluate by clinic_id hash
|
||||
|
|
||||
v
|
||||
Return final value (ON/OFF)
|
||||
```
|
||||
|
||||
## Prioridad de Evaluacion
|
||||
|
||||
1. **Override de Clinica** - Maxima prioridad, permite excepciones manuales
|
||||
2. **Features del Plan** - Segun plan contratado por la clinica
|
||||
3. **Rollout Gradual** - Para features experimentales
|
||||
|
||||
## Casos de Uso
|
||||
|
||||
### Caso 1: Activar Beta para Clinica Especifica
|
||||
|
||||
```yaml
|
||||
# Override para clinica VIP
|
||||
override:
|
||||
clinica_id: "vet-premium-001"
|
||||
flag: "ia_diagnostico_apoyo"
|
||||
value: true
|
||||
expires_at: "2026-03-01"
|
||||
reason: "Beta tester"
|
||||
```
|
||||
|
||||
### Caso 2: Rollout Gradual de Telemedicina
|
||||
|
||||
```yaml
|
||||
# Rollout gradual 15%
|
||||
flag:
|
||||
name: "telemedicina_video"
|
||||
rollout_percentage: 15
|
||||
target_plans: ["clinica", "hospital"]
|
||||
tracking_enabled: true
|
||||
```
|
||||
|
||||
### Caso 3: Desactivar Feature por Incidente
|
||||
|
||||
```yaml
|
||||
# Kill switch de emergencia
|
||||
flag:
|
||||
name: "integracion_laboratorio_externo"
|
||||
value: false
|
||||
reason: "Incidente API externa - ticket INC-001"
|
||||
disabled_by: "admin@clinica.com"
|
||||
disabled_at: "2026-01-13T10:00:00Z"
|
||||
```
|
||||
|
||||
## Documentacion del Modulo
|
||||
|
||||
- [Mapa del Modulo](./_MAP.md)
|
||||
- [Requerimientos](./requerimientos/INDICE-RF-FFLAGS.md)
|
||||
- [Especificaciones](./especificaciones/INDICE-ET-FFLAGS.md)
|
||||
- [Historias de Usuario](./historias-usuario/INDICE-US-FFLAGS.md)
|
||||
- [Trazabilidad](./implementacion/TRACEABILITY.yml)
|
||||
|
||||
---
|
||||
|
||||
*Modulo: MGN-019-feature-flags-vet*
|
||||
*Propagado desde: erp-core/MGN-019-feature-flags*
|
||||
*Adaptado para: Dominio veterinario*
|
||||
*Actualizado: 2026-01-13*
|
||||
50
docs/04-fase-saas/MGN-019-feature-flags/_MAP.md
Normal file
50
docs/04-fase-saas/MGN-019-feature-flags/_MAP.md
Normal file
@ -0,0 +1,50 @@
|
||||
# MGN-019: Feature Flags - Mapa del Modulo
|
||||
|
||||
**Modulo:** MGN-019-feature-flags
|
||||
**Proyecto:** clinica-veterinaria
|
||||
**Fecha:** 2026-01-13
|
||||
|
||||
---
|
||||
|
||||
## Estructura
|
||||
|
||||
```
|
||||
MGN-019-feature-flags/
|
||||
├── README.md <- Vision general
|
||||
├── _MAP.md <- ESTE ARCHIVO
|
||||
├── requerimientos/
|
||||
│ └── INDICE-RF-FFLAGS.md <- Indice de requerimientos
|
||||
├── especificaciones/
|
||||
│ └── INDICE-ET-FFLAGS.md <- Indice de especificaciones
|
||||
├── historias-usuario/
|
||||
│ └── INDICE-US-FFLAGS.md <- Indice de historias
|
||||
└── implementacion/
|
||||
└── TRACEABILITY.yml <- Trazabilidad
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Feature Flags Veterinarios
|
||||
|
||||
| Flag | Plan Minimo | Descripcion |
|
||||
|------|-------------|-------------|
|
||||
| `cartilla_digital` | Basico | Cartilla de vacunacion digital |
|
||||
| `control_vacunas` | Profesional | Recordatorios automaticos |
|
||||
| `hospitalizacion` | Profesional | Modulo de internamiento |
|
||||
| `laboratorio` | Profesional | Integracion con labs |
|
||||
| `asistente_ia` | Clinica | IA veterinaria |
|
||||
| `multi_sucursal` | Hospital | Varias sedes |
|
||||
|
||||
---
|
||||
|
||||
## Navegacion
|
||||
|
||||
| Destino | Enlace |
|
||||
|---------|--------|
|
||||
| Fase | [04-fase-saas](../) |
|
||||
| Modulo anterior | [MGN-018-webhooks](../MGN-018-webhooks/) |
|
||||
| Siguiente fase | [05-fase-ia](../../05-fase-ia/) |
|
||||
|
||||
---
|
||||
|
||||
*Mapa generado: 2026-01-13*
|
||||
73
docs/04-fase-saas/README.md
Normal file
73
docs/04-fase-saas/README.md
Normal file
@ -0,0 +1,73 @@
|
||||
# Fase 04: SaaS - Clinica Veterinaria
|
||||
|
||||
**Proyecto:** clinica-veterinaria
|
||||
**Fase:** 04 - SaaS
|
||||
**Tipo:** SUB-CONSUMER (hereda de erp-clinicas -> erp-core)
|
||||
**Fecha:** 2026-01-13
|
||||
**Version:** 1.0.0
|
||||
|
||||
---
|
||||
|
||||
## Descripcion
|
||||
|
||||
Esta fase implementa las capacidades SaaS de la clinica veterinaria, incluyendo sistema de billing, planes de suscripcion, webhooks y feature flags adaptados al dominio veterinario.
|
||||
|
||||
## Normativas Aplicables
|
||||
|
||||
- **NOM-064-ZOO-2000**: Lineamientos para la clasificacion y prescripcion de productos farmaceuticos veterinarios
|
||||
- **SENASICA**: Servicio Nacional de Sanidad, Inocuidad y Calidad Agroalimentaria
|
||||
- **Ley Federal de Sanidad Animal**: Regulaciones de bienestar animal
|
||||
|
||||
## Modulos de esta Fase
|
||||
|
||||
| Modulo | Nombre | Descripcion | Estado |
|
||||
|--------|--------|-------------|--------|
|
||||
| MGN-016 | [Billing](./MGN-016-billing/) | Facturacion y suscripciones para clinicas veterinarias | Draft |
|
||||
| MGN-017 | [Plans](./MGN-017-plans/) | Planes y cuotas adaptados a servicios veterinarios | Draft |
|
||||
| MGN-018 | [Webhooks](./MGN-018-webhooks/) | Eventos para integraciones veterinarias | Draft |
|
||||
| MGN-019 | [Feature Flags](./MGN-019-feature-flags/) | Control de funcionalidades veterinarias | Draft |
|
||||
|
||||
## Planes Sugeridos para Clinicas Veterinarias
|
||||
|
||||
| Plan | Precio/mes | Mascotas | Veterinarios | Funcionalidades |
|
||||
|------|-----------|----------|--------------|-----------------|
|
||||
| **Basico** | $499 MXN | 100 | 2 | Expedientes, Citas, Vacunacion |
|
||||
| **Profesional** | $999 MXN | 500 | 5 | + Hospitalizacion, Laboratorio, WhatsApp |
|
||||
| **Clinica** | $1,999 MXN | Ilimitadas | 10 | + IA, Reportes avanzados, Integraciones |
|
||||
| **Hospital** | $3,999 MXN | Ilimitadas | Ilimitados | + Multi-sucursal, API, Soporte prioritario |
|
||||
|
||||
## Consideraciones Especiales
|
||||
|
||||
### Especies Soportadas
|
||||
|
||||
- Caninos (perros)
|
||||
- Felinos (gatos)
|
||||
- Aves
|
||||
- Exoticos (reptiles, roedores, hurones)
|
||||
- Fauna silvestre (requiere permisos SEMARNAT)
|
||||
|
||||
### Bienestar Animal
|
||||
|
||||
Todas las funcionalidades deben considerar:
|
||||
- Trazabilidad de vacunas y desparasitaciones
|
||||
- Alertas de calendario de vacunacion
|
||||
- Registro de condiciones de bienestar
|
||||
- Cumplimiento de protocolos de la NOM-064-ZOO-2000
|
||||
|
||||
## Dependencias
|
||||
|
||||
- **erp-clinicas**: Modulos de gestion clinica
|
||||
- **erp-core**: Infraestructura SaaS base
|
||||
- **template-saas**: Patrones y arquitectura SaaS
|
||||
|
||||
## Navegacion
|
||||
|
||||
- [Indice de Fase](./_MAP.md)
|
||||
- [Vision General](../00-vision-general/)
|
||||
- [Fase 05 - IA](../05-fase-ia/)
|
||||
|
||||
---
|
||||
|
||||
*Propagado desde erp-core via erp-clinicas*
|
||||
*Adaptado para dominio veterinario*
|
||||
*Version: 1.0.0 | Fecha: 2026-01-13*
|
||||
117
docs/04-fase-saas/_MAP.md
Normal file
117
docs/04-fase-saas/_MAP.md
Normal file
@ -0,0 +1,117 @@
|
||||
# Fase 04: SaaS - Mapa de Navegacion
|
||||
|
||||
**Fase:** 04-fase-saas
|
||||
**Proyecto:** clinica-veterinaria
|
||||
**Fecha:** 2026-01-13
|
||||
|
||||
---
|
||||
|
||||
## Estructura de la Fase
|
||||
|
||||
```
|
||||
04-fase-saas/
|
||||
├── README.md <- Descripcion de la fase
|
||||
├── _MAP.md <- ESTE ARCHIVO
|
||||
│
|
||||
├── MGN-016-billing/ <- Sistema de facturacion
|
||||
│ ├── README.md <- Descripcion del modulo
|
||||
│ ├── _MAP.md <- Indice del modulo
|
||||
│ ├── requerimientos/ <- RFs del modulo
|
||||
│ ├── especificaciones/ <- ETs del modulo
|
||||
│ ├── historias-usuario/ <- USs del modulo
|
||||
│ └── implementacion/ <- Trazabilidad
|
||||
│
|
||||
├── MGN-017-plans/ <- Planes y cuotas
|
||||
│ └── ...
|
||||
│
|
||||
├── MGN-018-webhooks/ <- Webhooks outbound
|
||||
│ └── ...
|
||||
│
|
||||
└── MGN-019-feature-flags/ <- Feature flags
|
||||
└── ...
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Modulos de la Fase
|
||||
|
||||
### MGN-016: Billing - Facturacion Veterinaria
|
||||
|
||||
Sistema de facturacion y suscripciones adaptado para clinicas veterinarias.
|
||||
|
||||
| Documento | Tipo | Descripcion |
|
||||
|-----------|------|-------------|
|
||||
| [README.md](./MGN-016-billing/README.md) | Overview | Vision general del modulo |
|
||||
| [_MAP.md](./MGN-016-billing/_MAP.md) | Indice | Navegacion del modulo |
|
||||
|
||||
**Adaptaciones veterinarias:**
|
||||
- Facturacion de servicios (consultas, cirugia, hospitalizacion)
|
||||
- Facturacion de productos (medicamentos, alimentos, accesorios)
|
||||
- Paquetes de vacunacion y desparasitacion
|
||||
- Planes de bienestar por mascota
|
||||
|
||||
---
|
||||
|
||||
### MGN-017: Plans - Planes Veterinarios
|
||||
|
||||
Definicion de planes y limites para clinicas veterinarias.
|
||||
|
||||
| Documento | Tipo | Descripcion |
|
||||
|-----------|------|-------------|
|
||||
| [README.md](./MGN-017-plans/README.md) | Overview | Vision general del modulo |
|
||||
| [_MAP.md](./MGN-017-plans/_MAP.md) | Indice | Navegacion del modulo |
|
||||
|
||||
**Adaptaciones veterinarias:**
|
||||
- Limites por mascotas registradas
|
||||
- Limites por veterinarios activos
|
||||
- Features por tipo de servicio (hospitalizacion, cirugia, etc.)
|
||||
|
||||
---
|
||||
|
||||
### MGN-018: Webhooks - Eventos Veterinarios
|
||||
|
||||
Sistema de webhooks para integraciones con sistemas externos.
|
||||
|
||||
| Documento | Tipo | Descripcion |
|
||||
|-----------|------|-------------|
|
||||
| [README.md](./MGN-018-webhooks/README.md) | Overview | Vision general del modulo |
|
||||
| [_MAP.md](./MGN-018-webhooks/_MAP.md) | Indice | Navegacion del modulo |
|
||||
|
||||
**Eventos veterinarios:**
|
||||
- `mascota.registrada`, `mascota.actualizada`
|
||||
- `vacuna.aplicada`, `vacuna.proxima`
|
||||
- `cita.agendada`, `cita.confirmada`, `cita.completada`
|
||||
- `hospitalizacion.ingreso`, `hospitalizacion.alta`
|
||||
|
||||
---
|
||||
|
||||
### MGN-019: Feature Flags - Control de Funcionalidades
|
||||
|
||||
Sistema de feature flags para control granular de funcionalidades.
|
||||
|
||||
| Documento | Tipo | Descripcion |
|
||||
|-----------|------|-------------|
|
||||
| [README.md](./MGN-019-feature-flags/README.md) | Overview | Vision general del modulo |
|
||||
| [_MAP.md](./MGN-019-feature-flags/_MAP.md) | Indice | Navegacion del modulo |
|
||||
|
||||
**Flags veterinarios:**
|
||||
- `cartilla_digital`: Cartilla de vacunacion digital
|
||||
- `control_vacunas`: Sistema de recordatorios de vacunas
|
||||
- `hospitalizacion`: Modulo de internamiento
|
||||
- `telemedicina`: Consultas remotas
|
||||
- `laboratorio`: Integracion con laboratorios
|
||||
|
||||
---
|
||||
|
||||
## Navegacion
|
||||
|
||||
| Destino | Enlace |
|
||||
|---------|--------|
|
||||
| Fase anterior | [02-definicion-modulos](../02-definicion-modulos/) |
|
||||
| Fase siguiente | [05-fase-ia](../05-fase-ia/) |
|
||||
| Mapa principal | [docs/_MAP.md](../_MAP.md) |
|
||||
|
||||
---
|
||||
|
||||
*Mapa generado: 2026-01-13*
|
||||
*Propagado desde: erp-core/docs/04-fase-saas*
|
||||
248
docs/05-fase-ia/MGN-020-ai-integration/README.md
Normal file
248
docs/05-fase-ia/MGN-020-ai-integration/README.md
Normal file
@ -0,0 +1,248 @@
|
||||
---
|
||||
id: MGN-020-ai-vet
|
||||
title: "Modulo AI Integration - Asistente Veterinario Inteligente"
|
||||
type: Module
|
||||
status: Draft
|
||||
version: 1.0.0
|
||||
priority: P1
|
||||
phase: "Fase IA"
|
||||
created_date: 2026-01-13
|
||||
updated_date: 2026-01-13
|
||||
source: erp-core/MGN-020-ai-integration
|
||||
---
|
||||
|
||||
# MGN-020: AI Integration - Asistente Veterinario Inteligente
|
||||
|
||||
> Asistente de IA especializado en medicina veterinaria para clinicas
|
||||
|
||||
## Resumen Ejecutivo
|
||||
|
||||
El modulo AI Integration proporciona un asistente veterinario inteligente que utiliza LLMs (Large Language Models) para ayudar a veterinarios y propietarios de mascotas. Incluye conocimiento especializado de especies, razas, vacunacion, sintomas comunes y cuidados.
|
||||
|
||||
---
|
||||
|
||||
## Normativas Aplicables
|
||||
|
||||
- **NOM-064-ZOO-2000**: La IA NO puede prescribir medicamentos
|
||||
- **SENASICA**: Informacion de vacunacion alineada con calendario oficial
|
||||
- **Bienestar Animal**: Priorizar siempre la salud del animal
|
||||
|
||||
## Limitaciones Eticas
|
||||
|
||||
La IA veterinaria:
|
||||
- **NO diagnostica** enfermedades de forma definitiva
|
||||
- **NO prescribe** medicamentos controlados
|
||||
- **NO reemplaza** la consulta veterinaria presencial
|
||||
- **SIEMPRE recomienda** atencion profesional ante sintomas graves
|
||||
- **DERIVA** casos de emergencia inmediatamente
|
||||
|
||||
---
|
||||
|
||||
## 1. Objetivos del Modulo
|
||||
|
||||
| Objetivo | Descripcion | Prioridad |
|
||||
|----------|-------------|-----------|
|
||||
| Asistente veterinario | Responder consultas de salud animal | P0 |
|
||||
| Calendario vacunacion | Informar sobre vacunas por especie | P0 |
|
||||
| Triaje basico | Evaluar urgencia de sintomas | P0 |
|
||||
| Cuidados generales | Orientar sobre alimentacion, higiene | P1 |
|
||||
| Apoyo a veterinarios | Sugerir diferenciales (apoyo, no diagnostico) | P2 |
|
||||
|
||||
---
|
||||
|
||||
## 2. Conocimiento Especializado
|
||||
|
||||
### 2.1 Especies Soportadas
|
||||
|
||||
| Especie | Nivel de Conocimiento | Notas |
|
||||
|---------|----------------------|-------|
|
||||
| Caninos (perros) | Avanzado | 200+ razas, vacunas, enfermedades |
|
||||
| Felinos (gatos) | Avanzado | 70+ razas, vacunas, enfermedades |
|
||||
| Aves | Intermedio | Especies domesticas comunes |
|
||||
| Reptiles | Basico | Husbandry general |
|
||||
| Roedores | Basico | Hamsters, conejos, cuyes |
|
||||
| Exoticos | Basico | Deriva a especialista |
|
||||
|
||||
### 2.2 Calendario de Vacunacion
|
||||
|
||||
#### Caninos
|
||||
|
||||
| Vacuna | Edad Inicial | Refuerzos | Obligatoria |
|
||||
|--------|--------------|-----------|-------------|
|
||||
| Parvovirus | 6-8 semanas | 12, 16 sem, anual | Si |
|
||||
| Moquillo | 6-8 semanas | 12, 16 sem, anual | Si |
|
||||
| Hepatitis | 6-8 semanas | 12, 16 sem, anual | Si |
|
||||
| Rabia | 12-16 semanas | Anual | Si (SENASICA) |
|
||||
| Leptospirosis | 12 semanas | 16 sem, anual | Recomendada |
|
||||
| Bordetella | 8 semanas | Cada 6-12 meses | Opcional |
|
||||
|
||||
#### Felinos
|
||||
|
||||
| Vacuna | Edad Inicial | Refuerzos | Obligatoria |
|
||||
|--------|--------------|-----------|-------------|
|
||||
| Triple Felina (FVRCP) | 6-8 semanas | 12, 16 sem, anual | Si |
|
||||
| Leucemia Felina (FeLV) | 8 semanas | 12 sem, anual | Recomendada |
|
||||
| Rabia | 12-16 semanas | Anual | Si (SENASICA) |
|
||||
|
||||
---
|
||||
|
||||
## 3. System Prompt Veterinario
|
||||
|
||||
```
|
||||
Eres el Asistente Veterinario de {{CLINICA_NAME}}, una clinica veterinaria en Mexico.
|
||||
|
||||
TU ROL:
|
||||
- Orientar a propietarios sobre salud de mascotas
|
||||
- Informar sobre vacunacion y cuidados preventivos
|
||||
- Ayudar a agendar citas
|
||||
- Evaluar urgencia de sintomas (triaje basico)
|
||||
|
||||
REGLAS ESTRICTAS:
|
||||
1. NUNCA diagnostiques enfermedades de forma definitiva
|
||||
2. NUNCA prescribas medicamentos controlados (NOM-064-ZOO-2000)
|
||||
3. SIEMPRE recomienda consulta veterinaria ante sintomas preocupantes
|
||||
4. Si detectas EMERGENCIA (hemorragia, convulsiones, atropello, dificultad respiratoria):
|
||||
- Responde: "Esto es una EMERGENCIA. Lleva a tu mascota al veterinario INMEDIATAMENTE."
|
||||
- Proporciona telefono de emergencias: {{TELEFONO_EMERGENCIA}}
|
||||
|
||||
CONOCIMIENTO:
|
||||
- Caninos: vacunas, razas, enfermedades comunes
|
||||
- Felinos: vacunas, razas, enfermedades comunes
|
||||
- Otras especies: informacion basica, deriva a especialista
|
||||
|
||||
ESTILO:
|
||||
- Espanol mexicano, amigable pero profesional
|
||||
- Empatico con propietarios preocupados
|
||||
- Claro y conciso
|
||||
- Usa terminos que el propietario entienda
|
||||
|
||||
HERRAMIENTAS DISPONIBLES:
|
||||
- consultar_historial_mascota: Ver expediente de la mascota
|
||||
- registrar_vacuna: Registrar aplicacion de vacuna
|
||||
- agendar_consulta: Programar cita
|
||||
- consultar_cartilla_vacunacion: Ver vacunas aplicadas
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 4. Casos de Uso
|
||||
|
||||
### 4.1 Consulta de Vacunacion
|
||||
|
||||
```
|
||||
Propietario: "Mi perro tiene 3 meses, que vacunas le tocan?"
|
||||
|
||||
Asistente:
|
||||
"A los 3 meses tu cachorro necesita las siguientes vacunas:
|
||||
|
||||
1. Segunda dosis de Cuadruple (parvovirus, moquillo, hepatitis, parainfluenza)
|
||||
2. Primera dosis de Rabia
|
||||
|
||||
Te recomiendo agendar una cita para aplicarlas. ¿Quieres que te programe?
|
||||
|
||||
Nota: Es importante que complete su esquema a los 4 meses con la tercera dosis de cuadruple."
|
||||
```
|
||||
|
||||
### 4.2 Triaje de Sintomas
|
||||
|
||||
```
|
||||
Propietario: "Mi gato no ha comido en 2 dias y vomita"
|
||||
|
||||
Asistente:
|
||||
"Entiendo tu preocupacion. Un gato que no come por 2 dias y presenta vomitos
|
||||
necesita atencion veterinaria pronto.
|
||||
|
||||
URGENCIA: MODERADA-ALTA
|
||||
|
||||
Esto puede indicar desde una bola de pelo hasta algo mas serio.
|
||||
Te recomiendo traerlo HOY para una revision.
|
||||
|
||||
¿Quieres que te agende una cita de urgencia?"
|
||||
```
|
||||
|
||||
### 4.3 Emergencia
|
||||
|
||||
```
|
||||
Propietario: "Mi perro se comio un raticida"
|
||||
|
||||
Asistente:
|
||||
"🚨 EMERGENCIA VETERINARIA
|
||||
|
||||
Esto es una situacion de emergencia. El raticida puede ser toxico y
|
||||
requiere atencion INMEDIATA.
|
||||
|
||||
ACCION REQUERIDA:
|
||||
1. NO induzcas el vomito (puede empeorar la situacion)
|
||||
2. Lleva a tu mascota al veterinario AHORA
|
||||
3. Si puedes, trae el empaque del producto
|
||||
|
||||
Telefono de emergencias: {{TELEFONO_EMERGENCIA}}
|
||||
|
||||
¿Necesitas direcciones para llegar a la clinica?"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 5. Rate Limits por Plan
|
||||
|
||||
| Plan | Consultas IA/dia | Max Tokens/consulta |
|
||||
|------|-----------------|---------------------|
|
||||
| Basico | 0 | - |
|
||||
| Profesional | 0 | - |
|
||||
| Clinica | 100 | 2,000 |
|
||||
| Hospital | Ilimitado | 4,096 |
|
||||
|
||||
---
|
||||
|
||||
## 6. Dependencias
|
||||
|
||||
### 6.1 Internas
|
||||
|
||||
| Modulo | Relacion |
|
||||
|--------|----------|
|
||||
| MGN-017-plans | Limites de IA por plan |
|
||||
| MGN-022-mcp-server | Herramientas veterinarias |
|
||||
| MGN-021-whatsapp | Canal de comunicacion |
|
||||
|
||||
### 6.2 Externas
|
||||
|
||||
| Servicio | Proposito |
|
||||
|----------|-----------|
|
||||
| OpenRouter API | Gateway multi-provider LLM |
|
||||
| Claude 3 Haiku | Modelo default (rapido, economico) |
|
||||
|
||||
---
|
||||
|
||||
## 7. Configuracion
|
||||
|
||||
```bash
|
||||
# OpenRouter
|
||||
OPENROUTER_API_KEY=sk-or-xxx
|
||||
OPENROUTER_SITE_URL=https://clinica.example.com
|
||||
OPENROUTER_SITE_NAME=Clinica Veterinaria Example
|
||||
|
||||
# Defaults
|
||||
AI_DEFAULT_MODEL=anthropic/claude-3-haiku
|
||||
AI_DEFAULT_TEMPERATURE=0.7
|
||||
AI_DEFAULT_MAX_TOKENS=2000
|
||||
|
||||
# Veterinario
|
||||
VET_EMERGENCY_PHONE=+5255123456
|
||||
VET_CLINIC_NAME=Clinica Veterinaria Example
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Indices
|
||||
|
||||
- [Requerimientos](./requerimientos/INDICE-RF-AI.md)
|
||||
- [Especificaciones](./especificaciones/INDICE-ET-AI.md)
|
||||
- [Historias de Usuario](./historias-usuario/INDICE-US-AI.md)
|
||||
- [Trazabilidad](./implementacion/TRACEABILITY.yml)
|
||||
|
||||
---
|
||||
|
||||
*Modulo: MGN-020-ai-integration-vet*
|
||||
*Propagado desde: erp-core/MGN-020-ai-integration*
|
||||
*Adaptado para: Dominio veterinario*
|
||||
*Actualizado: 2026-01-13*
|
||||
59
docs/05-fase-ia/MGN-020-ai-integration/_MAP.md
Normal file
59
docs/05-fase-ia/MGN-020-ai-integration/_MAP.md
Normal file
@ -0,0 +1,59 @@
|
||||
# MGN-020: AI Integration - Mapa del Modulo
|
||||
|
||||
**Modulo:** MGN-020-ai-integration
|
||||
**Proyecto:** clinica-veterinaria
|
||||
**Fecha:** 2026-01-13
|
||||
|
||||
---
|
||||
|
||||
## Estructura
|
||||
|
||||
```
|
||||
MGN-020-ai-integration/
|
||||
├── README.md <- Vision general
|
||||
├── _MAP.md <- ESTE ARCHIVO
|
||||
├── requerimientos/
|
||||
│ └── INDICE-RF-AI.md <- Indice de requerimientos
|
||||
├── especificaciones/
|
||||
│ └── INDICE-ET-AI.md <- Indice de especificaciones
|
||||
├── historias-usuario/
|
||||
│ └── INDICE-US-AI.md <- Indice de historias
|
||||
└── implementacion/
|
||||
└── TRACEABILITY.yml <- Trazabilidad
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Capacidades del Asistente Veterinario
|
||||
|
||||
| Capacidad | Descripcion |
|
||||
|-----------|-------------|
|
||||
| Calendario vacunacion | Informar vacunas por especie y edad |
|
||||
| Triaje basico | Evaluar urgencia de sintomas |
|
||||
| Cuidados generales | Orientacion sobre alimentacion, higiene |
|
||||
| Gestion de citas | Agendar consultas via IA |
|
||||
| Emergencias | Detectar y derivar casos urgentes |
|
||||
|
||||
---
|
||||
|
||||
## Especies Soportadas
|
||||
|
||||
| Especie | Nivel |
|
||||
|---------|-------|
|
||||
| Caninos | Avanzado |
|
||||
| Felinos | Avanzado |
|
||||
| Aves | Intermedio |
|
||||
| Exoticos | Basico |
|
||||
|
||||
---
|
||||
|
||||
## Navegacion
|
||||
|
||||
| Destino | Enlace |
|
||||
|---------|--------|
|
||||
| Fase | [05-fase-ia](../) |
|
||||
| Siguiente modulo | [MGN-021-whatsapp-business](../MGN-021-whatsapp-business/) |
|
||||
|
||||
---
|
||||
|
||||
*Mapa generado: 2026-01-13*
|
||||
281
docs/05-fase-ia/MGN-021-whatsapp-business/README.md
Normal file
281
docs/05-fase-ia/MGN-021-whatsapp-business/README.md
Normal file
@ -0,0 +1,281 @@
|
||||
---
|
||||
id: MGN-021-whatsapp-vet
|
||||
title: Modulo WhatsApp Business para Clinicas Veterinarias
|
||||
type: Module
|
||||
status: Draft
|
||||
priority: P1
|
||||
phase: 05-fase-ia
|
||||
version: 1.0.0
|
||||
created_date: 2026-01-13
|
||||
updated_date: 2026-01-13
|
||||
---
|
||||
|
||||
# MGN-021: WhatsApp Business para Clinicas Veterinarias
|
||||
|
||||
> Comunicacion inteligente con propietarios de mascotas via WhatsApp
|
||||
|
||||
## Resumen Ejecutivo
|
||||
|
||||
El modulo WhatsApp Business permite a las clinicas veterinarias comunicarse con los propietarios de mascotas a traves de WhatsApp, procesando mensajes con IA para proporcionar respuestas sobre vacunacion, citas, y cuidados de mascotas.
|
||||
|
||||
---
|
||||
|
||||
## Normativas Aplicables
|
||||
|
||||
- **NOM-064-ZOO-2000**: No prescribir medicamentos via WhatsApp
|
||||
- **SENASICA**: Recordatorios de vacunacion oficial
|
||||
- **LFPDPPP**: Proteccion de datos personales de propietarios
|
||||
|
||||
---
|
||||
|
||||
## 1. Objetivos del Modulo
|
||||
|
||||
### 1.1 Objetivos Principales
|
||||
|
||||
- **Recordatorios de vacunacion**: Notificar proximas vacunas pendientes
|
||||
- **Confirmacion de citas**: Confirmar asistencia a consultas
|
||||
- **Consultas rapidas**: Responder dudas sobre cuidados basicos
|
||||
- **Instrucciones post-operatorias**: Enviar cuidados despues de cirugias
|
||||
- **Resultados de laboratorio**: Notificar cuando esten listos
|
||||
|
||||
### 1.2 Objetivos Secundarios
|
||||
|
||||
- Soporte multi-mascota por propietario
|
||||
- Templates aprobados por Meta
|
||||
- Trazabilidad de conversaciones
|
||||
- Metricas de engagement
|
||||
|
||||
---
|
||||
|
||||
## 2. Templates de WhatsApp Veterinarios
|
||||
|
||||
### 2.1 recordatorio_vacuna
|
||||
|
||||
```
|
||||
Hola {{nombre_propietario}}! 🐾
|
||||
|
||||
Te recordamos que {{nombre_mascota}} tiene pendiente su vacuna de {{tipo_vacuna}}.
|
||||
|
||||
Ultima aplicacion: {{fecha_ultima}}
|
||||
Fecha recomendada: {{fecha_proxima}}
|
||||
|
||||
¿Te agendamos una cita?
|
||||
Responde "SI" para agendar o "LLAMAR" para que te contactemos.
|
||||
|
||||
Clinica Veterinaria {{nombre_clinica}}
|
||||
📞 {{telefono}}
|
||||
```
|
||||
|
||||
### 2.2 confirmacion_cita_veterinaria
|
||||
|
||||
```
|
||||
Hola {{nombre_propietario}}! 📅
|
||||
|
||||
Confirmamos tu cita en Clinica {{nombre_clinica}}:
|
||||
|
||||
🐾 Mascota: {{nombre_mascota}}
|
||||
📅 Fecha: {{fecha_cita}}
|
||||
🕐 Hora: {{hora_cita}}
|
||||
👨⚕️ Veterinario: {{nombre_veterinario}}
|
||||
📍 Direccion: {{direccion}}
|
||||
|
||||
Responde "CONFIRMAR" para confirmar o "CAMBIAR" para reagendar.
|
||||
|
||||
¡Te esperamos!
|
||||
```
|
||||
|
||||
### 2.3 instrucciones_cuidado
|
||||
|
||||
```
|
||||
Hola {{nombre_propietario}}! 🏥
|
||||
|
||||
Instrucciones de cuidado post-{{tipo_procedimiento}} para {{nombre_mascota}}:
|
||||
|
||||
{{instrucciones_detalladas}}
|
||||
|
||||
⚠️ Senales de alerta (llama inmediatamente si notas):
|
||||
{{senales_alerta}}
|
||||
|
||||
📞 Emergencias: {{telefono_emergencia}}
|
||||
|
||||
¿Tienes alguna duda? Responde este mensaje.
|
||||
```
|
||||
|
||||
### 2.4 alerta_desparasitacion
|
||||
|
||||
```
|
||||
Hola {{nombre_propietario}}! 🐛
|
||||
|
||||
{{nombre_mascota}} necesita su desparasitacion de rutina.
|
||||
|
||||
Ultima desparasitacion: {{fecha_ultima}}
|
||||
Proxima recomendada: {{fecha_proxima}}
|
||||
|
||||
La desparasitacion regular protege a tu mascota de parasitos internos y externos.
|
||||
|
||||
¿Agendamos una cita? Responde "SI"
|
||||
|
||||
Clinica {{nombre_clinica}}
|
||||
```
|
||||
|
||||
### 2.5 resultados_laboratorio
|
||||
|
||||
```
|
||||
Hola {{nombre_propietario}}! 🔬
|
||||
|
||||
Los resultados del laboratorio de {{nombre_mascota}} ya estan listos.
|
||||
|
||||
Estudio: {{tipo_estudio}}
|
||||
Fecha de toma: {{fecha_muestra}}
|
||||
|
||||
Para revisar los resultados, puedes:
|
||||
1. Agendar cita con el veterinario
|
||||
2. Solicitar envio por correo electronico
|
||||
|
||||
Responde "CITA" o "CORREO"
|
||||
|
||||
Clinica {{nombre_clinica}}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 3. Flujo de Mensaje Completo
|
||||
|
||||
```
|
||||
+----------+ +----------+ +---------------+ +------------+
|
||||
|Propietario|---->| WhatsApp |---->| Meta API |---->| Webhook |
|
||||
| (movil) | | (app) | | (Cloud API) | | (Backend) |
|
||||
+----------+ +----------+ +---------------+ +------------+
|
||||
|
|
||||
v
|
||||
+------------------+
|
||||
| WhatsApp Service |
|
||||
| 1. Identificar |
|
||||
| propietario |
|
||||
| 2. Cargar |
|
||||
| mascotas |
|
||||
+------------------+
|
||||
|
|
||||
v
|
||||
+------------------+
|
||||
| AI Veterinaria |
|
||||
| 1. System prompt |
|
||||
| veterinario |
|
||||
| 2. Contexto |
|
||||
| mascotas |
|
||||
+------------------+
|
||||
|
|
||||
v
|
||||
+------------------+
|
||||
| MCP Tools |
|
||||
| - historial |
|
||||
| - vacunas |
|
||||
| - citas |
|
||||
+------------------+
|
||||
|
|
||||
v
|
||||
+------------------+
|
||||
| Respuesta |
|
||||
| Veterinaria |
|
||||
+------------------+
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 4. Integracion con MCP Tools
|
||||
|
||||
### Herramientas Disponibles para WhatsApp
|
||||
|
||||
| Tool | Descripcion | Ejemplo de Uso |
|
||||
|------|-------------|----------------|
|
||||
| `consultar_historial_mascota` | Expediente clinico | "¿Que tiene Max registrado?" |
|
||||
| `registrar_vacuna` | Registrar vacuna | (Solo por staff, no propietario) |
|
||||
| `agendar_consulta` | Programar cita | "Quiero agendar cita para Luna" |
|
||||
| `consultar_cartilla_vacunacion` | Ver vacunas | "¿Que vacunas tiene mi gato?" |
|
||||
| `verificar_desparasitacion` | Estado desparasitacion | "¿Cuando toca desparasitar?" |
|
||||
|
||||
---
|
||||
|
||||
## 5. System Prompt para WhatsApp Veterinario
|
||||
|
||||
```
|
||||
Eres el asistente de WhatsApp de {{CLINICA_NAME}}, clinica veterinaria.
|
||||
|
||||
El propietario {{PROPIETARIO_NOMBRE}} tiene las siguientes mascotas registradas:
|
||||
{{LISTA_MASCOTAS}}
|
||||
|
||||
PUEDES:
|
||||
- Informar sobre vacunas pendientes
|
||||
- Agendar citas
|
||||
- Dar instrucciones de cuidado basico
|
||||
- Consultar el expediente de sus mascotas
|
||||
- Responder sobre horarios y servicios
|
||||
|
||||
NO PUEDES:
|
||||
- Diagnosticar enfermedades
|
||||
- Prescribir medicamentos
|
||||
- Dar consejos medicos especificos
|
||||
|
||||
ESTILO:
|
||||
- Espanol mexicano, amigable
|
||||
- Usa emojis moderadamente (🐾 🐶 🐱 📅 💉)
|
||||
- Respuestas cortas y claras
|
||||
- Si no sabes algo, ofrece contactar al veterinario
|
||||
|
||||
EMERGENCIAS:
|
||||
Si el propietario describe una emergencia, responde:
|
||||
"🚨 Esto suena como una emergencia. Por favor llama inmediatamente al {{TELEFONO_EMERGENCIA}} o acude a la clinica."
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 6. Disponibilidad por Plan
|
||||
|
||||
| Plan | WhatsApp | Mensajes/mes | Templates |
|
||||
|------|----------|--------------|-----------|
|
||||
| Basico | No | - | - |
|
||||
| Profesional | Si | 1,000 | Basicos |
|
||||
| Clinica | Si | 5,000 | Todos |
|
||||
| Hospital | Si | Ilimitados | Todos + Custom |
|
||||
|
||||
---
|
||||
|
||||
## 7. Metricas de Exito
|
||||
|
||||
| Metrica | Target | Medicion |
|
||||
|---------|--------|----------|
|
||||
| Tasa de respuesta | > 90% | Mensajes respondidos < 5 min |
|
||||
| Confirmacion citas | > 70% | Citas confirmadas via WhatsApp |
|
||||
| Satisfaccion | > 4.0/5.0 | Encuestas post-interaccion |
|
||||
| Costo por mensaje | < $0.10 MXN | Costo Meta + IA |
|
||||
|
||||
---
|
||||
|
||||
## Dependencias
|
||||
|
||||
### Internas
|
||||
|
||||
- `MGN-020-ai-integration` - Procesamiento con IA
|
||||
- `MGN-022-mcp-server` - Herramientas veterinarias
|
||||
- `MGN-017-plans` - Limites por plan
|
||||
|
||||
### Externas
|
||||
|
||||
- Meta Cloud API (WhatsApp Business)
|
||||
- OpenRouter (Gateway LLM)
|
||||
|
||||
---
|
||||
|
||||
## Indices
|
||||
|
||||
- [Requerimientos](./requerimientos/INDICE-RF-WHATSAPP.md)
|
||||
- [Especificaciones](./especificaciones/INDICE-ET-WHATSAPP.md)
|
||||
- [Historias de Usuario](./historias-usuario/INDICE-US-WHATSAPP.md)
|
||||
- [Trazabilidad](./implementacion/TRACEABILITY.yml)
|
||||
|
||||
---
|
||||
|
||||
*Modulo: MGN-021-whatsapp-business-vet*
|
||||
*Propagado desde: erp-core/MGN-021-whatsapp-business*
|
||||
*Adaptado para: Dominio veterinario*
|
||||
*Creado: 2026-01-13*
|
||||
49
docs/05-fase-ia/MGN-021-whatsapp-business/_MAP.md
Normal file
49
docs/05-fase-ia/MGN-021-whatsapp-business/_MAP.md
Normal file
@ -0,0 +1,49 @@
|
||||
# MGN-021: WhatsApp Business - Mapa del Modulo
|
||||
|
||||
**Modulo:** MGN-021-whatsapp-business
|
||||
**Proyecto:** clinica-veterinaria
|
||||
**Fecha:** 2026-01-13
|
||||
|
||||
---
|
||||
|
||||
## Estructura
|
||||
|
||||
```
|
||||
MGN-021-whatsapp-business/
|
||||
├── README.md <- Vision general
|
||||
├── _MAP.md <- ESTE ARCHIVO
|
||||
├── requerimientos/
|
||||
│ └── INDICE-RF-WHATSAPP.md <- Indice de requerimientos
|
||||
├── especificaciones/
|
||||
│ └── INDICE-ET-WHATSAPP.md <- Indice de especificaciones
|
||||
├── historias-usuario/
|
||||
│ └── INDICE-US-WHATSAPP.md <- Indice de historias
|
||||
└── implementacion/
|
||||
└── TRACEABILITY.yml <- Trazabilidad
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Templates Veterinarios
|
||||
|
||||
| Template | Proposito |
|
||||
|----------|-----------|
|
||||
| `recordatorio_vacuna` | Notificar vacunas pendientes |
|
||||
| `confirmacion_cita_veterinaria` | Confirmar citas |
|
||||
| `instrucciones_cuidado` | Cuidados post-operatorios |
|
||||
| `alerta_desparasitacion` | Recordatorio desparasitacion |
|
||||
| `resultados_laboratorio` | Notificar resultados |
|
||||
|
||||
---
|
||||
|
||||
## Navegacion
|
||||
|
||||
| Destino | Enlace |
|
||||
|---------|--------|
|
||||
| Fase | [05-fase-ia](../) |
|
||||
| Modulo anterior | [MGN-020-ai-integration](../MGN-020-ai-integration/) |
|
||||
| Siguiente modulo | [MGN-022-mcp-server](../MGN-022-mcp-server/) |
|
||||
|
||||
---
|
||||
|
||||
*Mapa generado: 2026-01-13*
|
||||
275
docs/05-fase-ia/MGN-022-mcp-server/README.md
Normal file
275
docs/05-fase-ia/MGN-022-mcp-server/README.md
Normal file
@ -0,0 +1,275 @@
|
||||
# MGN-022: MCP Server Veterinario
|
||||
|
||||
**Modulo:** MGN-022
|
||||
**Nombre:** MCP Server para Clinicas Veterinarias
|
||||
**Fase:** 05 - Inteligencia Artificial
|
||||
**Estado:** Draft
|
||||
**Ultima actualizacion:** 2026-01-13
|
||||
|
||||
---
|
||||
|
||||
## Descripcion
|
||||
|
||||
Servidor MCP (Model Context Protocol) especializado para clinicas veterinarias. Expone herramientas de negocio veterinario a los modelos de lenguaje, permitiendo que el asistente IA interactue con expedientes de mascotas, cartillas de vacunacion, citas y hospitalizaciones.
|
||||
|
||||
---
|
||||
|
||||
## Normativas Aplicables
|
||||
|
||||
- **NOM-064-ZOO-2000**: Trazabilidad de medicamentos y vacunas
|
||||
- **SENASICA**: Registro oficial de vacunacion
|
||||
- **Bienestar Animal**: Registro de condiciones de pacientes
|
||||
|
||||
---
|
||||
|
||||
## Herramientas MCP Veterinarias
|
||||
|
||||
### Mascotas Tools (4 herramientas)
|
||||
|
||||
| Tool | Descripcion | Parametros |
|
||||
|------|-------------|------------|
|
||||
| `consultar_historial_mascota` | Expediente clinico completo | mascota_id |
|
||||
| `buscar_mascota` | Buscar por nombre o propietario | query, propietario_id? |
|
||||
| `obtener_signos_vitales` | Ultimos signos vitales | mascota_id |
|
||||
| `listar_mascotas_propietario` | Mascotas de un propietario | propietario_id |
|
||||
|
||||
### Vacunacion Tools (4 herramientas)
|
||||
|
||||
| Tool | Descripcion | Parametros |
|
||||
|------|-------------|------------|
|
||||
| `consultar_cartilla_vacunacion` | Historial de vacunas | mascota_id |
|
||||
| `registrar_vacuna` | Registrar aplicacion | mascota_id, vacuna_id, lote, veterinario_id |
|
||||
| `vacunas_pendientes` | Vacunas proximas | mascota_id, dias_anticipacion? |
|
||||
| `esquema_vacunacion_especie` | Esquema por especie | especie, edad_meses? |
|
||||
|
||||
### Desparasitacion Tools (3 herramientas)
|
||||
|
||||
| Tool | Descripcion | Parametros |
|
||||
|------|-------------|------------|
|
||||
| `verificar_desparasitacion` | Estado actual | mascota_id |
|
||||
| `registrar_desparasitacion` | Registrar aplicacion | mascota_id, producto_id, dosis |
|
||||
| `proxima_desparasitacion` | Fecha recomendada | mascota_id |
|
||||
|
||||
### Citas Tools (4 herramientas)
|
||||
|
||||
| Tool | Descripcion | Parametros |
|
||||
|------|-------------|------------|
|
||||
| `agendar_consulta` | Programar cita | mascota_id, fecha, hora, motivo, veterinario_id? |
|
||||
| `consultar_citas` | Citas del dia/semana | fecha_inicio, fecha_fin?, veterinario_id? |
|
||||
| `confirmar_cita` | Confirmar asistencia | cita_id |
|
||||
| `cancelar_cita` | Cancelar cita | cita_id, motivo? |
|
||||
|
||||
### Hospitalizacion Tools (4 herramientas)
|
||||
|
||||
| Tool | Descripcion | Parametros |
|
||||
|------|-------------|------------|
|
||||
| `consultar_hospitalizacion` | Estado de internado | mascota_id |
|
||||
| `registrar_evolucion` | Agregar nota de evolucion | hospitalizacion_id, notas, signos_vitales? |
|
||||
| `pacientes_internados` | Lista de hospitalizados | area? |
|
||||
| `alta_hospitalizacion` | Dar de alta | hospitalizacion_id, instrucciones |
|
||||
|
||||
### Laboratorio Tools (3 herramientas)
|
||||
|
||||
| Tool | Descripcion | Parametros |
|
||||
|------|-------------|------------|
|
||||
| `solicitar_estudio` | Ordenar estudio de lab | mascota_id, tipo_estudio, notas? |
|
||||
| `resultados_laboratorio` | Consultar resultados | mascota_id, estudio_id? |
|
||||
| `estudios_pendientes` | Estudios sin resultado | mascota_id? |
|
||||
|
||||
---
|
||||
|
||||
## Recursos MCP Veterinarios
|
||||
|
||||
| URI | Descripcion | Retorna |
|
||||
|-----|-------------|---------|
|
||||
| `vet://config/clinica` | Configuracion de la clinica | nombre, direccion, telefono, horarios |
|
||||
| `vet://catalogo/vacunas` | Catalogo de vacunas | Array de vacunas por especie |
|
||||
| `vet://catalogo/especies` | Especies soportadas | Array de especies con razas |
|
||||
| `vet://calendario/vacunacion` | Calendario oficial | Esquemas por especie y edad |
|
||||
| `vet://hospitalizacion/resumen` | Resumen de internados | total, por_area, alertas |
|
||||
|
||||
---
|
||||
|
||||
## Endpoints API
|
||||
|
||||
| Metodo | Endpoint | Descripcion |
|
||||
|--------|----------|-------------|
|
||||
| POST | /api/v1/mcp/tools/call | Ejecutar herramienta |
|
||||
| GET | /api/v1/mcp/tools | Listar herramientas |
|
||||
| GET | /api/v1/mcp/tools/:name | Definicion de herramienta |
|
||||
| GET | /api/v1/mcp/resources | Listar recursos |
|
||||
| GET | /api/v1/mcp/resources/:uri | Obtener recurso |
|
||||
|
||||
---
|
||||
|
||||
## Ejemplos de Uso
|
||||
|
||||
### Consultar Cartilla de Vacunacion
|
||||
|
||||
```json
|
||||
// Request
|
||||
{
|
||||
"tool": "consultar_cartilla_vacunacion",
|
||||
"params": {
|
||||
"mascota_id": "pet-123"
|
||||
}
|
||||
}
|
||||
|
||||
// Response
|
||||
{
|
||||
"mascota": {
|
||||
"nombre": "Max",
|
||||
"especie": "canino",
|
||||
"raza": "Labrador",
|
||||
"edad": "2 anios"
|
||||
},
|
||||
"vacunas": [
|
||||
{
|
||||
"vacuna": "Cuadruple",
|
||||
"fecha_aplicacion": "2024-03-15",
|
||||
"lote": "LOT-2024-001",
|
||||
"veterinario": "Dr. Garcia",
|
||||
"proxima": "2025-03-15"
|
||||
},
|
||||
{
|
||||
"vacuna": "Rabia",
|
||||
"fecha_aplicacion": "2024-06-20",
|
||||
"lote": "RAB-2024-050",
|
||||
"veterinario": "Dr. Garcia",
|
||||
"proxima": "2025-06-20"
|
||||
}
|
||||
],
|
||||
"pendientes": [
|
||||
{
|
||||
"vacuna": "Bordetella",
|
||||
"recomendada_desde": "2024-09-15",
|
||||
"dias_vencida": 120
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
### Agendar Consulta
|
||||
|
||||
```json
|
||||
// Request
|
||||
{
|
||||
"tool": "agendar_consulta",
|
||||
"params": {
|
||||
"mascota_id": "pet-456",
|
||||
"fecha": "2026-01-15",
|
||||
"hora": "10:00",
|
||||
"motivo": "Vacunacion anual",
|
||||
"veterinario_id": "vet-001"
|
||||
}
|
||||
}
|
||||
|
||||
// Response
|
||||
{
|
||||
"cita": {
|
||||
"id": "cit-789",
|
||||
"mascota": "Luna",
|
||||
"propietario": "Maria Lopez",
|
||||
"fecha": "2026-01-15",
|
||||
"hora": "10:00",
|
||||
"veterinario": "Dra. Martinez",
|
||||
"motivo": "Vacunacion anual",
|
||||
"estado": "confirmada"
|
||||
},
|
||||
"mensaje": "Cita agendada exitosamente. Se enviara recordatorio por WhatsApp."
|
||||
}
|
||||
```
|
||||
|
||||
### Consultar Hospitalizacion
|
||||
|
||||
```json
|
||||
// Request
|
||||
{
|
||||
"tool": "consultar_hospitalizacion",
|
||||
"params": {
|
||||
"mascota_id": "pet-789"
|
||||
}
|
||||
}
|
||||
|
||||
// Response
|
||||
{
|
||||
"hospitalizacion": {
|
||||
"id": "hosp-001",
|
||||
"mascota": "Rocky",
|
||||
"especie": "canino",
|
||||
"ingreso": "2026-01-12T14:00:00Z",
|
||||
"motivo": "Cirugia de rodilla",
|
||||
"estado": "estable",
|
||||
"area": "Post-quirurgico",
|
||||
"veterinario_responsable": "Dr. Hernandez"
|
||||
},
|
||||
"ultima_evolucion": {
|
||||
"fecha": "2026-01-13T08:00:00Z",
|
||||
"notas": "Paciente alerta, comiendo bien. Herida sin signos de infeccion.",
|
||||
"signos_vitales": {
|
||||
"temperatura": 38.5,
|
||||
"frecuencia_cardiaca": 90,
|
||||
"frecuencia_respiratoria": 20
|
||||
}
|
||||
},
|
||||
"dias_internado": 1,
|
||||
"alta_estimada": "2026-01-14"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Arquitectura
|
||||
|
||||
```
|
||||
+-------------------+ +-------------------+ +-------------------+
|
||||
| AI Veterinaria |---->| MCP Controller |---->| Tool Services |
|
||||
| (Claude/GPT) | | (validacion) | | (veterinarios) |
|
||||
+-------------------+ +-------------------+ +-------------------+
|
||||
| |
|
||||
v v
|
||||
+-------------+ +---------------+
|
||||
| Tool Logger | | Backend Vet |
|
||||
| (auditoria) | | (services) |
|
||||
+-------------+ +---------------+
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Seguridad
|
||||
|
||||
- Autenticacion JWT requerida
|
||||
- Aislamiento por clinica (RLS)
|
||||
- Logging de todas las llamadas
|
||||
- Validacion de permisos por herramienta
|
||||
- Rate limiting por plan
|
||||
- Datos sensibles de mascotas protegidos
|
||||
|
||||
---
|
||||
|
||||
## Dependencias
|
||||
|
||||
**Este modulo depende de:**
|
||||
- MGN-001 Auth (autenticacion, tenant_id)
|
||||
- MGN-017 Plans (rate limiting por plan)
|
||||
- Modulos veterinarios (mascotas, vacunacion, citas, hospitalizacion)
|
||||
|
||||
**Modulos que dependen de este:**
|
||||
- MGN-020 AI Integration (usa las tools)
|
||||
- MGN-021 WhatsApp Business (usa las tools)
|
||||
|
||||
---
|
||||
|
||||
## Indices
|
||||
|
||||
- [Requerimientos](./requerimientos/INDICE-RF-MCP.md)
|
||||
- [Especificaciones](./especificaciones/INDICE-ET-MCP.md)
|
||||
- [Historias de Usuario](./historias-usuario/INDICE-US-MCP.md)
|
||||
- [Trazabilidad](./implementacion/TRACEABILITY.yml)
|
||||
|
||||
---
|
||||
|
||||
*Modulo: MGN-022-mcp-server-vet*
|
||||
*Propagado desde: erp-core/MGN-022-mcp-server*
|
||||
*Adaptado para: Dominio veterinario*
|
||||
*Fecha: 2026-01-13*
|
||||
63
docs/05-fase-ia/MGN-022-mcp-server/_MAP.md
Normal file
63
docs/05-fase-ia/MGN-022-mcp-server/_MAP.md
Normal file
@ -0,0 +1,63 @@
|
||||
# MGN-022: MCP Server - Mapa del Modulo
|
||||
|
||||
**Modulo:** MGN-022-mcp-server
|
||||
**Proyecto:** clinica-veterinaria
|
||||
**Fecha:** 2026-01-13
|
||||
|
||||
---
|
||||
|
||||
## Estructura
|
||||
|
||||
```
|
||||
MGN-022-mcp-server/
|
||||
├── README.md <- Vision general
|
||||
├── _MAP.md <- ESTE ARCHIVO
|
||||
├── requerimientos/
|
||||
│ └── INDICE-RF-MCP.md <- Indice de requerimientos
|
||||
├── especificaciones/
|
||||
│ └── INDICE-ET-MCP.md <- Indice de especificaciones
|
||||
├── historias-usuario/
|
||||
│ └── INDICE-US-MCP.md <- Indice de historias
|
||||
└── implementacion/
|
||||
└── TRACEABILITY.yml <- Trazabilidad
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Herramientas MCP Veterinarias
|
||||
|
||||
| Categoria | Tools | Descripcion |
|
||||
|-----------|-------|-------------|
|
||||
| Mascotas | 4 | Expediente, busqueda, signos vitales |
|
||||
| Vacunacion | 4 | Cartilla, registro, pendientes |
|
||||
| Desparasitacion | 3 | Estado, registro, proxima |
|
||||
| Citas | 4 | Agendar, consultar, confirmar |
|
||||
| Hospitalizacion | 4 | Estado, evolucion, alta |
|
||||
| Laboratorio | 3 | Solicitar, resultados |
|
||||
|
||||
**Total: 22 herramientas veterinarias**
|
||||
|
||||
---
|
||||
|
||||
## Recursos MCP
|
||||
|
||||
| URI | Descripcion |
|
||||
|-----|-------------|
|
||||
| `vet://config/clinica` | Configuracion |
|
||||
| `vet://catalogo/vacunas` | Vacunas disponibles |
|
||||
| `vet://catalogo/especies` | Especies soportadas |
|
||||
| `vet://calendario/vacunacion` | Calendario oficial |
|
||||
|
||||
---
|
||||
|
||||
## Navegacion
|
||||
|
||||
| Destino | Enlace |
|
||||
|---------|--------|
|
||||
| Fase | [05-fase-ia](../) |
|
||||
| Modulo anterior | [MGN-021-whatsapp-business](../MGN-021-whatsapp-business/) |
|
||||
| Mapa principal | [docs/_MAP.md](../../_MAP.md) |
|
||||
|
||||
---
|
||||
|
||||
*Mapa generado: 2026-01-13*
|
||||
103
docs/05-fase-ia/README.md
Normal file
103
docs/05-fase-ia/README.md
Normal file
@ -0,0 +1,103 @@
|
||||
# Fase 05: Inteligencia Artificial - Clinica Veterinaria
|
||||
|
||||
**Proyecto:** clinica-veterinaria
|
||||
**Fase:** 05 - IA
|
||||
**Tipo:** SUB-CONSUMER (hereda de erp-clinicas -> erp-core)
|
||||
**Fecha:** 2026-01-13
|
||||
**Version:** 1.0.0
|
||||
|
||||
---
|
||||
|
||||
## Descripcion
|
||||
|
||||
Esta fase implementa las capacidades de Inteligencia Artificial para la clinica veterinaria, incluyendo un asistente veterinario inteligente, integracion con WhatsApp Business y un servidor MCP con herramientas especializadas para el dominio veterinario.
|
||||
|
||||
## Normativas Aplicables
|
||||
|
||||
- **NOM-064-ZOO-2000**: Lineamientos para la clasificacion y prescripcion de productos farmaceuticos veterinarios
|
||||
- **SENASICA**: Servicio Nacional de Sanidad, Inocuidad y Calidad Agroalimentaria
|
||||
- **Ley Federal de Sanidad Animal**: Regulaciones de bienestar animal
|
||||
|
||||
## Modulos de esta Fase
|
||||
|
||||
| Modulo | Nombre | Descripcion | Estado |
|
||||
|--------|--------|-------------|--------|
|
||||
| MGN-020 | [AI Integration](./MGN-020-ai-integration/) | Gateway LLM para asistente veterinario | Draft |
|
||||
| MGN-021 | [WhatsApp Business](./MGN-021-whatsapp-business/) | Comunicacion con propietarios de mascotas | Draft |
|
||||
| MGN-022 | [MCP Server](./MGN-022-mcp-server/) | Herramientas MCP para dominio veterinario | Draft |
|
||||
|
||||
## Capacidades de IA para Veterinaria
|
||||
|
||||
### Asistente Veterinario
|
||||
|
||||
El asistente de IA esta entrenado para:
|
||||
|
||||
- **Consultas de salud**: Orientar a propietarios sobre sintomas y urgencia
|
||||
- **Calendario de vacunacion**: Informar sobre vacunas por especie y raza
|
||||
- **Citas**: Agendar, confirmar y recordar citas
|
||||
- **Cartilla de vacunacion**: Consultar historial de vacunas
|
||||
- **Desparasitacion**: Informar sobre calendario de desparasitacion
|
||||
- **Cuidados post-operatorios**: Instrucciones segun procedimiento
|
||||
- **Nutricion**: Recomendaciones alimenticias por especie/raza/edad
|
||||
|
||||
### Especies Soportadas
|
||||
|
||||
| Especie | Conocimiento IA | Nivel |
|
||||
|---------|-----------------|-------|
|
||||
| Caninos | Razas, vacunas, enfermedades comunes | Avanzado |
|
||||
| Felinos | Razas, vacunas, enfermedades comunes | Avanzado |
|
||||
| Aves | Especies domesticas comunes | Intermedio |
|
||||
| Exoticos | Reptiles, roedores, hurones | Basico |
|
||||
| Fauna silvestre | Derivacion a especialista | Referencia |
|
||||
|
||||
## Integraciones
|
||||
|
||||
### WhatsApp Business
|
||||
|
||||
Comunicacion bidireccional con propietarios:
|
||||
|
||||
- Recordatorios de vacunacion
|
||||
- Confirmacion de citas
|
||||
- Instrucciones de cuidado
|
||||
- Consultas rapidas sobre sintomas
|
||||
- Resultados de laboratorio
|
||||
|
||||
### MCP Tools Veterinarias
|
||||
|
||||
Herramientas especializadas para el dominio:
|
||||
|
||||
- `consultar_historial_mascota`: Expediente clinico completo
|
||||
- `registrar_vacuna`: Registro de aplicacion de vacunas
|
||||
- `agendar_consulta`: Programacion de citas
|
||||
- `consultar_cartilla_vacunacion`: Historial de vacunacion
|
||||
- `verificar_desparasitacion`: Estado de desparasitacion
|
||||
- `consultar_hospitalizacion`: Estado de pacientes internados
|
||||
|
||||
## Consideraciones de Bienestar Animal
|
||||
|
||||
La IA debe:
|
||||
|
||||
1. Priorizar la salud y bienestar del animal
|
||||
2. Recomendar atencion veterinaria presencial cuando sea necesario
|
||||
3. No diagnosticar ni prescribir medicamentos
|
||||
4. Alertar sobre situaciones de emergencia
|
||||
5. Cumplir con normativas SENASICA y NOM-064-ZOO-2000
|
||||
|
||||
## Dependencias
|
||||
|
||||
- **MGN-016-billing**: Limites de uso de IA por plan
|
||||
- **MGN-017-plans**: Features de IA por plan
|
||||
- **erp-clinicas**: Modulos de gestion clinica
|
||||
- **erp-core**: Infraestructura IA base
|
||||
|
||||
## Navegacion
|
||||
|
||||
- [Indice de Fase](./_MAP.md)
|
||||
- [Fase 04 - SaaS](../04-fase-saas/)
|
||||
- [Mapa Principal](../_MAP.md)
|
||||
|
||||
---
|
||||
|
||||
*Propagado desde erp-core via erp-clinicas*
|
||||
*Adaptado para dominio veterinario*
|
||||
*Version: 1.0.0 | Fecha: 2026-01-13*
|
||||
131
docs/05-fase-ia/_MAP.md
Normal file
131
docs/05-fase-ia/_MAP.md
Normal file
@ -0,0 +1,131 @@
|
||||
# Fase 05: Inteligencia Artificial - Mapa de Navegacion
|
||||
|
||||
**Fase:** 05-fase-ia
|
||||
**Proyecto:** clinica-veterinaria
|
||||
**Fecha:** 2026-01-13
|
||||
|
||||
---
|
||||
|
||||
## Estructura de la Fase
|
||||
|
||||
```
|
||||
05-fase-ia/
|
||||
├── README.md <- Descripcion de la fase
|
||||
├── _MAP.md <- ESTE ARCHIVO
|
||||
│
|
||||
├── MGN-020-ai-integration/ <- Gateway LLM
|
||||
│ ├── README.md <- Descripcion del modulo
|
||||
│ ├── _MAP.md <- Indice del modulo
|
||||
│ ├── requerimientos/ <- RFs del modulo
|
||||
│ ├── especificaciones/ <- ETs del modulo
|
||||
│ ├── historias-usuario/ <- USs del modulo
|
||||
│ └── implementacion/ <- Trazabilidad
|
||||
│
|
||||
├── MGN-021-whatsapp-business/ <- WhatsApp con IA
|
||||
│ └── ...
|
||||
│
|
||||
└── MGN-022-mcp-server/ <- Servidor MCP
|
||||
└── ...
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Modulos de la Fase
|
||||
|
||||
### MGN-020: AI Integration - Asistente Veterinario
|
||||
|
||||
Gateway LLM multi-proveedor con conocimiento veterinario especializado.
|
||||
|
||||
| Documento | Tipo | Descripcion |
|
||||
|-----------|------|-------------|
|
||||
| [README.md](./MGN-020-ai-integration/README.md) | Overview | Vision general del modulo |
|
||||
| [_MAP.md](./MGN-020-ai-integration/_MAP.md) | Indice | Navegacion del modulo |
|
||||
|
||||
**Capacidades veterinarias:**
|
||||
- Conocimiento de especies y razas
|
||||
- Calendario de vacunacion por especie
|
||||
- Sintomas comunes y nivel de urgencia
|
||||
- Cuidados post-operatorios
|
||||
|
||||
---
|
||||
|
||||
### MGN-021: WhatsApp Business - Comunicacion con Propietarios
|
||||
|
||||
Integracion WhatsApp para comunicacion con duenos de mascotas.
|
||||
|
||||
| Documento | Tipo | Descripcion |
|
||||
|-----------|------|-------------|
|
||||
| [README.md](./MGN-021-whatsapp-business/README.md) | Overview | Vision general del modulo |
|
||||
| [_MAP.md](./MGN-021-whatsapp-business/_MAP.md) | Indice | Navegacion del modulo |
|
||||
|
||||
**Templates veterinarios:**
|
||||
- `recordatorio_vacuna`: Proxima vacuna pendiente
|
||||
- `confirmacion_cita_veterinaria`: Confirmar asistencia
|
||||
- `instrucciones_cuidado`: Post-operatorio y tratamientos
|
||||
- `alerta_desparasitacion`: Recordatorio de desparasitacion
|
||||
- `resultados_laboratorio`: Notificacion de resultados
|
||||
|
||||
---
|
||||
|
||||
### MGN-022: MCP Server - Herramientas Veterinarias
|
||||
|
||||
Servidor MCP con herramientas especializadas para el dominio veterinario.
|
||||
|
||||
| Documento | Tipo | Descripcion |
|
||||
|-----------|------|-------------|
|
||||
| [README.md](./MGN-022-mcp-server/README.md) | Overview | Vision general del modulo |
|
||||
| [_MAP.md](./MGN-022-mcp-server/_MAP.md) | Indice | Navegacion del modulo |
|
||||
|
||||
**Herramientas MCP:**
|
||||
- `consultar_historial_mascota`
|
||||
- `registrar_vacuna`
|
||||
- `agendar_consulta`
|
||||
- `consultar_cartilla_vacunacion`
|
||||
- `verificar_desparasitacion`
|
||||
- `consultar_hospitalizacion`
|
||||
|
||||
---
|
||||
|
||||
## Flujo de Interaccion IA
|
||||
|
||||
```
|
||||
Propietario (WhatsApp)
|
||||
|
|
||||
v
|
||||
+------------------+
|
||||
| WhatsApp Business|
|
||||
| (MGN-021) |
|
||||
+------------------+
|
||||
|
|
||||
v
|
||||
+------------------+
|
||||
| AI Integration |
|
||||
| (MGN-020) |
|
||||
+------------------+
|
||||
|
|
||||
v
|
||||
+------------------+
|
||||
| MCP Server |
|
||||
| (MGN-022) |
|
||||
+------------------+
|
||||
|
|
||||
v
|
||||
+------------------+
|
||||
| Backend |
|
||||
| Veterinario |
|
||||
+------------------+
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Navegacion
|
||||
|
||||
| Destino | Enlace |
|
||||
|---------|--------|
|
||||
| Fase anterior | [04-fase-saas](../04-fase-saas/) |
|
||||
| Mapa principal | [docs/_MAP.md](../_MAP.md) |
|
||||
|
||||
---
|
||||
|
||||
*Mapa generado: 2026-01-13*
|
||||
*Propagado desde: erp-core/docs/05-fase-ia*
|
||||
95
docs/_MAP.md
95
docs/_MAP.md
@ -1,9 +1,9 @@
|
||||
# Clinica Veterinaria - Mapa de Documentacion
|
||||
|
||||
**Proyecto:** clinica-veterinaria
|
||||
**Tipo:** ERP Especializado (hereda de erp-clinicas)
|
||||
**Fecha:** 2026-01-07
|
||||
**Estado:** Fase 0 - Preparacion
|
||||
**Tipo:** ERP Especializado (hereda de erp-clinicas -> erp-core)
|
||||
**Fecha:** 2026-01-13
|
||||
**Estado:** Documentacion SaaS e IA propagada
|
||||
|
||||
---
|
||||
|
||||
@ -14,21 +14,31 @@ docs/
|
||||
├── _MAP.md <- ESTE ARCHIVO
|
||||
├── 00-vision-general/
|
||||
│ ├── README.md <- Indice de vision
|
||||
│ └── VISION.md <- Vision estrategica [PENDIENTE]
|
||||
│ └── VISION.md <- Vision estrategica
|
||||
│
|
||||
├── 01-epicas/
|
||||
│ └── VET-XXX-*.md <- Epicas veterinarias
|
||||
│
|
||||
├── 02-definicion-modulos/
|
||||
│ ├── _MAP.md <- Indice de modulos [PENDIENTE]
|
||||
│ ├── modulo-mascotas.md <- Registro de pacientes [PENDIENTE]
|
||||
│ ├── modulo-propietarios.md <- Duenos de mascotas [PENDIENTE]
|
||||
│ ├── modulo-vacunacion.md <- Cartilla de vacunas [PENDIENTE]
|
||||
│ ├── modulo-hospitalizacion.md <- Internamiento [PENDIENTE]
|
||||
│ ├── modulo-farmacia.md <- Medicamentos [PENDIENTE]
|
||||
│ ├── modulo-estetica.md <- Grooming [PENDIENTE]
|
||||
│ ├── modulo-laboratorio.md <- Analisis clinicos [PENDIENTE]
|
||||
│ └── modulo-cirugia.md <- Procedimientos [PENDIENTE]
|
||||
│ ├── _MAP.md <- Indice de modulos
|
||||
│ ├── modulo-mascotas.md <- Registro de pacientes
|
||||
│ ├── modulo-vacunacion.md <- Cartilla de vacunas
|
||||
│ └── ... <- Otros modulos veterinarios
|
||||
│
|
||||
├── 03-especificaciones/
|
||||
│ └── ... (futuras especificaciones tecnicas)
|
||||
├── 04-fase-saas/ <- [NUEVO] Modulos SaaS
|
||||
│ ├── README.md <- Vision de fase SaaS
|
||||
│ ├── _MAP.md <- Mapa de navegacion
|
||||
│ ├── MGN-016-billing/ <- Facturacion veterinaria
|
||||
│ ├── MGN-017-plans/ <- Planes para clinicas
|
||||
│ ├── MGN-018-webhooks/ <- Eventos veterinarios
|
||||
│ └── MGN-019-feature-flags/ <- Control de funcionalidades
|
||||
│
|
||||
├── 05-fase-ia/ <- [NUEVO] Modulos IA
|
||||
│ ├── README.md <- Vision de fase IA
|
||||
│ ├── _MAP.md <- Mapa de navegacion
|
||||
│ ├── MGN-020-ai-integration/ <- Asistente veterinario IA
|
||||
│ ├── MGN-021-whatsapp-business/ <- Comunicacion WhatsApp
|
||||
│ └── MGN-022-mcp-server/ <- Herramientas MCP veterinarias
|
||||
│
|
||||
└── 90-transversal/
|
||||
└── ... (documentacion transversal)
|
||||
@ -140,6 +150,43 @@ campos_principales:
|
||||
| SENASICA | Reportes de vacunacion | Pendiente |
|
||||
| Laboratorios | Resultados de analisis | Pendiente |
|
||||
| Proveedores | Pedidos de medicamentos | Pendiente |
|
||||
| WhatsApp Business | Comunicacion con propietarios | Documentado |
|
||||
| Stripe | Billing y suscripciones | Documentado |
|
||||
|
||||
---
|
||||
|
||||
## Fase 04: SaaS (Propagado desde erp-core)
|
||||
|
||||
Modulos de capacidades SaaS adaptados al dominio veterinario.
|
||||
|
||||
| Modulo | Nombre | Descripcion | Estado |
|
||||
|--------|--------|-------------|--------|
|
||||
| MGN-016 | [Billing](./04-fase-saas/MGN-016-billing/) | Facturacion y suscripciones | Draft |
|
||||
| MGN-017 | [Plans](./04-fase-saas/MGN-017-plans/) | Planes para clinicas veterinarias | Draft |
|
||||
| MGN-018 | [Webhooks](./04-fase-saas/MGN-018-webhooks/) | Eventos veterinarios | Draft |
|
||||
| MGN-019 | [Feature Flags](./04-fase-saas/MGN-019-feature-flags/) | Control de funcionalidades | Draft |
|
||||
|
||||
**Normativas:** NOM-064-ZOO-2000, SENASICA
|
||||
|
||||
---
|
||||
|
||||
## Fase 05: Inteligencia Artificial (Propagado desde erp-core)
|
||||
|
||||
Modulos de IA especializados en medicina veterinaria.
|
||||
|
||||
| Modulo | Nombre | Descripcion | Estado |
|
||||
|--------|--------|-------------|--------|
|
||||
| MGN-020 | [AI Integration](./05-fase-ia/MGN-020-ai-integration/) | Asistente veterinario IA | Draft |
|
||||
| MGN-021 | [WhatsApp Business](./05-fase-ia/MGN-021-whatsapp-business/) | Comunicacion con propietarios | Draft |
|
||||
| MGN-022 | [MCP Server](./05-fase-ia/MGN-022-mcp-server/) | Herramientas MCP veterinarias | Draft |
|
||||
|
||||
**Herramientas MCP Veterinarias:**
|
||||
- `consultar_historial_mascota` - Expediente clinico
|
||||
- `registrar_vacuna` - Aplicacion de vacunas
|
||||
- `agendar_consulta` - Programacion de citas
|
||||
- `consultar_cartilla_vacunacion` - Historial de vacunacion
|
||||
- `verificar_desparasitacion` - Estado de desparasitacion
|
||||
- `consultar_hospitalizacion` - Pacientes internados
|
||||
|
||||
---
|
||||
|
||||
@ -168,5 +215,19 @@ campos_principales:
|
||||
|
||||
---
|
||||
|
||||
**Ultima actualizacion:** 2026-01-07
|
||||
**Version:** 1.0.0
|
||||
---
|
||||
|
||||
## Propagacion de Documentacion
|
||||
|
||||
Este proyecto recibe documentacion propagada desde:
|
||||
|
||||
| Origen | Via | Modulos | Fecha |
|
||||
|--------|-----|---------|-------|
|
||||
| erp-core | erp-clinicas | MGN-016 a MGN-022 | 2026-01-13 |
|
||||
|
||||
Ver: [PROPAGATION-STATUS.yml](/home/isem/workspace-v2/shared/mirrors/clinica-veterinaria/PROPAGATION-STATUS.yml)
|
||||
|
||||
---
|
||||
|
||||
**Ultima actualizacion:** 2026-01-13
|
||||
**Version:** 1.1.0
|
||||
|
||||
Loading…
Reference in New Issue
Block a user