HelpMI — Plataforma de asesoramiento a terapeutas

Visión general del sistema

HelpMI es una plataforma web privada que gestiona el servicio de asesoramiento clínico semanal que la asociación MeGeMIT ofrece a los terapeutas especializados en microinmunoterapia de la región DACH. La plataforma cubre el ciclo completo: reserva de cita, recepción y gestión de casos, documentación post-consulta, y reporting estadístico.

Contexto y funcionamiento del servicio

MeGeMIT ofrece a sus socios terapeutas un servicio semanal de consulta telefónica (o Zoom/WhatsApp) con médicos especialistas. Los terapeutas presentan casos clínicos de pacientes anonimizados y reciben orientación terapéutica y recomendación de productos de microinmunoterapia.

Dinámica semanal

• Las consultas se celebran semanalmente en franjas de 30 minutos fijos. El tiempo real de llamada puede ser menor, pero el slot siempre ocupa 30 min en el calendario.
• Cada terapeuta puede reservar un máximo de 2 citas por día de consulta
• La consulta dura ~20 min + 10 min de documentación del asesor
• El canal principal es telefónico; alternativas: Zoom, WhatsApp

Asesores activos (referencia)

Acceso al servicio — condiciones

• El terapeuta debe ser socio de MeGeMIT y haber cursado al menos la formación básica
• Excepción: los no socios pueden usar el servicio un máximo de 2 veces; al superarlo reciben un email automático sobre la membresía
• En la vista de administración se señala visualmente si el terapeuta aún no es socio

Punto de acceso público

La reserva se realiza desde la web de MeGeMIT (megemit.org) en la sección "Para terapeutas → Asesoramiento a terapeutas", donde el portal de reserva está embebido como iframe. El portal de reserva es parte del alcance de este proyecto y se reimplementa junto al panel de administración. megemit.org no se toca — solo se actualizará la URL del iframe para apuntar al nuevo sistema.

Datos clínicos — privacidad

Stack de la reimplementación

Stack elegido para el nuevo desarrollo. Prioriza productividad, mantenibilidad a largo plazo y madurez del ecosistema para el perfil de este proyecto (plataforma interna + portal embebible, equipo reducido, dominio CRUD con reglas de negocio específicas).

Sistema original (referencia)

El sistema a sustituir se construyó sobre Concloo CMS (TW-Datentechnik) con IBM Lotus Domino/Notes como base de datos. Se documenta aquí solo como referencia para entender comportamientos existentes.

Arquitectura de URLs del sistema actual

Roles de usuario

Agenda y gestión de citas

Vista principal de administración. Muestra todas las citas del sistema en una tabla paginada y filtrable. Permite al administrador gestionar el estado de las consultas y crear citas de forma manual.

Columnas de la tabla de citas

Estados de una cita

Creación manual de citas

El administrador puede crear citas directamente en la plataforma, por ejemplo cuando la reserva llega por teléfono o vía compañeros. El formulario es el mismo que el público pero accesible desde el panel de administración.

Indicadores visuales

• Verde: terapeuta con membresía MeGeMIT activa
• Naranja/rojo: terapeuta sin membresía ("noch kein Mitglied")

Portal de reserva pública

Segunda aplicación dentro del mismo proyecto Laravel. Equivale al actual service.mgm.concloo.net y forma parte del alcance del rediseño. Se servirá desde su propia URL y megemit.org lo seguirá embebiendo exactamente igual que ahora, cambiando únicamente la URL del iframe. No requiere login separado — el terapeuta se identifica con un token firmado generado a partir de su email.

Flujo de reserva del terapeuta

Campos del formulario de reserva

Taxonomía completa de categorías (Hauptthema / Unterkategorie)

Extraída de datos reales de producción (marzo 2026). Configurable por el administrador.

Límites del calendario

• Máximo 2 citas por terapeuta y día de consulta
• Los festivos configurados en el sistema bloquean automáticamente las franjas
• Las vacaciones y ausencias de asesores ocultan su disponibilidad
• Los slots bloquean siempre 30 minutos en el calendario; la duración real de la llamada es libre dentro de ese tiempo

Documentación de la consulta (Asesor)

Tras la llamada, el asesor accede al detalle de la cita y registra la documentación clínica. Esta información es solo visible para el asesor y el administrador, no para el terapeuta.

Vista previa de la cita

Un día antes, el asesor recibe por email un enlace con su agenda completa del día y los links a cada caso. Puede revisar la anamnesis y los documentos adjuntos antes de la llamada.

