clinica-veterinaria/orchestration/MAPA-DOCUMENTACION.yml
rckrdmrd 3bb417fef3 [clinica-veterinaria] feat: Add SaaS documentation from erp-clinicas chain
- Add orchestration/directivas/ with TRIGGER-COHERENCIA-CAPAS.md and
  TRIGGER-INVENTARIOS.md adapted for veterinary domain
- Add orchestration/agents/perfiles/ with specialized agents:
  - PERFIL-VETERINARIO-AGENT.yml (domain expert)
  - PERFIL-DDL-VET-AGENT.yml (database specialist)
  - _INDEX.yml (agents catalog)
- Add MAPA-DOCUMENTACION.yml with full heritage chain references:
  - template-saas (origin/PROVIDER)
  - erp-core (abuelo/INTERMEDIATE)
  - erp-clinicas (padre/CONSUMER)
- Include normative references: NOM-064-ZOO-2000, NOM-051-ZOO-1995, SENASICA
- Define @VET_ prefixed aliases for project navigation
- Add species catalog (canine, feline, birds, rodents, exotic)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-16 19:50:27 -06:00

405 lines
11 KiB
YAML

# ===============================================================================
# MAPA DE DOCUMENTACION - CLINICA VETERINARIA
# ===============================================================================
#
# Proposito: Centro de referencias a toda la documentacion del proyecto
# Alias: @VET_MAPA_DOC
# Tipo: SUB-VERTICAL (hereda de erp-clinicas)
#
# ===============================================================================
version: "1.0.0"
created: "2026-01-16"
updated: "2026-01-16"
proyecto: "clinica-veterinaria"
tipo: "SUB-VERTICAL"
nivel: 3
# -------------------------------------------------------------------------------
# CADENA DE HERENCIA COMPLETA
# -------------------------------------------------------------------------------
cadena_herencia:
origen:
proyecto: "template-saas"
tipo: "PROVIDER"
nivel: 0
alias: "@TS_MAPA_DOC"
ubicacion: "projects/template-saas/orchestration/MAPA-DOCUMENTACION.yml"
abuelo:
proyecto: "erp-core"
tipo: "INTERMEDIATE"
nivel: 1
alias: "@ERP_MAPA_DOC"
ubicacion: "projects/erp-core/orchestration/MAPA-DOCUMENTACION.yml"
padre:
proyecto: "erp-clinicas"
tipo: "CONSUMER"
nivel: 2
alias: "@CLINICAS_MAPA_DOC"
ubicacion: "projects/erp-clinicas/orchestration/MAPA-DOCUMENTACION.yml"
actual:
proyecto: "clinica-veterinaria"
tipo: "SUB-VERTICAL"
nivel: 3
alias: "@VET_MAPA_DOC"
especializacion: "Veterinaria"
# -------------------------------------------------------------------------------
# DOCUMENTACION DE USUARIO (docs/)
# -------------------------------------------------------------------------------
docs:
raiz:
README.md:
alias: "@VET_README"
descripcion: "Punto de entrada del proyecto"
_MAP.md:
alias: "@VET_MAP"
descripcion: "Mapa maestro de navegacion"
vision:
ruta: "docs/00-vision-general/"
alias: "@VET_VISION"
archivos:
- VISION-CLINICA-VETERINARIA.md
- ARQUITECTURA-VETERINARIA.md
modulos:
ruta: "docs/01-modulos/"
alias: "@VET_MODULOS"
patron: "CVT-{NNN}-{nombre}.md"
archivos:
- CVT-001-Mascotas.md
- CVT-002-Vacunacion.md
- CVT-003-Desparasitaciones.md
- CVT-004-Hospitalizacion.md
- CVT-005-Estetica-Canina.md
- CVT-006-Farmacia-Veterinaria.md
normativa:
ruta: "docs/02-normativa/"
alias: "@VET_NORMATIVA"
archivos:
- NOM-064-ZOO-2000-Implementacion.md
- NOM-051-ZOO-1995-Trato-Humanitario.md
- SENASICA-Registro-Biologicos.md
definitions:
ruta: "docs/_definitions/"
alias: "@VET_DEF"
archivos:
_INDEX.yml:
alias: "@VET_DEF_INDEX"
DATABASE-SCHEMA.md:
alias: "@VET_DEF_DB"
descripcion: "Schema sub_veterinaria (15+ tablas)"
ENTITIES-CATALOG.md:
alias: "@VET_DEF_ENTITIES"
descripcion: "Catalogo de entities veterinarias"
SERVICES-CATALOG.md:
alias: "@VET_DEF_SERVICES"
descripcion: "Catalogo de services veterinarios"
MODULES-CATALOG.md:
alias: "@VET_DEF_MODULES"
descripcion: "Catalogo de 6 modulos CVT"
quick:
ruta: "docs/_quick/"
alias: "@VET_QUICK"
archivos:
QUICK-INDEX.yml:
alias: "@VET_QUICK_INDEX"
QUICK-MODULES.yml:
alias: "@VET_QUICK_MODULES"
QUICK-DATABASE.yml:
alias: "@VET_QUICK_DATABASE"
QUICK-API.yml:
alias: "@VET_QUICK_API"
# -------------------------------------------------------------------------------
# DOCUMENTACION OPERACIONAL (orchestration/)
# -------------------------------------------------------------------------------
orchestration:
raiz:
_MAP.md:
alias: "@VET_ORCH_MAP"
PROJECT-STATUS.md:
alias: "@VET_STATUS"
descripcion: "Estado actual del proyecto"
PROXIMA-ACCION.md:
alias: "@VET_NEXT"
descripcion: "Siguiente tarea a ejecutar"
trazabilidad:
TRACEABILITY.yml:
alias: "@VET_TRACEABILITY"
descripcion: "Trazabilidad de 6 modulos CVT"
DEPENDENCY-GRAPH.yml:
alias: "@VET_DEP_GRAPH"
descripcion: "Grafo de dependencias"
CONTEXT-MAP.yml:
alias: "@VET_CONTEXT"
descripcion: "Mapeo de contexto"
_inheritance.yml:
alias: "@VET_INHERITANCE"
descripcion: "Herencia: SUB-VERTICAL nivel 3"
MAPA-DOCUMENTACION.yml:
alias: "@VET_MAPA_DOC"
descripcion: "Este archivo"
inventarios:
ruta: "orchestration/inventarios/"
alias: "@VET_INV"
archivos:
MASTER_INVENTORY.yml:
alias: "@VET_INV_MASTER"
DATABASE_INVENTORY.yml:
alias: "@VET_INV_DB"
BACKEND_INVENTORY.yml:
alias: "@VET_INV_BE"
FRONTEND_INVENTORY.yml:
alias: "@VET_INV_FE"
directivas:
ruta: "orchestration/directivas/"
alias: "@VET_DIRECTIVAS"
hereda_de: "@CLINICAS_DIRECTIVAS"
archivos:
- TRIGGER-COHERENCIA-CAPAS.md
- TRIGGER-INVENTARIOS.md
agentes:
ruta: "orchestration/agents/"
alias: "@VET_AGENTS"
archivos:
perfiles:
_INDEX.yml:
alias: "@VET_AGENTS_INDEX"
PERFIL-VETERINARIO-AGENT.yml:
alias: "@VET_AGENT_VETERINARIO"
PERFIL-DDL-VET-AGENT.yml:
alias: "@VET_AGENT_DDL"
trazas:
ruta: "orchestration/agents/trazas/"
referencias:
ruta: "orchestration/referencias/"
alias: "@VET_REFS"
environment:
ruta: "orchestration/environment/"
alias: "@VET_ENV"
# -------------------------------------------------------------------------------
# REFERENCIAS AL WORKSPACE Y CADENA
# -------------------------------------------------------------------------------
referencias_cadena:
template_saas:
mapa: "@TS_MAPA_DOC"
ubicacion: "projects/template-saas/orchestration/MAPA-DOCUMENTACION.yml"
hereda:
- "Directivas base"
- "Estructura de inventarios"
- "Perfiles de agentes base"
erp_core:
mapa: "@ERP_MAPA_DOC"
ubicacion: "projects/erp-core/orchestration/MAPA-DOCUMENTACION.yml"
hereda:
- "23 modulos MGN"
- "Triggers de coherencia"
- "Modelo multi-tenant"
erp_clinicas:
mapa: "@CLINICAS_MAPA_DOC"
ubicacion: "projects/erp-clinicas/orchestration/MAPA-DOCUMENTACION.yml"
hereda:
- "Modulos de pacientes (adaptados), citas, expedientes"
- "Directivas clinicas"
- "Normativa salud base"
workspace:
archivo: "orchestration/_refs/WS-REFERENCES.yml"
alias: "@VET_WS_REFS"
contenido:
- "@WS_DIRECTIVAS"
- "@WS_PERFILES"
- "@WS_TEMPLATES"
- "@WS_DEFINITIONS"
# -------------------------------------------------------------------------------
# MODULOS CVT (CLINICA VETERINARIA)
# -------------------------------------------------------------------------------
modulos_cvt:
CVT-001:
nombre: "Mascotas"
estado: "30%"
alias: "@VET_MOD_MASCOTAS"
normativa: "NOM-064-ZOO-2000"
CVT-002:
nombre: "Vacunacion"
estado: "25%"
alias: "@VET_MOD_VACUNACION"
normativa: "SENASICA"
CVT-003:
nombre: "Desparasitaciones"
estado: "20%"
alias: "@VET_MOD_DESPARASITACION"
CVT-004:
nombre: "Hospitalizacion"
estado: "20%"
alias: "@VET_MOD_HOSPITALIZACION"
normativa: "NOM-051-ZOO-1995"
CVT-005:
nombre: "Estetica Canina"
estado: "15%"
alias: "@VET_MOD_ESTETICA"
CVT-006:
nombre: "Farmacia Veterinaria"
estado: "20%"
alias: "@VET_MOD_FARMACIA"
normativa: "SENASICA"
# -------------------------------------------------------------------------------
# NORMATIVA APLICABLE
# -------------------------------------------------------------------------------
normativa:
obligatoria:
- codigo: "NOM-064-ZOO-2000"
nombre: "Requisitos para establecimientos de atencion medica veterinaria"
aplica_a: ["CVT-001", "todos"]
alias: "@VET_NOM_064"
- codigo: "NOM-051-ZOO-1995"
nombre: "Trato humanitario en movilizacion de animales"
aplica_a: ["CVT-004"]
alias: "@VET_NOM_051"
- codigo: "SENASICA"
nombre: "Servicio Nacional de Sanidad, Inocuidad y Calidad Agroalimentaria"
aplica_a: ["CVT-002", "CVT-006"]
alias: "@VET_SENASICA"
complementaria:
- codigo: "NOM-033-SAG/ZOO-2014"
nombre: "Metodos para dar muerte a animales domesticos y silvestres"
aplica_a: ["procedimientos-terminales"]
- codigo: "NOM-012-ZOO-1993"
nombre: "Especificaciones para la regulacion de productos quimicos"
aplica_a: ["CVT-006"]
# -------------------------------------------------------------------------------
# ESPECIES SOPORTADAS
# -------------------------------------------------------------------------------
especies:
domesticas:
- codigo: "CAN"
nombre: "Canino"
alias: "@VET_ESP_CANINO"
vacunas_basicas: ["rabia", "parvovirus", "moquillo", "leptospira"]
- codigo: "FEL"
nombre: "Felino"
alias: "@VET_ESP_FELINO"
vacunas_basicas: ["rabia", "triple_felina", "leucemia_felina"]
menores:
- codigo: "AVE"
nombre: "Aves"
alias: "@VET_ESP_AVE"
- codigo: "ROE"
nombre: "Roedores"
alias: "@VET_ESP_ROEDOR"
exoticas:
- codigo: "REP"
nombre: "Reptiles"
consideraciones: "Requiere MVZ especializado"
- codigo: "HUR"
nombre: "Hurones"
- codigo: "CON"
nombre: "Conejos"
# -------------------------------------------------------------------------------
# ESTADISTICAS
# -------------------------------------------------------------------------------
estadisticas:
docs:
total_archivos: TBD
carpetas: 8
modulos_documentados: 6
orchestration:
total_archivos: 15
inventarios: 4
trazas: 1
perfiles_agentes: 2
triggers: 2
total_aliases: 55+
cobertura_documentacion: "80%"
ultima_auditoria: "2026-01-16"
# -------------------------------------------------------------------------------
# NAVEGACION RAPIDA POR ROL
# -------------------------------------------------------------------------------
por_rol:
veterinario:
inicio: "@VET_NORMATIVA"
modulos: "@VET_MODULOS"
mascotas: "@VET_MOD_MASCOTAS"
vacunacion: "@VET_MOD_VACUNACION"
desarrollador_backend:
inicio: "@VET_DEF_ENTITIES"
api: "@VET_QUICK_API"
inventario: "@VET_INV_BE"
desarrollador_frontend:
inicio: "@VET_QUICK_MODULES"
api: "@VET_QUICK_API"
inventario: "@VET_INV_FE"
dba:
inicio: "@VET_DEF_DB"
inventario: "@VET_INV_DB"
quick: "@VET_QUICK_DATABASE"
arquitecto:
inicio: "@VET_VISION"
dependencias: "@VET_DEP_GRAPH"
herencia: "@VET_INHERITANCE"
cadena: "Ver seccion cadena_herencia"
orquestador:
inicio: "@VET_STATUS"
siguiente: "@VET_NEXT"
trazabilidad: "@VET_TRACEABILITY"
farmaceutico:
inicio: "@VET_MOD_FARMACIA"
normativa: "@VET_SENASICA"
inventario: "@VET_INV_DB"
# ===============================================================================
# FIN DEL MAPA DE DOCUMENTACION
# ===============================================================================