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

4.8 KiB

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

# 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