quoska
Herramienta de registro de horas open-source para pequeñas empresas y equipos. Utiliza Next.js, React y Supabase con PostgreSQL. Incluye auditoría estricta, PWA y seguridad de nivel de fila para aislamiento de datos.
Ficha actualizada 22 sept 2026, 18:14 · upstream 22 sept 2026, 15:48 · release v0.1.0
Qué es quoska
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Quoska es una solución de registro de tiempos (Zeiterfassung) diseñada para pequeños negocios y equipos, enfocada en la transparencia y el cumplimiento normativo. La plataforma permite a los empleados registrar horas, pausas y ausencias mediante una interfaz PWA accesible en móviles y escritorio, garantizando que todos los eventos se basen en la hora del servidor para evitar discrepancias de zona horaria.
El sistema prioriza la trazabilidad y la integridad de los datos. Las correcciones a registros no son silenciosas; requieren una justificación explícita y dejan un rastro auditivo completo, lo cual es crucial para auditorías laborales. Además, utiliza seguridad de nivel de fila en PostgreSQL para asegurar que cada instancia o empresa solo acceda a sus propios datos, incluso en entornos compartidos.
Técnicamente, está construida con Next.js 16, React 19 y TypeScript, integrando Supabase para autenticación y base de datos. El proyecto incluye una suite de pruebas robusta (Vitest, Playwright) y reglas personalizadas de ESLint que protegen contra prácticas inseguras como la eliminación directa de datos o el uso de timestamps del cliente.
- Registro de horas y pausas en móviles y escritorio vía PWA
- Gestión de vacaciones, bajas y aprobaciones por parte de administradores
- Auditoría de cambios con justificación obligatoria para cumplimiento legal
- Aislamiento de datos entre múltiples empresas usando RLS en PostgreSQL
- Exportación de reportes CSV y visualización de progreso semanal
- Despliegue autoalojado con Docker y Supabase CLI local
- Timestamps del servidor para evitar manipulación de horas locales
- Seguridad de nivel de fila (RLS) para aislamiento estricto de datos
- Auditoría completa: correcciones visibles con autor y razón
- Licencia AGPL-3.0 garantizando código abierto en servicios web
- PWA nativa sin necesidad de instalar aplicaciones nativas
- Reglas ESLint personalizadas para prevenir vulnerabilidades comunes
- Dependencia obligatoria de Supabase CLI para el desarrollo local
- No incluye Docker Compose, requiriendo configuración manual de servicios
- Requiere Node.js 24+, lo que puede excluir entornos legacy
- La implementación legal final recae en la responsabilidad del empleador según disclaimer
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.
Se recomienda usar Docker y Caddy para producción. Para desarrollo local, instalar Supabase CLI y configurar .env con las credenciales de API. Consultar docs/deployment-hetzner.md o docs/aws-s3-backups.md para estrategias de backup y hosting en la nube.
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.