rckrdmrd/clinica-veterinaria
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
2bd796b4c9
clinica-veterinaria/docs/_MAP.md
rckrdmrd 2b7388df1e [INTEGRATION] F3: Crear _definitions/ y _quick/ (nivel=3, padre=erp-clinicas) 
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-16 04:14:26 -06:00

8.7 KiB
Raw Blame History

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)

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

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

Cartilla Vacunacion

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 Facturacion y suscripciones Draft
MGN-017 Plans Planes para clinicas veterinarias Draft
MGN-018 Webhooks Eventos veterinarios Draft
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 Asistente veterinario IA Draft
MGN-021 WhatsApp Business Comunicacion con propietarios Draft
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

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

Ultima actualizacion: 2026-01-16 Version: 1.2.0