DevOps Timesheet
Il diario ore che si compila da solo con le ore dei tuoi task di Azure DevOps. Ferie, malattie, permessi e attività fuori dai task li aggiungi a mano.
Apri l'app → https://davidedg87.github.io/devops-timesheet/
Cosa fa
- Legge le ore dai task. Ricostruisce giorno per giorno quanto hai lavorato, dagli incrementi del Completed Work che hai registrato sui task, in uno o più progetti.
- Carica le ore sui task. Le ore scritte nel diario e non ancora su Azure DevOps aggiornano Completed Work e Remaining Work, con una conferma prima di scrivere.
- Assenze a mano. Ferie, permessi, malattia, congedi e altre causali, con il loro codice.
- Viste. Diario del giorno, griglia del mese, grafici e sprint presi dalle iterazioni dei progetti.
- Export CSV per settimana, mese o sprint, pronto per Excel.
- Funziona anche sul telefono, e si può installare come app.
Come funziona
Non c'è un server. La pagina è statica e gira tutta nel tuo browser, che parla solo con due servizi:
┌──────────────────────────┐
│ DevOps Timesheet │
│ (pagina nel browser) │
└──────┬────────────┬──────┘
ore dei task, │ │ attivita.json
iterazioni ▼ ▼ (le tue ore e assenze)
┌────────────────┐ ┌──────────────────────────┐
│ Azure DevOps │ │ il tuo repo GitHub │
│ (API REST) │ │ privato │
└────────────────┘ └──────────────────────────┘
- I tuoi dati stanno in un file
attivita.json in un tuo repo GitHub privato. Lo ritrovi su ogni PC e sul telefono, e ogni salvataggio è un commit, quindi hai lo storico di tutte le versioni.
- I token restano nel browser. Il token di Azure DevOps viene salvato anche in
segreti.json nel repo privato, così sugli altri dispositivi non devi reinserirlo.
Configurazione (circa 5 minuti)
Al primo avvio l'app ti guida in due passi. Ecco cosa ti serve.
Passo 1 · Repo GitHub per i dati
-
Crea un repo privato. Apri github.com/new, scegli un nome (ad esempio timesheet-data), seleziona Private e premi Create repository. Può restare vuoto.
-
Crea un token di accesso. Apri Fine-grained tokens → Generate new token e compila così:
- Expiration: fino a un anno (alla scadenza ne crei uno nuovo).
- Repository access: Only select repositories, poi scegli il repo appena creato.
- Permissions → Repository permissions → Contents: Read and write.
Premi Generate token e copialo.
-
Nell'app scrivi il repo (tuo-utente/timesheet-data) e incolla il token. Se il repo è vuoto, scegli Un diario vuoto.
L'app rifiuta i repo pubblici: ore e assenze, malattie comprese, sono dati personali.
Passo 2 · Azure DevOps (puoi farlo anche dopo)
- Apri dev.azure.com, clicca l'icona User settings in alto a destra (omino con l'ingranaggio) → Personal access tokens → + New Token.
- Compila così:
- Name:
DevOps Timesheet
- Organization: All accessible organizations
- Expiration: fino a un anno
- Scopes: Custom defined, poi Show all scopes e spunta:
| Permesso | Livello | A cosa serve |
|---|
| Work Items | Read & write | leggere le ore dei task e caricare quelle scritte nel diario |
| Project and Team | Read | mostrarti l'elenco dei progetti |
| User Profile | Read | mostrarti l'elenco delle tue organizzazioni |
- Premi Create e copia il token: Azure DevOps lo mostra una volta sola.
- Nell'app incolla il token, scegli l'organizzazione e spunta i progetti da cui leggere le ore.
Se hai saltato questo passo, lo riprendi dal riquadro Azure DevOps in basso a sinistra o da Impostazioni.
Uso quotidiano
- Le ore dei task arrivano da sole a ogni apertura. Puoi anche premere Sincronizza nel riquadro Azure DevOps.
- Correzioni su Azure DevOps: se dopo una sync cambi a mano il Completed Work di un task, anche chiuso, la sync successiva aggiorna il diario. Le ore in più arrivano nel giorno in cui le hai aggiunte; quelle in meno vengono tolte dalla riga importata più recente di quel task. Le righe scritte a mano nel diario non vengono mai modificate.
- Aggiungere un'attività: usa la riga in alto nel Diario (giorno, cosa hai fatto, task, ore). Commessa e nota stanno sotto Altro. Sul telefono c'è il pulsante ＋.
- Assenze: in ogni giorno c'è il menu ＋ Assenza, visibile passando col mouse sulla giornata. Se non scrivi le ore, l'assenza vale una giornata intera.
- Caricare le ore su Azure DevOps: se ci sono ore scritte nel diario e non ancora sui task, in alto compare "N h non ancora su DevOps · Carica". Prima di scrivere ti mostra il riepilogo; se qualcuno ha modificato il task nel frattempo, non sovrascrive.
- Giorni da compilare: i giorni lavorativi passati e vuoti sono tratteggiati in arancione, e in alto trovi quanti sono.
- Mese, Grafici, Esporta: dal menu a sinistra.
- Impostazioni: ore al giorno (8 di base, per part-time o orari diversi), tema chiaro o scuro, nome, sprint da nascondere, scorciatoie da tastiera.
Scorciatoie da tastiera
| Tasto | Azione |
|---|
N | nuova attività |
/ | cerca |
↑ ↓ Invio | muoversi tra le righe |
Ctrl + D | duplica la riga |
Ctrl + Z | annulla |
Alt + ← → | mese precedente o successivo |
Sul telefono
- Installa l'app: apri l'indirizzo con Chrome, menu ⋮ → Installa app.
- Collegala ai tuoi dati: sul PC apri Impostazioni → Collega un altro dispositivo e inquadra il codice QR con il telefono. Il QR contiene l'accesso al tuo repo dei dati: mostralo solo ai tuoi dispositivi.
Sicurezza e privacy
- Nessun server: i dati passano solo tra il tuo browser, il tuo repo GitHub e Azure DevOps.
- Token di GitHub: resta nel browser e può accedere solo al repo dei dati.
- Token di Azure DevOps: resta nel browser e in
segreti.json nel repo privato. Non finisce mai in attivita.json, né negli export.
- Per revocare l'accesso: elimina i token da GitHub (Settings → Developer settings → Personal access tokens) e da Azure DevOps (User settings → Personal access tokens). L'app ti chiederà quelli nuovi.
Problemi comuni
| Cosa succede | Cosa fare |
|---|
| Non compare l'elenco delle organizzazioni | Il token Azure DevOps deve valere per All accessible organizations e avere User Profile: Read. In alternativa scrivi l'organizzazione a mano: è la parola dopo dev.azure.com/ nel tuo indirizzo. |
| "PAT non valido o scaduto" | Il token Azure DevOps è scaduto o è stato revocato: creane uno nuovo e inseriscilo da Impostazioni → Azure DevOps. |
| "Token GitHub non valido o scaduto" | Crea un nuovo token GitHub per il repo dei dati e ricollega l'archivio da Impostazioni → Cambia archivio. |
| Mancano delle ore di un task | L'app legge le modifiche al Completed Work fatte da te, nei progetti scelti. Controlla che il progetto sia spuntato e premi Sincronizza. |
| Non vedo la versione nuova dell'app | Ricarica la pagina con Ctrl + F5. Sul telefono chiudi e riapri l'app. |
| "I dati erano cambiati: ricaricati" | Hai salvato da un altro dispositivo: l'app ha ricaricato la versione più recente, unendo le modifiche. |
Codici di assenza
| Codice | Causale |
|---|
| FER | Ferie |
| PER | Permesso retribuito (ROL) |
| PST | Permesso studio |
| MAL | Malattia |
| CPG | Congedo parentale giornaliero |
| CPO | Congedo parentale orario |
| L104 | Permesso L. 104 |
| DON | Donazione sangue |
| ASS | Assemblea / riunione sindacale |
| LUT | Permesso lutto |
| MAT | Congedo matrimoniale |
| CHI | Chiusura aziendale |
| FES | Festività / patrono |
| ALL | Permesso allattamento |
Le festività nazionali italiane, Pasquetta compresa, sono già escluse dai giorni lavorativi.
Sviluppo
- Un solo file,
index.html, senza build né dipendenze. Per provarlo in locale basta servirlo con un server statico qualsiasi, ad esempio python3 -m http.server.
- I controlli sulla logica (import da Azure DevOps, unione dei salvataggi, sprint, configurazione) si lanciano con
node checks.mjs. Non usano la rete: le chiamate sono simulate.
- La pubblicazione è automatica: ogni push su
main aggiorna la pagina tramite GitHub Pages.
