From c4620ca4e9a59deae390b87f658d5adfc78bad79 Mon Sep 17 00:00:00 2001 From: rckrdmrd Date: Fri, 16 Jan 2026 00:28:18 -0600 Subject: [PATCH] [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 --- docs/04-fase-saas/MGN-016-billing/README.md | 187 ++++++++++++ docs/04-fase-saas/MGN-016-billing/_MAP.md | 48 +++ docs/04-fase-saas/MGN-017-plans/README.md | 161 ++++++++++ docs/04-fase-saas/MGN-017-plans/_MAP.md | 49 +++ docs/04-fase-saas/MGN-018-webhooks/README.md | 177 +++++++++++ docs/04-fase-saas/MGN-018-webhooks/_MAP.md | 50 ++++ .../MGN-019-feature-flags/README.md | 165 ++++++++++ .../MGN-019-feature-flags/_MAP.md | 50 ++++ docs/04-fase-saas/README.md | 73 +++++ docs/04-fase-saas/_MAP.md | 117 ++++++++ .../MGN-020-ai-integration/README.md | 248 ++++++++++++++++ .../05-fase-ia/MGN-020-ai-integration/_MAP.md | 59 ++++ .../MGN-021-whatsapp-business/README.md | 281 ++++++++++++++++++ .../MGN-021-whatsapp-business/_MAP.md | 49 +++ docs/05-fase-ia/MGN-022-mcp-server/README.md | 275 +++++++++++++++++ docs/05-fase-ia/MGN-022-mcp-server/_MAP.md | 63 ++++ docs/05-fase-ia/README.md | 103 +++++++ docs/05-fase-ia/_MAP.md | 131 ++++++++ docs/_MAP.md | 95 ++++-- 19 files changed, 2364 insertions(+), 17 deletions(-) create mode 100644 docs/04-fase-saas/MGN-016-billing/README.md create mode 100644 docs/04-fase-saas/MGN-016-billing/_MAP.md create mode 100644 docs/04-fase-saas/MGN-017-plans/README.md create mode 100644 docs/04-fase-saas/MGN-017-plans/_MAP.md create mode 100644 docs/04-fase-saas/MGN-018-webhooks/README.md create mode 100644 docs/04-fase-saas/MGN-018-webhooks/_MAP.md create mode 100644 docs/04-fase-saas/MGN-019-feature-flags/README.md create mode 100644 docs/04-fase-saas/MGN-019-feature-flags/_MAP.md create mode 100644 docs/04-fase-saas/README.md create mode 100644 docs/04-fase-saas/_MAP.md create mode 100644 docs/05-fase-ia/MGN-020-ai-integration/README.md create mode 100644 docs/05-fase-ia/MGN-020-ai-integration/_MAP.md create mode 100644 docs/05-fase-ia/MGN-021-whatsapp-business/README.md create mode 100644 docs/05-fase-ia/MGN-021-whatsapp-business/_MAP.md create mode 100644 docs/05-fase-ia/MGN-022-mcp-server/README.md create mode 100644 docs/05-fase-ia/MGN-022-mcp-server/_MAP.md create mode 100644 docs/05-fase-ia/README.md create mode 100644 docs/05-fase-ia/_MAP.md diff --git a/docs/04-fase-saas/MGN-016-billing/README.md b/docs/04-fase-saas/MGN-016-billing/README.md new file mode 100644 index 0000000..c6de868 --- /dev/null +++ b/docs/04-fase-saas/MGN-016-billing/README.md @@ -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* diff --git a/docs/04-fase-saas/MGN-016-billing/_MAP.md b/docs/04-fase-saas/MGN-016-billing/_MAP.md new file mode 100644 index 0000000..f01e381 --- /dev/null +++ b/docs/04-fase-saas/MGN-016-billing/_MAP.md @@ -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* diff --git a/docs/04-fase-saas/MGN-017-plans/README.md b/docs/04-fase-saas/MGN-017-plans/README.md new file mode 100644 index 0000000..5e4819c --- /dev/null +++ b/docs/04-fase-saas/MGN-017-plans/README.md @@ -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* diff --git a/docs/04-fase-saas/MGN-017-plans/_MAP.md b/docs/04-fase-saas/MGN-017-plans/_MAP.md new file mode 100644 index 0000000..eee7550 --- /dev/null +++ b/docs/04-fase-saas/MGN-017-plans/_MAP.md @@ -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* diff --git a/docs/04-fase-saas/MGN-018-webhooks/README.md b/docs/04-fase-saas/MGN-018-webhooks/README.md new file mode 100644 index 0000000..2f2b6f7 --- /dev/null +++ b/docs/04-fase-saas/MGN-018-webhooks/README.md @@ -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* diff --git a/docs/04-fase-saas/MGN-018-webhooks/_MAP.md b/docs/04-fase-saas/MGN-018-webhooks/_MAP.md new file mode 100644 index 0000000..cd84790 --- /dev/null +++ b/docs/04-fase-saas/MGN-018-webhooks/_MAP.md @@ -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* diff --git a/docs/04-fase-saas/MGN-019-feature-flags/README.md b/docs/04-fase-saas/MGN-019-feature-flags/README.md new file mode 100644 index 0000000..1bc8ecc --- /dev/null +++ b/docs/04-fase-saas/MGN-019-feature-flags/README.md @@ -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* diff --git a/docs/04-fase-saas/MGN-019-feature-flags/_MAP.md b/docs/04-fase-saas/MGN-019-feature-flags/_MAP.md new file mode 100644 index 0000000..2b74ad5 --- /dev/null +++ b/docs/04-fase-saas/MGN-019-feature-flags/_MAP.md @@ -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* diff --git a/docs/04-fase-saas/README.md b/docs/04-fase-saas/README.md new file mode 100644 index 0000000..e127b00 --- /dev/null +++ b/docs/04-fase-saas/README.md @@ -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* diff --git a/docs/04-fase-saas/_MAP.md b/docs/04-fase-saas/_MAP.md new file mode 100644 index 0000000..331c694 --- /dev/null +++ b/docs/04-fase-saas/_MAP.md @@ -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* diff --git a/docs/05-fase-ia/MGN-020-ai-integration/README.md b/docs/05-fase-ia/MGN-020-ai-integration/README.md new file mode 100644 index 0000000..16b370b --- /dev/null +++ b/docs/05-fase-ia/MGN-020-ai-integration/README.md @@ -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* diff --git a/docs/05-fase-ia/MGN-020-ai-integration/_MAP.md b/docs/05-fase-ia/MGN-020-ai-integration/_MAP.md new file mode 100644 index 0000000..eb75374 --- /dev/null +++ b/docs/05-fase-ia/MGN-020-ai-integration/_MAP.md @@ -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* diff --git a/docs/05-fase-ia/MGN-021-whatsapp-business/README.md b/docs/05-fase-ia/MGN-021-whatsapp-business/README.md new file mode 100644 index 0000000..c599a8c --- /dev/null +++ b/docs/05-fase-ia/MGN-021-whatsapp-business/README.md @@ -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* diff --git a/docs/05-fase-ia/MGN-021-whatsapp-business/_MAP.md b/docs/05-fase-ia/MGN-021-whatsapp-business/_MAP.md new file mode 100644 index 0000000..ee730ac --- /dev/null +++ b/docs/05-fase-ia/MGN-021-whatsapp-business/_MAP.md @@ -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* diff --git a/docs/05-fase-ia/MGN-022-mcp-server/README.md b/docs/05-fase-ia/MGN-022-mcp-server/README.md new file mode 100644 index 0000000..5fa65a7 --- /dev/null +++ b/docs/05-fase-ia/MGN-022-mcp-server/README.md @@ -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* diff --git a/docs/05-fase-ia/MGN-022-mcp-server/_MAP.md b/docs/05-fase-ia/MGN-022-mcp-server/_MAP.md new file mode 100644 index 0000000..2c63909 --- /dev/null +++ b/docs/05-fase-ia/MGN-022-mcp-server/_MAP.md @@ -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* diff --git a/docs/05-fase-ia/README.md b/docs/05-fase-ia/README.md new file mode 100644 index 0000000..1ce86a1 --- /dev/null +++ b/docs/05-fase-ia/README.md @@ -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* diff --git a/docs/05-fase-ia/_MAP.md b/docs/05-fase-ia/_MAP.md new file mode 100644 index 0000000..f31b8bd --- /dev/null +++ b/docs/05-fase-ia/_MAP.md @@ -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* diff --git a/docs/_MAP.md b/docs/_MAP.md index 73e3f8a..aa8226c 100644 --- a/docs/_MAP.md +++ b/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