The Jozzino Timesheet
Guida Utente

Il manuale
del tuo lavoro

Versione 1.8

Il tempo è la risorsa più preziosa. Registrarlo bene significa poterlo comprendere, ritrovare e valorizzare.

Archivio intelligenteNon gestionalemacOS2026
Indice

Una guida da usare, non solo da leggere.

01 - Benvenuto

Cos'è The Jozzino Timesheet

The Jozzino Timesheet è un'applicazione macOS per registrare ore, attività, assenze e saldi ufficiali in un archivio personale, coerente e ricercabile.

Non è un gestionale aziendale e non è un sistema di controllo. È un archivio intelligente: conserva i dati inseriti dall'utente, li collega tra loro e li trasforma in informazioni utili senza decidere al posto suo.

Semplice

Una finestra, quattro aree principali e un flusso pensato per registrare rapidamente il lavoro quotidiano.

Affidabile

Il workbook resta la fonte unica dei dati. Ogni salvataggio riscrive lo stato coerente solo dopo un'azione confermata.

Ricercabile

Ogni registrazione rimane ritrovabile per data, ID, commessa, lavorazione, tipo di riga e stato.

La filosofiaIl Timesheet non decide, non controlla e non interpreta. Archivia, collega e rende ritrovabili i dati ufficiali inseriti dall'utente.
02 - Primo avvio

Creare o aprire un Timesheet

All'avvio l'app mostra una schermata essenziale: puoi creare un nuovo archivio, aprirne uno esistente oppure trascinare direttamente il file nella finestra.

Schermata iniziale con Nuovo Timesheet, Apri Timesheet e area di trascinamento.
Schermata iniziale con Nuovo Timesheet, Apri Timesheet e area di trascinamento.
1Nuovo Timesheet

Crea un workbook personale pronto per registrazioni, lavorazioni, saldi e note.

2Apri Timesheet

Collega un archivio esistente e apre l'area di lavoro completa.

3Drag & Drop

Trascina il file Timesheet direttamente nella finestra per aprirlo.

SuggerimentoConserva il Timesheet in una cartella sincronizzata, ad esempio iCloud Drive o Dropbox, così avrai sempre una copia recuperabile.
Nessun blocco di sicurezzaThe Jozzino Timesheet è firmata con Developer ID Apple e notarizzata da Apple: al primo avvio macOS non mostra il blocco riservato alle app da sviluppatore non identificato.
Novità 1.8Questa schermata dipende ora dalla modalità attiva: "Nuovo Timesheet" compare solo in Editor. Vedi il capitolo Modalità Consultazione/Editor.
03 - Modalità Consultazione/Editor

Due modalità, un solo archivio

Novità della versione 1.8: ogni sessione del Timesheet parte in Consultazione — si può leggere tutto, ma non creare né modificare nulla. Passare a Editor sblocca la scrittura, dietro autenticazione del Mac.

Consultazione

Modalità predefinita a ogni avvio. Consente solo operazioni non distruttive: Consultazione e, in Amministrazione, Archivio e Previsioni.

Editor

Sblocca Inserimento, Anagrafiche e l'intera Amministrazione. Richiede un'autenticazione del Mac a ogni cambio modalità.

Schermata iniziale in Consultazione: solo Apri Timesheet, Nuovo Timesheet non compare.
In Consultazione la schermata iniziale mostra solo "Apri Timesheet": creare un nuovo archivio è un'azione Editor-only.
Pannello Modalità aperto con le due opzioni Consultazione ed Editor.
Il pulsante in alto a destra apre il pannello "Modalità", identico in ogni schermata dell'app.
Richiesta di autenticazione del Mac per passare alla modalità Editor.
Selezionando Editor, macOS chiede un'autenticazione — Touch ID, Apple Watch o password. Annullare o non riuscire l'autenticazione riporta automaticamente a Consultazione.

Cosa cambia nella barra e nei menu

Stessa area di lavoro, due modalità: la barra e le sotto-schede si adattano a quello che è consentito fare.

