SC-2: Igiene dei Commit

Descrizione

L’igiene dei commit si riferisce alle pratiche che rendono la storia del repository chiara, tracciabile e affidabile. I commit DEVONO (MUST) essere piccoli, ben descritti e collegati al lavoro che rappresentano.

Guida

Requisiti per i commit

I commit DEVONO (MUST) essere:

Piccoli e focalizzati: Ogni commit dovrebbe rappresentare una singola modifica logica. Evitare commit che mescolano refactoring, nuove funzionalità e bug fix
Chiaramente descritti: Il messaggio di commit deve spiegare cosa è stato modificato e perché, non solo cosa è stato fatto
Collegati a work item: Includere riferimenti a ticket Jira, GitHub Issues o altri sistemi di tracking (es. PROJ-123: Add user authentication)

Commit firmati

Tutti i commit DOVREBBERO (SHOULD) essere firmati per verificare l’autore e l’integrità. I commit firmati:

Confermano che il commit proviene effettivamente dall’autore dichiarato
Garantiscono che il contenuto del commit non sia stato alterato
Forniscono non-repudiation per scopi di audit

Format dei messaggi di commit

I messaggi di commit PUÒ (MAY) seguire il formato Conventional Commits:

<type>[optional scope]: <description>

[optional body]

[optional footer(s)]

Esempi:

feat(auth): add OAuth2 login support
fix(api): handle null response from user service
docs: update deployment instructions

Misurazione

Stato	Criteri
🟢 VERDE	Commit piccoli e ben descritti, firmati, collegati a work item, formato consistente
🟡 AMBRA	Pratiche inconsistenti, alcuni commit mal descritti o troppo grandi
🔴 ROSSO	Commit grandi o non chiari, nessuna firma, nessun collegamento a work item