Sección: Productos recomendados (Empfohlene Präparate)

Cuadrícula de checkboxes con todos los preparados del catálogo. El asesor selecciona los que recomienda para ese caso.

Preparados serie 2L

Otros preparados

Sección: Formación recomendada (Empfohlene Hilfen)

• Grundlagenseminar (Seminario básico) — checkbox
• A1 — checkbox
• A2 — checkbox
• Lyty — checkbox
• Serologien (Pruebas serológicas) — checkbox
• Bestimmte Pathologien — campo de texto libre (patologías específicas)
• Weitere empfohlene Hilfen — área de texto grande (recomendaciones adicionales, formaciones especiales)

Sección: Comentario interno

Campo de texto libre donde el asesor registra la recomendación terapéutica y los próximos pasos del caso. Nunca visible para el terapeuta.

Cierre del caso

El asesor marca la cita como completada (erledigt). El caso permanece en el sistema (importante para casos complejos con seguimiento). El asesor también puede enviar información adicional (formaciones, etc.) al responsable vía el CRM integrado.

Gestión de terapeutas

Lógica de no-socios

1. El terapeuta puede reservar sin ser socio hasta 2 veces
2. Al superar el límite, se le bloquea la reserva y recibe un email automático explicando las ventajas de la membresía y cómo hacerse socio
3. En la vista admin, los no-socios aparecen visualmente señalados en el listado de citas

Gestión de asesores médicos

Email de agenda del asesor

El sistema envía automáticamente al asesor su agenda del día X días antes (configurable individualmente). El email incluye la lista de citas con enlace directo a cada caso para que pueda prepararse con antelación.

Catálogo de productos / medicamentos

El administrador mantiene el listado de preparados disponibles en la plataforma. Este listado se utiliza como fuente para los checkboxes de recomendación que rellena el asesor post-consulta.

Estadísticas e informes

El administrador puede generar informes en distintos periodos de tiempo. Los informes se exportan (formato no especificado; recomendar PDF y Excel).

Periodos disponibles

Contenido de los informes

Exportación mensual (formato CSV / XLSX)

Verena Heufler recibe mensualmente un fichero XLSX con el detalle completo de todas las citas del mes. El sistema debe generar este archivo automáticamente. Las columnas exactas extraídas del CSV de producción son:

Configuración del sistema

Entidades principales y campos

Termin — Cita / Caso clínico

Entidad central del sistema. Cada cita es a la vez un expediente clínico del caso.

Therapeut — Terapeuta

Berater — Asesor médico

Medikament — Preparado

Kategorie — Tema / Patología

Betreuer — Coordinador interno

Personal interno de MeGeMIT asignado como referente de cada terapeuta. Aparece en cada cita del informe mensual. Pendiente de confirmar si los Betreuer tienen acceso propio a la plataforma o si es únicamente un campo de asignación gestionado por el administrador.

Feiertag — Festivo

Flujos de email automático

Reglas de negocio críticas

• Un terapeuta puede reservar un máximo de 2 citas por día de consulta
• Los slots de reserva son siempre de 30 minutos fijos. La duración real de la llamada puede ser menor; el CSV de exportación refleja el tiempo de llamada efectivo, no el slot.
• Los festivos configurados bloquean automáticamente todas las franjas de ese día en el calendario
• Las vacaciones del asesor bloquean automáticamente su disponibilidad
• Un terapeuta sin membresía solo puede usar el servicio 2 veces; a la tercera, recibe el email y queda bloqueado
• Las recomendaciones del asesor (productos, comentario interno) son solo visibles para el asesor y el administrador, nunca para el terapeuta
• Los datos del paciente deben subirse completamente anonimizados; casos con datos identificativos deben poder eliminarse inmediatamente
• Las citas completadas permanecen en el sistema indefinidamente (necesario para seguimiento de casos complejos)
• El asesor sustituto recibe acceso idéntico al sustituido durante el periodo de vacaciones
• Los documentos enviados por fax se asignan al caso mediante el código de fax autogenerado visible en el email de confirmación

Multiidioma

El sistema soporta múltiples idiomas desde el inicio. El alemán (de) es el idioma principal y de referencia. Los idiomas adicionales se añaden sin cambios estructurales. Hay dos capas de traducción con soluciones distintas que deben tratarse por separado.

Capa 1 — Cadenas de la interfaz

