Kuidas luua ajajälgimise rakendust: taimerid, tööajalehed ja aruanded

Ajajälgimise rakendus salvestab, kes, mille kallal ja kui kaua töötas ning kas seda aega saab arvele panna. Selle ehitamiseks vajate kliente ja projekte, mille järgi jälgida, taimerit, mis püsib ka siis, kui brauseri vahekaart on suletud, võimalust lisada ja parandada kirjeid käsitsi, nädala tööajalehte ning aruandeid, mis muudavad toored kirjed kogusummadeks. AI-rakendusehitaja saab ühest selgest käsust valmis esimese versiooni. Olulised otsused puudutavad reegleid: ümardamist, seda, kes mida muuta tohib, millal nädal lukustatakse ja mis on arveldatav.

Otsustage, milleks te aega jälgite

Sama rakendus näeb erinev välja sõltuvalt põhjusest:

• Klientide arvestamine. Tunnid kliendi kohta, hinnad inimese või projekti kohta ja puhas eksport arvete jaoks. Täpsus ja auditijälg on kõige olulisemad.
• Palk tunnipalgaliste töötajate jaoks. Sisse- ja väljalogimine, pausid, ületundide reeglid ning juhi kinnitus. Kohalikud tööseadused kehtivad, seega kontrollige, milliseid kirjeid peate säilitama.
• Selle mõistmine, kuhu aeg läheb. Isiklik või meeskonna ülevaade, hinnangud vs tegelik aeg. Sisestuse kiirus on tähtsam kui kinnitusvoog.

Valige üks peamine eesmärk esimeseks versiooniks. Vabakutselise arvestustööriist ja laovahetuse kell jagavad taimerit ja väga vähe muud.

Mida rakendus vajab

Andmed

Salvestage igale kirjele alguse ja lõpu aeg ning tuletage kestus neist. Käsitsi sisestatud kirjed nagu „2 h 15 min“ ilma kellaaegadeta võivad salvestada ainult kestuse, kuid hoidke kuupäeva.

Lehed

• Taimer ja täna: suur alusta/peata nupp, projekti valija ja tänased kirjed selle all.
• Nädala vaade: ruudustik, kus projektid on read ja päevad veerud, kuhu inimesed saavad tunde otse sisestada. Paljud eelistavad seda taimeritele.
• Aruanded: tunnid kliendi, projekti ja inimese kaupa valitud kuupäevavahemikus, jaotatud arveldatavateks ja mitte-arveldatavateks ning CSV-eksport.
• Admin: klientide, projektide, inimeste ja hindade haldamine.

Õigused

Kirjutage enne ehitamist üles, kes mida teha tohib:

• Inimesed näevad ja muudavad ainult oma kirjeid.
• Juhid näevad oma meeskonna kirjeid ja kinnitavad nädalaid.
• Ainult administraatorid muudavad hindu ja ideaalis näevad hindu ainult nemad.
• Kedagi ei muuda kirjet pärast kinnitamist või arvele panemist, välja arvatud juhul, kui administraator selle uuesti avab.

Viimane reegel teeb aruanded usaldusväärseks. Meie juhend sisselogimise lisamisest oma rakendusele katab sisselogimise poole ning rollipõhine juurdepääsukontroll katab rollid.

Otsused ja kompromissid

Taimer, käsitsi sisestus või mõlemad

Taimerid on täpsed, kui inimesed mäletavad neid käivitada, mis ei ole alati nii. Käsitsi sisestus on kiire inimestele, kes täidavad oma nädala reede õhtul. Enamik meeskondi vajab mõlemat ning võimalust taimeri kirjet hiljem muuta. Kui ehitate ainult ühe, ehitage nädala ruudustik; see on lihtsam ja katab juhtumi, kui unustati taimer käivitada.

Kus töötav taimer elab

Brauseris töötav taimer kaotab kõik, kui vahekaart suletakse. Salvestage alguse aeg andmebaasi, kui keegi vajutab alusta, ja näidake möödunud aega, lahutades selle praegusest ajast. Taimer jätkab siis töötamist lehe värskendamise, sülearvutite ja telefonide vahel. Otsustage, kas üks inimene saab käivitada kaks taimerit korraga. Tavaliselt on vastus ei: uue alustamine peatab vana.

Ümardamine

Levinud reeglid on iga kirje ümardamine üles järgmise 6, 15 või 30 minuti peale. Hoidke täpsed ajad andmebaasis ja rakendage ümardamist ainult aruannetes ja arvetes. Näidake aruannetes mõlemat arvu, et keegi ei oleks üllatunud.

Lukustamine ja kinnitamine

Ilma lukustuseta võivad eelmise kuu arvele pandud tunnid muutuda pärast arve väljastamist. Lihtne mudel: inimesed esitavad nädala, juht kinnitab selle ja kinnitatud kirjed muutuvad ainult lugemiseks. Kui väljastate arved rakendusest, märkige kirjed arvele pandud olekusse, et neid ei arveldataks kaks korda.

Ajavööndid ja kesköö

Salvestage ajad UTC-s ja kuvage need inimese ajavööndis. Otsustage, mis päeva kuulub kirje, mis kestab 23:00 kuni 01:00. Tavaline vastus on päev, millal see alustas.

Esimene töötav käsk

