Aggiungi 'docs/03-workflow-giornaliero-commit-push.md'

docs/03-workflow-giornaliero-commit-push.md

@@ -0,0 +1,186 @@
+<!-- File: 03-workflow-giornaliero-commit-push.md -->
+
+# Workflow ideale per lavorare su un task
+
+## 1. Assicurarsi di essere aggiornati
+
+Prima di iniziare a lavorare:
+
+```bash
+git fetch origin
+git status
+```
+
+Se la tua branch locale è dietro rispetto a `origin/<branch>`:
+
+```bash
+git merge origin/<branch>
+# oppure, se sai cosa fai:
+# git pull
+```
+
+Esempio, se lavori su `develop`:
+
+```bash
+git checkout develop
+git fetch origin
+git merge origin/develop
+```
+
+> Nota: `git pull` = `git fetch` + `git merge` (vedi file dedicato).
+
+---
+
+## 2. Creare (o spostarsi su) la branch di lavoro
+
+In Meridiana, tipicamente:
+
+* branch lunga vita: `main`, `develop`
+* branch di feature: `feature/<nome-breve>`
+
+Esempio nuova feature:
+
+```bash
+git checkout develop
+git pull origin develop  # se preferisci pull qui
+git checkout -b feature/nuovo-report
+```
+
+Ora sei su `feature/nuovo-report` e puoi lavorare.
+
+---
+
+## 3. Modificare i file e controllare lo stato
+
+Dopo aver modificato il codice:
+
+```bash
+git status
+```
+
+Esempio:
+
+```text
+On branch feature/nuovo-report
+Changes not staged for commit:
+  modified:   src/report.py
+
+Untracked files:
+  docs/spec-report.md
+```
+
+---
+
+## 4. Aggiungere i file allo staging (`git add`)
+
+Aggiungi solo i file che devono entrare nel commit:
+
+```bash
+git add src/report.py docs/spec-report.md
+```
+
+Per aggiungere tutte le modifiche tracciate e i nuovi file:
+
+```bash
+git add .
+# oppure
+git add -A
+```
+
+Controlla:
+
+```bash
+git status
+```
+
+Esempio:
+
+```text
+Changes to be committed:
+  modified:   src/report.py
+  new file:   docs/spec-report.md
+```
+
+---
+
+## 5. Creare un commit (`git commit`)
+
+Usiamo messaggi brevi e descrittivi in inglese/italiano coerenti.
+
+```bash
+git commit -m "Aggiunge report mensile con nuovo layout"
+```
+
+Oppure, per messaggi multi-riga:
+
+```bash
+git commit
+# si apre l'editor configurato
+```
+
+Struttura consigliata:
+
+```text
+Breve descrizione al presente
+
+- dettaglio 1
+- dettaglio 2
+```
+
+---
+
+## 6. Pubblicare la branch sul server (`git push`)
+
+Per la prima volta su una branch nuova:
+
+```bash
+git push -u origin feature/nuovo-report
+```
+
+Il flag `-u` imposta il tracking: in futuro basterà:
+
+```bash
+git push
+```
+
+Esempio di output:
+
+```text
+Counting objects: 7, done.
+Delta compression using up to 8 threads.
+...
+To https://git.meridiana.it/progetto/repo.git
+ * [new branch]      feature/nuovo-report -> feature/nuovo-report
+Branch 'feature/nuovo-report' set up to track remote branch 'feature/nuovo-report' from 'origin'.
+```
+
+---
+
+## 7. Creare la Merge Request / Pull Request
+
+Dal sistema di gestione (nel nostro caso **Gogs**):
+
+1. Scegli come **source branch**: `feature/nuovo-report`
+2. Scegli come **target branch**: di solito `develop`
+3. Assegna revisori, descrivi cosa fa la feature
+4. Una volta approvata si fa il **merge** in `develop`
+
+---
+
+## Riepilogo rapido workflow
+
+```bash
+# una volta che hai clonato il repo
+git checkout develop
+git pull origin develop
+
+git checkout -b feature/nuovo-report
+
+# ...modifichi file...
+git status
+git add file1 file2
+git commit -m "Messaggio chiaro"
+
+git push -u origin feature/nuovo-report
+# poi apri la MR/PR da interfaccia web
+```