259 lines
8.7 KiB
Markdown
259 lines
8.7 KiB
Markdown
# 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
|