
Il manuale
del tuo lavoro
Versione 1.8
Il tempo è la risorsa più preziosa. Registrarlo bene significa poterlo comprendere, ritrovare e valorizzare.
Una guida da usare, non solo da leggere.
Vai alla sezione2Primo avvio
Vai alla sezione3Modalità Consultazione/Editor
Vai alla sezione4Il file Timesheet
Vai alla sezione5Inserimento
Vai alla sezione6Consultazione
Vai alla sezione7Anagrafiche
Vai alla sezione8Amministrazione
Vai alla sezione9Catalogo Autocomplete
Vai alla sezione10Dati personali
Vai alla sezione11Pianificazioni
Vai alla sezione12Workflow consigliato
Vai alla sezione13FAQ
Vai alla sezione14Glossario
Vai alla sezione
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.
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.

Crea un workbook personale pronto per registrazioni, lavorazioni, saldi e note.
Collega un archivio esistente e apre l'area di lavoro completa.
Trascina il file Timesheet direttamente nella finestra per aprirlo.
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à.



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.



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.
| Foglio | Ruolo |
|---|---|
| REGISTRAZIONI | Eventi datati: data, ore, tipo, note e lavorazione collegata. |
| LAVORI | Lavorazioni reali con stato, ore previste e archiviazione. |
| CATALOGO | Memoria grezza dell'autocompletamento: suggerimenti disponibili, non lavoro reale. |
| NOTE | Quaderno di progetto interno al Timesheet. |
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.

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.
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.



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.

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.

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.

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.

La memoria dei suggerimenti
Il Catalogo è una memoria grezza di triple ID + Commessa + Lavorazione. Non contiene stato e non rappresenta lavoro reale. Scheda Editor-only.

Importa Excel
Legge file esterni con colonne ID, Commessa e Lavorazione. Il Blocco può anche essere vuoto.
Vista filtrata
Se una voce diventa lavorazione vera, può sparire dalla vista Catalogo ma resta nel workbook come memoria.
Importare un file Excel, passo dopo passo






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.

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

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

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.

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

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

Funzione in preparazione
In futuro questa sezione potrà gestire date di consegna, eventi, scadenze, referenti e pianificazioni esterne.
Una giornata tipo
Il Timesheet funziona meglio quando diventa un gesto quotidiano: pochi secondi, sempre nello stesso punto, sempre nello stesso modo.
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.
Domande frequenti
| Domanda | Risposta |
|---|---|
| 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. |
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.