eSTUDIO DE SUFICIENCIA DE LA UPC

17 de jul

Estudio de suficiencia y de los mecanismos de ajuste de riesgo para el cálculo de la Unidad de Pago por Capitación 2024:

Debes hacer clic en la imagen para descargar el archivo completo

Danny Moreano https://www.md-co.org

ACTUALIZACIÓN NORMATIVA 2025

para estar informado, publicación blog

MD&CO Consulting Group · Documentación técnica

Ca Próstata Valle

Manual técnico de arquitectura, mantenimiento y transferencia

Plataforma demostrativa de gestión integral de la ruta de cáncer de próstata en el Valle del Cauca.

Versión documentada: V12F · Corte: 28 de octubre de 2026

Estado: prototipo funcional con datos ficticios. No autorizado para uso clínico.

Índice de contenidos

01. Identificación y alcance

Nombre: CaPróstata Valle.

Propósito: apoyar demostrativamente el registro, seguimiento y análisis de oportunidad de una ruta integral de atención del cáncer de próstata.

Ámbito: Valle del Cauca, Colombia. Referencia institucional del prototipo: HUV.

Tecnología: Google Apps Script, Google Sheets, HTML, CSS y JavaScript.

Versión funcional: evolución de módulos V4 a V12F.

El sistema contiene exclusivamente datos ficticios. No debe emplearse para almacenar información real de pacientes ni para decisiones diagnósticas o terapéuticas. Los motores PCPT y PBCG están integrados con fines demostrativos y requieren validación clínica independiente.

1.1. Rutas del proyecto

Recurso	Enlace	Finalidad
Editor Apps Script	Abrir código fuente	Administración y edición del proyecto.
Entorno /dev	Abrir pruebas	Validación de cambios guardados, según permisos.
Portal /exec	Navegar por el portal	Versión desplegada para demostración.
Base de datos	Abrir Google Sheets	Persistencia de registros ficticios.

La URL del editor identifica el proyecto fuente. La URL /dev ejecuta la versión de desarrollo y /exec una implementación desplegada. No debe suponerse que ambas contienen exactamente la misma versión sin verificar el historial de implementaciones.

1.2. Estado de la evidencia

Este manual se basa en el código HTML compartido durante el desarrollo, las funciones Apps Script proporcionadas en la conversación y los registros de ejecución hasta V12F. No constituye una auditoría completa del repositorio actual. Antes de modificar el proyecto, el desarrollador entrante debe contrastar el inventario con los archivos existentes en el editor.

02. Arquitectura tecnológica

2.1. Componentes

Usuario
Chrome / navegador

→

Index.html
Interfaz y eventos

→

google.script.run
Comunicación asíncrona

→

Apps Script
Reglas y validación

→

Google Sheets
Persistencia

2.2. Responsabilidades

Capa	Responsabilidad
Presentación	Renderizar formularios, navegación, tablas, gráficos, mapas, mensajes y validaciones inmediatas.
Comunicación	Invocar funciones Apps Script mediante `google.script.run`, con manejadores de éxito y error.
Servidor	Validar entradas, consultar pacientes, registrar evaluaciones, calcular indicadores, almacenar gestiones y recuperar historiales.
Datos	Conservar registros tabulares en Google Sheets, relacionados mediante identificadores.
Servicios externos	Leaflet 1.9.4 y teselas OpenStreetMap para los mapas; enlaces de referencia a PCPT y PBCG.

2.3. Patrón de comunicación

google.script.run
  .withSuccessHandler(resultado => {
    // Actualizar la interfaz
  })
  .withFailureHandler(error => {
    // Mostrar el error
  })
  .nombreFuncionServidor(datos);

Las llamadas son asíncronas. El frontend debe evitar guardar dos veces, controlar errores y comprobar que una respuesta tardía todavía corresponde al paciente seleccionado.

2.4. Consideraciones de diseño

La aplicación es un prototipo monolítico en Apps Script. No se ha confirmado un repositorio Git, entorno de integración continua ni infraestructura independiente de Google Workspace.

El código HTML utiliza estilos y funciones JavaScript integrados en la página. Para una evolución futura se recomienda separar responsabilidades y mantener un inventario formal de versiones.

03. Inventario de archivos, módulos y funciones

El proyecto contiene archivos Apps Script y una interfaz HTML. Los nombres exactos de todos los archivos deben verificarse en el editor antes de una transferencia definitiva.

3.1. Archivos identificados

