Pacientes

​

Descripción

• Centraliza toda la información del paciente
• Sirve como referencia para citas, facturas, documentos clínicos
• Cumple con normativas de protección de datos (LOPD/RGPD)
• Permite trazabilidad completa del paciente
• Facilita la comunicación con el paciente (email/SMS)

​

Usuarios Objetivo

• Recepcionistas: Crear y actualizar datos básicos de pacientes, gestionar citas
• Personal administrativo: Gestión completa de datos administrativos y documentación
• Profesionales médicos: Acceso a historial clínico, documentos médicos, evolución
• Administradores: Configuración, fusión de duplicados, gestión de permisos

​

1. Alta de Nuevo Paciente

• Actor: Recepcionista / Administrativo
• Objetivo: Dar de alta un nuevo paciente en el sistema
• Precondiciones: Usuario con permiso de creación de pacientes
• Pasos:
  1. Ir a Pacientes → Crear paciente
  2. Rellenar datos obligatorios (nombre, apellidos)
  3. Completar datos de contacto (teléfono, email)
  4. Seleccionar pagador (privado, aseguradora, etc.)
  5. Aceptar consentimiento LOPD
  6. Guardar paciente (se asigna número automáticamente)
• Resultado: Paciente creado y disponible para citas y facturación

​

2. Búsqueda de Paciente

• Actor: Cualquier usuario con acceso
• Objetivo: Localizar un paciente específico
• Precondiciones: Paciente debe existir en la base de datos
• Pasos:
  1. Ir a Pacientes → Buscar pacientes
  2. Introducir criterios de búsqueda (nombre, DNI, teléfono, nº paciente)
  3. Ejecutar búsqueda
  4. Seleccionar paciente de los resultados
• Resultado: Ficha del paciente abierta para consulta/edición

​

3. Actualización de Datos

• Actor: Recepcionista / Administrativo
• Objetivo: Modificar datos de un paciente existente
• Precondiciones: Paciente localizado, permiso de edición
• Pasos:
  1. Buscar y abrir paciente
  2. Hacer clic en botón “Editar”
  3. Modificar campos necesarios
  4. Guardar cambios
• Resultado: Datos actualizados en el sistema

​

4. Gestión de Documentos del Paciente

• Actor: Personal médico / Administrativo
• Objetivo: Subir o consultar documentos del paciente
• Precondiciones: Paciente creado
• Pasos:
  1. Abrir ficha de paciente
  2. Ir a pestaña “Archivos”
  3. Subir nuevo documento o consultar existentes
  4. Categorizar documento (médico, administrativo, etc.)
  5. Si se genera un documento de plantilla para imprimir y el centro tiene activada la preferencia de profesional firmante, seleccionar el profesional cuyos datos de firma se insertarán en el documento
• Resultado: Documentación del paciente organizada y accesible

​

5. Firma Electrónica de Consentimientos

• Actor: Paciente (con asistencia de personal)
• Objetivo: Firmar electrónicamente consentimientos informados
• Precondiciones: Sistema de firma online activado
• Pasos:
  1. Desde ficha de paciente, solicitar firma
  2. Seleccionar plantilla de consentimiento
  3. Enviar solicitud por email al paciente
  4. Paciente firma desde enlace recibido
  5. Documento firmado se almacena automáticamente
• Resultado: Consentimiento firmado digitalmente y archivado

​

6. Solicitud de Documentos al Paciente

• Actor: Personal administrativo
• Objetivo: Solicitar al paciente que complete/suba documentos
• Precondiciones: Sistema de solicitud de documentos activado
• Pasos:
  1. Desde Pacientes → Solicitud de documentos
  2. Crear nueva solicitud
  3. Seleccionar paciente y documentos a solicitar
  4. Enviar notificación por email
  5. Paciente completa desde portal online
  6. Personal revisa documentos recibidos
• Resultado: Documentos recibidos del paciente

​

Opciones del Menú

​

Opción 1: Buscar Pacientes

• Función JavaScript: openPatientSearch()
• Vista cargada: partials3.0/patient/patientsearch
• Descripción: Pantalla de búsqueda avanzada de pacientes con múltiples filtros

​

Opción 2: Crear Paciente

• Función JavaScript: openCreatePatientForm()
• Vista cargada: partials3.0/patient/patient
• Descripción: Formulario de alta de nuevo paciente

​

Opción 3: Firmas Online (Opcional)

• Función JavaScript: openSignrequestSearch()
• Vista cargada: partials3.0/patient/signrequestsearch
• Descripción: Gestión de solicitudes de firma electrónica

​

Opción 4: Solicitud de Documentos (Opcional)

• Función JavaScript: openDocfillrequestSearch()
• Vista cargada: partials3.0/patient/docfillrequestsearch
• Descripción: Solicitudes de documentos al paciente
• Configuración: customer->allowSendCustomDocumentsToFillByPatient()

​

Opción 5: Remisiones (Opcional)

• Función JavaScript: openPatientremissionSearch()
• Vista cargada: partials3.0/patient/patientremissionsearch
• Descripción: Derivaciones a otros profesionales
• Configuración: customer->allowRemisiones()

​

Pantalla 1: Búsqueda de Pacientes

​

Descripción

​

Secciones de la Pantalla

• Campos de filtro: 9 campos de búsqueda (ver tabla detallada abajo)
• Botones de gestión de filtros:
  • “Guardar filtro actual” - Almacena configuración de filtros actual
  • “Cargar filtro” - Recupera filtros previamente guardados
• Botones de acción:
  • “Buscar” (botón azul) - Ejecuta la búsqueda
  • “Limpiar filtro” - Resetea todos los campos
  • “Filtro Avanzado” - Abre opciones adicionales de filtrado

• Listado de pacientes encontrados (tabla con 10 columnas visibles)
• Paginación: Muestra registros configurables (20/50/100/200 por página)
• Indicador: “Mostrando 1 - 20 de 57” (ejemplo con 57 pacientes totales)
• Ordenamiento por columnas (clic en encabezado)
• Selección múltiple mediante checkboxes

