# DoxMed HealthTech — Especificación Técnica y Funcional Completa ## 1. Visión General de la Plataforma DoxMed es una Progressive Web App (PWA) de grado hospitalario y suite de gestión clínica desarrollada bajo estándares internacionales de seguridad para la industria de la salud. Fue diseñada para modernizar la atención médica ambulatoria y hospitalaria en República Dominicana, sustituyendo fichas de papel, plantillas desorganizadas de Excel y programas antiguos de escritorio desactualizados. - **Nombre Comercial**: DoxMed (Suite Médica & Expediente Clínico Electrónico) - **Empresa Matriz**: Dox Technology (https://doxtechnology.com/) - **Landing Comercial & Información**: https://doxtechnology.com/doxmed/ - **Acceso a la Plataforma (App)**: https://doxmed.doxtechnology.com/login - **Pila Tecnológica**: - **Frontend**: React 18, TypeScript, Vite, TailwindCSS, Lucide Icons, Recharts, Sonner. - **Backend**: NestJS, TypeScript, Prisma ORM, Node.js 22, PostgreSQL 16. - **Criptografía**: AES-256-GCM nativo con derivación segura de claves en reposo (EncryptionService). - **Despliegue & Red**: Docker Compose, Traefik Reverse Proxy con SSL automático (Let's Encrypt). --- ## 2. Especificación Detallada de Módulos ### 2.1 Expediente Clínico Electrónico (ECE) & Seguridad en Reposo - **Cifrado AES-256-GCM**: Todo dato sensible del paciente (antecedentes patológicos, historia de la enfermedad actual, notas de evolución médica, diagnósticos y exploraciones físicas) es encriptado en el backend antes de persistir en PostgreSQL. - **Catálogo CIE-10**: Autocompletado de diagnósticos médicos estándar internacionales con códigos y descripciones en español. - **Signos Vitales y Evolución**: - Presión Arterial Sistólica / Diastólica (mmHg). - Frecuencia Cardíaca (lpm) y Frecuencia Respiratoria (rpm). - Temperatura (°C), Saturación de Oxígeno (SpO2 %). - Peso (kg/lb), Talla (cm/m) y cálculo automático del Índice de Masa Corporal (IMC) con categorización visual (Bajo peso, Normal, Sobrepeso, Obesidad). - Gráficas cronológicas interactivas de evolución para seguimiento a pacientes hipertensos, diabéticos y pediátricos. - **Alertas Clínicas**: Sistema de badges fijados para alergias medicamentosas críticas y antecedentes mórbidos. ### 2.2 Agenda Médica, Sala de Espera & Enlace Público de Reserva - **Enlace de Auto-Reserva (`/book/:doctorId`)**: URL única y pública por especialista para colocar en biografías de Instagram, WhatsApp Business o página web de la clínica. Permite al paciente seleccionar fecha, hora y motivo de consulta sin intermediarios. - **Cancelación y Reprogramación Asistida**: Enlace seguro `/public/appointments/:id/cancel` enviado en confirmaciones. - **Sincronización iCalendar (RFC 5545)**: Endpoint público seguro `GET /public/appointments/feed/:doctorId.ics` para sincronización en tiempo real vía `webcal://` con Google Calendar, Apple Calendar y Outlook. - **Gestión de Sala de Espera**: - Estados: PROGRAMADA, CONFIRMADA, EN ESPERA, EN CONSULTA, COMPLETADA, CANCELADA. - Tiempos de espera auditados en vivo para reducir demoras en recepción. ### 2.3 Prescripciones Médicas, Certificados y Vademécum - **Plantillas Personalizadas de Receta (PDF)**: - Membrete institucional con logotipo del médico o centro de salud. - Datos regulatorios: Nombre completo, especialidad médica, número de exequátur oficial de ley y cédula de identidad. - Dirección del consultorio, teléfonos de contacto y firma digitalizada. - **Vademécum Personal**: Base de datos de fármacos con búsqueda predictiva por principio activo y nombre comercial, con sugerencia de presentación, dosis, frecuencia y duración. ### 2.4 Facturación Médica, Copagos ARS y Caja POS - **Desglose Seguro ARS vs Copago**: Manejo de coberturas y tarifas con las principales Administradoras de Riesgos de Salud (ARS Senasa Contributivo/Subsidiado, Primera ARS, Mapfre Salud, Humano Seguros, ARS Universal, Monumental, etc.). - **Pagos Múltiples y Divididos (Split Payments)**: Registro exacto de facturas saldadas con combinación de métodos (ej: 50% Transferencia + 50% Efectivo o Tarjeta). - **Descuentos Dinámicos por Ítem**: Descuentos aplicables en porcentaje (`%`) o monto fijo (`RD$`) con recálculo en vivo y visualización transparente en el recibo. - **Cierre y Arqueo de Caja POS**: Conciliación ciega de turnos discriminando efectivo físico, cobros con tarjeta y transferencias bancarias. ### 2.5 Liquidación de Honorarios Médicos - Asignación configurable de comisiones (porcentaje fijo o monto por consulta/procedimiento). - Deducción automática de costos de consultorio y materiales clínicos. - Reporte detallado de honorarios acumulados por período y estado de liquidación. ### 2.6 Encuestas de Satisfacción Automatizadas (NPS) - Generación de tokens UUID con expiración configurable (por defecto 72 horas). - Envío automático post-consulta mediante cron de NestJS o despacho manual por WhatsApp / correo electrónico. - 5 tipos de preguntas: RATING (1 a 5 estrellas), SINGLE (selección única), MULTIPLE (selección múltiple), YES_NO (sí/no) y TEXT (comentarios libres). - Dashboard con cálculo de Net Promoter Score (NPS) y desglose estadístico. ### 2.7 Auditoría Inmutable y Control de Acceso - **Roles de Usuario (RBAC)**: - `MEDICO`: Acceso a expedientes clínicos propios, agenda, recetas y vademécum. - `CENTRO`: Acceso global a nivel clínica, gestión de médicos, consultorios y honorarios. - `ASISTENTE`: Acceso a agenda, recepción, sala de espera, cobros y envío de encuestas (sin acceso a modificación de historiales médicos). - `ADMIN`: Control de configuración global y auditoría. - **Auditoría Inmutable**: Interceptor en NestJS que almacena cada evento (`CREATE`, `UPDATE`, `READ`, `DELETE`) con usuario, IP, entidad y timestamp para trazabilidad legal. - **2FA TOTP**: Doble factor de autenticación compatible con Google Authenticator y Authy. ### 2.8 Facturación Electrónica e-CF DGII (Ley 32-23) - **Emisión de Comprobantes Serie E**: E31 (Factura de Crédito Fiscal Electrónica) y E32 (Factura de Consumo Electrónica) según el formato XML oficial de la DGII. - **Timbre Fiscal QR**: Generación de URL oficial DGII con RNC del emisor, e-NCF, monto total, código de seguridad de 6 dígitos y firma digital. - **Firma Digital XMLDSig PKCS#12**: Certificado digital con algoritmo RSA-SHA256 y Variant-G. - **Integración con Motor Fiscal Dox Technology**: Comunicación directa con el Web Service de la DGII para recepción de TrackID y acuses comerciales automáticos. ### 2.9 Control de Inventario de Medicamentos, Insumos y Farmacia Interna - **Kardex en Tiempo Real**: Entradas por compras a proveedores, salidas a consultorios y mermas justificadas con costo promedio ponderado. - **Descuento Automático de Insumos (BOM Clínico)**: Al facturar o completar un procedimiento médico (ej. sutura, curación, infiltración), el sistema deduce automáticamente los insumos vinculados (jeringas, gazas, anestésicos). - **Alertas de Stock Mínimo y Vencimiento**: Notificaciones proactivas para reabastecimiento y control de lotes con fechas de expiración. - **Gestión de Suplidores & Compras**: Catálogo de proveedores médicos, recepción de facturas y cuentas por pagar. ### 2.10 Contabilidad Clínica Integrada en Tiempo Real - **Asientos Automáticos de Partida Doble**: Generación inmediata de transacciones contables tras cada cobro de consulta, copago liquidado o compra de insumos a crédito/contado. - **Catálogo de Cuentas Especializado en Salud**: Plan contable adaptado a policlínicas y consultorios (honorarios profesionales, aseguradoras ARS, ingresos por especialidad). - **Cuentas por Cobrar a Aseguradoras (CxC ARS)**: Registro de facturas enviadas a reclamación, control de glosas y conciliación bancaria de depósitos de aseguradoras. - **Balanza de Comprobación y Estados de Resultados**: Análisis de rentabilidad por consultorio, médico especialista y centro. ### 2.11 Recursos Humanos, Turnos y Nómina Médica TSS - **Expedientes Laborales de Personal**: Médicos de planta, enfermeras, técnicos y personal administrativo con registro de contratos, cargos y horarios. - **Control de Turnos Clínicos y Guardias**: Calendario de asignación de guardias médicas y control de asistencias. - **Nómina con Deducciones TSS (Ley 87-01)**: Cálculo automatizado de AFP (2.87%), SFS (3.04%) y aportes patronales (AFP 7.10%, SFS 7.09%, SRL). - **Retención de ISR y Salario 13**: Escala progresiva oficial de la DGII y cálculo legal de la Regalía Pascual (Ley 16-92) y prestaciones. --- ## 3. Planes Comerciales Oficiales - **Plan Médico Particular**: US$ 69 / mes (o US$ 58 / mes en ciclo anual con 2 meses gratis). Para médicos especialistas y consultorios independientes. Incluye: 1 Médico Especialista, hasta 2 Asistentes/Recepcionistas, Expediente Clínico Electrónico (ECE) Cifrado AES-256 en reposo, Agenda con auto-reserva (`/book/:id`), Sincronización Google Calendar (iCal RFC 5545), Recetas médicas oficiales en PDF con exequátur y firma digital, Vademécum farmacológico inteligente, Facturación médica y copagos ARS, Arqueo de caja POS, Encuestas post-consulta por WhatsApp y Soporte técnico directo. - **Plan Clínicas & Centros**: US$ 199 / mes (o US$ 165 / mes en ciclo anual con 2 meses gratis) [Plan Más Recomendado]. Para policlínicas, centros médicos, clínicas de especialidades y redes de salud. Incluye: Todo lo del Plan Médico Particular para múltiples especialistas y consultorios, Asistentes y secretarias ilimitadas, Liquidación automatizada de honorarios y comisiones médicas, Control de inventario multi-almacén, insumos y farmacia interna, Contabilidad clínica integrada en tiempo real (asientos automáticos por partida doble), Recursos Humanos y Nómina médica dominicana TSS (Ley 87-01) / ISR, Facturación Electrónica e-CF DGII Ley 32-23, Control de caja POS multi-cajero con pagos divididos (split), Auditoría inmutable hospitalaria RBAC con 2FA TOTP y Soporte prioritario VIP 24/7 con migración asistida. --- ## 4. Contacto y Soporte Oficial - **WhatsApp**: +1 (849) 389-6191 (https://wa.me/18493896191) - **Correo Electrónico**: admin@doxtechnology.com / info@doxtechnology.com - **Oficinas**: República Dominicana.