# Clinica Veterinaria - Mapa de Documentacion

**Proyecto:** clinica-veterinaria
**Tipo:** ERP Especializado (hereda de erp-clinicas -> erp-core)
**Fecha:** 2026-01-16
**Estado:** Estructura _definitions/ y _quick/ completada
**Nivel de Herencia:** 3 (clinica-veterinaria <- erp-clinicas <- erp-core)

---

## Estructura de Documentacion

```
docs/
├── _MAP.md                            <- ESTE ARCHIVO
├── _definitions/                      <- [NUEVO] Definiciones canonicas
│   ├── _INDEX.yml                     <- Indice de definiciones
│   ├── DATABASE-SCHEMA.md             <- Schema BD (@PROJ_DEF_DB)
│   ├── ENTITIES-CATALOG.md            <- Catalogo entities (@PROJ_DEF_ENTITIES)
│   ├── SERVICES-CATALOG.md            <- Catalogo services (@PROJ_DEF_SERVICES)
│   └── MODULES-CATALOG.md             <- Catalogo modulos (@PROJ_DEF_MODULES)
│
├── _quick/                            <- [NUEVO] Navegacion rapida
│   ├── QUICK-INDEX.yml                <- Punto de entrada rapido
│   ├── QUICK-MODULES.yml              <- Navegacion por modulos
│   ├── QUICK-DATABASE.yml             <- Navegacion por BD
│   └── QUICK-API.yml                  <- Navegacion por API
│
├── 00-vision-general/
│   ├── README.md                      <- Indice de vision
│   └── VISION.md                      <- Vision estrategica
│
├── 01-epicas/
│   └── VET-XXX-*.md                   <- Epicas veterinarias
│
├── 02-definicion-modulos/
│   ├── _MAP.md                        <- Indice de modulos
│   ├── modulo-mascotas.md             <- Registro de pacientes
│   ├── modulo-vacunacion.md           <- Cartilla de vacunas
│   └── ...                            <- Otros modulos veterinarios
│
├── 04-fase-saas/                      <- 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/                        <- 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)
```

---

## Aliases de Definiciones

| Alias | Archivo | Descripcion |
|-------|---------|-------------|
| @PROJ_DEF_DB | `_definitions/DATABASE-SCHEMA.md` | Schema canonico BD |
| @PROJ_DEF_ENTITIES | `_definitions/ENTITIES-CATALOG.md` | Catalogo de entidades |
| @PROJ_DEF_SERVICES | `_definitions/SERVICES-CATALOG.md` | Catalogo de servicios |
| @PROJ_DEF_MODULES | `_definitions/MODULES-CATALOG.md` | Catalogo de modulos |

---

## Modulos Especializados (Veterinaria)

### Modulos Core

| Modulo | Prioridad | Estado | Descripcion |
|--------|-----------|--------|-------------|
| Mascotas | P1 | Pendiente | Registro de pacientes animales |
| Propietarios | P1 | Pendiente | Gestion de duenos |
| Vacunacion | P1 | Pendiente | Cartilla de vacunas por especie |
| Consultas | P1 | Pendiente | Atencion veterinaria |

### Modulos Especializados

| Modulo | Prioridad | Estado | Descripcion |
|--------|-----------|--------|-------------|
| Hospitalizacion | P2 | Pendiente | Internamiento y seguimiento |
| Farmacia | P2 | Pendiente | Medicamentos veterinarios |
| Estetica | P2 | Pendiente | Grooming, bano, corte |
| Laboratorio | P2 | Pendiente | Analisis clinicos |
| Cirugia | P2 | Pendiente | Procedimientos quirurgicos |

---

## Modulos Heredados (de erp-clinicas)

| Modulo | Fuente | Adaptacion Requerida |
|--------|--------|----------------------|
| Expedientes | erp-clinicas | Adaptar a mascotas |
| Citas | erp-clinicas | Ninguna |
| Consultas | erp-clinicas | Agregar signos vitales animales |
| Recetas | erp-clinicas | Medicamentos veterinarios |
| Facturacion | erp-core | Ninguna |
| Inventario | erp-core | Productos veterinarios |

---

## Especies Soportadas

### Principales

| Especie | Vacunas Requeridas |
|---------|-------------------|
| Canino (Perro) | Parvovirus, Moquillo, Hepatitis, Rabia, Leptospirosis, Bordetella |
| Felino (Gato) | Triple felina, Leucemia felina, Rabia |

### Otras Especies

| Especie | Notas |
|---------|-------|
| Ave | Vacunas segun tipo |
| Reptil | Sin vacunas estandar |
| Roedor | Sin vacunas estandar |
| Pez | Sin vacunas |
| Exotico | Segun especie especifica |

---

## Entidades Especificas

### Mascota (Paciente)
```yaml
campos_principales:
  - nombre: VARCHAR(100)
  - especie: ENUM (canino, felino, ave, reptil, roedor, pez, exotico)
  - raza: VARCHAR(100)
  - sexo: ENUM (macho, hembra)
  - fecha_nacimiento: DATE
  - peso_actual: DECIMAL(6,2)
  - color: VARCHAR(100)
  - microchip: VARCHAR(50) UNIQUE
  - esterilizado: BOOLEAN
  - propietario_id: UUID (FK)
```

### Propietario
```yaml
campos_principales:
  - nombre: VARCHAR(200)
  - telefono: VARCHAR(20)
  - email: VARCHAR(255)
  - direccion: TEXT
  - rfc: VARCHAR(13)
```

### Cartilla Vacunacion
```yaml
campos_principales:
  - mascota_id: UUID (FK)
  - vacuna_id: UUID (FK catalogo)
  - fecha_aplicacion: DATE
  - fecha_proxima: DATE
  - lote: VARCHAR(50)
  - veterinario_id: UUID (FK)
```

---

## Integraciones Externas

| Sistema | Proposito | Estado |
|---------|-----------|--------|
| 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

---

## Navegacion Rapida

### Por Rol de Usuario
- **Veterinario:** Consultas, diagnosticos, prescripciones
- **Auxiliar veterinario:** Apoyo en consultas, hospitalizacion
- **Recepcionista:** Citas, cobros, atencion al propietario
- **Estilista:** Servicios de estetica (grooming)
- **Administrador:** Gestion general, reportes

### Por Componente Tecnico
- **Database:** Ver orchestration/inventarios/DATABASE_INVENTORY.yml
- **Backend:** Ver orchestration/inventarios/BACKEND_INVENTORY.yml
- **Frontend:** Ver orchestration/inventarios/FRONTEND_INVENTORY.yml

---

## Referencias

- [CONTEXTO-PROYECTO.md](../orchestration/00-guidelines/CONTEXTO-PROYECTO.md)
- [HERENCIA-ERP-CLINICAS.md](../orchestration/00-guidelines/HERENCIA-ERP-CLINICAS.md)
- [PROXIMA-ACCION.md](../orchestration/PROXIMA-ACCION.md)
- [CONTEXT-MAP.yml](../orchestration/CONTEXT-MAP.yml)

---

---

## 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-16
**Version:** 1.2.0