• Acciones - Menú desplegable con acciones sobre pacientes seleccionados
• Exportar - Exportar resultados a Excel
• Cód. barras - Generar códigos de barras de pacientes
• Ficha - Ver ficha completa del paciente seleccionado
• Nuevo - Crear nuevo paciente (abre formulario de creación)
• Importar pacientes - Importación masiva desde archivo
• Buscar duplicados - Detectar pacientes duplicados

​

Campos de Búsqueda

Nota sobre campo “Activo”: Tiene dos checkboxes independientes (Si/No) que permiten buscar pacientes activos, inactivos, o ambos si ninguno está marcado.

• Fecha nacimiento (rango)
• Pagador
• Profesional asignado
• Es pre-paciente
• Otros criterios avanzados

​

Columnas del Grid

Nota: Las columnas son configurables y pueden variar según preferencias del usuario. La configuración mostrada corresponde a la vista por defecto.

• Selector de registros por página: 20 / 50 / 100 / 200
• Navegación por páginas (Anterior / Siguiente)
• Indicador de registros: “Mostrando [inicio] - [fin] de [total]”
• Ejemplo: “Mostrando 1 - 20 de 57”

• Fecha de nacimiento
• Edad
• Email
• Pagador
• Profesional asignado
• Última cita

​

Pantalla 2: Formulario de Creación/Edición de Paciente

​

Descripción

​

Estructura del Formulario de Creación

• Nº Paciente: Auto-asignado (ej: “64”) - Campo de solo lectura
• Nº Externo: Número de referencia externa (opcional)
• Nombre* - Obligatorio
• Primer apellido* - Obligatorio
• 2º apellido
• Tipo ID: Selector (DNI/NIE/Pasaporte/CIF)
• DNI/NIE/CIF: Número de documento
• Fecha nacimiento: Selector de fecha
• Sexo: Radio buttons (Hombre/Mujer)
• RGPD firmado?: Toggle switch
• Activo?: Toggle switch

• País: Selector de país
• CP: Código postal
• Provincia: Selector de provincia
• Región/Comunidad autónoma
• Dirección: Calle/Avenida
• Población: Ciudad/Localidad
• Tel. Móvil: Teléfono principal
• Tel. 2: Teléfono secundario
• Email: Correo electrónico principal
• Email 2: Correo secundario

• Pagador* - Obligatorio - Selector (Privado/Aseguradora/etc.)
• Etiquetas: Multi-select para categorización
• Descuento: Selector de descuento aplicable
• Permisos de comunicación (toggle switches):
  • WhatsApp
  • SMS
  • Email
• Asignado a: Profesional responsable
• Desde: Fecha de alta

• Comentario: Campo de texto largo para observaciones
• Estado civil: Selector (Soltero/Casado/etc.)

Campos obligatorios: Los campos marcados con asterisco (*) son obligatorios: Nombre, Primer apellido, Pagador.

• Título: “Crear Paciente” / “Editar Paciente”
• Botón “Guardar” (esquina superior derecha)
• Botón “Cancelar” (cierra el formulario)

​

Estructura de la Ficha Completa (Paciente Existente)

​

Pantalla 3: Ficha Completa del Paciente (Pestañas)

• screenshots/pacientes-ficha-principal.png (pestaña INICIO)
• screenshots/pacientes-ficha-episodios.png (pestaña EPISODIOS)
• screenshots/pacientes-ficha-hoja-clinica-llave.png (pestaña HOJA CLÍNICA)
• screenshots/pacientes-ficha-calendario.png (pestaña CALENDARIO)
• screenshots/pacientes-ficha-datos-contacto.png (pestaña DATOS DE CONTACTO)
• screenshots/pacientes-ficha-crm.png (pestaña CRM)
• screenshots/pacientes-ficha-timeline.png (pestaña TIMELINE)

​

Descripción General

​

Cabecera de la Ficha (Común a todas las pestañas)

• Avatar del paciente: Icono/foto del paciente (Hombre/Mujer genérico si no tiene foto personalizada)
• Nombre completo y número: “Prueba AddisAbeba Johannesburgo | 55”
• Edad: Calculada automáticamente desde fecha de nacimiento (ej: “36 años”)
• Estado RGPD: Indicador visual del estado de firma RGPD
  • “RGPD firmada” (verde) o “RGPD no firmada” (rojo/advertencia)
• Información de citas:
  • Última cita: Fecha de la última cita atendida o “No hay.”
  • Próxima cita: Fecha de la siguiente cita programada o “No hay. [crear cita]”
  • Enlace rápido para crear cita

Ejemplo de contador: “Citas 0”, “Facturas 0”, “Bonos/Actividades 0 0”

​

Pestaña 1: INICIO

• Avatar, nombre, edad, RGPD, última cita, próxima cita (descrito arriba)

• Lista de citas programadas futuras
• Si no hay citas: Mensaje “No hay citas programadas”
• Cada cita muestra:
  • Fecha y hora
  • Profesional
  • Prestación/servicio
  • Estado de la cita
  • Botones de acción (modificar, cancelar, etc.)

• Información de la última cita atendida
• Si no hay: Mensaje “No hay citas pasadas”
• Detalles mostrados:
  • Fecha de la cita
  • Profesional que atendió
  • Prestación realizada
  • Notas de la cita
  • Factura asociada (si existe)

• Crear nueva cita (desde botón ”+ Crear cita” en cabecera)
• Ver detalles de citas (haciendo clic en cada cita)
• Acceder a otras pestañas desde menú superior

​

Pestaña 2: EPISODIOS

• Mensaje: “No hay episodios registrados.”
• Submensaje: “Cree un episodio para visualizar la información.”
• Botón: ” Nuevo episodio”

• Lista de episodios con:
  • Nombre del episodio
  • Fecha de inicio
  • Fecha de fin (si está cerrado)
  • Estado (Activo/Cerrado)
  • Diagnóstico principal
  • Citas asociadas al episodio
  • Profesional responsable

• Múltiples citas relacionadas
• Diagnósticos
• Tratamientos
• Evolución del paciente
• Documentos clínicos asociados

• “Tratamiento de Fisioterapia - Lumbalgia” (10 sesiones)
• “Tratamiento Ortodóncico” (seguimiento de 2 años)
• “Proceso Quirúrgico - Rodilla” (pre-op, cirugía, post-op)

