From b886cfe1ac710fc0e6caa113e4b51d6ea289094a Mon Sep 17 00:00:00 2001 From: rckrdmrd Date: Tue, 13 Jan 2026 16:13:23 -0600 Subject: [PATCH] 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 --- .../00-guidelines/HERENCIA-ERP-CLINICAS.md | 23 ++- .../00-guidelines/HERENCIA-ERP-CORE.md | 139 ++++++++++++++++++ .../inventarios/MASTER_INVENTORY.yml | 111 ++++++++++++-- .../referencias/DEPENDENCIAS-ERP-CORE.yml | 137 +++++++++++++++++ 4 files changed, 393 insertions(+), 17 deletions(-) create mode 100644 orchestration/00-guidelines/HERENCIA-ERP-CORE.md create mode 100644 orchestration/referencias/DEPENDENCIAS-ERP-CORE.yml diff --git a/orchestration/00-guidelines/HERENCIA-ERP-CLINICAS.md b/orchestration/00-guidelines/HERENCIA-ERP-CLINICAS.md index 9ef6c77..7b118b5 100644 --- 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 diff --git a/orchestration/00-guidelines/HERENCIA-ERP-CORE.md b/orchestration/00-guidelines/HERENCIA-ERP-CORE.md new file mode 100644 index 0000000..5838d56 --- /dev/null +++ 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 diff --git a/orchestration/inventarios/MASTER_INVENTORY.yml b/orchestration/inventarios/MASTER_INVENTORY.yml index 117f172..07c5a72 100644 --- 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" diff --git a/orchestration/referencias/DEPENDENCIAS-ERP-CORE.yml b/orchestration/referencias/DEPENDENCIAS-ERP-CORE.yml new file mode 100644 index 0000000..2beee52 --- /dev/null +++ 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"