Barra schede in Consultazione: solo Consultazione e Amministrazione.
Consultazione: solo le schede Consultazione e Amministrazione restano raggiungibili.
Barra schede in Editor: Inserimento, Consultazione, Anagrafiche, Amministrazione.
Editor: tornano visibili Inserimento e Anagrafiche.
Amministrazione in Consultazione: solo le sotto-schede Archivio e Dati Personali.
Anche dentro Amministrazione la Consultazione riduce le sotto-schede a Archivio e Dati Personali (che a sua volta mostra solo Previsioni); Catalogo Autocomplete, Pianificazioni e Note restano Editor-only.
Perché due modalitàConsultazione è pensata per guardare i propri dati — anche su un Mac condiviso o in una demo — senza il rischio di modificarli per errore. Editor resta il luogo in cui si registra davvero il lavoro.
Nessuna password gestita dall'appL'autenticazione usa solo il sistema di sicurezza di macOS (Touch ID, Apple Watch o la password del Mac): il Timesheet non salva né gestisce credenziali proprie.
04 - Il file Timesheet

Un solo archivio

The Jozzino Timesheet non usa database, server o cloud proprietari. Tutto vive in un unico file Timesheet.

Cosa contiene

Registrazioni giornaliere, lavorazioni, riepiloghi giorno, saldi ufficiali, Catalogo Autocomplete, ore ufficiali e note.

Perché è importante

Il file è trasportabile, salvabile, duplicabile e archiviabile. Aprire il file significa aprire il progetto.

FoglioRuolo
REGISTRAZIONIEventi datati: data, ore, tipo, note e lavorazione collegata.
LAVORILavorazioni reali con stato, ore previste e archiviazione.
CATALOGOMemoria grezza dell'autocompletamento: suggerimenti disponibili, non lavoro reale.
NOTEQuaderno di progetto interno al Timesheet.
AttenzioneIl file è tecnicamente un workbook Excel, ma la modifica diretta è consigliata solo per interventi consapevoli. L'app mantiene la coerenza tra registrazioni, lavorazioni e riepiloghi.
05 - Inserimento

Registrare il lavoro

Inserimento è la schermata quotidiana (Editor-only): compili una bozza, scegli data e tipo riga, confermi. Il Timesheet si occupa di collegare tutto al resto dell'archivio.

Schermata Inserimento con una registrazione salvata: 51002, Nebula, Storyboard, 2 ore.
Una registrazione salvata: la riga appare in basso e il form resta pronto per la successiva.

ID

Codice della commessa o attività. L'ID da solo non identifica una lavorazione: lavora sempre insieme a Commessa e Blocco/Lavorazione.

Commessa

Nome leggibile del progetto, cliente interno o attività.

Blocco/Lavorazione

La parte specifica del lavoro: montaggio, analisi, revisione, test, supporto, report.

Ore, Data e Tipo

Le ore alimentano riepiloghi e saldi. Il tipo distingue Lavoro, Permesso, Recupero, Ferie e Altro.

Un inserimento, passo dopo passo

Dodici schermate reali che seguono due registrazioni dall'inizio alla modifica.

Autocompletamento

Le proposte arrivano da cronologia, Lavori e Catalogo. Inserisci una volta, riutilizza ovunque.

Merge automatico

Se registri nello stesso giorno la stessa lavorazione, le ore si sommano invece di creare duplicati.

Controllo 8 ore

Il totale giornaliero aiuta a non superare la giornata standard.

Modifica ed elimina

Le registrazioni sono l'unica entità eliminabile direttamente dall'utente.

Stato lavorazione

Cinque stati disponibili: Da iniziare, In corso, Da rendicontare, Rendicontata, Interna.

Copia lavorazione

Tiene in memoria ID, Commessa e Blocco per incollarli in un'altra registrazione senza ridigitarli.

06 - Consultazione

Capire lo storico

Consultazione non cambia i dati: li riorganizza. Puoi leggere il lavoro per lavorazione, assenze o report cronologico Anziano.rtf — ed è l'unica scheda sempre raggiungibile, in entrambe le modalità.

Lavorazioni

Raggruppa le registrazioni per ID + Commessa + Blocco, con ore previste, ore lavorate, scostamento, stato e storico attività espandibile.

Assenze

Mostra saldi ufficiali da busta paga e movimenti calcolati nel Timesheet: permessi, ferie, recuperi e altro, con archivio assenze dettagliato.

Anziano.rtf

Un report cronologico con ricerca: elenco lavorazioni in alto, giorno per giorno sotto, con ore, stato colorato e assenze.