• Crear nuevo episodio
• Abrir/editar episodio existente
• Cerrar episodio
• Ver citas del episodio
• Agregar notas de evolución

​

Pestaña 3: HOJA CLÍNICA

1. “Seleccionar código QR desde fichero”
   • Permite seleccionar una imagen con código QR desde el ordenador
   • El QR contiene la clave de cifrado de la historia clínica
2. “Introducir código alfanumérico”
   • Opción para escribir manualmente el código de desbloqueo
   • Código alfanumérico de seguridad

• “Puede arrastrar aquí el código QR”
• Drag & drop para subir imagen del QR

• aceptar - Procesar el QR/código introducido
• cancelar - Cancelar acceso a hoja clínica

• Cumplimiento con normativa de protección de datos sanitarios
• Doble factor de autenticación para historia clínica
• Prevención de accesos no autorizados
• Registro de accesos (auditoría)

• Código QR único por profesional
• Se genera desde administración del sistema
• Puede imprimirse o guardarse en móvil
• Necesario presentarlo cada vez que se accede a historia clínica protegida

• Anamnesis
• Exploración física
• Diagnósticos
• Tratamientos
• Prescripciones
• Evoluciones
• Pruebas complementarias
• Informes médicos

​

Pestaña 4: CALENDARIO

• Título: ” CALENDARIO PARTICULAR”
• Subtítulo: “RESUMEN (01/12/2025 - 31/12/2025)”

• Encabezado: “diciembre 2025” (heading nivel 2)
• Días de la semana: lun. mar. mié. jue. vie. sáb. dom.
• Días del mes: 1-31 (diciembre 2025 en captura)
• Días de otros meses: 1-11 (enero 2026 visible al final)

• Las citas aparecen como eventos en los días correspondientes
• Código de colores según estado de la cita:
  • Azul: Programada
  • Verde: Confirmada
  • Amarillo: En sala
  • Gris: Atendida
  • Rojo: No asiste
• Al hacer clic en una cita, se abre diálogo con detalles

• Calendario vacío sin eventos

• Cambiar entre meses con flechas prev/next
• Cambiar tipo de vista (Mes/Semana/Día)
• Hacer clic en un día para crear cita en esa fecha

• Visualizar agenda del paciente
• Identificar patrones de asistencia
• Planificar futuras citas
• Ver historial de citas pasadas

​

Pestaña 5: DATOS DE CONTACTO

• Título: ” DATOS DEL PACIENTE” (con icono de usuario)
• Botón: ” Aceptar” (para guardar cambios)

• Icono de menú desplegable "" junto a Nº Externo para “ver acciones”

• “Personas de contacto” - Para gestionar contactos relacionados con el paciente

• Etiqueta: “Sucursal”
• Valores mostrados:
  • “centro” / “sucursal”
  • “Centro Clínica TEST”
• Botón: "" (icono de lápiz) para “Modificar”

• Las secciones son acordeones (colapsables/expandibles)
• Al hacer cambios, se habilita el botón “Aceptar”
• Los campos obligatorios están marcados con *
• Los toggle switches tienen estados SI/NO con colores diferenciados
• Los combo boxes tienen autocompletado y búsqueda
• Validación en tiempo real de email, teléfono, CP, etc.

• Guardar cambios (botón “Aceptar”)
• Ver acciones adicionales (menú desplegable)
• Modificar sucursal/centro asignado
• Gestionar personas de contacto

​

Pestaña 6: CRM

• ” especial”
• ” provisional”
• ” test1”

• ” Crear nueva etiqueta” - Permite definir nuevas categorías

• ” Nuevo” - Descripción: “Crear nueva” (probablemente nueva interacción o tarea)

• Permiten categorizar pacientes (VIP, Urgente, Seguimiento especial, etc.)
• Se usan para filtrar búsquedas
• Segmentar campañas de marketing
• Identificar pacientes con necesidades especiales

• Documentar todas las interacciones con el paciente
• Trazabilidad de comunicaciones
• Historial completo de contactos
• Cumplimiento normativo (registro de consentimientos verbales, etc.)

• Enviar recordatorios
• Notificaciones de resultados
• Información de interés
• Respeta preferencias de comunicación del paciente
• Al enviar una notificación, el diálogo se cierra automáticamente y aparece un mensaje de confirmación verde en la parte inferior indicando que el mensaje ha sido enviado al procesador de notificaciones correctamente

• Marcar paciente como “VIP” para atención especial
• Registrar que se llamó al paciente para confirmar cita
• Enviar SMS recordatorio de cita mañana
• Documentar conversación telefónica sobre resultados
• Enviar email con indicaciones post-consulta

​

Pestaña 7: TIMELINE

• ☑ Comunicaciones - Llamadas, emails, mensajes (checked)
• ☑ Tareas - Tareas asociadas al paciente (checked)
• ☐ Citas - Citas programadas y atendidas (unchecked)
• ☐ Pagos - Historial de pagos (unchecked)

• Creado entre Fecha: Campo de fecha con valor “18/12/2025”
• y fecha: Campo de fecha vacío
• Botón ” Buscar” para aplicar filtros

• × - Cerrar/colapsar panel de filtros

• Comunicaciones:
  • Llamadas telefónicas recibidas/realizadas
  • Emails enviados/recibidos
  • Mensajes WhatsApp
  • Mensajes SMS
  • Otros contactos
• Tareas:
  • Tareas creadas
  • Tareas completadas
  • Recordatorios
• Citas:
  • Citas programadas
  • Citas confirmadas
  • Citas atendidas
  • Citas canceladas
• Pagos:
  • Facturas emitidas
  • Pagos recibidos
  • Presupuestos enviados

• Icono según tipo de evento (teléfono, email, cita, pago)
• Fecha y hora del evento
• Usuario que registró el evento
• Descripción del evento
• Detalles adicionales (según tipo)
• Acciones disponibles (ver detalles, editar, eliminar)

• ” Llamada telefónica”
• ” Email”
• ” WhatsApp”
• ” Facebook”
• “Videoconferencia”
• ” Otro”

Profesional abre timeline del paciente → Filtra últimas 2 semanas
→ Ve: llamada de confirmación, email con indicaciones, cita anterior hace 15 días
→ Contexto completo para la consulta

