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

185 lines
4.5 KiB
Markdown

# 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
```yaml
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
```yaml
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
```yaml
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
```yaml
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
```yaml
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*