Consultazione - Lavorazioni: righe 51002 e 51020 espanse con storico attività per data.
Ogni ID espanso mostra il dettaglio per Blocco/Lavorazione e lo storico attività riga per riga.
Consultazione - Assenze: saldi ufficiali, movimenti del periodo e archivio assenze.
Movimenti del periodo (permessi, ferie, recuperi, altro) e archivio assenze con data e ore.
Consultazione - Anziano.rtf: ricerca, elenco lavorazioni e report cronologico giornaliero.
Il report cronologico segnala anche le giornate incomplete e permette di copiare la tabella.
Regola di robustezzaQuando possibile il Timesheet usa il LavoroUID; se il riferimento è orfano, recupera la lavorazione tramite tripla normalizzata ID + Commessa + Blocco.
07 - Anagrafiche

Lavorazioni vere

Anagrafiche non è il Catalogo. Qui vivono le lavorazioni reali: quelle create o usate dall'utente, con stato, ore previste e archiviazione. Scheda Editor-only.

Anagrafiche - Attive: elenco lavorazioni e pannello di dettaglio con ID, Commessa, Lavorazione, ore previste, ore lavorate, stato, ultima attività e archiviazione.
Il pannello di dettaglio mostra ID, Commessa, Lavorazione, ore previste/lavorate, stato, ultima attività e pulsanti Salva/Archivia.

Attive

Lavorazioni disponibili e ancora usabili nel workflow quotidiano.

Archiviate

Lavorazioni da non proporre più nel futuro, ma sempre conservate nello storico.

Salva

Modifica commessa, lavorazione, ore previste e stato quando necessario.

Archivia / Ripristina

Operazione reversibile: agisce sul futuro, non cancella il passato.

Nessuna eliminazione manualeUna lavorazione non viene più cancellata da Anagrafiche. Se perde l'ultima registrazione, torna automaticamente nel Catalogo come suggerimento disponibile.
Vista Archiviate: dettaglio della lavorazione archiviata con pulsante Ripristina.
Una lavorazione archiviata mostra "Archiviazione: Archiviata" nel dettaglio; il pulsante diventa Ripristina.
08 - Amministrazione

La stanza tecnica

Amministrazione contiene le viste di controllo, importazione, dati personali, pianificazioni e note. In Consultazione restano raggiungibili solo Archivio e Dati Personali → Previsioni; il resto è Editor-only.

Amministrazione in Editor: cinque sotto-schede, Archivio - Registrazioni con ricerca ed Esporta Excel.
In Editor tutte le sotto-schede sono visibili: Archivio, Catalogo Autocomplete, Dati Personali, Pianificazioni, Note. Il tab Archivio mostra a sua volta Registrazioni/Lavori/Giornate/Saldi, ricerca ed Esporta Excel.

Archivio

Vista grezza dei fogli del workbook — Registrazioni, Lavori, Giornate, Saldi — con ricerca ed esportazione in Excel.

Catalogo Autocomplete

Importa e conserva suggerimenti ID + Commessa + Lavorazione.

Dati Personali

Busta paga, tariffa personale, ore ufficiali, previsioni e festività.

Note

Un quaderno libero dentro il file Timesheet.

Amministrazione - Note: lista note a sinistra, testo di una nota a destra.
Note: elenco a sinistra, editor a destra — qui con una nota già scritta.
PianificazioniHa un capitolo dedicato — vedi Pianificazioni — perché in una versione futura gestirà date, eventi e scadenze.
10 - Dati personali

Saldi, tariffe e previsioni

Questa sezione contiene dati amministrativi inseriti manualmente: saldi da busta paga, tariffa oraria, ore ufficiali, previsioni e festività — cinque schede, ciascuna con il proprio scopo. In Consultazione resta raggiungibile solo Previsioni.

Busta Paga

Inserimento manuale dei saldi ufficiali per periodo: ferie, permessi, ROL, banca ore ed ex festività residue, con note opzionali e archivio per mese. L'import diretto da PDF è previsto ma non ancora disponibile.

Dati Personali - Busta Paga: import PDF non disponibile, saldi ufficiali per periodo con ferie, permessi, ROL, banca ore ed ex festività.
Busta Paga: saldi ufficiali del periodo selezionato, con salvataggio in archivio.

Tariffa Personale

Una tariffa oraria in euro, usata per calcolare il ricavo teorico nelle viste di consultazione.

Dati Personali - Tariffa Personale: campo Tariffa oraria in euro con pulsante Salva.
Tariffa Personale: un solo valore, alla base dei calcoli di ricavo.