Buscar eventos de un periodo (último mes) → Filtrar solo citas y comunicaciones
→ Ver: 4 citas atendidas, 2 llamadas de seguimiento, 1 email con dudas
→ Evaluar adherencia al tratamiento

Filtrar solo comunicaciones → Ver todas las notificaciones enviadas
→ Verificar que se informó al paciente correctamente
→ Cumplimiento LOPD (registro de consentimientos)

​

Navegación entre Pestañas

• Las pestañas se cargan dinámicamente (AJAX)
• El contenido se carga solo cuando se accede a la pestaña
• La URL cambia con hash para permitir enlaces directos
• Se puede abrir directamente una pestaña específica desde un enlace
• El estado se mantiene al navegar entre pestañas

• Desde búsqueda → doble clic → abre pestaña INICIO
• Desde diálogo de acciones → “Ficha completa” → abre pestaña INICIO
• Desde cita → clic en paciente → abre pestaña INICIO
• Desde factura → clic en paciente → abre pestaña INICIO

​

Formularios y Campos

Nota: Esta sección documenta la estructura completa de campos del modelo de datos de paciente. La presentación visual en la interfaz de usuario agrupa estos campos en las 4 secciones descritas en la pantalla anterior (ver screenshots/pacientes-formulario-crear.png).

​

Formulario: Datos del Paciente

​

Sección 1: Datos de Identificación

​

Sección 2: Datos de Contacto

​

Sección 3: Datos Administrativos

​

Sección 4: Datos Médicos / Clínicos

​

Sección 5: Permisos y Notificaciones

Nota de interfaz: En la UI, estos campos se muestran como toggle switches (interruptores) en lugar de checkboxes tradicionales, ubicados en la sección “Datos administrativos” del formulario de creación.

​

Sección 6: Datos de Alta/Baja

​

Sección 7: Estado

​

Workflow 1: Crear Nuevo Paciente

1. Usuario hace clic en "Pacientes" → "Crear paciente"
   ↓
2. Sistema muestra formulario vacío en modo edición
   - Formulario organizado en 4 secciones acordeón
   - Primera sección "Datos principales" desplegada por defecto
   - Nº Paciente pre-asignado visible (ej: "64")
   ↓
3. Usuario completa datos obligatorios en sección "Datos principales":
   - Nombre*
   - Primer apellido*
   - Opcionalmente: 2º apellido, DNI, Fecha nacimiento, Sexo
   - Activa toggle "RGPD firmado?" (obligatorio)
   - Activa toggle "Activo?" (por defecto activado)
   ↓
4. Usuario despliega sección "Datos de contacto" y completa:
   - Tel. Móvil
   - Email
   - Dirección completa (País, CP, Provincia, Dirección, Población)
   ↓
5. Usuario despliega sección "Datos administrativos" y completa:
   - Pagador* (obligatorio)
   - Etiquetas (opcional, multi-select)
   - Descuento (opcional)
   - Permisos de comunicación con toggle switches:
     • WhatsApp
     • SMS
     • Email
   - Profesional asignado (opcional)
   ↓
6. Usuario opcionalmente despliega "Datos complementarios":
   - Comentario
   - Estado civil
   ↓
7. Usuario hace clic en botón "GUARDAR" (esquina superior derecha)
   ↓
8. Sistema valida datos:
   - Nombre no vacío
   - Primer apellido no vacío
   - Pagador seleccionado
   - RGPD firmado activado
   - Email válido (si se proporciona)
   - Teléfono válido (si se proporciona)
   ↓
9. Sistema verifica duplicados (si está configurado):
   - Busca por DNI si se proporcionó
   - Busca por nombre+apellidos+fecha nacimiento
   - Si encuentra similar, pregunta si desea continuar
   ↓
10. Sistema guarda paciente:
    - Asigna el número de paciente mostrado (ej: 64)
    - Genera código aleatorio para acceso online
    - Guarda fecha de creación
    - Almacena datos de aceptación LOPD
    ↓
11. Sistema muestra mensaje "Paciente creado correctamente"
    ↓
12. Formulario se cierra o pasa a modo solo lectura
    ↓
13. Paciente disponible para búsquedas, citas y facturación

• Si el paciente es empresa (pre-paciente tipo 2): Se muestran campos diferentes
• Si es pre-paciente (contacto): No se asigna número de historia
• Si hay foto: Se sube avatar después de crear paciente

• Error: “El campo nombre es obligatorio”
  • Causa: No se completó el nombre del paciente
  • Solución: Rellenar el campo nombre
• Error: “Debe seleccionar un pagador”
  • Causa: No se seleccionó tipo de pagador
  • Solución: Seleccionar pagador de la lista desplegable
• Error: “Email no válido”
  • Causa: Formato de email incorrecto
  • Solución: Verificar formato (ejemplo@dominio.com)
• Error: “Ya existe un paciente con este DNI”
  • Causa: DNI duplicado en la base de datos
  • Solución: Verificar si es el mismo paciente o corregir DNI

​

Workflow 2: Buscar y Editar Paciente

1. Usuario va a "Pacientes" → "Buscar pacientes"
   ↓
2. Sistema muestra pantalla de búsqueda
   ↓
3. Usuario introduce criterios de búsqueda:
   - Por nombre: Escribe "García"
   - O por DNI: Escribe "12345678A"
   - O por teléfono: Escribe "600123456"
   ↓
4. Usuario hace clic en "BUSCAR"
   ↓
5. Sistema busca en base de datos
   ↓
6. Sistema muestra resultados en grid:
   - Lista paginada de pacientes coincidentes
   - Ordenados por relevancia/nombre
   ↓
7. Usuario hace clic en paciente deseado
   ↓
8. Sistema abre ficha del paciente en modo solo lectura
   ↓
9. Usuario hace clic en botón "EDITAR" (icono lápiz)
   ↓
10. Formulario pasa a modo edición
   ↓
11. Usuario modifica campos necesarios
   ↓
12. Usuario hace clic en "ACEPTAR"
   ↓
13. Sistema valida cambios
   ↓
14. Sistema guarda modificaciones
   ↓
15. Sistema muestra "Datos actualizados correctamente"
   ↓
16. Formulario vuelve a modo solo lectura