Archivo	Responsabilidad	Evidencia
`Index.html`	Interfaz, navegación, formularios, resultados, alertas, mapas e historiales.	Código compartido y pruebas visuales.
`Code.gs`	Funciones generales y acceso a datos; distribución exacta pendiente de auditoría.	Identificado en el editor.
`IndicadoresV11.gs`	Hitos, indicadores de oportunidad, consulta de alertas y gestiones V12.	Funciones y ejecuciones verificadas.
`FactoresRiesgoV9.gs`	Registro y consulta de antecedentes.	Identificado durante el desarrollo.
`PBCG_Validacion.gs`	Validaciones relacionadas con PBCG.	Nombre observado; contenido pendiente.
`PBCG_Integracion_V6B.gs`	Integración de evaluaciones PBCG.	Nombre observado; contenido pendiente.
`AlertasNavegacionV7.gs`	Bandeja general de navegación y alertas.	Nombre observado; pruebas funcionales.
`CalculadoraPCPT_V10.gs`	Registro y cálculo demostrativo PCPT.	Funciones utilizadas y registros de validación.

3.2. Funciones del frontend

Función	Responsabilidad
`go(id)`	Alterna las secciones visibles y actualiza la navegación.
`reload()`	Recupera datos generales mediante `obtenerInicioDemo()`.
`render()`	Actualiza indicadores generales, tablas, selectores y distribución por etapas.
`fr9ConsultarPaciente()`	Consulta antecedentes y actualiza el formulario V9.
`aps10ConsultarPaciente()`	Consulta datos sugeridos e historial APS.
`aps10MostrarResultadoPCPT()`	Representa probabilidades, barra segmentada e interpretación demostrativa.
`pbcgMostrarResultado()`	Muestra resultados PBCG.
`cargarBandejaNAV7()`	Consulta y presenta alertas generales.
`v11MostrarAlertas()`	Renderiza alertas de oportunidad y botones Gestionar.
`v11MostrarIndicadores()`	Actualiza tarjetas de oportunidad y cumplimiento.
`v12AbrirGestion()`	Abre el formulario para el hito seleccionado.
`v12IniciarGuardado()`	Controla el registro de intervenciones.
`v12MostrarHistorial()`	Construye el historial administrativo detallado.

3.3. Funciones de servidor identificadas

MD&CO CONSULTING GROUP · GUÍA DE OPERACIÓN

Ca Próstata Valle

Manual de Usuario

Gestión integral de la ruta de cáncer de próstata en el Valle del Cauca.

Versión demostrativa V12F · 28 de octubre de 2026

Dirigido a medicina general, urología, navegadores de pacientes y equipos de seguimiento.

Contenido del manual

01. Introducción

CaPróstata Valle es una plataforma demostrativa para representar la gestión y el seguimiento de pacientes a lo largo de una ruta de atención del cáncer de próstata.

Su propósito es facilitar la comprensión de cómo una herramienta digital puede integrar el registro nominal, la evaluación inicial, la valoración especializada, los estudios, las alertas, los indicadores de oportunidad y el seguimiento de intervenciones.

1.1. Usuarios previstos

Función	Finalidad
`bd_()`	Acceso a la base de Google Sheets.

Perfil	Uso previsto
Médico general	Registro de evaluación inicial, antecedentes y variables de atención primaria.
Personal de urología	Consulta de antecedentes y demostración de evaluación especializada.
Navegador de pacientes	Seguimiento, identificación de pendientes y registro de gestiones.
Coordinación de ruta	Revisión de indicadores, tiempos y alertas de oportunidad.
Personal administrativo	Consulta demostrativa de contactos, compromisos y disponibilidad de cupos.

Uso exclusivamente demostrativo. No registrar nombres, identificaciones, teléfonos, direcciones, resultados clínicos ni otros datos reales. Las calculadoras y los indicadores del prototipo no están validados para tomar decisiones clínicas.

1.2. Principios de operación

La plataforma conserva historiales de evaluaciones y gestiones. Los resultados de una evaluación anterior no deben confundirse con los datos que se están diligenciando en un formulario nuevo.

El cierre administrativo de una gestión tampoco equivale a la confirmación diagnóstica ni al inicio del tratamiento.

02. Acceso al portal

2.1. Dirección principal

Para navegar por la demostración, utiliza:

Abrir portal demostrativo CaPróstata Valle

2.2. Procedimiento de ingreso

Abre Google Chrome u otro navegador compatible.
Ingresa a la dirección del portal demostrativo.
Si Google solicita autenticación, utiliza una cuenta con acceso autorizado.
Espera a que cargue la página principal.
Comprueba que aparezca el aviso de datos ficticios.
Selecciona el módulo que deseas consultar desde el menú superior.

El acceso depende de la configuración y los permisos del despliegue de Google Apps Script. Si aparece un error de autorización, contacta al administrador del proyecto.

2.3. Entorno de pruebas

Los desarrolladores y usuarios autorizados para pruebas pueden utilizar la versión /dev. Esta versión puede diferir de la versión desplegada /exec.

03. Navegación general

La aplicación dispone de un menú superior para acceder a sus diferentes componentes. Según la versión desplegada, pueden aparecer las siguientes opciones:

Módulo	Función principal
Inicio	Presentación general y resumen de pacientes y alertas.
Registro nominal	Consulta y captura de información de pacientes ficticios.
Atención primaria - PCPT	Evaluación inicial demostrativa por medicina general.
Calculadora PBCG	Evaluación especializada demostrativa.
Navegación	Seguimiento de pacientes y contactos.
Bandeja de alertas	Alertas generales y por tiempos de oportunidad.
Mapa y cupos	Consulta geográfica y oferta ficticia.
Indicadores	Resumen de oportunidad diagnóstica y tratamiento.

3.1. Tarjetas del inicio

La portada presenta tarjetas con pacientes registrados, pacientes en urología, alertas abiertas y casos cerrados. Estos valores corresponden al conjunto de datos de demostración y no representan cifras institucionales reales.

No interpretar el número de casos cerrados como número de pacientes curados. El cierre de una ruta o de una actividad administrativa requiere una definición operativa específica.

04. Registro nominal de pacientes

4.1. Objetivo

El registro nominal permite identificar y consultar pacientes ficticios dentro de la ruta. Cada paciente debe conservar un identificador interno que permita relacionar sus evaluaciones, antecedentes, contactos, hitos y gestiones.

4.2. Información del registro

Grupo	Datos previstos
Identificación	Identificador, documento ficticio y nombre ficticio.
Caracterización	Edad, municipio, EPS y régimen.
Contacto	Teléfono, dirección, barrio y ciudad ficticios.
Información clínica	Datos clínicos y observaciones relevantes de prueba.
Ruta	Momento de atención, estado, próxima acción y fecha programada.

4.3. Consulta de un paciente

Ingresa a Registro nominal.
Localiza el paciente ficticio mediante las opciones de búsqueda disponibles.
Comprueba que corresponda al registro que deseas consultar.
Revisa los datos generales y el momento de la ruta.
Utiliza los módulos de evaluación o seguimiento según la actividad demostrativa que realizarás.

La estructura de datos admite campos de contacto y antecedentes, pero las opciones concretas de edición pueden variar según la versión publicada. No debe asumirse que todos los campos sean editables desde la misma pantalla.

05. Consulta y actualización de factores de riesgo

Este módulo permite consultar antecedentes de un paciente ficticio y registrar nuevas evaluaciones sin eliminar las anteriores.

5.1. Variables del formulario

Variable	Descripción
Antecedente familiar	Presencia o ausencia de antecedentes familiares.
Familiar afectado	Relación familiar declarada.
Edad del familiar al diagnóstico	Edad referida para el antecedente familiar.
Cáncer hereditario familiar	Información declarada sobre antecedente hereditario.
Mutación genética conocida	Existencia de información genética previa.
Ascendencia africana	Variable contemplada en los modelos demostrativos.
Biopsia negativa previa	Antecedente de biopsia prostática negativa.
Tacto rectal	Resultado registrado o condición no realizada.
Síntomas urinarios y signos de alarma	Información narrativa de la evaluación.
Observaciones	Información complementaria.

5.2. Procedimiento

Abre Consulta y actualización de factores de riesgo.
Selecciona un paciente ficticio registrado.
Espera a que aparezcan sus antecedentes y el historial, si existe.
Revisa los valores recuperados antes de modificarlos.
Diligencia las variables correspondientes a la nueva evaluación.
Confirma que los datos son ficticios.
Selecciona Guardar nueva evaluación.
Verifica el mensaje de confirmación y consulta el historial actualizado.

5.3. Historial

Las evaluaciones aparecen organizadas desde la más reciente. Cada elemento puede desplegarse para consultar sus variables y observaciones.

Una nueva evaluación no reemplaza automáticamente las anteriores. Si se identifican diferencias, deben revisarse sus fechas y circunstancias, no asumir que un valor histórico es un error.

06. Evaluación inicial de riesgo - Atención primaria PCPT

El módulo PCPT permite demostrar cómo el médico general podría registrar una evaluación inicial a partir de variables disponibles en atención primaria.

6.1. Datos solicitados

Campo

Uso en el formulario

MD & CO CONSULTING GROUP

¿Tienes preguntas?

Telefono: +6024869390

Email: Info@mdco.com.co

Dirección: 5-169 Carrera 100, torre B, piso n°6, Cali, Valle del Cauca, CP 760032, Colombia

Política de protección de datos personales

Todos los derechos reservados MD&CO Consulting Group - De acuerdo a las políticas internas de MD&CO Consulting Group la información del registro de clientes y usuarios en nuestra pagina web únicamente se utilizan en nuestro sitio web. Las finalidades del Tratamiento de datos personales suministrados por nuestros clientes y usuarios tales como teléfono, dirección, correo electrónico, celular, son específicamente para mantener la conectividad académica, la consultoría o el acompañamiento y de comercialización de nuestros productos y servicios.