Ehita ajajälgimise rakendus kuuelikule disainistuudiole. Andmed: kliendid (nimi, tunnihind), projektid (klient, nimi, eelarvetunnid) ja ajakirjed (inimene, projekt, algus, lõpp, märkus, arveldatav jah/ei, olek mustand/esitatud/kinnitatud). Lehed: Tänane leht alusta/peata taimeri ja projekti valijaga, mis salvestab alguse aja andmebaasi, et taimer püsiks ka värskendamisel; Nädala leht, kus projektid on read ja esmaspäevast pühapäevani veerud, kuhu inimesed saavad tunde otse sisestada; Aruannete leht, mis näitab tunde kliendi, projekti ja inimese kaupa valitud kuupäevavahemikus, jaotatud arveldatavateks ja mitte-arveldatavateks, koos CSV-eksportiga; ja Admin-leht klientide, projektide ja inimeste jaoks. Inimese kohta saab korraga töötada ainult üks taimer. Kinnitatud kirjeid ei saa muuta. Salvesta ajad UTC-s ja näita neid kasutaja ajavööndis. Puhas, kiire, klaviatuurisõbralik disain.

See nimetab tabelid, lehed, taimeri käitumise ja lukustusreegli — asjad, mida AI muidu oletaks.

Ehitamise sammud

1. Kõigepealt projektid ja käsitsi sisestused. Kliendid, projektid, vorm kirje lisamiseks ja nimekiri. Veenduge, et summad klapivad.
2. Taimer. Alusta, peata, üks töötav taimer inimese kohta, salvestatud alguse aeg. Testige: käivitage taimer, sulgege vahekaart ja avage see uuesti.
3. Nädala ruudustik. Tundide sisestamine lahtrisse loob või uuendab kirje.
4. Sisselogimine ja rollid. Lisage need enne, kui päris inimesed seda kasutavad, et keegi ei näeks kogemata hindu ega teiste kirjeid.
5. Esitamine ja kinnitamine. Nädalane esitamine, juhi kinnitus, ainult lugemiseks pärast kinnitamist.
6. Aruanded ja eksport. Kuupäevavahemik, rühmitamine, arveldatavate jaotus, CSV.
7. Hinnad ja arvete ühendused, kui arvete esitate. Hoidke arvete loomine eraldi sammuna või eraldi rakenduses; vt kuidas luua arvelduse rakendust.
8. Testige servajuhtumeid. Kirje üle kesköö, suveaja vahetuse nädal, kaks taimerit kahest seadmest, kinnitatud kirje muutmine.

Levinud vead

• Aja arvestamine ainult brauseris. See töötab demos ja kaotab tunde tegelikus kasutuses.
• Salvestatud väärtuste ümardamine. Täpset aega ei saa kunagi tagasi.
• Kinnitatud nädalate lukustamata jätmine. Aruanded lakkavad klappimast arvetega.
• Kõik näevad kõigi hindu. Peitke hinnad rolli järgi esimesest päevast alates.
• Liiga palju kohustuslikke välju. Kui aja logimine võtab rohkem kui paar sekundit, lakkavad inimesed seda tegemast ja andmed muutuvad väljamõeldiseks. Tehke ülesanne ja märkus esialgu valikuliseks.
• Täieliku projektihaldustööriista ehitamine jälgija sisse. Hoidke projektid lihtsate siltidena. Kui vajate ülesandeid, tahvleid ja tähtaegu, on see projektihaldustööriist, eraldi ehitus.

Millal on valmislahendus parem valik

Kui teie meeskond vajab taimerit, nädala vaadet ja aruandeid, teevad spetsiaalsed ajajälgimise tooted seda juba hästi. Need tulevad ka asjadega, mille ehitamine võtab tõsist tööd: töölaua- ja mobiilirakendused, tegevusetuse tuvastamine, kalendri- ja tööriistade integratsioonid ning meeldetuletused tööajalehtede täitmiseks. Tunnipalga arvestamiseks sobib tööks ehitatud tööriist ohutumalt, käsitledes pause, ületunde ja arvestust, kui esimene oma rakendus.

Ehitage oma, kui teie reeglid ei sobi, kui soovite tunde siduda andmetega, mida juba hoiate (tööd, töökorraldused, retainerid, arved), kui kasutajapõhine hind suurel meeskonnal kokku läheb või kui ajajälgimine on suurema sisetööriista osa. Meie juhend tarkvara ostmise ja ehitamise võrdlemisest käib kompromisside läbi, ja kui teie tunnid elavad praegu jagatud tabelis, vaadake kuidas muuta tabel rakenduseks.

Ehitamine Mythexis

Mythexis kirjeldate jälgijat vestluses ja agent ehitab selle reaalajas eelvaates. Kui kirjed vajavad salvestamist, lisab see spetsiaalse Postgres andmebaasi, ja seda saate paluda otse või kirjutada /database. Sisetööriista kasutusjuhtum dokumentatsioonis soovitab valida ühe valusa sammu esimeseks versiooniks, mis sobib siia hästi: alustage kirjete ja nädala ruudustikuga, seejärel lisage taimerid ja kinnitused.

Meeskonna sisselogimise lisate oma autentimisviisiga (sisselogimise lisamise juhend). Mythexi kontod on mõeldud inimestele, kes ehitavad, mitte inimestele, kes teie rakendust kasutavad. Kui põhiline voog töötab, käsib /test agendil klõpsata läbi eelvaate (käivitada taimer, lisada kirje, käivitada aruanne) ja teatada, mis puruneb. Visuaalseks alguspunktiks vaadake rakenduste malle.

Küsimused