• Si no se encuentran resultados: Mensaje “No se encontraron pacientes”
• Si hay muchos resultados: Se sugiere afinar la búsqueda
• Si el usuario no tiene permiso de edición: No se muestra botón “Editar”

​

Workflow 3: Subir Documento del Paciente

1. Usuario abre ficha de paciente
   ↓
2. Usuario hace clic en pestaña "Archivos"
   ↓
3. Sistema muestra lista de archivos existentes
   ↓
4. Usuario hace clic en "Subir archivo"
   ↓
5. Sistema muestra diálogo de carga
   ↓
6. Usuario selecciona archivo de su ordenador
   ↓
7. Usuario completa:
   - Nombre del documento
   - Descripción (opcional)
   - Tipo: Médico / Administrativo
   - Es consentimiento informado: Sí/No
   ↓
8. Usuario hace clic en "Subir"
   ↓
9. Sistema valida:
   - Tamaño < límite (ej: 10MB)
   - Formato permitido (PDF, JPG, PNG, DOC, etc.)
   ↓
10. Sistema sube archivo:
   - Almacena en carpeta del paciente
   - Opcionalmente encripta
   - Registra en base de datos
   - Actualiza uso de disco del paciente
   ↓
11. Sistema muestra "Archivo subido correctamente"
   ↓
12. Documento aparece en lista de archivos

​

Workflow 4: Solicitar Firma Electrónica de Consentimiento

1. Usuario abre ficha de paciente
   ↓
2. Usuario va a Pacientes → Firmas Online
   ↓
3. Usuario hace clic en "Nueva Solicitud de Firma"
   ↓
4. Sistema muestra formulario de solicitud:
   - Paciente (pre-seleccionado o buscar)
   - Plantilla de consentimiento
   - Email del paciente
   - Mensaje personalizado (opcional)
   ↓
5. Usuario selecciona plantilla de consentimiento
   ↓
6. Sistema pre-visualiza documento a firmar
   ↓
7. Usuario hace clic en "Enviar Solicitud"
   ↓
8. Sistema:
   - Genera documento personalizado con datos del paciente
   - Crea código único de firma
   - Genera URL segura
   - Envía email al paciente con enlace
   - Registra solicitud como "Pendiente"
   ↓
9. Paciente recibe email y hace clic en enlace
   ↓
10. Paciente accede a portal seguro:
    - Revisa documento
    - Completa campos si es necesario
    - Firma electrónicamente (con dedo o mouse)
    - Confirma firma
   ↓
11. Sistema registra firma:
    - Almacena firma gráfica
    - Marca solicitud como "Firmada"
    - Genera PDF final con firma
    - Almacena en archivos del paciente
    - Notifica al centro por email
   ↓
12. Personal del centro ve documento firmado en:
    - Firmas Online (lista de solicitudes)
    - Archivos del paciente

​

️ Diálogo de Acciones de Paciente

Patrón importante: Este diálogo de acciones es un patrón estándar en Nubidoc que se repite para muchas otras entidades del sistema (citas, facturas, etc.). Comprender su funcionamiento es fundamental para usar el sistema eficientemente.

​

¿Cómo acceder al diálogo de acciones?

1. Desde búsqueda de pacientes:
   • Hacer doble clic en cualquier fila de la tabla de resultados
   • O seleccionar un paciente (checkbox) y hacer clic en botón “Acciones” (parte inferior)
2. Desde cualquier referencia a paciente en la aplicación:
   • En listas de citas, facturas, tareas, etc.
   • Al hacer clic en el nombre del paciente o icono de acciones

​

Estructura del Diálogo

​

Sección de Información del Paciente

• Nombre completo del paciente con enlace a ficha completa (ej: “Prueba AddisAbeba Johannesburgo | 55”)
• Estado RGPD: Indicador visual del estado de firma RGPD
  • “RGPD firmada” (verde) o “RGPD no firmada” (rojo/advertencia)
• Estado del paciente:
  • Si está en No confirmado, se muestra la etiqueta roja Paciente sin confirmar
  • Si el usuario puede modificar pacientes, aparece junto a esa etiqueta el botón Confirmar
• Información de citas:
  • Próximas citas programadas o “Sin próximas citas”
  • Citas anteriores o “Sin citas anteriores”
  • Botón ”+ Crear cita” para programar nueva cita rápidamente
• Datos adicionales visibles:
  • Descuento aplicable al paciente (si tiene)
  • Comentario general del paciente
  • Estado civil

​

ACCIONES PACIENTE

Nota: La disponibilidad de algunos botones depende de los privilegios del usuario y la configuración del centro (ej: “Crear Remisión” solo si customer->allowRemisiones() está activo).

Acción rápida adicional: Si el paciente está marcado como No confirmado, en la parte superior del diálogo aparece el botón Confirmar. Al pulsarlo, Nubidoc cambia el estado del paciente a confirmado y refresca el propio diálogo para ocultar esa alerta.

​

ACCIONES CITA

​

ACCIONES FACTURACIÓN

​

BONOS ABIERTOS

• Si tiene bonos: Lista de bonos con información:
  • Tipo de bono
  • Sesiones disponibles / total
  • Fecha de caducidad
  • Estado
• Si no tiene bonos: Mensaje “No se ha encontrado ningún bono”

• Ver detalles del bono
• Consumir sesión
• Modificar bono

​

ACTIVIDADES ACTUALES

• Si tiene actividades: Lista de actividades con:
  • Nombre de la actividad
  • Profesional responsable
  • Estado
  • Fecha de inicio
• Si no tiene actividades: Mensaje “No se ha encontrado ninguna actividad”

Nota: Las “actividades” son tratamientos continuos o procesos clínicos que requieren seguimiento (ej: tratamiento de fisioterapia, plan de rehabilitación, etc.).

​

PERSONAS DE CONTACTO

• Lista de contactos asociados:
  • Familiares
  • Representantes legales
  • Personas autorizadas
  • Otros pacientes relacionados
• Si no tiene contactos: Mensaje “No se han añadido contactos”

• ”+ añadir persona de contacto” - Agregar nuevo contacto externo
• ”+ relacionar con paciente” - Vincular con otro paciente existente del sistema

• Padre/Madre
• Hijo/Hija
• Cónyuge
• Tutor legal
• Otro

​

Botón Final

