Runbook: gestione delle issue (pianificazione & triage)

Le Issue sono il piano di lavoro condiviso e la coda delle segnalazioni. Regola d'oro per un team piccolo (3 persone, pari poteri): semplice, con responsabilità chiare — ogni issue ha un owner e uno stato.

Label (3 assi)

Asse	Label
Tipo	bug, feature, chore, docs, question
Priorità	P0 (urgente/blocca), P1 (prossimo), P2 (quando capita)
Stato/flag	needs-triage (default in ingresso), blocked, good-first-issue
Area (opz.)	area:core, area:connector, area:pipeline, area:infra, area:docs

Apertura

Si apre solo dai template (le issue vuote sono disabilitate): 🐞 Bug · ✨ Feature/attività · 🔌 Richiesta pipeline. I template applicano già tipo + needs-triage. La GitHub Action issue-triage garantisce needs-triage e aggiunge la issue alla board.

Triage (rapido, anche solo settimanale)

Per ogni issue in needs-triage:

1. assegna priorità (P0/P1/P2) e, se utile, l'area;
2. assegna un owner (assignee);
3. togli needs-triage e spostala in Ready sulla board;
4. se non è chiara, chiedi dettagli (resta in triage) o chiudila come question/duplicato.

project-pulse segnala le issue non triagliate e quelle ferme.

Pianificazione — board Projects

Board: noeva-etl — Delivery. Colonne consigliate: Triage → Ready → In progress → In review → Done. Si lavora dall'alto della colonna Ready per priorità.

Dalla issue alla PR

• Crea un branch feat|fix|chore|docs/<descrizione> collegato alla issue.
• Nel corpo della PR: Closes #<n> → la issue si chiude da sola al merge (squash).
• Vale la stessa Definition of Done del repo (CI verde, test, doc nello stesso commit).

Setup una tantum (per l'auto-aggiunta alla board)

La board è un Projects v2 di organizzazione: il GITHUB_TOKEN di default non può scriverci. Per attivare lo step "Aggiungi alla board":

1. crea un PAT (classic) con scope project (o un fine-grained con accesso ai Projects dell'org);
2. salvalo come secret del repo ADD_TO_PROJECT_PAT (gh secret set ADD_TO_PROJECT_PAT).

Senza il secret, l'etichettatura needs-triage funziona comunque; salta solo l'aggiunta alla board.