HelpMI — Planificación por fases

Entornos

• Crear repositorio Git con estrategia de branching (main / develop / feature branches)
• Provisionar servidor de producción y staging (Hetzner/DigitalOcean) con Laravel Forge
• Configurar Nginx + PHP 8.3-FPM + MySQL 8.0 + Redis en ambos entornos
• Configurar almacenamiento S3 o MinIO para documentos clínicos
• Configurar cuenta de email transaccional (Mailgun o Postmark) con dominio verificado

Proyecto base

• Instalar Laravel 11 + Filament 3 + Livewire 3
• Instalar paquetes core: Spatie Permission, Spatie Media Library, Spatie Translatable, Laravel Excel, mcamara/laravel-localization, pragmarx/google2fa, Laravel Fortify
• Configurar Laravel Pint (code style) + PHPStan nivel 6
• Configurar Pest como framework de tests
• Configurar pipeline CI/CD (GitHub Actions): lint → tests → deploy staging en merge a develop

Migraciones y modelos Eloquent

• Migraciones: termins, therapeuts, beraters, betreuer, medikaments, kategorien, feiertags, users
• Modelos Eloquent con relaciones, casts, fillable y reglas de validación
• Spatie Translatable en: Kategorie.nombre, Medikament.nombre_display, plantillas de email
• Spatie Media Library: colección befunde en modelo Termin

Autenticación y roles

• Laravel Fortify: login, logout, contraseñas
• TOTP 2FA con pragmarx/google2fa (activable por usuario)
• Spatie Permission: roles admin, berater, betreuer (pendiente confirmar con Verena)
• Middleware de autorización por rol en rutas admin

Seeders de datos de referencia

• Seeder de categorías completo (14 Hauptthemen + subcategorías extraídas del CSV)
• Seeder de los 61 productos del catálogo con código y serie
• Seeder de los 3 asesores con horarios reales
• Seeder de festivos base para DE/AT/CH (año en curso)

Filament Resources para todos los catálogos y entidades de configuración. No requieren la lógica de negocio de citas.

Resources Filament

• TherapeutResource: tabla filtrable, badge membresía, contador de usos sin socio, campo HubSpot ID
• BeraterResource: CRUD completo, gestión de horarios de slots (configuración semanal), días de antelación de agenda, periodos de vacaciones y asignación de sustituto
• BetreuerResource: CRUD básico (pendiente confirmar si tiene login o solo es catálogo)
• MedikamentResource: CRUD con campo serie y orden de visualización en formularios. Soporte translatable.
• KategorieResource: árbol jerárquico Hauptthema → Unterkategorie. Soporte translatable.
• FeiertageResource: CRUD por país (DE/AT/CH/ALL) con selector de fecha
• EinstellungenPage: página de configuración global (límite no-socios, parámetros generales)

Autorización

• Policies Filament: solo rol admin accede a estos módulos
• Navegación Filament condicional por rol

TerminResource — Vista admin

• Tabla principal con todas las columnas del CSV: fecha, terapeuta, asesor, betreuer, tema, estado, FAX-code, Fallnummer
• Filtros: por asesor, por Hauptthema, por periodo, por estado (completada/pendiente), por membresía del terapeuta
• Indicador visual para terapeutas sin membresía
• Acción de creación manual de cita (admin puede reservar por teléfono/email)
• Acción de marcar como completada, cancelar
• Campo interner_kommentar visible solo para admin y berater

Vista del asesor (Berater)

• Vista filtrada: solo las citas asignadas al asesor logueado (o a su sustituto si aplica)
• Página de detalle de cita: anamnesis completa, documentos adjuntos descargables, datos del paciente
• Formulario post-consulta: cuadrícula de checkboxes de productos (61), checkboxes de formaciones recomendadas, campo de texto libre adicional, comentario interno
• Acción de marcar cita como completada

Servicio de slots

• SlotAvailabilityService: calcula franjas libres de 30 min para un asesor en una fecha dada, excluyendo festivos, vacaciones y citas ya reservadas
• Validación: máximo 2 citas por terapeuta por día de consulta
• Generación automática de Fallnummer y FAX-Code al crear cita