​

Caso 1: Acceso Rápido desde Búsqueda

Usuario busca paciente "García" → Ve 5 resultados → Hace doble clic en "García López, Juan"
→ Se abre diálogo de acciones → Puede ver estado y ejecutar acción sin abrir ficha completa
→ Hace clic en "+ Crear cita" → Agenda se abre con paciente pre-seleccionado

​

Caso 2: Revisión Rápida de Estado

Recepcionista tiene lista de pacientes del día → Doble clic en paciente
→ Ve en diálogo: "RGPD no firmada" → Hace clic en "Enviar notificación"
→ Envía recordatorio al paciente para firmar consentimiento

​

Caso 3: Confirmación Rápida de Paciente

Recepcionista abre Acciones de un paciente pendiente de validar
→ Ve la etiqueta roja "Paciente sin confirmar" en la cabecera
→ Pulsa "Confirmar" → El diálogo se recarga
→ El paciente queda ya confirmado sin entrar en la ficha completa

​

Caso 4: Flujo de Facturación Rápida

Tras atender paciente → Doble clic en nombre del paciente
→ Diálogo muestra: "Sin citas anteriores" pero paciente recién atendido
→ Clic en "+ Crear factura" → Genera factura rápidamente sin abrir ficha completa

​

Ventajas del Diálogo de Acciones

​

Privilegios Requeridos

​

Integraciones

• Al crear cita, se selecciona paciente
• Desde ficha de paciente se pueden ver todas sus citas
• Pestaña “Historial de Citas” en el paciente
• Botón rápido “Crear cita” desde paciente

• Facturas vinculadas a paciente
• Desde paciente se accede a historial de facturas
• Pagador del paciente determina tarifas
• Descuentos del paciente se aplican automáticamente

• Cada paciente tiene carpeta de documentos
• Consentimientos firmados se almacenan
• Informes médicos vinculados al paciente
• Fotos/avatares del paciente

• Campañas dirigidas a segmentos de pacientes
• Filtros por etiquetas de pacientes
• Permisos de notificación controlan envíos
• Historial de campañas recibidas

• Tareas asignadas a pacientes específicos
• Recordatorios de seguimiento
• Pendientes clínicos del paciente

​

Dependencias

• Pagadores - Debe existir al menos un pagador
• Usuario - El sistema necesita un usuario creador

• Agenda - No se pueden crear citas sin pacientes
• Facturación - Facturas se emiten a pacientes
• Historia Clínica - Registros clínicos vinculados a paciente

​

Regla 1: Número de Paciente Único

• Descripción: Cada paciente tiene un número único autoincremental
• Cuándo aplica: Al crear nuevo paciente (no pre-paciente)
• Efecto: El sistema asigna automáticamente el siguiente número disponible

​

Regla 2: Validación de Duplicados

• Descripción: El sistema puede detectar posibles duplicados por DNI o nombre+apellidos
• Cuándo aplica: Al crear nuevo paciente si se activa la validación
• Efecto: Muestra advertencia si encuentra coincidencias

​

Regla 3: LOPD Obligatorio

• Descripción: No se puede crear paciente sin aceptar LOPD
• Cuándo aplica: Siempre al crear paciente
• Efecto: Campo obligatorio, se guarda fecha y datos de aceptación

​

Regla 4: Estados del Paciente

• Descripción: Paciente puede estar en diferentes estados
• Estados:
  • 0 = Activo - Paciente normal
  • 1 = No confirmado - Pendiente de confirmación
  • 2 = Descartado - No es paciente del centro
  • 5 = Deshabilitado - Inactivo temporalmente
• Acción rápida asociada: En Acciones del paciente, si el estado es 1 = No confirmado, aparece el botón Confirmar, que cambia el registro a 0 = Activo
• Efecto: Pacientes no activos no aparecen en búsquedas normales

​

Regla 5: Pre-pacientes vs Pacientes

• Descripción: Diferencia entre contactos (pre-pacientes) y pacientes reales
• Valores:
  • 0 = Paciente - Paciente completo con historia clínica
  • 1 = Pre-paciente/Contacto - Lead o contacto sin historia
  • 2 = Empresa/Persona jurídica - Entidad legal
• Efecto: Pre-pacientes no tienen número de historia, pueden convertirse a pacientes

​

Regla 6: Permisos de Notificación

• Descripción: Sistema respeta preferencias de comunicación del paciente
• Condiciones:
  • Email: allownotification=1 AND allownotificationsmail=1 AND email no vacío
  • SMS: allownotification=1 AND allownotificationstel=1 AND teléfono no vacío
  • WhatsApp: allownotification=1 AND allownotificationswhatsapp=1 AND teléfono no vacío
• Efecto: Sistema solo envía notificaciones si el paciente lo permite
• Comunicaciones comerciales: Algunos centros tienen habilitada la opción “¿Permite envío de publicidad?” en la ficha del paciente y en el formulario de registro del portal. En el portal de registro, aparece como pregunta obligatoria con opciones Sí/No que el paciente debe responder antes de completar el alta. Si el centro no tiene esta opción habilitada, el campo no aparece

​

Regla 7: Fusión de Pacientes Duplicados

• Descripción: Permite fusionar dos pacientes duplicados en uno solo
• Cuándo aplica: Cuando se detectan duplicados y se decide unificar
• Efecto: Un paciente se marca como fusionado (patientmerged_id apunta al principal)

​

Regla 8: Multi-centro

• Descripción: En instalaciones multi-centro, pacientes pueden pertenecer a varios centros
• Efecto: Se gestionan asignaciones de paciente a centros en tabla patient_center

​

Mensajes de Éxito

• “Paciente creado correctamente”: Cuando se crea un nuevo paciente exitosamente
• “Datos actualizados correctamente”: Cuando se modifican datos del paciente
• “Archivo subido correctamente”: Cuando se sube un documento
• “Paciente eliminado correctamente”: Cuando se elimina (soft delete) un paciente
• “Solicitud de firma enviada”: Cuando se envía email de firma electrónica

​

Mensajes de Error

