PRRI Jira Sprint Viewer

Sprint board viewer per il progetto PRRI su Jira Cloud. Mostra epiche, story, bug e sottotask in una vista gerarchica con possibilita di creare issue direttamente dalla board.

Requisiti

• Node.js >= 18
• Jira API Token (genera qui)

Installazione e avvio rapido

Un solo comando, non serve installare nulla:

npx @meloniwastaken/prri-jira-viewer

Si apre il browser su http://localhost:3000. Inserisci le credenziali Jira nel form di login:

| Campo | Valore | |-------|--------| | Email | La tua email Jira (es. [email protected]) | | API Token | Il token generato da Atlassian |

Configurazione avanzata

Porta personalizzata

PORT=4000 npx @meloniwastaken/prri-jira-viewer

Credenziali via variabili d'ambiente

Se preferisci non usare il form di login, puoi passare le credenziali direttamente:

[email protected] JIRA_TOKEN=il-tuo-token npx @meloniwastaken/prri-jira-viewer

Con le variabili d'ambiente impostate, il login viene saltato automaticamente.

URL Jira personalizzato

Se l'istanza Jira non e quella di default:

JIRA_URL=https://la-tua-istanza.atlassian.net npx @meloniwastaken/prri-jira-viewer

Funzionalita

• Vista gerarchica: Epiche > Story/Sottotask > Bug con struttura ad albero
• Creazione issue: Clicca il pulsante + su un'epica per creare una Story, o su una Story/Sottotask per creare un Bug. L'issue viene creata via API con il parent gia assegnato
• Dettaglio issue: Clicca su qualsiasi issue per vedere descrizione, stato, assegnatario e commenti
• Barra di progresso: Avanzamento completamento per ogni epica
• Filtro completate: Toggle per nascondere le issue completate
• Refresh: Aggiorna i dati dalla board Jira con un click

Sviluppo locale

# Clona il repo e installa le dipendenze
cd lda-jira-viewer
npm install

# Crea un file .env con le credenziali
cat > .env << EOF
JIRA_URL=https://regcam-projectmgm.atlassian.net
[email protected]
JIRA_TOKEN=il-tuo-token
EOF

# Avvia server Express + Vite in dev mode
npm run dev:all

Il frontend e disponibile su http://localhost:5173 con hot-reload.

Pubblicazione

# Bumpa la versione in package.json, poi:
npm publish --access public