Cómo crear una app de control de tiempo: temporizadores, hojas de horas e informes

Una app de control de tiempo registra quién ha trabajado en qué, durante cuánto tiempo y si ese tiempo se puede facturar. Para crear una necesitas clientes y proyectos a los que imputar el tiempo, un temporizador que sobreviva al cierre de la pestaña, una forma de añadir y corregir registros a mano, una hoja semanal y unos informes que conviertan los registros en totales. Un creador de apps con IA puede generar una primera versión funcional con un prompt claro. Las decisiones que importan son de reglas: el redondeo, quién puede editar qué, cuándo se bloquea una semana y qué se considera facturable.

Decide para qué vas a controlar el tiempo

La misma app cambia según el motivo que haya detrás:

• Facturar a clientes. Horas por cliente, una tarifa por persona o proyecto y una exportación limpia para las facturas. Lo más importante son la precisión y un registro de auditoría.
• Nóminas de personal por horas. Fichaje de entrada y salida, pausas, reglas de horas extra y visto bueno del responsable. Se aplican las normas laborales locales, así que revisa qué registros estás obligado a conservar.
• Entender en qué se va el tiempo. Análisis personal o de equipo, estimaciones frente a lo real. La rapidez de registro importa más que los flujos de aprobación.

Elige uno como función principal para la primera versión. El rastreador de un autónomo que factura y el reloj de turnos de un almacén comparten un temporizador y poco más.

Qué necesita la app

Datos

Guarda la hora de inicio y la de fin en cada registro y deriva la duración a partir de ellas. Los registros introducidos como «2h 15m» sin horas pueden guardar solo la duración, pero conserva la fecha.

Páginas

• Temporizador y hoy: un botón grande de inicio y parada, un selector de proyecto y los registros de hoy debajo.
• Vista semanal: una cuadrícula con los proyectos en vertical y los días en horizontal, donde las personas escriben las horas directamente. Muchas prefieren esto a los temporizadores.
• Informes: horas por cliente, proyecto y persona para un rango de fechas, con la división entre facturable y no facturable, y exportación a CSV.
• Administración: gestionar clientes, proyectos, personas y tarifas.

Permisos

Define por escrito quién puede hacer qué antes de construir:

• Cada persona ve y edita sus propios registros.
• Los responsables ven los registros de su equipo y aprueban las semanas.
• Solo los administradores cambian las tarifas, e idealmente solo los administradores las ven.
• Nadie edita un registro una vez aprobado o facturado, salvo que un administrador lo reabra.

Esa última regla es lo que hace fiables los informes. Nuestra guía sobre cómo añadir inicio de sesión a tu app cubre la parte del acceso, y el control de acceso basado en roles cubre los roles.

Decisiones y compromisos

Temporizador, registro manual o ambos

Los temporizadores son precisos cuando la gente se acuerda de iniciarlos, y eso no siempre pasa. El registro manual es rápido para quien rellena su semana el viernes. La mayoría de equipos necesitan ambos, y una forma de editar un registro de temporizador a posteriori. Si solo vas a construir uno, construye la cuadrícula semanal: es más sencilla y cubre el caso de «se me olvidó iniciarlo».

Dónde vive el temporizador en marcha

Un temporizador que cuenta en el navegador pierde todo cuando se cierra la pestaña. Guarda la hora de inicio en la base de datos cuando alguien pulsa iniciar, y muestra el tiempo transcurrido restando esa hora de la actual. El temporizador sigue entonces funcionando al recargar, en otros portátiles y en el móvil. Decide si una persona puede tener dos temporizadores a la vez. Normalmente la respuesta es no: iniciar uno nuevo detiene el anterior.

Redondeo

Las reglas habituales son redondear cada registro hacia arriba al múltiplo de 6, 15 o 30 minutos más cercano. Guarda las horas exactas en la base de datos y aplica el redondeo solo en los informes y las facturas. Muestra ambas cifras en los informes para que nadie se sorprenda.

Bloqueo y aprobaciones

Sin bloqueo, las horas facturadas del mes pasado pueden cambiar después de haber enviado la factura. Un modelo sencillo: las personas envían una semana, un responsable la aprueba y los registros aprobados pasan a solo lectura. Si facturas desde la app, marca los registros como facturados para que no se puedan cobrar dos veces.

Zonas horarias y medianoche

Guarda las horas en UTC y muéstralas en la zona horaria de cada persona. Decide a qué día pertenece un registro que va de las 23:00 a la 01:00. La respuesta habitual es el día en que empezó.

Un primer prompt que funciona

