docs: Update inheritance documentation and inventory

- Add HERENCIA-ERP-CORE.md for core inheritance chain - Update HERENCIA-ERP-CLINICAS.md with module definitions - Add referencias/ directory - Update MASTER_INVENTORY.yml with inheritance info Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-13 16:13:23 -06:00 · 2026-01-13 16:13:23 -06:00 · b886cfe1ac
commit b886cfe1ac
parent c76c6806bf
4 changed files with 393 additions and 17 deletions
--- a/orchestration/00-guidelines/HERENCIA-ERP-CLINICAS.md
+++ b/orchestration/00-guidelines/HERENCIA-ERP-CLINICAS.md
@ -105,12 +105,31 @@ psql -f erp-clinicas/database/seeds/fase8/*.sql
 psql -f clinica-veterinaria/database/seeds/fase8/*.sql
 ```

-## 6. Versionado
+## 6. Herencia Indirecta de ERP-CORE
+
+Este proyecto también hereda funcionalidades de `erp-core` a través de `erp-clinicas`:
+
+### 6.1 Módulos Fase 04 - SaaS (Propagados 2026-01-13)
+- MGN-016: Billing (Facturación SaaS)
+- MGN-017: Plans (Planes de suscripción)
+- MGN-018: Webhooks (Eventos webhook)
+- MGN-019: Feature Flags (Toggles de funcionalidad)
+
+### 6.2 Módulos Fase 05 - IA (Propagados 2026-01-13)
+- MGN-020: AI Integration (Integración LLMs)
+- MGN-021: WhatsApp Business (Mensajería)
+- MGN-022: MCP Server (Servidor MCP)
+
+Ver: `HERENCIA-ERP-CORE.md` para detalles completos.
+
+## 7. Versionado

 | Versión | Fecha | Cambios |
 |---------|-------|---------|
 | 1.0 | 2026-01-04 | Creación inicial, herencia de erp-clinicas FASE-8 |
+| 1.1 | 2026-01-13 | Agregada herencia indirecta erp-core Fases 04-05 |

 ---

-**Última actualización:** 2026-01-04
+**Última actualización:** 2026-01-13
+**Propagación:** PROP-CORE-002
--- a/orchestration/00-guidelines/HERENCIA-ERP-CORE.md
+++ b/orchestration/00-guidelines/HERENCIA-ERP-CORE.md
@ -0,0 +1,139 @@
+# Herencia ERP-CORE (Indirecta via ERP-Clínicas) - Clínica Veterinaria
+
+## Información de Herencia
+
+| Campo | Valor |
+|-------|-------|
+| **Proyecto:** | clinica-veterinaria |
+| **Hereda de (directo):** | erp-clinicas |
+| **Hereda de (indirecto):** | erp-core |
+| **Cadena completa:** | template-saas -> erp-core -> erp-clinicas -> clinica-veterinaria |
+| **Fecha actualización:** | 2026-01-13 |
+| **Versión ERP-Core:** | 1.3.0 |
+
+---
+
+## 1. Cadena de Herencia
+
+```
+template-saas (PROVIDER - v1.2.1)
+    │
+    │ DEPENDS_ON
+    ▼
+erp-core (INTERMEDIATE - v1.3.0)
+    │
+    │ EXTENDS
+    ▼
+erp-clinicas (VERTICAL - v1.0.0)
+    │
+    │ SPECIALIZES
+    ▼
+clinica-veterinaria (SUB-VERTICAL - v1.0.0) ← ESTE PROYECTO
+```
+
+## 2. Módulos Heredados de ERP-CORE (via erp-clinicas)
+
+### 2.1 Fase 03 - Core ERP (17 módulos base)
+
+| Código | Módulo | Descripción | Hereda |
+|--------|--------|-------------|--------|
+| MGN-001 | Auth | Autenticación JWT | ✅ |
+| MGN-002 | Users | Gestión de usuarios | ✅ |
+| MGN-003 | Roles | RBAC | ✅ |
+| MGN-004 | Tenants | Multi-tenancy | ✅ |
+| MGN-005 | Branches | Sucursales | ✅ |
+| MGN-006 | Geo | Geolocalización | ✅ |
+| MGN-007 | Mobile | APIs móviles | ✅ |
+| MGN-008 | Terminals | Terminales de pago | ✅ |
+| MGN-009 | Biometrics | Biométricos | ❌ No aplica |
+| MGN-010 | Catalog | Catálogos | ✅ |
+| MGN-011 | Products | Productos | ✅ |
+| MGN-012 | Inventory | Inventario | ✅ |
+| MGN-013 | Customers | Propietarios | ✅ |
+| MGN-014 | Sales | Ventas | ✅ |
+| MGN-015 | Invoicing | Facturación | ✅ |
+
+### 2.2 Fase 04 - SaaS (4 módulos) - Propagados 2026-01-13
+
+| Código | Módulo | Descripción | Hereda | Adaptación Veterinaria |
+|--------|--------|-------------|--------|------------------------|
+| MGN-016 | Billing | Facturación SaaS | ✅ | Planes para clínicas vet |
+| MGN-017 | Plans | Planes de suscripción | ✅ | Básico/Pro/Hospital |
+| MGN-018 | Webhooks | Eventos webhook | ✅ | Alertas vacunación |
+| MGN-019 | Feature Flags | Toggles de funcionalidad | ✅ | Módulos opcionales |
+
+### 2.3 Fase 05 - IA (3 módulos) - Propagados 2026-01-13
+
+| Código | Módulo | Descripción | Hereda | Adaptación Veterinaria |
+|--------|--------|-------------|--------|------------------------|
+| MGN-020 | AI Integration | Integración LLMs | ✅ | Asistente diagnóstico vet |
+| MGN-021 | WhatsApp Business | Mensajería WhatsApp | ✅ | Recordatorio vacunas |
+| MGN-022 | MCP Server | Servidor MCP | ✅ | Tools veterinarios |
+
+## 3. Adaptaciones Específicas Veterinaria
+
+### 3.1 Terminología
+
+| ERP-Core/Clínicas | Veterinaria |
+|-------------------|-------------|
+| Paciente | Mascota/Animal |
+| Cliente | Propietario |
+| Consulta | Consulta veterinaria |
+| Tratamiento | Tratamiento veterinario |
+| Prescripción | Receta veterinaria |
+
+### 3.2 Módulos Específicos Veterinarios
+
+| Código | Módulo | Descripción |
+|--------|--------|-------------|
+| VET-001 | Mascotas-Propietarios | Registro de animales y dueños |
+| VET-002 | Vacunación | Control de vacunas |
+| VET-003 | Desparasitaciones | Control de desparasitación |
+| VET-004 | Hospitalización | Internamiento de animales |
+| VET-005 | Estética | Servicios de estética canina |
+| VET-006 | Farmacia | Farmacia veterinaria |
+
+### 3.3 Adaptaciones IA para Veterinaria
+
+| Funcionalidad IA | Uso Veterinario |
+|------------------|-----------------|
+| AI Integration | Diagnóstico por síntomas, dosis por peso |
+| WhatsApp Business | Recordatorios de vacunas, seguimiento hospitalización |
+| MCP Server | Tools: crear_cita_vet, cartilla_vacunacion, calcular_dosis |
+
+## 4. Normativa Aplicable
+
+| Normativa | Descripción |
+|-----------|-------------|
+| NOM-064-ZOO-2000 | Requisitos sanitarios clínicas veterinarias |
+| NOM-051-ZOO-1995 | Trato humanitario de animales |
+| NOM-046-ZOO-1995 | Sistema de identificación animal |
+| SENASICA | Registro de establecimientos |
+| SAGARPA | Regulaciones sanitarias |
+
+## 5. Propagación
+
+### 5.1 Estado de Propagación
+
+| Tipo | Estado | Fecha |
+|------|--------|-------|
+| Documentación | ✅ Propagado | 2026-01-13 |
+| Definiciones | ✅ Propagado | 2026-01-13 |
+| Código | ⏳ Pendiente | - |
+
+### 5.2 Referencia de Propagación
+
+- ID: `PROP-CORE-002`
+- Tipo: `bulk_propagation`
+- Cadena: `erp-core -> erp-clinicas -> clinica-veterinaria`
+
+## 6. Archivos Relacionados
+
+- `HERENCIA-ERP-CLINICAS.md` - Herencia directa de erp-clinicas
+- `../referencias/DEPENDENCIAS-ERP-CORE.yml` - Dependencias técnicas
+- `docs/04-modelado/especificaciones-tecnicas-core/README.md` - Specs técnicas
+
+---
+
+**Última actualización:** 2026-01-13
+**Propagación ID:** PROP-CORE-002
--- a/orchestration/inventarios/MASTER_INVENTORY.yml
+++ b/orchestration/inventarios/MASTER_INVENTORY.yml
@ -1,33 +1,72 @@
 ---
 # MASTER INVENTORY - Clinica Veterinaria
-# Version: 1.0.0
-# Ultima actualizacion: 2026-01-07
+# Version: 1.1.0
+# Ultima actualizacion: 2026-01-13

 proyecto: "clinica-veterinaria"
 descripcion: "ERP especializado para clinicas veterinarias"
-version: "0.1.0"
+version: "1.0.0"
 estado: "desarrollo"
-tipo: "vertical"
+tipo: "sub-vertical"
 base: "erp-clinicas"

 progreso:
  fase_actual: "Database"
-  porcentaje: 15
+  porcentaje: 25
  database_completado: true
  backend_completado: false
  frontend_completado: false

+# Cadena de herencia completa
 herencia:
+  cadena: "template-saas -> erp-core -> erp-clinicas -> clinica-veterinaria"
  vertical_padre: "erp-clinicas"
  suite_core: "erp-core"
+  provider: "template-saas"
+
+  # Módulos heredados por fase
  modulos_heredados:
-    - "auth"
-    - "users"
-    - "tenants"
-    - "roles"
-    - "patients"
-    - "appointments"
-    - "billing"
+    fase_01_02_core:
+      - MGN-001 (auth)
+      - MGN-002 (users)
+      - MGN-003 (roles)
+      - MGN-004 (tenants)
+      - MGN-005 (catalogs)
+      - MGN-007 (audit)
+      - MGN-008 (notifications)
+      - MGN-009 (reports)
+    fase_04_saas:
+      - MGN-016 (billing)
+      - MGN-017 (plans)
+      - MGN-018 (webhooks)
+      - MGN-019 (feature-flags)
+    fase_05_ia:
+      - MGN-020 (ai-integration)
+      - MGN-021 (whatsapp-business)
+      - MGN-022 (mcp-server)
+    erp_clinicas:
+      - CL-001 (fundamentos)
+      - CL-002 (pacientes)
+      - CL-003 (citas)
+      - CL-004 (consultas)
+      - CL-005 (recetas)
+      - CL-006 (laboratorio)
+      - CL-007 (farmacia)
+      - CL-008 (facturacion)
+      - CL-009 (reportes)
+      - CL-010 (telemedicina)
+      - CL-011 (expediente)
+      - CL-012 (imagenologia)
+
+  total_modulos_heredados: 28  # 16 erp-core (sin biometrics) + 12 erp-clinicas
+
+  # Propagación recibida
+  ultima_propagacion:
+    id: "PROP-CORE-002"
+    fecha: "2026-01-13"
+    tipo: "bulk_propagation"
+    modulos_recibidos:
+      - MGN-016 a MGN-022 (Fases 04-05)

 modulos_especificos:
  - id: "VET-001"
@ -51,6 +90,11 @@ modulos_especificos:
    estado: "ddl_completado"

  - id: "VET-005"
+    nombre: "estetica"
+    descripcion: "Servicios de estetica canina"
+    estado: "documentado"
+
+  - id: "VET-006"
    nombre: "farmacia"
    descripcion: "Inventario veterinario"
    estado: "pendiente"
@ -66,6 +110,12 @@ database:
    - "vaccination_records"
    - "hospitalizations"
    - "vet_consultations"
+  schemas_heredados:
+    - billing (Fase 04)
+    - webhooks (Fase 04)
+    - feature_flags (Fase 04)
+    - ai_agents (Fase 05)
+    - messaging (Fase 05)

 catalogos:
  - "especies"
@ -73,10 +123,41 @@ catalogos:
  - "vacunas_por_especie"
  - "especialidades_veterinarias"

+# Adaptaciones IA para veterinaria
+ia_adaptations:
+  mcp_tools:
+    - crear_cita_vet
+    - cartilla_vacunacion
+    - calcular_dosis
+    - historial_mascota
+    - alerta_vacunas
+  whatsapp_templates:
+    - recordatorio_vacuna
+    - confirmacion_cita_vet
+    - seguimiento_hospitalizacion
+    - recordatorio_desparasitacion
+    - promocion_estetica
+
+normativa:
+  - NOM-064-ZOO-2000
+  - NOM-051-ZOO-1995
+  - NOM-046-ZOO-1995
+  - SENASICA
+  - SAGARPA
+
 proximas_tareas:
  - "Implementar backend modulo mascotas"
  - "Crear frontend para cartilla de vacunacion"
-  - "Integracion con erp-clinicas"
+  - "Configurar feature flags para veterinaria"
+  - "Crear templates WhatsApp para vacunas"
+  - "Integrar MCP tools veterinarios"
+  - "Implementar modulo VET-006 farmacia"

-ultima_actualizacion: "2026-01-07"
-actualizado_por: "Orquestador"
+documentos_referencia:
+  - "orchestration/00-guidelines/HERENCIA-ERP-CORE.md"
+  - "orchestration/00-guidelines/HERENCIA-ERP-CLINICAS.md"
+  - "orchestration/referencias/DEPENDENCIAS-ERP-CORE.yml"
+
+ultima_actualizacion: "2026-01-13"
+actualizado_por: "CLAUDE-CAPVED"
+propagacion_ref: "PROP-CORE-002"
--- a/orchestration/referencias/DEPENDENCIAS-ERP-CORE.yml
+++ b/orchestration/referencias/DEPENDENCIAS-ERP-CORE.yml
@ -0,0 +1,137 @@
+# DEPENDENCIAS-ERP-CORE.yml - Clínica Veterinaria
+# Dependencias técnicas heredadas de erp-core via erp-clinicas
+# Versión: 1.0.0
+# Fecha: 2026-01-13
+
+version: "1.0.0"
+updated: "2026-01-13"
+project: "clinica-veterinaria"
+
+inheritance_chain:
+  - source: "template-saas"
+    version: "1.2.1"
+    relation: "PROVIDES_TO"
+  - source: "erp-core"
+    version: "1.3.0"
+    relation: "DEPENDS_ON"
+  - source: "erp-clinicas"
+    version: "1.0.0"
+    relation: "EXTENDS"
+  - target: "clinica-veterinaria"
+    version: "1.0.0"
+    relation: "SPECIALIZES"
+
+# Módulos heredados de ERP-CORE
+modules_from_erp_core:
+  fase_03_core:
+    total: 14
+    inherited:
+      - MGN-001-auth
+      - MGN-002-users
+      - MGN-003-roles
+      - MGN-004-tenants
+      - MGN-005-branches
+      - MGN-006-geo
+      - MGN-007-mobile
+      - MGN-008-terminals
+      - MGN-010-catalog
+      - MGN-011-products
+      - MGN-012-inventory
+      - MGN-013-customers  # Propietarios
+      - MGN-014-sales
+      - MGN-015-invoicing
+    not_applicable:
+      - MGN-009-biometrics  # No aplica para veterinaria
+
+  fase_04_saas:
+    total: 4
+    inherited:
+      - MGN-016-billing
+      - MGN-017-plans
+      - MGN-018-webhooks
+      - MGN-019-feature-flags
+    propagation_date: "2026-01-13"
+    propagation_id: "PROP-CORE-002"
+
+  fase_05_ia:
+    total: 3
+    inherited:
+      - MGN-020-ai-integration
+      - MGN-021-whatsapp-business
+      - MGN-022-mcp-server
+    propagation_date: "2026-01-13"
+    propagation_id: "PROP-CORE-002"
+
+# Dependencias técnicas (DDL)
+ddl_dependencies:
+  from_erp_core:
+    reused:
+      - "01-extensions.sql"
+      - "02-core-schema.sql"
+      - "10-billing.sql"
+      - "15-ai-agents.sql"
+      - "16-messaging.sql"
+    created_fase_04_05:
+      - "19-webhooks.sql"
+      - "20-feature-flags.sql"
+
+  from_erp_clinicas:
+    - "03-clinical-tables.sql"
+    - "04-financial-ext-schema-ddl.sql"
+    - "05-hr-ext-fase8-schema-ddl.sql"
+    - "06-inventory-ext-fase8-schema-ddl.sql"
+    - "07-purchase-ext-fase8-schema-ddl.sql"
+    - "08-clinica-ext-fase8-schema-ddl.sql"
+
+  specific_veterinaria:
+    - "01-veterinaria-schema-ddl.sql"
+
+# Adaptaciones específicas veterinaria
+adaptations:
+  terminology:
+    Paciente: "Mascota/Animal"
+    Cliente: "Propietario"
+    Consulta: "Consulta veterinaria"
+    Prescripción: "Receta veterinaria"
+    Médico: "Veterinario"
+
+  ai_tools:
+    - name: "crear_cita_vet"
+      description: "Crear cita en agenda veterinaria"
+    - name: "cartilla_vacunacion"
+      description: "Consultar/actualizar cartilla de vacunación"
+    - name: "calcular_dosis"
+      description: "Calcular dosis según peso del animal"
+    - name: "historial_mascota"
+      description: "Consultar historial clínico de la mascota"
+    - name: "alerta_vacunas"
+      description: "Verificar próximas vacunas pendientes"
+
+  whatsapp_templates:
+    - "recordatorio_vacuna"
+    - "confirmacion_cita_vet"
+    - "seguimiento_hospitalizacion"
+    - "recordatorio_desparasitacion"
+    - "promocion_estetica"
+
+# Normativa
+compliance:
+  - code: "NOM-064-ZOO-2000"
+    name: "Requisitos sanitarios clínicas veterinarias"
+  - code: "NOM-051-ZOO-1995"
+    name: "Trato humanitario de animales"
+  - code: "NOM-046-ZOO-1995"
+    name: "Sistema de identificación animal"
+  - code: "SENASICA"
+    name: "Servicio Nacional de Sanidad"
+  - code: "SAGARPA"
+    name: "Regulaciones sanitarias agropecuarias"
+
+metadata:
+  created_by: "CLAUDE-CAPVED"
+  created_at: "2026-01-13"
+  propagation_ref: "PROP-CORE-002"
+  related_documents:
+    - "../00-guidelines/HERENCIA-ERP-CORE.md"
+    - "../00-guidelines/HERENCIA-ERP-CLINICAS.md"
+    - "shared/mirrors/erp-core/PROPAGATION-STATUS.yml"