Informe de Alcance — SINAPSIS
Instituto Mexicano del Seguro Social · OOAD Chihuahua
Informe de Alcance del Proyecto
SINAPSIS — Sistema Nacional de Administración y Procesos Integrados en Salud
Alcance Funcional · Técnico · Estratégico
Versión 1.7.4 · Mayo 2026 · Uso interno institucional
1. Antecedentes
El IMSS, como la institución de seguridad social más grande de América Latina, enfrenta el reto permanente de gestionar un volumen creciente de servicios médicos que exceden su capacidad instalada. Los servicios subrogados —contratación de prestadores privados para atender derechohabientes— y el intercambio interinstitucional —derivaciones entre el IMSS, ISSSTE, Secretaría de Salud y otras instituciones— constituyen instrumentos fundamentales para garantizar la continuidad de la atención médica.
La operación de estos servicios involucra cadenas de procesos administrativos complejos: captura de solicitudes, validación de derechos, autorizaciones multi-nivel, recepción y glosa de facturas electrónicas (CFDI), control presupuestal y generación de reportes normativos. Históricamente, estos procesos operaban de manera fragmentada, con alto grado de intervención manual y escasa trazabilidad.
SINAPSIS surge como respuesta a esta problemática, con el objetivo de integrar, digitalizar y estandarizar estos procesos en una sola plataforma institucional, cumpliendo con los lineamientos normativos y los estándares de modernización tecnológica del IMSS.
2. Objetivo General
Definir, delimitar y documentar el alcance funcional, técnico y organizacional del Sistema SINAPSIS, estableciendo con precisión los módulos implementados, los procesos institucionales impactados, los usuarios involucrados, las integraciones existentes, las limitaciones identificadas y la visión de evolución futura del sistema.
3. Objetivos Específicos
- Describir la arquitectura técnica completa del sistema y las tecnologías que la soportan.
- Inventariar todos los módulos funcionales implementados con su estado actual de desarrollo.
- Mapear los procesos institucionales del IMSS transformados por la implementación.
- Identificar a los usuarios, perfiles y roles involucrados en la operación del sistema.
- Documentar las integraciones con sistemas institucionales externos (AcceDer, SIAP, SAT).
- Delimitar los beneficios concretos por área administrativa.
- Registrar las limitaciones técnicas y exclusiones de alcance identificadas.
- Presentar la visión evolutiva del sistema con un roadmap de mediano y largo plazo.
4. Alcance Funcional
El alcance funcional de SINAPSIS comprende los siguientes procesos institucionales:
4.1 Procesos Completamente Digitalizados (Alcance Cubierto)
| Proceso | Módulo | Estado |
|---|---|---|
| Captura y validación de solicitudes de subrogación | Subrogados | 🟢 Producción |
| Flujo de autorización multi-nivel (VoBo → Auth) | Subrogados | 🟢 Producción |
| Verificación de derechos ACCEDER pre-autorización | Subrogados / Intercambio | 🟢 Producción |
| Gestión de derivaciones con Anexo 1 y 2 | Intercambio | 🟢 Producción |
| Diagnósticos CIE-10 en derivaciones | Intercambio | 🟢 Producción |
| Recepción de CFDI con validación UUID/RFC/QR | Facturas | 🟢 Producción |
| Glosa médica con Mesa de Glosa digital | Facturas | 🟢 Producción |
| Devoluciones multi-factura con memorándum PDF | Facturas | 🟢 Producción |
| Vinculación solicitud-factura con cálculo fiscal | Control de Facturas | 🟢 Producción |
| Importación y consulta PREI (IMKK022) | Herramientas | 🟢 Producción |
| Analítica de subrogados (KPIs, datamart, reporteador) | Analítica | 🟢 Producción |
| Analítica de finanzas PREI histórico | Analítica | 🟢 Producción |
| Gestión de usuarios con RBAC dinámico | Administración | 🟢 Producción |
| Catálogos institucionales centralizados | Administración | 🟢 Producción |
| Chat institucional 1-a-1 con historial | Chat | 🟢 Producción |
| Notificaciones push segmentadas por perfil | Notificaciones | 🟢 Producción |
| Respaldo automático diario de base de datos | Infraestructura | 🟢 Producción |
| Reporte SUI Subsistema 19 | Subrogados | 🟢 Producción |
| Gestión de proveedores (catálogo, contratos, tarifas) | Administración | 🟢 Producción |
| Portal de consulta para proveedores externos | Proveedores | 🟢 Producción |
4.2 Procesos en Desarrollo
| Proceso | Módulo | Estado |
|---|---|---|
| Dashboard comparativo PREI (multi-zona/OOAD) | Analítica | 🟡 En desarrollo |
| Datamart completo de derivaciones | Analítica | 🟡 Planificado |
| Datamart de facturación | Analítica | 🟡 Planificado |
| Dashboards ejecutivos adicionales | Analítica | 🟡 Planificado |
5. Alcance Técnico
5.1 Arquitectura General del Sistema
SINAPSIS implementa una arquitectura de tres capas desacoplada, con separación clara entre presentación, lógica de negocio y persistencia de datos:
┌──────────────────────────────────────────────────────┐
│ CAPA DE PRESENTACIÓN │
│ React 18 + Vite + Material UI (Berry) │
│ MUI X DataGrid · Axios · dayjs · WebSocket │
└─────────────────────┬────────────────────────────────┘
│ HTTPS / WSS
┌─────────────────────▼─────────────────────────────────┐
│ CAPA DE SERVICIOS (API) │
│ Go · Gorilla Mux · GORM · JWT │
│ 200+ Endpoints REST · WebSocket · RBAC Cache │
│ Redis Pub/Sub · Swagger │
└─────────────────────┬─────────────────────────────────┘
│ GORM / TCP
┌─────────────────────▼────────────────────────────────┐
│ CAPA DE PERSISTENCIA │
│ MariaDB 10.6+ · Redis 7.x · Backups │
│ 50+ Tablas · 15+ Vistas SQL · Soft Delete │
└──────────────────────────────────────────────────────┘
Servidores activos:
| Servidor | Entorno | IP Privada | Estado | Certificado |
|---|---|---|---|---|
| Principal (subrogados.com) | Internet | N/A | 🟢 Activo | HTTPS Let's Encrypt |
| HGR66 Ciudad Juárez | Intranet IMSS | 172.17.14.14 | 🟢 Activo | HTTPS (Let's Encrypt) |
| Nivel Central CDMX | Intranet IMSS | 172.24.30.173 | 🟢 Activo | HTTPS (Let's Encrypt) |
5.2 Tecnologías Utilizadas
Backend:
| Tecnología | Versión | Rol |
|---|---|---|
| Go | 1.22+ | Lenguaje del servidor API |
| Gorilla Mux | v1.8 | Router HTTP |
| GORM | v2 | ORM (acceso a datos) |
| gorilla/websocket | v1.5 | Comunicación tiempo real |
| go-redis | v9 | Caché RBAC y Pub/Sub |
| gofpdf | v2 | Generación de PDFs Letter |
| excelize | v2 | Exportación a Excel |
| golang-jwt | v4 | Autenticación JWT |
Frontend:
| Tecnología | Versión | Rol |
|---|---|---|
| React | 18 | Framework UI |
| Vite | 5 | Bundler y servidor dev |
| Material UI (MUI) | v5 | Componentes UI (Berry Dashboard) |
| MUI X DataGrid | v7 | Grillas de datos avanzadas |
| Axios | v1 | Cliente HTTP |
| dayjs | v1 | Manejo de fechas (YYYY-MM-DD) |
| SheetJS (xlsx) | v0.18 | Export Excel client-side |
Infraestructura:
| Tecnología | Rol |
|---|---|
| MariaDB 10.6+ | Base de datos relacional principal |
| Redis 7.x | Caché RBAC, Pub/Sub, sesiones |
| Docker Compose | Orquestación de contenedores |
| Nginx | Reverse proxy, SSL termination, WebSocket |
| Let's Encrypt | Certificados HTTPS (renovación DNS-01) |
| mysqldump + gzip | Respaldo automático diario |
Documentación e integración:
| Tecnología | Rol |
|---|---|
| Docusaurus 3.9.2 | Portal de documentación institucional |
| Swagger / OpenAPI | Documentación interactiva de la API |
| SOAP (AcceDer, SIAP) | Integración con sistemas IMSS intranet |
| FastAPI + ChromaDB | Asistente IA RAG local (desarrollo) |
| Ollama | Modelos LLM locales (nomic-embed-text, llama3.2) |
6. Módulos Incluidos — Detalle
Módulo: Subrogados
- Alcance: Ciclo de vida completo de la solicitud (CI→VB→AU→RP→FA→PA).
- Tablas principales:
subr_solicitudes,subr_solicitudes_detalle,subr_solicitudes_estudios,subr_contratos,subr_subs19. - Endpoints: 30+ (listado, CRUD, cambio de estatus, PDF, exportación, reporte SUI).
- Integraciones: AcceDer (vigencia ACCEDER), Módulo de Facturación.
- Documentos generados: Solicitud PDF (Letter), Reporte SUI Subsistema 19 (Excel).
Módulo: Intercambio
- Alcance: Derivaciones interinstitucionales con Anexo 1 y Anexo 2, diagnósticos CIE-10.
- Tablas principales:
inter_derivaciones,inter_derivaciones_detalle,inter_derivaciones_diagnosticos,inter_derivaciones_anexo1,inter_derivaciones_anexo2. - Endpoints: 25+ (listado, CRUD, anexos, cambio de estatus, PDF).
- Integraciones: AcceDer (vigencia), Módulo de Facturación.
Módulo: Facturas
- Alcance: Recepción CFDI, glosa, devoluciones, Mesa de Glosa, bitácora.
- Tablas principales:
fac_facturas,fac_movimientos,fac_devoluciones,fac_devoluciones_facturas,fac_glosadores,fac_unidades_departamentos. - Endpoints: 20+ (recepción, estatus, glosa, devolución, PDF memorándum).
- Documentos generados: Memorándum de devolución PDF (Letter).
Módulo: Control de Facturas
- Alcance: Vinculación solicitud-factura, cálculo fiscal, trazabilidad de zona.
- Endpoints: 6 (
solicitudes-elegibles,vincular,vincular-uno,solicitudes,desvincular,marcar-pagada). - Cálculo: Subtotal, IVA 16%, Ret. IVA 10.67%, Ret. ISR, Total, Total Neto.
Módulo: Analítica / Datamart
- Alcance: Dashboards ejecutivos, datamart de Subrogados, Derivaciones y Finanzas PREI.
- Endpoints: 25+ (KPIs, series, top-N, detalle, Excel).
- Vistas SQL: 4 vistas especializadas (datamart subrogados, derivaciones, finanzas PREI, PREI disponibilidad).
Módulo: PREI / Herramientas
- Alcance: Importación IMKK022, DataGrid de consulta, disponibilidad histórico.
- Tablas:
prei_disponibilidad,prei_disponibilidad_historico,prei_import_jobs. - Endpoints: 15+ (importación, consulta, opciones, analítica).
Módulo: Administración
- Alcance: Usuarios, RBAC, catálogos, proveedores, contratos, changelog.
- Tablas: 10+ tablas (usuarios, perfiles, permisos, instituciones, unidades, proveedores, contratos, catálogos).
- Endpoints: 50+ (CRUD completo de todos los catálogos y entidades).
7. Procesos Institucionales Impactados
| Proceso Institucional | Descripción | Impacto Digital |
|---|---|---|
| Subrogación de servicios médicos | Contratación de servicios con proveedores privados cuando el IMSS no tiene capacidad | Digitalización total del flujo: desde la solicitud hasta el pago |
| Intercambio interinstitucional | Derivaciones bajo Convenio de Colaboración entre instituciones del sector salud | Gestión digital de Anexos, diagnósticos CIE-10 y trazabilidad |
| Recepción y validación de CFDI | Proceso de recepción, verificación y registro de facturas electrónicas de proveedores | Validación automática UUID/RFC, escaneo QR, registro digital |
| Glosa médica | Revisión técnica de la procedencia de los cargos facturados por los proveedores | Mesa de Glosa digital con bitácora completa y asignación a glosadores |
| Control presupuestal PREI | Gestión de la disponibilidad del Presupuesto de Recursos para la Infraestructura | DataGrid integrado, importación automática de reportes IMKK022 |
| Verificación de derechohabiencia | Validación de vigencia de derechos del paciente ante el IMSS | Consulta automática AcceDer antes de cada autorización |
| Validación de personal IMSS | Verificación de empleados IMSS en el sistema de administración de personal | Integración SOAP con SIAP al crear o actualizar usuarios IMSS |
| Reporte SUI Subsistema 19 | Reporte oficial ARIMAC 4-30-13a de estudios subrogados por período | Generación automática desde los datos del sistema |
| Comunicación interna operativa | Mensajes y notificaciones entre operadores, médicos y administradores | Chat 1-a-1 + notificaciones push segmentadas (VAPID) |
| Control de acceso a la información | Regulación de qué información puede ver o modificar cada usuario | RBAC dinámico con 6 privilegios por módulo, por unidad |
8. Integraciones Existentes y Futuras
8.1 Integraciones Activas
| Sistema Externo | Protocolo | Propósito | Estado |
|---|---|---|---|
| AcceDer (Acceso a Derechohabientes IMSS) | SOAP/XML | Verificación de vigencia de derechos del paciente antes de la autorización | 🟢 Activo |
| SIAP (Sistema Integral de Administración de Personal IMSS) | SOAP/XML | Validación de datos biométricos e identificativos de empleados IMSS al crear usuarios | 🟢 Activo |
| SAT (Servicio de Administración Tributaria) | CFDI v3.3/4.0 | Validación de UUID y estructura fiscal de las facturas electrónicas recibidas | 🟢 Activo |
8.2 Integraciones Planificadas
| Sistema Externo | Propósito | Horizonte |
|---|---|---|
| RENAPO (Registro Nacional de Población) | Validación de CURP vía SOAP | Largo plazo |
| PHEDS (Platforma de hospitalización del Ecosistema Digital en Salud) | Consulta de expediente clínico del derechohabiente | Mediano plazo |
| Otras OOADs IMSS | Expansión del sistema a nivel nacional | Corto-mediano plazo |
| ISSSTE / Secretaría de Salud | Gestión de intercambio interinstitucional externo | Largo plazo |
9. Usuarios y Roles Involucrados
SINAPSIS implementa un modelo de Control de Acceso Basado en Roles (RBAC) con los siguientes tipos de usuarios y perfiles:
9.1 Tipos de Usuario
| Tipo | Descripción |
|---|---|
| IMSS | Empleados del IMSS con validación vía SIAP |
| ISSSTE | Personal del Instituto de Seguridad y Servicios Sociales de los Trabajadores del Estado |
| Secretaría de Salud | Personal del sector salud federal o estatal |
| Proveedor | Personal de empresas privadas prestadoras de servicios médicos subrogados |
| Externo | Otros usuarios con acceso controlado |
9.2 Perfiles Operativos Principales
| Perfil | Funciones Principales |
|---|---|
| Administrador del Sistema | Gestión de usuarios, perfiles, catálogos, configuración del sistema |
| Médico / VoBo | Revisión y validación técnica de solicitudes de subrogación |
| Autorizador | Autorización institucional de solicitudes (firma electrónica en flujo) |
| Capturista | Registro de solicitudes de subrogación e intercambio |
| Operador de Facturas | Recepción, registro y seguimiento de facturas CFDI |
| Glosador | Revisión técnica de procedencia de cargos en facturas |
| Analista | Consulta de dashboards, datamart y reportes dinámicos |
| Proveedor Externo | Consulta del estatus de sus facturas vía portal propio |
| Director / Subdirector | Consulta ejecutiva de dashboards y reportes |
9.3 Privilegios del Sistema
| Privilegio | Descripción |
|---|---|
create | Creación de nuevos registros |
read | Consulta y visualización de información |
update | Modificación de registros existentes |
delete | Eliminación lógica (soft delete) de registros |
export | Exportación de datos (Excel, CSV, PDF) |
print | Generación e impresión de documentos oficiales |
10. Beneficios por Área
💡
Los beneficios descritos son funcionalidades implementadas y operativas en la versión actual del sistema.
Dirección Médica
- Visibilidad en tiempo real del volumen y estatus de todas las solicitudes de subrogación e intercambio.
- Dashboards con KPIs de solicitudes, estudios autorizados e importes comprometidos.
- Reportes SUI Subsistema 19 generados automáticamente para reporteo institucional.
- Reducción de riesgo por autorizaciones sin documentación o fuera de los lineamientos normativos.
Área de Finanzas y Presupuesto
- Control integrado de la disponibilidad PREI con los datos históricos y actuales.
- Cálculo fiscal automático (IVA, retenciones) para todas las facturas vinculadas.
- Dashboard histórico de gasto por capítulo, subcapítulo, rubro y departamento.
- Trazabilidad completa de la vinculación solicitud-factura con usuario y fecha.
Área Administrativa (Subrogados e Intercambio)
- Eliminación de registros manuales y uso de papel en los flujos de captura y autorización.
- Flujos digitales con notificaciones automáticas en cada cambio de estatus.
- Historial completo de cada solicitud: desde la captura hasta el pago.
- Verificación automática de derechos del paciente sin necesidad de consultar sistemas externos.
Área de Proveedores
- Portal propio de consulta de estatus de facturas, sin necesidad de contactar al IMSS.
- Trazabilidad de devoluciones con memorándum oficial firmado digitalmente.
- Acceso a contratos y tarifas vigentes en tiempo real.
Área de Glosa
- Mesa de Glosa digital con todas las herramientas integradas (asignación, observaciones, aprobación).
- Acceso simultáneo al expediente completo de la solicitud desde la factura.
- Historial de movimientos y responsables por cada factura, auditable en cualquier momento.
Área de Sistemas e Informática
- Infraestructura dockerizada completamente reproducible con Docker Compose.
- Respaldo automático diario de base de datos a las 23:55 con rotación de los últimos 3 backups.
- Documentación técnica completa en portal Docusaurus (arquitectura, API, seguridad, normativa).
- Código fuente estructurado en monorepo con convenciones de commit estrictas (Conventional Commits).
11. Limitaciones Actuales
| Limitación | Descripción | Plan de Mitigación |
|---|---|---|
| Dependencia de AcceDer | La verificación de vigencia del paciente requiere conectividad a la intranet IMSS (AcceDer). Sin red IMSS, el proceso es no bloqueante pero sin verificación. | Modo no bloqueante con advertencia documentada (ADR-013) |
| Importación PREI manual | El archivo IMKK022 debe ser importado manualmente por el administrador cada vez que se actualiza el presupuesto. | Se evalúa automatización vía API o FTP en mediano plazo |
| Renew certificado intranet manual | El certificado HTTPS del servidor Nivel Central (CDMX) requiere renovación manual (Namecheap API no disponible para DNS-01). Vence julio 2026. | Tarea programada para junio 2026 |
| AI Assistant en CPU | El asistente de IA RAG local con Ollama es funcional pero lento en hardware sin GPU. | Solo disponible en ambiente de desarrollo; producción usa API externa |
| Datos históricos pre-SINAPSIS | Las solicitudes y facturas registradas antes de la implementación no están en el sistema (no hay migración histórica de datos previos). | Posible migración manual a criterio institucional |
| Datamart de Derivaciones y Facturación | Los dashboards analíticos de los módulos de Intercambio y Facturación están en etapa de planificación. | Roadmap mediano plazo |
12. Exclusiones del Alcance
Los siguientes elementos quedan explícitamente fuera del alcance actual de SINAPSIS:
- Historia Clínica Electrónica: El sistema no gestiona expedientes médicos clínicos; solo datos administrativos de solicitudes.
- Módulo de Nómina o Pagos a Empleados: No incluye procesamiento de nómina ni pagos a personal IMSS.
- Gestión de Camas u Hospitalización: No cubre gestión de recursos hospitalarios internos del IMSS.
- Telemedicina: No incluye consultas en línea ni expedientes clínicos digitales.
- Integración con IMSS Digital / IMSS Contigo: No aplica interfaz al derechohabiente final; es un sistema exclusivamente de uso interno IMSS.
- Licitaciones y procesos de compra: No gestiona los procesos de licitación o contratación de proveedores (solo la operación post-contrato).
- Farmacia y medicamentos: No incluye gestión de medicamentos, insumos médicos ni almacenes.
- Facturación hacia el IMSS (cuentas por cobrar): No gestiona la facturación que el IMSS emite; solo la que recibe de proveedores externos.
13. Riesgos Identificados
| Riesgo | Nivel | Mitigación Implementada |
|---|---|---|
| Pérdida de conectividad intranet | Medio | Modo degradado no bloqueante; funciones principales operan en internet |
| Vencimiento de certificado TLS | Medio | Alerta programada para junio 2026; proceso manual de renovación documentado |
| Pérdida de datos por fallo de BD | Bajo | Respaldo automático diario con rotación; respaldo adicional manual pre-deploy |
| Cambio de normativas fiscales (SAT) | Medio | Módulo de facturas desacoplado para adaptación ágil a cambios en CFDI |
| Escalada de usuarios sin RBAC configurado | Bajo | RBAC obligatorio en toda la plataforma; nuevos perfiles requieren configuración explícita |
| Dependencia de versiones AcceDer/SIAP | Bajo | Integración vía contratos SOAP estables; cambios versionados en connector intranet |
| Crecimiento de datos sin particionamiento | Bajo-Medio | Monitoreo activo; particionamiento planificado para fase de escalabilidad |
14. Estrategia de Crecimiento Futuro
SINAPSIS fue diseñado desde el inicio con una arquitectura escalable y multi-institución. La estrategia de crecimiento contempla tres horizontes:
Horizonte Corto Plazo (2026)
- Estandarización de helpers de backend para DataGrid y Datamart.
- Mejora de performance en consultas de analítica (índices, caché selectivo).
- Hardening de seguridad: rotación de claves JWT, rate limiting por endpoint.
- Completar Dashboard Comparativo PREI (multi-zona/OOAD).
- Despliegue en OOADs adicionales (configuración reproducible con Docker Compose).
Horizonte Mediano Plazo (2026-2027)
- Datamart completo para Derivaciones y Facturación.
- Dashboards ejecutivos para dirección (consolidado OOAD, comparativo histórico).
- Mejoras UX/UI basadas en retroalimentación de operadores.
- API pública documentada para integración con sistemas IMSS corporativos.
Horizonte Largo Plazo (2027+)
- Expansión multiinstitución: ISSSTE, Secretaría de Salud, hospitales privados convenidos.
- Integración RENAPO: Validación de CURP vía SOAP para derechohabientes.
- Agentes de inteligencia artificial: Detección de anomalías en facturación, predicción de demanda de servicios subrogados, asistente conversacional para operadores.
- Portal del derechohabiente: Consulta del estatus de su solicitud vía IMSS Digital.
- Firma electrónica avanzada: Integración con e.firma SAT para documentos oficiales.
15. Roadmap del Proyecto
2025 ──────────────────────────────────────────────────────── 2027+
│
├─ [Q3 2025] Módulos base: Subrogados, Intercambio, Facturas
│
├─ [Q4 2025] RBAC dinámico, Portal Proveedores, Chat/Notificaciones
│
├─ [Q1 2026] Control Facturas (vinculación, cálculo fiscal)
│ PREI: Importación + DataGrid
│
├─ [Q2 2026] Analítica Subrogados (Dashboard, Datamart, Reporteador)
│ Finanzas PREI Histórico
│ Reporte SUI Subsistema 19
│ Backup automático diario
│ Documentación integral (Docusaurus)
│ Admin Subrogados completo ← ACTUAL (v1.7.4)
│
├─ [Q3 2026] Comparativo PREI (multi-zona/OOAD)
│ Despliegue OOADs adicionales
│ Hardening seguridad
│
├─ [Q4 2026] Datamart Derivaciones y Facturación
│ Dashboards ejecutivos directivos
│
└─ [2027+] Expansión multiinstitución
Integración RENAPO
Agentes IA operativos
Portal derechohabiente
20
Procesos institucionalizados
9
Tipos de perfil de usuario
3
Integraciones IMSS activas
SINAPSIS v1.7.4 · Uso institucional interno · IMSS OOAD Chihuahua · Mayo 2026