• “El campo nombre es obligatorio”: Falta completar el nombre
• “Debe seleccionar un pagador”: No se seleccionó pagador
• “Email no válido”: Formato de email incorrecto
• “Ya existe un paciente con este DNI”: DNI duplicado
• “El paciente no existe”: ID de paciente inválido
• “No tiene permisos para realizar esta acción”: Falta privilegio
• “Error al subir archivo”: Problema al cargar documento
• “Tamaño de archivo excede el límite”: Archivo demasiado grande
• “El usuario no tiene ningún centro asignado”: En multi-centro, usuario sin centros

​

Mensajes de Advertencia

• “Posible paciente duplicado”: Se encontró paciente similar
• “El paciente no tiene email”: Al intentar enviar email sin dirección
• “El paciente no permite notificaciones”: Intentando enviar a paciente que no acepta
• “No se ha encontrado el paciente”: Puede aparecer si se intenta abrir el diálogo de acciones con un registro ya no disponible o sin un paciente válido seleccionado. El sistema muestra el aviso y no abre el detalle interno.

​

Preguntas Frecuentes

• “VIP” - Pacientes de especial atención
• “Familiares” - Familiares de empleados o del equipo médico
• “Jubilados” - Para aplicar descuentos o programas especiales
• “Estudiantes” - Para tarifas reducidas
• “Riesgo de abandono” - Para seguimiento preventivo
• “Alergias importantes” - Alerta visual inmediata Una vez asignadas las etiquetas, se pueden utilizar para:
• Visualizarlas destacadas en la ficha del paciente
• Filtrar búsquedas de pacientes por etiqueta
• Segmentar envíos de correos o campañas de marketing
• Generar listados y estadísticas por grupos

• Citas automáticas: Al crear una nueva cita para ese paciente, el profesional asignado aparece seleccionado por defecto
• Restricción de acceso: Se puede configurar para que el profesional solo tenga acceso a los datos de los pacientes que tiene asignados o con los que ha tenido o tiene alguna cita
• Trazabilidad: Facilita saber quién es el terapeuta o médico de referencia de cada paciente
• Continuidad asistencial: Garantiza que el paciente siempre ve al mismo profesional Esta funcionalidad es muy utilizada en clínicas de psicología y centros de logopedia donde la relación paciente-terapeuta es fundamental.

​

Operadores de Búsqueda

• Operador: LIKE (contiene)
• Ejemplo: Buscar “garcía” encuentra “José García”, “García López”, “María del Carmen García”

• Operadores: = (igual), > (mayor), < (menor)
• Ejemplo: Edad > 65 encuentra todos los mayores de 65 años

• Operadores: = (igual), BETWEEN (rango), > (después), < (antes)
• Ejemplo: Fecha nacimiento BETWEEN 01/01/1980 AND 31/12/1990

• Operador: = (igual) o IN (múltiples valores)
• Ejemplo: Pagador = “PRIVADO” o Profesional IN (Dr. García, Dra. López)

​

Filtros Avanzados

• Selección múltiple de etiquetas
• Operador AND (tiene todas) u OR (tiene alguna)

• Filtra pacientes asignados a un profesional específico

• Filtra por tipo de pagador (Privado, Aseguradora X, etc.)

• Activo, No confirmado, Descartado, Deshabilitado
• Por defecto solo busca “Activos”

• Pacientes que vinieron en un rango de fechas
• Útil para identificar pacientes inactivos

​

Guardado de Filtros

1. Configurar filtros complejos
2. Guardar el filtro con un nombre
3. Cargar filtros guardados en futuras búsquedas

​

Exportación de Resultados

• Exportar a Excel - Descarga XLSX con datos de pacientes. Este botón solo es visible para usuarios que tengan el privilegio “Exportar pacientes” activado en su rol (Administración > Datos maestros > Roles y permisos, sección Pacientes). Los administradores siempre lo ven.
• Imprimir - Genera PDF con listado
• Selección múltiple - Realizar acciones sobre varios pacientes

​

Estados Visuales

• Verde - Paciente activo y confirmado
• Amarillo - Paciente no confirmado (pendiente verificación)
• Rojo - Paciente descartado o con alertas
• Gris - Paciente deshabilitado o inactivo

​

Iconos Principales

• 🔍 fa-search - Buscar pacientes
• ➕ fa-plus-circle - Crear nuevo paciente
• ✏️ fa-edit / fa-pencil - Editar paciente
• 🗑️ fa-trash - Eliminar paciente
• 👤 fa-user - Datos del paciente
• 📄 fa-file - Documentos
• 📅 fa-calendar - Citas del paciente
• 💰 fa-money - Facturas del paciente
• 📧 fa-envelope - Enviar email
• 📱 fa-mobile - SMS/WhatsApp
• ✍️ fa-pencil-alt - Solicitar firma
• 🔗 fa-link - Fusionar pacientes
• 📷 fa-camera - Foto/Avatar
• 🏷️ fa-tag - Etiquetas

​

Badges y Alertas

• Badge azul - Número de documentos del paciente
• Badge rojo - Tareas pendientes relacionadas con paciente
• Badge verde - Citas próximas
• Etiqueta roja “Paciente sin confirmar” - Paciente pendiente de validación administrativa
• Botón “Confirmar” - Acción rápida disponible en Acciones del paciente para pasar el estado a confirmado
• Icono alerta - Paciente con notas importantes

​

Niveles de Acceso

​

Restricciones

• Usuarios de centro médico: Solo pueden ver/editar pacientes de sus centros asignados
• Multi-centro: Si está activo, se valida que el usuario tenga centros asignados. Además de los centros propios, el usuario puede ver pacientes de centros configurados en “Ver pacientes de centros” (Administración > Usuarios)
• Solo lectura: Usuarios sin permiso de modificación ven todo en modo consulta
• Soft delete: Los pacientes eliminados siguen en BD pero marcados como deleted=1

​

Auditoría

• Cada modificación de paciente se registra en tabla hpc_audit
• Se guarda: usuario, fecha, acción, datos modificados
• Cumple con normativa RGPD de trazabilidad

​

Exportar a Excel

• Botón “Exportar a Excel”
• Genera archivo XLSX con columnas configurables
• Incluye todos los pacientes del resultado de búsqueda (paginación completa)
• Campos exportados:
  • Nº Paciente
  • Nombre completo
  • DNI
  • Fecha nacimiento
  • Edad
  • Teléfonos
  • Email
  • Dirección
  • Ciudad
  • Pagador
  • Profesional
  • Fecha última cita
  • Estado

