erp-clinicas/orchestration/00-guidelines/HERENCIA-ERP-CORE.md

4.5 KiB

Herencia de ERP Core - Vertical Clinicas

Version: 1.0.0 Vertical: Clinicas Nivel: STANDALONE (proyecto independiente) Version ERP-Core: 1.2.0 Ruta ERP-Core: projects/erp-core Herencia: 60-70% de funcionalidad base de erp-core Fecha Migracion: 2025-12-27


RESUMEN DE HERENCIA

Este documento especifica exactamente que hereda la vertical Clinicas del ERP Core y como lo extiende.


1. MODULOS HEREDADOS (100%)

Modulo Core Codigo Uso en Clinicas
Auth MGN-001 Autenticacion con seguridad reforzada
Users MGN-002 Gestion de personal medico
Roles MGN-003 Roles medicos (doctor, enfermera, admin)
Audit MGN-007 Auditoria de acceso a expedientes
Notifications MGN-008 Recordatorios de citas
Reports MGN-009 Reportes medicos y administrativos

Accion: NO crear codigo para estos modulos. Usar directamente del core.


2. MODULOS HEREDADOS Y EXTENDIDOS

MGN-004: Tenants → Clinicas/Consultorios

herencia_base:
  - Multi-tenancy basico

extension_clinicas:
  - Clinica/Consultorio como tenant
  - Campos adicionales:
    - licencia_sanitaria
    - especialidades_medicas[]
    - horarios_atencion
    - numero_consultorios
  - Relaciones:
    - clinica → consultorios (1:N)
    - clinica → medicos (1:N)

MGN-005: Catalogs → Catalogos Medicos

herencia_base:
  - CRUD de catalogos genericos

extension_clinicas:
  - Catalogo CIE-10 (diagnosticos)
  - Catalogo de procedimientos medicos
  - Catalogo de medicamentos (cuadro basico)
  - Catalogo de laboratorios
  - Catalogo de especialidades medicas

MGN-010: Financial → Facturacion Medica

herencia_base:
  - Plan de cuentas
  - Facturacion basica

extension_clinicas:
  - CFDI para sector salud
  - Deducibilidad de gastos medicos
  - Integracion con aseguradoras

3. ESPECIFICACIONES TRANSVERSALES HEREDADAS

Obligatorias

Especificacion Gap Uso
SPEC-RRHH-EVALUACIONES-SKILLS.md GAP-MGN-010 Credenciales medicas
SPEC-INTEGRACION-CALENDAR.md GAP-MGN-014 Agenda de citas
SPEC-MAIL-THREAD-TRACKING.md Patron Comunicacion con pacientes

Recomendadas

Especificacion Gap Uso
SPEC-TWO-FACTOR-AUTHENTICATION.md GAP-MGN-001 Seguridad acceso expedientes
SPEC-SISTEMA-SECUENCIAS.md GAP-MGN-004 Foliado de expedientes
SPEC-SCHEDULER-REPORTES.md GAP-MGN-012 Recordatorios automaticos

4. MODULOS PROPIOS (No heredados)

Codigo Modulo Descripcion
CL-001 patients Registro de pacientes
CL-002 appointments Agenda y citas
CL-003 medical_records Expediente clinico electronico
CL-004 prescriptions Recetas medicas
CL-005 laboratory Resultados de laboratorio
CL-006 medical_billing Facturacion medica CFDI

5. SCHEMAS DE BASE DE DATOS

Heredados de Core

schemas_core:
  - auth (con seguridad reforzada)
  - core_users
  - core_rbac
  - core_tenants (extendido)
  - core_catalogs (extendido)
  - core_audit (critico para HIPAA/datos sensibles)

Propios de Clinicas

schemas_vertical:
  - vertical_clinicas
    - patients
    - medical_records (ENCRIPTADO)
    - appointments
    - prescriptions
    - vital_signs
    - lab_results

6. CONSIDERACIONES ESPECIALES

Cumplimiento Normativo

CRITICO: Este vertical maneja datos sensibles de salud.

  • NOM-024-SSA3-2012: Expediente clinico electronico
  • Ley de Proteccion de Datos Personales: Datos sensibles
  • COFEPRIS: Requisitos de trazabilidad

Requisitos de Seguridad

  1. Encriptacion obligatoria de datos medicos en reposo
  2. Auditoria completa de acceso a expedientes
  3. Control de acceso granular por paciente
  4. Consentimiento informado digital
  5. Backup cifrado de expedientes

Interoperabilidad Futura

  • HL7 FHIR para intercambio de datos
  • Integracion con laboratorios externos
  • Receta electronica SAT

7. REFERENCIAS

Recurso Ubicacion
MASTER_INVENTORY Core erp-core/orchestration/inventarios/MASTER_INVENTORY.yml
Specs Transversales erp-core/docs/04-modelado/especificaciones-tecnicas/transversal/
NOM-024-SSA3-2012 Normativa externa
HERENCIA-DIRECTIVAS ./HERENCIA-DIRECTIVAS.md

Sistema NEXUS + SIMCO v2.2.0 Vertical: Clinicas (Nivel 2B.2) Ultima actualizacion: 2025-12-08