← Volver a proyectos
Productividad 2026 En curso
Timora: control de jornadas y reportes
Timora ayuda a gestionar historial de horas de trabajo, cálculo de pagos y reportes con separación estricta por usuario. Incluye flujo completo de jornadas, plantillas/proyectos y configuración de períodos sobre una arquitectura orientada a features.
Reto
Construir una app confiable para control diario de jornadas y cálculo de pago por horas, con reglas configurables y aislamiento estricto entre usuarios.
Solución
Se implementó una arquitectura por features sobre Next.js App Router con Server Actions, servicios y repositorios sobre Prisma. Se incorporaron autenticación con Better Auth, validaciones Zod y cálculo automático de horas normales y extra por plantilla.
Resultados
- Registro y edición de jornadas con cálculo de horas y pago en tiempo real
- Gestión de plantillas/proyectos con reglas por usuario
- Reportes exportables en CSV, PDF e imagen
- Configuración flexible de períodos de trabajo por usuario
- Base técnica lista para evolucionar con nuevos módulos
Detalle técnico
Stack y tecnologías
- - Next.js 15 + React 19 + TypeScript
- - Tailwind CSS v4 + componentes reutilizables
- - Prisma 7 + PostgreSQL
- - Better Auth (Prisma adapter)
- - Zod para validación en Server Actions
- - Zustand para notificaciones de cliente
Cómo está organizado
- - src/app: rutas, layouts, redirects y metadata
- - src/features: work-days, projects, reports, settings, auth, notifications
- - src/lib: auth, prisma y utilidades de infraestructura
- - Actions validan input y delegan reglas a services
- - Repositories encapsulan acceso Prisma
Módulos clave
- - Work-days: alta/edición de jornadas y cálculo normal/extra con cutoff
- - Projects: plantillas por usuario con reglas de tarifa y multiplicador
- - Reports: analítica por rango/proyecto y exportación CSV/PDF/imagen
- - Settings: configuración de períodos y semana de inicio
- - Auth: login/registro, sesiones y guards reutilizables
Riesgos / deuda técnica
- - Complejidad creciente de reglas de horas extra puede requerir motor dedicado
- - Dependencia de Server Actions exige disciplina en manejo de errores
- - Sin e2e robusto, algunos flujos críticos dependen de pruebas unitarias
- - Escenarios de concurrencia en edición de jornadas requieren monitoreo
¿Necesitas construir o mejorar un sistema?
Lo aterrizamos con criterio técnico, foco operativo y una ejecución limpia.