project-phoenix

Project Phoenix es una plataforma de supervisión autohospedada, con privacidad por diseño y conforme al RGPD, para escuelas alemanas de jornada completa (Ganztagsbetreuung / OGS y Hort). Sustituye las listas de asistencia en papel por quioscos de entrada/salida basados en NFC y proporciona supervisión en tiempo real de la presencia de los estudiantes y la ocupación de las salas. Capacidades clave: - Seguimiento de estudiantes por NFC: los niños se registran de entrada y salida en quioscos tipo tableta que ejecutan PyrePortal (Tauri + React) en Raspberry Pis. Las actualizaciones se envían en vivo a los paneles del personal. - Gestión de salas y grupos: ver y gestionar la ocupación de salas, asignaciones de supervisión, grupos combinados y horarios de actividades. - Portal de padres: cuentas de tutores entre escuelas con interfaz multilingüe (alemán, inglés, ruso, albanés). - Inscripción en línea: formularios públicos de inscripción configurables con admisión por fases, ofertas de cuidado y bloques de consentimiento. - Seguimiento horario del personal: sesiones de trabajo, contabilidad de saldos y flujos de vacaciones conformes con la ley alemana de jornada laboral (ArbZG). - Multiinquilino: múltiples Träger (operadores) y escuelas coexisten en una sola implementación, aislados mediante seguridad a nivel de fila de PostgreSQL, cada uno en su propio subdominio con un portal de operador separado. - Configuración por escuela en tiempo de ejecución: los administradores del inquilino pueden configurar el comportamiento sin necesidad de redesplegar. - Manual integrado con PDFs imprimibles generados en CI. Arquitectura: backend en Go 1.27 con enrutador Chi y ORM Bun; frontend como aplicación Next.js 16 / React 19 / TypeScript / Tailwind CSS; PostgreSQL 17 con 15 esquemas de dominio, SSL y RLS; autenticación JWT con tokens de refresco y MFA; despliegue con Docker Compose con entornos cifrados con SOPS; CI/CD mediante GitHub Actions. Los quioscos NFC se comunican a través de un endpoint /api/iot/* autenticado por dispositivo. El proyecto se desarrolló junto a un OGS real y respaldado por investigación en la Universität Münster. Ofrece retención configurable, registros de auditoría de solo adición y soporte para el derecho a la supresión para cumplir con los requisitos alemanes de protección de datos.