# Contexto del Proyecto: ERP Clinicas

## Metadatos

| Campo | Valor |
|-------|-------|
| **Nombre** | ERP Clinicas - Gestion de Consultorios y Clinicas |
| **Tipo** | STANDALONE (Proyecto Independiente) |
| **Nivel** | Vertical que extiende erp-core |
| **Estado** | Por iniciar |
| **Progreso** | 0% |
| **Version** | 0.0.1 |
| **Base** | Extiende projects/erp-core (60-70%) |
| **Extension** | Modulos especificos (+30-40%) |
| **Path** | `/home/isem/workspace-v1/projects/erp-clinicas/` |
| **Fecha Migracion** | 2025-12-27 |

---

## VARIABLES PARA DIRECTIVAS GLOBALES

```yaml
# Identificacion del Proyecto
PROJECT:             erp-clinicas
PROJECT_NAME:        ERP Clinicas
PROJECT_LEVEL:       STANDALONE

# Paths Principales (WORKSPACE-V1)
WORKSPACE_ROOT:      ~/workspace-v1
PROJECT_ROOT:        ~/workspace-v1/projects/erp-clinicas
APPS_ROOT:           ~/workspace-v1/projects/erp-clinicas
DOCS_ROOT:           ~/workspace-v1/projects/erp-clinicas/docs
ORCHESTRATION:       ~/workspace-v1/projects/erp-clinicas/orchestration

# Herencia de ERP-Core
ERP_CORE_ROOT:       ~/workspace-v1/projects/erp-core
HERENCIA_DOC:        orchestration/00-guidelines/HERENCIA-ERP-CORE.md

# Base Orchestration (Directivas y Perfiles)
DIRECTIVAS_PATH:     ~/workspace-v1/orchestration/directivas
PERFILES_PATH:       ~/workspace-v1/orchestration/agents/perfiles
CATALOG_PATH:        ~/workspace-v1/core/catalog

# Base de Datos
DB_NAME:             erp_clinicas
DB_DDL_PATH:         ~/workspace-v1/projects/erp-clinicas/database/ddl
DB_SCRIPTS_PATH:     ~/workspace-v1/projects/erp-clinicas/database

# Backend
BACKEND_ROOT:        ~/workspace-v1/projects/erp-clinicas/backend
BACKEND_SRC:         ~/workspace-v1/projects/erp-clinicas/backend/src

# Frontend
FRONTEND_ROOT:       ~/workspace-v1/projects/erp-clinicas/frontend
FRONTEND_SRC:        ~/workspace-v1/projects/erp-clinicas/frontend/src
```

---

## Descripcion

ERP especializado para la gestion de clinicas, consultorios medicos y centros de salud. Extiende el ERP Core con funcionalidades especificas del sector salud.

**Funcionalidades principales:**
- Gestion de pacientes y expedientes clinicos
- Agenda y citas medicas
- Historia clinica electronica
- Recetas y prescripciones
- Facturacion medica (CFDI)
- Inventario de medicamentos e insumos
- Reportes clinicos y administrativos

---

## Stack Tecnologico

Hereda completamente del ERP Core:
- **Backend:** Node.js + Express + TypeScript
- **Frontend:** React + TypeScript + Tailwind
- **Database:** PostgreSQL 15+
- **Auth:** JWT + Multi-tenant

---

## Paths del Proyecto

```
/home/isem/workspace-v1/projects/erp-suite/apps/verticales/clinicas/
├── backend/              # Extensiones backend
├── frontend/             # UI especializada
├── database/             # DDL vertical
├── docs/                 # Documentacion
└── orchestration/        # Sistema NEXUS
```

---

## Modulos Especificos (MCL-*)

| Codigo | Modulo | Descripcion |
|--------|--------|-------------|
| MCL-001 | pacientes | Gestion de pacientes |
| MCL-002 | expedientes | Historia clinica electronica |
| MCL-003 | citas | Agenda y programacion |
| MCL-004 | recetas | Prescripciones medicas |
| MCL-005 | laboratorio | Resultados de laboratorio |
| MCL-006 | facturacion-medica | CFDI para sector salud |

---

## Modulos del Core que Extiende

| Modulo Core | Extension |
|-------------|-----------|
| MGN-002 Users | Roles medicos (doctor, enfermera, admin) |
| MGN-005 Catalogs | CIE-10, medicamentos, procedimientos |
| MGN-006 Settings | Configuracion de consultorio |
| MGN-008 Notifications | Recordatorios de citas |
| MGN-010 Financial | Facturacion medica |
| MGN-011 Inventory | Medicamentos e insumos |

---

## Schemas de Base de Datos

```
vertical_clinicas          # Schema principal
├── patients              # Pacientes
├── medical_records       # Expedientes clinicos
├── appointments          # Citas
├── prescriptions         # Recetas
├── vital_signs           # Signos vitales
├── lab_results           # Resultados laboratorio
└── medical_invoices      # Facturacion
```

---

## Principios Especificos

1. **Confidencialidad:** Datos medicos requieren encriptacion adicional
2. **Auditoria:** Log detallado de acceso a expedientes
3. **Normativa:** Cumplir NOM-024-SSA3-2012 (expediente clinico)
4. **Interoperabilidad:** Preparado para HL7 FHIR

---

## Referencias

| Recurso | Path |
|---------|------|
| Directivas globales | `/home/isem/workspace-v1/orchestration/directivas/` |
| Directivas ERP-Core | `/home/isem/workspace-v1/projects/erp-core/orchestration/directivas/` |
| Herencia directivas | `./HERENCIA-DIRECTIVAS.md` |
| Dependencias ERP-Core | `../referencias/DEPENDENCIAS-ERP-CORE.yml` |
| Dependencias Shared | `../referencias/DEPENDENCIAS-SHARED.yml` |

---
*Ultima actualizacion: Diciembre 2025*