Com crear una app de control de temps: cronòmetres, fulls horaris i informes

Una app de control de temps registra qui ha treballat en què, durant quant de temps, i si aquest temps es pot facturar. Per construir-ne una necessites clients i projectes contra els quals registrar, un cronòmetre que sobrevisqui al tancament de la pestanya, una manera d'afegir i corregir entrades a mà, un full horari setmanal i informes que converteixin les entrades en totals. Un creador d'apps amb IA pot produir una primera versió funcional a partir d'un prompt clar. Les decisions que importen són de regles: arrodoniment, qui pot editar què, quan es bloqueja una setmana i què es considera facturable.

Decideix per a què registres el temps

La mateixa app es veu diferent segons el motiu que hi ha darrere:

• Facturar a clients. Hores per client, una tarifa per persona o projecte i una exportació neta per a les factures. La precisió i una traça d'auditoria són el més important.
• Nòmina per a personal per hores. Entrada i sortida, pauses, normes d'hores extres i validació per part del responsable. S'apliquen les normes laborals locals, així que revisa quins registres estàs obligat a conservar.
• Entendre on es va el temps. Visió personal o d'equip, estimacions contra temps reals. La velocitat d'entrada importa més que els fluxos d'aprovació.

Tria-ne un com a feina principal de la primera versió. El seguidor de facturació d'un autònom i el rellotge de torn d'un magatzem comparteixen un cronòmetre i poca cosa més.

Què necessita l'app

Dades

Guarda l'hora d'inici i de fi a cada entrada i deriva-ne la durada. Les entrades introduïdes com «2h 15m» sense hores poden guardar només la durada, però conserva-hi una data.

Pàgines

• Cronòmetre i avui: un botó gran d'inici i aturada, un selector de projecte i les entrades d'avui a sota.
• Vista setmanal: una graella amb els projectes a l'esquerra i els dies a la dreta, on la gent escriu les hores directament. Molta gent la prefereix als cronòmetres.
• Informes: hores per client, projecte i persona en un interval de dates, amb separació entre facturable i no facturable, i exportació a CSV.
• Administració: gestiona clients, projectes, persones i tarifes.

Permisos

Anota qui pot fer què abans de construir:

• Les persones veuen i editen les seves pròpies entrades.
• Els responsables veuen les entrades del seu equip i aproven setmanes.
• Només els administradors canvien les tarifes, i idealment només ells les veuen.
• Ningú edita una entrada un cop aprovada o facturada, tret que un administrador la reobri.

Aquesta última regla és la que fa fiables els informes. La nostra guia sobre afegir inici de sessió a la teva app cobreix la part d'inici de sessió, i el control d'accés basat en rols cobreix els rols.

Decisions i compromisos

Cronòmetre, entrada manual o les dues

Els cronòmetres són precisos quan la gent recorda engegar-los, cosa que no sempre passa. L'entrada manual és ràpida per a qui omple la setmana el divendres. La majoria d'equips necessiten les dues coses, i una manera d'editar una entrada de cronòmetre a posteriori. Si només en construeixes una, construeix la graella setmanal: és més senzilla i cobreix el cas d'haver oblidat d'engegar el cronòmetre.

On viu el cronòmetre en curs

Un cronòmetre que compta al navegador perd tot quan es tanca la pestanya. Guarda l'hora d'inici a la base de dades quan la persona prem inici, i mostra el temps transcorregut restant-la de l'ara. Així el cronòmetre continua funcionant després d'actualitzar, en un altre portàtil o en el mòbil. Decideix si una persona pot tenir dos cronòmetres alhora. Normalment la resposta és no: en començar-ne un de nou, s'atura l'anterior.

Arrodoniment

Les regles habituals són arrodonir cada entrada cap amunt als 6, 15 o 30 minuts més pròxims. Guarda els temps exactes a la base de dades i aplica l'arrodoniment només als informes i a les factures. Mostra les dues xifres als informes perquè ningú no es sorprengui.

Bloqueig i aprovacions

Sense bloqueig, les hores facturades del mes passat poden canviar després que s'hagi enviat la factura. Un model senzill: la gent envia una setmana, un responsable l'aprova, i les entrades aprovades passen a només lectura. Si factures des de l'app, marca les entrades com a facturades perquè no es puguin cobrar dues vegades.

Zones horàries i mitjanit

Guarda les hores en UTC i mostra-les en la zona horària de la persona. Decideix a quin dia pertany una entrada que va de les 23:00 a la 01:00. La resposta habitual és el dia en què va començar.

Un primer prompt que funciona