Aplicación Livewire embebible como iframe en megemit.org. Sin login tradicional — identifica al terapeuta mediante token firmado.

Identificación del terapeuta

• Servicio TherapistTokenService: genera y verifica tokens firmados HMAC con email + timestamp + expiración configurable
• Middleware que verifica el token en cada request del portal
• Comprobación de límite no-socio (contador de usos)

Componentes Livewire

• BookingCalendar: selector de asesor + calendario de fechas disponibles. Llama a SlotAvailabilityService. Actualización reactiva sin recarga.
• AnamnesisForm: todos los campos del formulario (Betreff, Hauptthema, Unterkategorie dependiente, Weitere Angaben, Geschlecht, Alter, Gewicht, Größe, PLZ)
• FileUpload: subida múltiple de documentos (Spatie Media Library). Validación de formatos (PDF, JPEG, EPS, DOC/DOCX). Aviso visible de anonimización obligatoria.
• BookingConfirmation: muestra Fallnummer y FAX-Code. Checkbox de protección de datos.
• AppointmentManagement: listado de citas activas del terapeuta, opción de modificar o cancelar.

Integración iframe

• Ruta pública con prefijo de locale: /{locale}/buchen
• Headers X-Frame-Options: ALLOW-FROM megemit.org + Content-Security-Policy: frame-ancestors
• Responsive: funciona en las dimensiones del iframe de megemit.org

Plantillas de email (Blade + alemán)

• Confirmación de reserva: Fallnummer, FAX-Code, datos de la cita, instrucciones para modificar/cancelar
• Recordatorio 24h antes: detalles de la cita + aviso para subir documentos si no lo ha hecho
• Agenda del asesor: listado de citas del día con enlace directo a cada caso. Enviado X días antes (configurable por asesor).
• Email a no-socios: enviado al superar el límite de 2 usos. Información sobre membresía MeGeMIT.
• Todas las plantillas en alemán inicialmente; estructura multiidioma desde el primer día (lang/de/emails.php)

Jobs y Scheduler

• SendBookingConfirmationJob: disparado por evento AppointmentCreated
• SendReminderJob: Scheduler diario, busca citas de mañana y encola recordatorios
• SendAdvisorAgendaJob: Scheduler diario, envía agenda a los asesores que correspondan según su configuración de días
• CheckNonMemberLimitJob: disparado al crear cita; si supera límite, envía email y bloquea
• GenerateMonthlyReportJob: Scheduler el día 1 de cada mes, genera XLSX con todas las citas del mes anterior y lo envía por email a la administración

Dashboard de estadísticas (Filament)

• Filtro de periodo: mensual, trimestral, semestral, anual + rango personalizado
• Métricas: total de citas, desglose por asesor, por país (DE/AT/CH), por Hauptthema
• Ranking de productos más recomendados (top 10)
• Terapeutas con mayor frecuencia de uso
• Ratio socios/no-socios

Exportación XLSX

• Exportación manual desde el panel (Laravel Excel)
• Formato exacto del CSV de producción: 78 columnas en el orden documentado (Termin, Land, PLZ … RANTES 27CH)
• Exportación mensual automática via GenerateMonthlyReportJob (implementado en F4)

No es una fase independiente sino una disciplina que acompaña a cada fase. Cada módulo entregado incluye sus claves de traducción en lang/de/.

Infraestructura i18n (semana 2, junto con F1)

• Configurar mcamara/laravel-localization: routing con prefijo /{locale}/
• Configurar Filament para leer el locale del perfil de usuario
• Configurar middleware que establece el locale en cada request

Ficheros de traducción (se completan por fase)

• lang/de/auth.php, validation.php, pagination.php — junto con F0/F1
• lang/de/booking.php, lang/de/anamnesis.php — junto con F3
• lang/de/emails.php — junto con F4
• lang/de/admin.php, lang/de/stats.php — junto con F2 y F5
• Contenido traducible en BD (categorías, productos, plantillas): admin lo introduce desde Filament