Ore Ufficiali

Snapshot amministrativi datati: saldi comunicati (ferie, ROL, ex festività, banca ore) e maturazione mensile, usati anche dalle Previsioni.

Dati Personali - Ore Ufficiali: saldi comunicati e maturazione mensile con data situazione.
Ore Ufficiali: la data situazione ancora i saldi comunicati a un preciso momento.

Previsioni

Proietta ferie, ROL, ex festività e banca ore nel tempo, a partire da una comunicazione salvata in Ore Ufficiali. Unica scheda di Dati Personali raggiungibile anche in Consultazione.

Dati Personali - Previsioni: nessuna comunicazione attiva, serve una comunicazione in Ore Ufficiali.
Senza una comunicazione in Ore Ufficiali, le Previsioni restano vuote.

Festività

Il calendario delle festività nazionali italiane, per l'anno corrente e il successivo.

Dati Personali - Festività: elenco festività nazionali italiane 2026 e 2027.
Festività nazionali italiane, di riferimento per ferie ed ex festività.
11 - Pianificazioni

La sezione in arrivo

Pianificazioni è la scheda più recente di Amministrazione. Oggi è un segnaposto onesto: non gestisce ancora dati, ma anticipa una funzione futura.

Amministrazione - Pianificazioni: Funzione in preparazione, in futuro gestirà date consegna, eventi, scadenze, referenti e pianificazioni esterne.
Lo stato attuale: "Funzione in preparazione".
🗓

Funzione in preparazione

In futuro questa sezione potrà gestire date di consegna, eventi, scadenze, referenti e pianificazioni esterne.

Perché è nel manualeAnche una funzione non ancora attiva merita una voce: sapere che è "in preparazione" evita di cercare a lungo qualcosa che non c'è ancora.
12 - Workflow consigliato

Una giornata tipo

Il Timesheet funziona meglio quando diventa un gesto quotidiano: pochi secondi, sempre nello stesso punto, sempre nello stesso modo.

Apri TimesheetInserisci oreConfermaConsultaArchivia

Ogni giorno

Registra le ore appena possibile, usando autocompletamento e copia lavorazione quando serve.

Ogni settimana

Controlla Consultazione e verifica che gli stati delle lavorazioni siano coerenti.

Ogni mese

Aggiorna busta paga, saldi ufficiali e previsioni.

Ogni versione

Fai un backup del Timesheet prima di aggiornare l'app.

13 - FAQ

Domande frequenti

DomandaRisposta
Posso avere più Timesheet?Sì. Ogni file è un archivio autonomo.
Posso modificare il file Excel?Sì, ma è meglio usare l'app per mantenere coerenza tra i fogli.
Cosa succede se elimino una registrazione?La registrazione sparisce; se era l'ultima di una lavorazione, quella lavorazione torna al Catalogo.
Cosa significa Archivia?Una lavorazione archiviata non viene proposta nel futuro, ma resta nello storico.
Il Timesheet usa Internet?No. I dati sono nel file locale scelto dall'utente.
Perché Pianificazioni è vuota?È una funzione in preparazione: oggi mostra solo un segnaposto, non gestisce ancora dati.
Perché non vedo Inserimento o Anagrafiche?Sei in modalità Consultazione. Passa a Editor dal pannello "Modalità" (autenticazione del Mac richiesta) per sbloccarle.
L'app è sicura da aprire?Sì. È firmata con Developer ID Apple e notarizzata da Apple per la distribuzione diretta: macOS non mostra il blocco riservato alle app non identificate.
14 - Glossario

Parole chiave

Registrazione

Una riga datata con ore, tipo e lavorazione o assenza.

Lavorazione

Entità reale identificata da ID + Commessa + Blocco/Lavorazione.

Catalogo

Elenco di suggerimenti per l'autocompletamento, senza stato.

Anagrafiche

Vista delle lavorazioni vere, attive o archiviate.

Saldo ufficiale

Dato amministrativo inserito dalla busta paga.

Anziano.rtf

Report cronologico generato dall'app, ispirato al vecchio storico manuale.

Consultazione (modalità)

Livello operativo predefinito dell'intera app: solo lettura, nessuna creazione o modifica.

Editor (modalità)

Livello operativo che sblocca la scrittura, raggiungibile dopo autenticazione del Mac.