sleeplab
SleepLab es un panel local-first para analizar datos de CPAP ResMed. Usa React/Vite frontend, FastAPI backend y PostgreSQL para importar, almacenar y visualizar sesiones terapéuticas con informes PDF.
Ficha actualizada 24 sept 2026, 14:41 · upstream 24 sept 2026, 14:10 · release v2.0.3
Qué es sleeplab
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
SleepLab es una aplicación web auto-alojable diseñada específicamente para el análisis de datos de terapia CPAP de dispositivos ResMed. La arquitectura local-first prioriza la privacidad al procesar los archivos DATALOG directamente en el servidor del usuario sin enviarlos a servicios en la nube. El sistema combina un frontend moderno basado en React 19 con Vite y TypeScript para visualización interactiva, con un backend robusto en FastAPI que maneja autenticación JWT, gestión de sesiones y lógica de negocio.
- Visualizar métricas de sueño nocturno en dashboards interactivos con gráficos de tendencias
- Importar datos desde tarjetas SD ResMed DATALOG sin subir información sensible a servicios externos
- Calcular adherencia terapéutica con clasificación por niveles (cumplimiento/marginal/no cumplimiento)
- Generar informes PDF detallados para revisiones médicas o solicitudes de reembolso asegurador
- Soporte Docker Compose con imagen multi-architectura precompilada y migraciones automáticas
- Arquitectura modular separando frontend, backend e importador de datos en repositorios distintos
- Configuración flexible de umbrales de adherencia mediante variables de entorno personalizables
- Gestión robusta de zonas horarias con variables MACHINE_TZ y DISPLAY_TZ independientes
- Dependencia estricta de PostgreSQL 16 para la base de datos principal
- Necesidad de configurar manualmente CORS_ALLOWED_ORIGINS para despliegues públicos seguros
- Funcionalidades de resumen IA requieren clave OpenAI API externa opcionalmente configurada
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Usar docker compose up -d con .env.selfhost.example como base. Establecer SECRET_KEY con valor aleatorio largo antes del arranque. Verificar salud de PostgreSQL mediante pg_isready antes de iniciar app. Ajustar CORS_ALLOWED_ORIGINS a dominios específicos si se expone públicamente en lugar de usar *. Migraciones automáticas al arrancar API.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.