SD Radovljica

La mayoría de los clubes deportivos gestionan a sus socios en hojas de cálculo. SD Radovljica — un club de tiro de Radovljica, Eslovenia — quería algo mejor: un portal de socios en condiciones donde cada socio registrado pueda navegar por el calendario de entrenamientos, inscribirse a sesiones, entrar en competiciones y ver su clasificación de temporada, todo dentro de un sistema seguro y controlado por roles.

Lo construí como un plugin de WordPress a medida — no como un hack de tema ni como un montón de shortcodes, sino como un paquete PHP PSR-4 de primera clase con arquitectura por capas (Models → Repositories → Services → API / Admin / Frontend), una suite completa de PHPUnit con Brain Monkey y wp-phpunit, análisis estático vía PHPStan y WordPress Coding Standards aplicados en CI.

El sitio público es un tema hijo de GeneratePress portado desde mockups HTML aprobados. El trabajo diferenciador es el plugin: un sistema autocontenido de gestión de socios que costaría cinco cifras como SaaS de catálogo pero que corre dentro de un hosting cPanel de 10 €/mes — porque cada pieza fue construida exactamente a lo que el club necesita.

El portal tiene cuatro niveles de rol, cada uno con capacidades explícitas establecidas en el momento de activación. Un Socio SDR (SDR Član) puede inscribirse en sesiones de entrenamiento y competiciones, ver resultados y ver sus propias inscripciones. Un Admin de Competición SDR añade la capacidad de gestionar sesiones, gestionar competiciones, introducir resultados y asignar turnos. Un Miembro de Junta SDR (SDR Član IO) obtiene acceso de lectura a los documentos de la junta — actas de reuniones, registros de asambleas, reglamentos — que son invisibles para los socios corrientes. Los administradores tienen las 14 capacidades.

Calendario de entrenamientos. Las sesiones se almacenan en una tabla a medida con disciplina, tipo de evento (entrenamiento, competición, sesión de dynamics, visita, otro), ubicación, capacidad y recurrencia opcional (semanal, quincenal, mensual). Los socios se inscriben a través de un frontend renderizado por shortcode; la aplicación de capacidad y la detección de conflictos de horario ocurren en el lado del servidor. Las marcas de tiempo de inscripción se almacenan con precisión de microsegundo (datetime(6)) — cuando una sesión se llena en exactamente el mismo segundo, gana el microsegundo más temprano, dando un orden de cola determinista y justo sin locks a nivel de aplicación.

Gestión de competiciones. Las competiciones tienen un ciclo de vida explícito: borrador → inscripciones abiertas → inscripciones cerradas → en curso → completada → cancelada. Los socios envían hasta tres preferencias de franja horaria; los admins asignan un turno confirmado y número de calle a través de una interfaz admin AJAX. Las transiciones de estado — pending, confirmed, DNS, DNF — siguen cada etapa del recorrido competitivo del socio.

Clasificaciones de temporada. Cada resultado de competición lleva una puntuación, categoría (junior / senior / veterano) y un flag is_ranked. Una regla configurable best-of-N (por defecto: las 5 mejores de 10 por temporada) impulsa el Ranking_Calculator. En lugar de un cron job que recomputa todo en un horario, las clasificaciones se reconstruyen de forma síncrona en el momento en que se guarda un resultado — la action sdr_result_saved se dispara dentro del repositorio, activa la calculadora limitada a ese par (discipline_id, season_year), y la tabla de líderes está actualizada antes de que regrese la respuesta HTTP. El desempate dense-rank (1,1,3 en lugar de 1,2,3) coincide con cómo se presentan convencionalmente los resultados de tiro.

Integración iCal. El plugin genera feeds .ics conformes a RFC 5545 — un feed público por disciplina o tipo de evento y un feed personal por socio (sólo sus propias inscripciones). Los feeds personales están protegidos por un token de 32 caracteres almacenado en user meta; el patrón de URL es /sdr-calendar/personal/<user_id>/<token>/. Los socios se suscriben una vez desde Google Calendar o Apple Calendar y se mantienen sincronizados automáticamente.

Automatización de email. Tres rutas automatizadas: confirmación de inscripción al registrarse (entrenamiento y competición, conmutables por separado), notificación de publicación de resultados y un recordatorio diario por WP-Cron que se dispara a las 08:00 y envía email a todos los inscritos a una sesión en las próximas 23–25 horas. El recordatorio usa una plantilla PHP en templates/email/reminder-training.php; cada envío — éxito o fallo — escribe una fila en el registro de auditoría para que la junta pueda ver la entrega de un vistazo.

Biblioteca de documentos. Los documentos de la junta (actas de reuniones, registros de asambleas, reglamentos, formularios) se almacenan con tres niveles de acceso: público, socios y junta. La taxonomía de tipos de documento mapea limpiamente a cómo los clubes deportivos eslovenos están legalmente obligados a mantener sus registros.

GDPR. Eslovenia está en la UE. El plugin se registra con las herramientas nativas de privacidad de WordPress — un exportador nombrado y un borrador nombrado bajo Herramientas → Exportar / Borrar datos personales. El borrador elimina las inscripciones pero anonimiza las filas de resultado: user_id se establece a NULL (nullable a nivel de esquema desde la versión 1.1.0 de la BD), las puntuaciones y marcas de tiempo se preservan, de modo que la solicitud de borrado de un socio no abre agujeros en las tablas de líderes históricas del club.

Línea base de calidad. El código corre PHPStan en nivel 5 con el plugin szepeviktor/phpstan-wordpress, PHPCS contra WordPress Coding Standards y una suite híbrida de PHPUnit — Brain Monkey para tests unitarios puros de Services y Models (sin bootstrap de WordPress requerido), wp-phpunit para tests de integración de repositorios, controladores REST y shortcodes. Cada push de CI ejecuta las tres herramientas.

Este es el tipo de proyecto que ilustra lo que “T4 Care” significa realmente en la práctica. El club tiene quizá sesenta socios activos. Nadie notaría si las marcas de tiempo de inscripción fueran de precisión de segundo en lugar de microsegundo. Nadie notaría si el borrado GDPR simplemente eliminara las filas de resultado. Nadie notaría si no hubiera registro de auditoría.

Lo construí con esos detalles de todos modos — porque los sesenta socios son personas reales, porque la aplicación de GDPR en Eslovenia es real y porque el secretario del club merece una infraestructura que no le ponga en evidencia dentro de dos años. La escala es una fracción de una plataforma fintech. El cuidado no lo es.