Criterio de completitud

• Ningún texto hardcodeado en Blade o Livewire: todo pasa por __() o trans()
• Añadir un nuevo idioma no requiere modificar código — solo crear lang/{locale}/ y traducir BD

Se construye el esqueleto de integración completo. El adaptador HubSpot real se implementará en una fase posterior cuando se defina el mapping de propiedades con el cliente.

Eventos de dominio

• AppointmentCompleted: disparado al marcar una cita como erledigt
• TherapistCreated: disparado al crear un nuevo terapeuta
• TherapistMembershipChanged: disparado al cambiar el estado de membresía

Capa de abstracción

• Interface CrmAdapterInterface: métodos syncContact(), recordActivity()
• NullCrmAdapter: implementación vacía (no-op) activa por defecto — no falla, no hace nada
• HubSpotCrmAdapter: clase esqueleto preparada; se implementa en fase posterior
• SyncToCrmJob: Job en cola que consume los eventos y llama al adapter activo
• Variable de entorno CRM_ADAPTER=null|hubspot para activar el adaptador

Tests de rendimiento (k6 / Artillery)

• Carga del calendario de slots: <300ms con 50 usuarios simultáneos
• Subida de ficheros: 10 uploads simultáneos sin timeout
• Login en panel admin: <200ms
• Generación del XLSX mensual con 200+ citas: <30s
• Test de concurrencia en reserva: dos terapeutas intentando reservar el mismo slot simultáneamente — solo uno triunfa

Tests funcionales completos (Dusk)

• Flujo completo: reserva → recordatorio → consulta → post-consulta → exportación XLSX
• Flujo de cancelación: terapeuta cancela → slot liberado → aparece disponible
• Flujo de sustitución: asesor en vacaciones → sustituto ve sus citas
• Portal embebido: test de renderizado correcto dentro de iframe

Revisión de seguridad

• Verificar que comentarios internos no son accesibles vía API por el terapeuta
• Verificar CSRF en todos los formularios
• Verificar que documentos clínicos requieren autenticación para descargarse
• Verificar que un berater no puede acceder a citas de otro berater manipulando la URL
• Revisar headers de seguridad (CSP, X-Frame-Options en el portal embebido)

Verena valida el sistema completo en el entorno de staging con datos reales de prueba. Las 17 preguntas pendientes documentadas en la especificación deben haberse respondido antes de esta fase.

Checklist de aceptación

• Reserva de cita desde el portal (simular un terapeuta real)
• Vista del asesor: revisión de caso, rellenar recomendaciones, marcar como completada
• Administración: crear cita manual, gestionar festivos, modificar catálogo de productos
• Verificar emails recibidos: confirmación, recordatorio y agenda del asesor
• Generar y descargar el informe mensual XLSX; comparar con el CSV de referencia
• Verificar que el portal se renderiza correctamente embebido en megemit.org (staging)
• Validar textos de emails en alemán con Verena

Gestión de incidencias

• Incidencias bloqueantes: corrección inmediata, re-test el mismo día
• Mejoras o ajustes menores: backlog priorizado para el sprint de lanzamiento

Cutover

• Deploy a producción: main ← merge de develop tras UAT aprobado
• Migrar datos históricos si los hay (acordar con Verena qué citas pasadas importar)
• Cargar seeders de producción (categorías, productos, asesores, festivos)
• Actualizar la URL del <iframe> en megemit.org apuntando al nuevo dominio
• Verificar envío de emails desde producción (dominio verificado en Mailgun/Postmark)
• Activar Redis queue workers en producción (Supervisor)
• Verificar Laravel Scheduler activo (crontab en el servidor)

Post-lanzamiento

• Sesión de formación con Verena: panel admin, gestión de citas, estadísticas
• Monitorización activa durante 48h (logs, colas, emails)
• Documento de handover: accesos, estructura del proyecto, cómo añadir un nuevo idioma, cómo añadir productos al catálogo
• Mantener sistema Concloo activo en paralelo durante 2 semanas como fallback