Todos los textos estáticos de la UI (etiquetas, botones, mensajes de error, emails) se externalizan en ficheros de traducción Laravel (lang/{locale}/). El idioma activo se determina por prefijo de URL.

Capa 2 — Contenido traducible en base de datos

Los datos gestionados por el administrador que deben mostrarse en el idioma del usuario se almacenan como campos JSON multiidioma mediante spatie/laravel-translatable. El administrador introduce las traducciones desde el panel de Filament.

Estructura del campo traducible en BD

// Columna JSON en MySQL — spatie/laravel-translatable
{
  "de": "Autoimmunerkrankung",
  "en": "Autoimmune disease",
  "fr": "Maladie auto-immune"
}

// Acceso en código — devuelve el valor del locale activo automáticamente
$kategorie->nombre          // → "Autoimmune disease" (si locale = en)
$kategorie->getTranslation('nombre', 'de')  // → "Autoimmunerkrankung"

Estrategia de locale por contexto

Idiomas iniciales y ampliación

Campo locale en el modelo Therapeut

Se añade el campo locale al modelo del terapeuta para que los emails automáticos se envíen siempre en su idioma, independientemente del idioma en que el administrador esté usando el panel.

Integraciones externas

Iframe en megemit.org

megemit.org no forma parte del alcance y no se modifica. El portal de reserva del nuevo sistema se servirá desde su propia URL; el único cambio necesario en megemit.org es actualizar la URL del <iframe> para apuntar al nuevo dominio. El comportamiento del embed es idéntico al actual.

HubSpot CRM — Ampliación futura

La sincronización con HubSpot no forma parte del alcance inicial pero el sistema se construirá con la arquitectura preparada para implementarla en una fase posterior sin cambios estructurales.

Eventos de dominio preparados para HubSpot

// Estructura del patrón — el adaptador es lo único que se implementa en fase 2
AppointmentCompleted  →  [EventBus]  →  HubSpotSyncJob  →  HubSpot Contacts API
TherapistCreated      →  [EventBus]  →  HubSpotSyncJob  →  HubSpot Contacts API

Resumen de integraciones

Arquitectura de API interna

El sistema actual usa un único endpoint AJAX (POST /ajax) para todas las interacciones del cliente. La reimplementación debería seguir una arquitectura REST o GraphQL estándar, pero se documenta aquí el patrón actual como referencia.

Patrón de request actual

POST /ajax
Content-Type: application/x-www-form-urlencoded

Request={TipoAccion}&campo1=valor1&campo2=valor2

Patrón de response

{
  "Status":  "OK | Error | TOTP | GPWD",
  "HTML":    "<html a inyectar en el DOM>",
  "Target":  "/redirect/url",
  "Comment": "Mensaje de alerta para el usuario",
  "Content": "<html de modal>",
  "submit":  "nuevo handler JS",
  "focus":   "#selector-elemento",
  "ut":      "user token",
  "uc":      "user CNID",
  "ud":      "debug flag"
}

Tipos de acción conocidos

Upload de ficheros

POST /cgi-bin/fileupload.cgi
Content-Type: multipart/form-data

# Formatos aceptados: JPEG, PDF, EPS, DOC, DOCX
# Almacenamiento interno (referencia):
# {Codigo}##YY##{Filename}##YY##{MIMEtype}##YY##{Bytes}
# Múltiples ficheros: {file1}##**##{file2}##**##...

Autenticación y seguridad

Sistema actual

1. El cliente envía email + sha256(urlencode(password)) vía AJAX
2. El servidor responde con token de sesión o solicita TOTP
3. El cliente almacena CNCLUC, CNCLUNID, CNCLDEBUG como cookies

Recomendaciones para la reimplementación

Identificación del terapeuta en el portal público

El portal público identifica al terapeuta mediante un token SHA-256 generado a partir de su email + timestamp. La URL tiene la forma:

https://service.mgm.concloo.net/{sha256token}&user={email}&ts={timestamp}

La reimplementación debe definir un mecanismo equivalente seguro (magic link, token firmado con expiración, etc.).

Preguntas pendientes — confirmar con Verena Heufler

Estas cuestiones no han podido resolverse con la documentación interna ni con el análisis del CSV. Deben confirmarse con Verena antes de iniciar el desarrollo para evitar suposiciones que luego requieran refactorización.

Roles y accesos

Flujos de email

Calendario y reservas

Datos y exportación

Integración con megemit.org

HubSpot (ampliación futura)