Crea una app de control de tiempo para un estudio de diseño de seis personas. Datos: clientes (nombre, tarifa horaria), proyectos (cliente, nombre, horas de presupuesto) y registros de tiempo (persona, proyecto, inicio, fin, nota, facturable sí/no, estado borrador/enviado/aprobado). Páginas: una página Hoy con un temporizador de inicio y parada y un selector de proyecto que guarda la hora de inicio en la base de datos para que el temporizador sobreviva a una recarga; una página Semana con los proyectos como filas y de lunes a domingo como columnas, donde las personas pueden escribir las horas directamente; una página de Informes que muestre las horas por cliente, proyecto y persona para un rango de fechas, divididas entre facturables y no facturables, con exportación a CSV; y una página de Administración para clientes, proyectos y personas. Solo puede haber un temporizador en marcha por persona. Los registros aprobados no se pueden editar. Guarda las horas en UTC y muéstralas en la zona horaria del usuario. Diseño limpio, rápido y pensado para usarse con el teclado.

Nombra las tablas, las páginas, el comportamiento del temporizador y la regla de bloqueo, que son las cosas que una IA adivinaría si no se le dicen.

Pasos de construcción

1. Proyectos y registros manuales primero. Clientes, proyectos, un formulario para añadir un registro y una lista. Asegúrate de que los totales cuadran.
2. Temporizador. Inicio, parada, un temporizador activo por persona, hora de inicio guardada. Pruébalo iniciando un temporizador, cerrando la pestaña y reabriéndola.
3. Cuadrícula semanal. Escribir horas en una celda crea o actualiza un registro.
4. Inicio de sesión y roles. Añádelos antes de que usen la app personas reales, para que nadie vea las tarifas o los registros de otros por accidente.
5. Enviar y aprobar. Envío semanal, aprobación del responsable y solo lectura tras la aprobación.
6. Informes y exportación. Rango de fechas, agrupación, división facturable y CSV.
7. Tarifas y enlaces para facturación si facturas a clientes. Mantén la creación de facturas en un paso o app separados; consulta cómo crear una app de facturación.
8. Prueba los casos límite. Un registro que cruza la medianoche, una semana con cambio de hora, dos temporizadores iniciados desde dos dispositivos, la edición de un registro aprobado.

Errores comunes

• Contar el tiempo solo en el navegador. Funciona en la demostración y pierde horas en el uso real.
• Redondear los valores guardados. Nunca podrás recuperar la hora exacta.
• No bloquear las semanas aprobadas. Los informes dejan de coincidir con las facturas.
• Que todos vean las tarifas de todos. Oculta las tarifas por rol desde el principio.
• Demasiados campos obligatorios. Si registrar el tiempo lleva más de unos segundos, la gente deja de hacerlo y los datos se vuelven ficción. Haz opcionales la tarea y la nota al principio.
• Construir un gestor de proyectos completo dentro del rastreador. Mantén los proyectos como simples etiquetas. Si necesitas tareas, tableros y plazos, eso es una herramienta de gestión de proyectos, una construcción aparte.

Cuándo es mejor un rastreador comercial

Si tu equipo necesita un temporizador, una vista semanal e informes, los productos dedicados al control de tiempo ya lo hacen bien. Además traen cosas que requieren mucho trabajo construir: apps de escritorio y móvil, detección de inactividad, integraciones con calendario y otras herramientas, y recordatorios para rellenar las hojas de horas. Para nóminas por horas, una herramienta diseñada para ello gestionará las pausas, las horas extra y el registro de forma más segura que una primera versión a medida.

Crea la tuya cuando tus reglas no encajen, cuando quieras vincular las horas con datos que ya guardas (trabajos, órdenes de trabajo, minutas, facturas), cuando el precio por usuario de un equipo grande se dispare, o cuando el control de tiempo sea una parte de una herramienta interna más grande. Nuestra guía sobre crear frente a comprar software explica el equilibrio, y si tus horas viven ahora en una hoja compartida, consulta cómo convertir una hoja de cálculo en una app.

Crearla con Mythex

En Mythex describes el rastreador en el chat y el agente lo construye en una vista previa en directo. Añade una base de datos Postgres dedicada cuando los registros necesitan guardarse, y puedes pedirlo directamente o escribir /database. El caso de uso de herramienta interna de la documentación sugiere elegir un paso doloroso para la primera versión, algo que encaja aquí: empieza con los registros y la cuadrícula semanal, y luego añade los temporizadores y las aprobaciones.

El inicio de sesión para tu equipo es algo que añades con tu propio método de autenticación (receta de añadir inicio de sesión). Las cuentas de Mythex son para quien construye, no para quien usa tu app. Una vez que funcione el flujo principal, /test hace que el agente haga clic por la vista previa (inicia un temporizador, añade un registro, genera un informe) e informa de lo que falla. Como punto de partida visual, explora las plantillas de apps.

Preguntas