​

Imprimir Listado

• Genera PDF con listado de pacientes
• Incluye logo del centro
• Formato tabular
• Encabezado con filtros aplicados
• Fecha y hora de generación

​

Exportar Ficha Completa

• Opción “Imprimir ficha”
• Genera PDF completo con:
  • Datos demográficos
  • Datos de contacto
  • Historial de citas
  • Documentos asociados (listado)
  • Consentimientos firmados

​

Multi-Centro

• Los pacientes se pueden asignar a múltiples centros
• Se usa tabla patient_center para gestionar asignaciones
• Campo ismaincenter indica el centro principal
• Los usuarios solo ven pacientes de sus centros asignados
• Ver pacientes de centros: Además de los centros donde trabaja, un usuario puede tener configurados centros adicionales en “Ver pacientes de centros” (Administración > Usuarios > Modificar). Esto permite al usuario buscar y ver pacientes pertenecientes a esos centros adicionales, tanto en el listado de pacientes como en la búsqueda rápida por nombre (autocompletado)

​

Selección de profesional firmante al imprimir

• Mostrar un selector de profesional firmante al imprimir consentimientos informados y documentos no clínicos para firma desde la ficha del paciente
• Usar el profesional seleccionado para sustituir nombre, número de colegiado y firma digitalizada en la plantilla
• Mantener el comportamiento actual cuando la preferencia está desactivada

​

Firmas Digitales Online

• Enviar solicitudes de firma por email
• Pacientes firman desde cualquier dispositivo
• Almacenamiento automático de documentos firmados
• Trazabilidad completa del proceso

​

Solicitud de Documentos

• Solicitar al paciente que suba documentos
• Paciente accede a portal seguro
• Completa formularios online
• Sube archivos requeridos
• Personal revisa documentos recibidos

​

Remisiones

• Derivaciones a otros profesionales
• Registro de remisiones enviadas/recibidas
• Seguimiento de pacientes derivados
• Intercambio de información clínica

​

Tutorial 1: Crear Primer Paciente del Centro

1. Acceder al módulo
   • Hacer clic en Pacientes en el menú lateral
   • Seleccionar Crear paciente
2. Completar datos principales
   • Nombre: escribir el nombre del paciente
   • Primer apellido: informar el primer apellido
   • Segundo apellido: añadirlo si aplica
   • DNI/NIE/CIF: completarlo si se usa en el centro o si se dispone de ese dato
   • Fecha de nacimiento: recomendable si se conoce
3. Completar datos de contacto (recomendado)
   • Teléfono móvil: recomendable para contacto y comunicaciones
   • Email: recomendable para futuras gestiones y envíos
4. Revisar datos administrativos
   • Revisar el campo Pagador
   • Tener en cuenta que algunos valores por defecto o bloques pueden variar según la configuración del centro
   • Si aparece una zona adicional poco poblada, puede corresponder a campos personalizados del centro
5. Guardar paciente
   • Hacer clic en el botón Aceptar (parte superior derecha)
   • Esperar el mensaje Paciente creado correctamente
6. Verificar la creación
   • Confirmar que se asignó un número de paciente automáticamente
   • Verificar que el formulario pasa a modo solo lectura
   • A partir de ahí ya se puede buscar al paciente, crear una cita o completar más datos

• La guía permite avanzar y retroceder por toda la secuencia (portada, pasos y resumen final) y volver al índice general desde el cierre.

​

Tutorial 2: Buscar Paciente por Teléfono

1. Ir a “Pacientes” → “Buscar pacientes”
2. En el campo “Teléfono”, escribir los últimos dígitos conocidos (ej: “3456”)
3. Hacer clic en “BUSCAR”
4. Revisar resultados:
   • Si hay un solo resultado, hacer clic directamente
   • Si hay varios, identificar por nombre
5. La ficha del paciente se abre automáticamente

​

Tutorial 3: Solicitar Firma de Consentimiento Informado

• Sistema de firmas online activado
• Paciente con email registrado
• Plantillas de consentimiento creadas

1. Crear solicitud
   • Ir a “Pacientes” → “Firmas Online”
   • Clic en “Nueva Solicitud de Firma”
2. Seleccionar paciente
   • Buscar paciente por nombre
   • Verificar que tiene email correcto
3. Elegir documento
   • Seleccionar plantilla: “Consentimiento Tratamiento Datos”
   • Previsualizar documento generado
4. Personalizar mensaje
   • Escribir mensaje para el email (opcional)
   • Ejemplo: “Por favor, firme el consentimiento adjunto para continuar con su tratamiento”
5. Enviar
   • Clic en “Enviar Solicitud”
   • Sistema envía email al paciente inmediatamente
6. Seguimiento
   • En lista de solicitudes, ver estado “Pendiente”
   • Cuando paciente firme, cambiará a “Firmada”
   • Documento firmado aparecerá en archivos del paciente

​

Búsqueda de Firmas Online — Filtros y Columnas

• Nº Paciente, Nombre, DNI/ID
• Fecha creación desde (por defecto: día 1 del mes en curso) y Fecha creación hasta
• Estado (Pendiente / Firmado / Rechazado / Bloqueado)

• Email, Teléfono
• Fecha firma desde y Fecha firma hasta — para buscar firmas completadas en un rango de fechas

• Nombre, DNI, Email, Teléfono, Fecha creación, Estado, Título (nombre del documento enviado), Fecha firma
• El listado se ordena por fecha de creación descendente (los más recientes primero)

• El Estado se muestra con colores: naranja (Pendiente), verde (Firmado), rojo (Rechazado), gris (Bloqueado)
• El botón “Enviar recordatorio” solo aparece cuando el estado es Pendiente

​

Firma en Dispositivo Móvil

• El panel de firma arranca minimizado para permitir ver el documento completo
• Aparece un mensaje en la parte inferior: “Para firmar, despliegue el panel lateral”
• Al pulsar el chevron lateral, el panel de firma se despliega a pantalla completa
• El mensaje desaparece permanentemente tras el primer despliegue
• Se puede hacer zoom con dos dedos (pinch-to-zoom) para ampliar el documento