erp-clinicas/orchestration/00-guidelines/CONTEXTO-PROYECTO.md

160 lines
4.8 KiB
Markdown

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