Construeix una app de control de temps per a un estudi de disseny de sis persones. Dades: clients (nom, tarifa horària), projectes (client, nom, hores de pressupost) i entrades de temps (persona, projecte, inici, fi, nota, facturable sí/no, estat esborrany/enviat/aprovat). Pàgines: una pàgina Avui amb un cronòmetre d'inici i aturada i un selector de projecte que desi l'hora d'inici a la base de dades perquè el cronòmetre sobrevisqui a una actualització; una pàgina Setmana amb els projectes com a files i de dilluns a diumenge com a columnes, on la gent pot escriure les hores directament; una pàgina Informes que mostri hores per client, projecte i persona en un interval de dates, separades en facturables i no facturables, amb exportació a CSV; i una pàgina d'administració per a clients, projectes i persones. Només es pot tenir un cronòmetre en marxa per persona. Les entrades aprovades no es poden editar. Guarda les hores en UTC i mostra-les en la zona horària de l'usuari. Disseny net, ràpid i fàcil d'utilitzar amb el teclat.

Descriu les taules, les pàgines, el comportament del cronòmetre i la regla de bloqueig, que són les coses que una IA endevinaria malament si no.

Passos de construcció

1. Primer projectes i entrades manuals. Clients, projectes, un formulari per afegir una entrada i una llista. Assegura't que els totals quadrin.
2. Cronòmetre. Inici, aturada, un cronòmetre en marxa per persona, hora d'inici desada. Prova-ho engegant un cronòmetre, tancant la pestanya i tornant-la a obrir.
3. Graella setmanal. Escriure hores en una cel·la crea o actualitza una entrada.
4. Inici de sessió i rols. Afegeix-los abans que hi entri gent real, perquè ningú no vegi tarifes ni entrades d'altres per error.
5. Enviar i aprovar. Enviament setmanal, aprovació del responsable, només lectura després de l'aprovació.
6. Informes i exportació. Interval de dates, agrupació, separació facturable i CSV.
7. Tarifes i punts d'enllaç amb la facturació si factures a clients. Mantén la creació de factures en un pas o una app separats; consulta com crear una app de facturació.
8. Prova els casos límit. Una entrada que creua la mitjanit, una setmana amb canvi d'hora, dos cronòmetres iniciats des de dos dispositius, editar una entrada aprovada.

Errors habituals

• Comptar el temps només al navegador. Funciona en la demostració i perd hores en l'ús real.
• Arrodonir els valors guardats. Mai no podràs recuperar l'hora exacta.
• Cap bloqueig de les setmanes aprovades. Els informes deixen de coincidir amb les factures.
• Tothom veu les tarifes de tothom. Amaga les tarifes per rol des del primer dia.
• Massa camps obligatoris. Si registrar el temps triga més de pocs segons, la gent deixa de fer-ho i les dades es converteixen en ficció. Fes que la tasca i la nota siguin opcionals al principi.
• Construir un gestor de projectes complet dins del control de temps. Mantén els projectes com a etiquetes simples. Si necessites tasques, taulers i terminis, és un gestor de projectes, una construcció separada.

Quan és millor una eina de control de temps ja feta

Si el teu equip necessita un cronòmetre, una vista setmanal i informes, els productes dedicats al control de temps ja ho fan molt bé. A més, inclouen coses que costen molt de construir: apps d'escriptori i de mòbil, detecció d'inactivitat, integracions amb calendaris i altres eines, i recordatoris per omplir els fulls horaris. Per a la nòmina per hores, una eina feta a aquest efecte gestionarà les pauses, les hores extres i el registre de manera més segura que una primera versió d'app pròpia.

Construeix-ne una de pròpia quan les teves regles no encaixin, quan vulguis connectar les hores amb dades que ja tens (feines, ordres de treball, retainers, factures), quan el preu per usuari d'un equip gran s'acumuli, o quan el control de temps sigui una part d'una eina interna més gran. La nostra guia sobre construir o comprar programari analitza el compromís, i si les teves hores viuen ara en un full compartit, mira com convertir un full de càlcul en una app.

Construir-la amb Mythex

A Mythex descrius el control de temps al xat i l'agent el construeix en una vista prèvia en directe. Afegeix una base de dades Postgres dedicada quan les entrades han de guardar-se, i pots demanar-ho directament o escriure /database. El cas d'ús d'eina interna de la documentació suggereix triar un pas dolorós per a la primera versió, cosa que encaixa aquí: comença amb les entrades i la graella setmanal, i després afegeix els cronòmetres i les aprovacions.

L'inici de sessió per al teu equip és alguna cosa que afegeixes amb el teu propi enfocament d'autenticació (recepta per afegir inici de sessió). Els comptes de Mythex són per a les persones que construeixen, no per a les que usen la teva app. Quan el flux central funcioni, /test fa que l'agent cliqui per la vista prèvia (iniciar un cronòmetre, afegir una entrada, executar un informe) i informi de què es trenca. Per a un punt de partida visual, mira les plantilles d'apps.

Preguntes