git-commit-ita

name	git-commit-ita
description	Genera messaggi di commit Git seguendo lo standard Conventional Commits con descrizione in italiano. Ottimizzato per il progetto LeenO con scope specifici e procedura di analisi dei file staged.

Git Commit – Conventional Commits in Italiano (LeenO)

Formato

<tipo>(<scope>): <descrizione in italiano>

[corpo opzionale: spiega il PERCHÉ, non il COSA]

Tipi

Tipo	Quando
feat	Nuova funzionalità
fix	Correzione bug
docs	Solo documentazione
style	Formattazione, spazi, punti e virgola mancanti (no logica)
refactor	Modifica del codice che non corregge bug né aggiunge funzionalità
perf	Miglioramento prestazioni
test	Aggiunta/modifica test
chore	Manutenzione, aggiornamento dipendenze, versioning, build
revert	Annullamento di un commit precedente

Scope Suggeriti (LeenO)

Identifica l'area principale colpita dalle modifiche:

• core: Logica principale (pyleeno.py, LeenoGlobals.py, ecc.)
• ui: Interfaccia utente (.xhp, .xlb, dialoghi in Python)
• contab, computo, variante, giornale: Modulo specifico in pythonpath
• import: Filtri di importazione (LeenoImport_*.py)
• icons: Icone e risorse grafiche (icons/, SVG/PNG)
• meta: Metadati estensione (description.xml, .xcu)
• template: Modifiche ai modelli di documento
• docs: Manuale PDF o documentazione tecnica

Regole d'Oro

1. Lingua: Descrizione in italiano, imperativo presente (es. "aggiunge", non "aggiunto")
2. Lunghezza: Max 72 caratteri per l'intestazione
3. Punteggiatura: Nessun punto finale nell'intestazione
4. Breaking Change: Aggiungi ! dopo il tipo (es. feat!: ...) e descrivi in BREAKING CHANGE: nel corpo
5. Separazione: Se le modifiche riguardano aree troppo diverse, suggerisci commit separati

Procedura Operativa

1. Analisi Stato: Esegui git status per vedere quali file sono staged e quali no.
2. Analisi Modifiche: Esegui git diff --cached per esaminare nel dettaglio il codice modificato.
3. Identificazione Scope: Scegli lo scope più calzante in base ai file modificati.
4. Draft Messaggio: Componi l'intestazione. Se la modifica non è auto-esplicativa, aggiungi un paragrafo di corpo dopo una riga vuota.
5. Proponi Comando: Mostra il comando finale: git commit -m "..." o git commit -e se serve un corpo esteso.

Esempi

• feat(computo): aggiunge calcolo automatico oneri sicurezza
• fix(ui): corregge refresh tabella dopo inserimento voce
• refactor(import): ottimizza parsing file XPWE
• chore(meta): bump versione a 3.25.x
• docs: aggiorna istruzioni nel manuale per il nuovo listino