feat: add project key support for Jira analytics

- Introduced `projectKey` and `ignoredProjects` fields in Jira configuration to enhance analytics capabilities.
- Implemented project validation logic in `JiraConfigClient` and integrated it into the `JiraConfigForm` for user input.
- Updated `IntegrationsSettingsPageClient` to display analytics dashboard link based on the configured project key.
- Enhanced API routes to handle project key in Jira sync and user preferences.
- Marked related tasks as complete in `TODO.md`.
This commit is contained in:
Julien Froidefond
2025-09-18 22:08:29 +02:00
parent 4f9cff94f3
commit 78a96b9c92
22 changed files with 2240 additions and 35 deletions

View File

@@ -0,0 +1,341 @@
'use client';
import { useState, useEffect } from 'react';
import { JiraConfig } from '@/lib/types';
import { useJiraAnalytics } from '@/hooks/useJiraAnalytics';
import { Header } from '@/components/ui/Header';
import { Card, CardHeader, CardContent } from '@/components/ui/Card';
import { Button } from '@/components/ui/Button';
import { VelocityChart } from '@/components/jira/VelocityChart';
import { TeamDistributionChart } from '@/components/jira/TeamDistributionChart';
import { CycleTimeChart } from '@/components/jira/CycleTimeChart';
import { TeamActivityHeatmap } from '@/components/jira/TeamActivityHeatmap';
import Link from 'next/link';
interface JiraDashboardPageClientProps {
initialJiraConfig: JiraConfig;
}
export function JiraDashboardPageClient({ initialJiraConfig }: JiraDashboardPageClientProps) {
const { analytics, isLoading, error, loadAnalytics, refreshAnalytics } = useJiraAnalytics();
const [selectedPeriod, setSelectedPeriod] = useState<'7d' | '30d' | '3m' | 'current'>('current');
useEffect(() => {
// Charger les analytics au montage si Jira est configuré avec un projet
if (initialJiraConfig.enabled && initialJiraConfig.projectKey) {
loadAnalytics();
}
}, [initialJiraConfig.enabled, initialJiraConfig.projectKey, loadAnalytics]);
// Vérifier si Jira est configuré
const isJiraConfigured = initialJiraConfig.enabled &&
initialJiraConfig.baseUrl &&
initialJiraConfig.email &&
initialJiraConfig.apiToken;
const hasProjectConfigured = isJiraConfigured && initialJiraConfig.projectKey;
if (!isJiraConfigured) {
return (
<div className="min-h-screen bg-[var(--background)]">
<Header
title="TowerControl"
subtitle="Dashboard Jira - Analytics d'équipe"
/>
<div className="container mx-auto px-4 py-8">
<Card className="max-w-2xl mx-auto">
<CardHeader>
<h2 className="text-xl font-semibold"> Configuration requise</h2>
</CardHeader>
<CardContent className="space-y-4">
<p className="text-[var(--muted-foreground)]">
Jira n&apos;est pas configuré. Vous devez d&apos;abord configurer votre connexion Jira
pour accéder aux analytics d&apos;équipe.
</p>
<Link href="/settings/integrations">
<Button variant="primary">
Configurer Jira
</Button>
</Link>
</CardContent>
</Card>
</div>
</div>
);
}
if (!hasProjectConfigured) {
return (
<div className="min-h-screen bg-[var(--background)]">
<Header
title="TowerControl"
subtitle="Dashboard Jira - Analytics d'équipe"
/>
<div className="container mx-auto px-4 py-8">
<Card className="max-w-2xl mx-auto">
<CardHeader>
<h2 className="text-xl font-semibold">🎯 Projet requis</h2>
</CardHeader>
<CardContent className="space-y-4">
<p className="text-[var(--muted-foreground)]">
Aucun projet n&apos;est configuré pour les analytics d&apos;équipe.
Configurez un projet spécifique à surveiller dans les paramètres Jira.
</p>
<Link href="/settings/integrations">
<Button variant="primary">
Configurer un projet
</Button>
</Link>
</CardContent>
</Card>
</div>
</div>
);
}
return (
<div className="min-h-screen bg-[var(--background)]">
<Header
title="TowerControl"
subtitle={`Analytics Jira - Projet ${initialJiraConfig.projectKey}`}
/>
<div className="container mx-auto px-4 py-4">
<div className="max-w-7xl mx-auto">
{/* Breadcrumb */}
<div className="mb-4 text-sm">
<Link href="/settings" className="text-[var(--muted-foreground)] hover:text-[var(--primary)]">
Paramètres
</Link>
<span className="mx-2 text-[var(--muted-foreground)]">/</span>
<Link href="/settings/integrations" className="text-[var(--muted-foreground)] hover:text-[var(--primary)]">
Intégrations
</Link>
<span className="mx-2 text-[var(--muted-foreground)]">/</span>
<span className="text-[var(--foreground)]">Dashboard Jira</span>
</div>
{/* Header avec contrôles */}
<div className="flex items-center justify-between mb-6">
<div>
<h1 className="text-2xl font-mono font-bold text-[var(--foreground)] mb-2">
📊 Analytics d&apos;équipe
</h1>
<p className="text-[var(--muted-foreground)]">
Surveillance en temps réel du projet {initialJiraConfig.projectKey}
</p>
</div>
<div className="flex items-center gap-3">
{/* Sélecteur de période */}
<div className="flex bg-[var(--card)] border border-[var(--border)] rounded-lg p-1">
{[
{ value: '7d', label: '7j' },
{ value: '30d', label: '30j' },
{ value: '3m', label: '3m' },
{ value: 'current', label: 'Sprint' }
].map((period: { value: string; label: string }) => (
<button
key={period.value}
onClick={() => setSelectedPeriod(period.value as '7d' | '30d' | '3m' | 'current')}
className={`px-3 py-1 text-sm rounded transition-all ${
selectedPeriod === period.value
? 'bg-[var(--primary)] text-[var(--primary-foreground)]'
: 'text-[var(--muted-foreground)] hover:text-[var(--foreground)]'
}`}
>
{period.label}
</button>
))}
</div>
<Button
onClick={refreshAnalytics}
disabled={isLoading}
variant="secondary"
>
{isLoading ? '🔄 Actualisation...' : '🔄 Actualiser'}
</Button>
</div>
</div>
{/* Contenu principal */}
{error && (
<Card className="mb-6 border-red-500/20 bg-red-500/10">
<CardContent className="p-4">
<div className="flex items-center gap-2 text-red-600 dark:text-red-400">
<span></span>
<span>{error}</span>
</div>
</CardContent>
</Card>
)}
{isLoading && !analytics && (
<div className="grid grid-cols-1 lg:grid-cols-3 gap-6">
{/* Skeleton loading */}
{[1, 2, 3, 4, 5, 6].map(i => (
<Card key={i} className="animate-pulse">
<CardContent className="p-6">
<div className="h-4 bg-[var(--muted)] rounded mb-4"></div>
<div className="h-8 bg-[var(--muted)] rounded mb-2"></div>
<div className="h-4 bg-[var(--muted)] rounded w-2/3"></div>
</CardContent>
</Card>
))}
</div>
)}
{analytics && (
<div className="space-y-6">
{/* Vue d'ensemble du projet */}
<Card>
<CardHeader>
<h2 className="text-lg font-semibold flex items-center gap-2">
🎯 Vue d&apos;ensemble - {analytics.project.name}
</h2>
</CardHeader>
<CardContent>
<div className="grid grid-cols-1 md:grid-cols-4 gap-4">
<div className="text-center">
<div className="text-2xl font-bold text-[var(--primary)]">
{analytics.project.totalIssues}
</div>
<div className="text-sm text-[var(--muted-foreground)]">
Total tickets
</div>
</div>
<div className="text-center">
<div className="text-2xl font-bold text-blue-500">
{analytics.teamMetrics.totalAssignees}
</div>
<div className="text-sm text-[var(--muted-foreground)]">
Membres équipe
</div>
</div>
<div className="text-center">
<div className="text-2xl font-bold text-green-500">
{analytics.teamMetrics.activeAssignees}
</div>
<div className="text-sm text-[var(--muted-foreground)]">
Actifs
</div>
</div>
<div className="text-center">
<div className="text-2xl font-bold text-orange-500">
{analytics.velocityMetrics.currentSprintPoints}
</div>
<div className="text-sm text-[var(--muted-foreground)]">
Points complétés
</div>
</div>
</div>
</CardContent>
</Card>
{/* Graphiques principaux */}
<div className="grid grid-cols-1 lg:grid-cols-2 gap-6">
<Card>
<CardHeader>
<h3 className="font-semibold">👥 Répartition de l&apos;équipe</h3>
</CardHeader>
<CardContent>
<TeamDistributionChart
distribution={analytics.teamMetrics.issuesDistribution}
className="h-64"
/>
</CardContent>
</Card>
<Card>
<CardHeader>
<h3 className="font-semibold">🚀 Vélocité des sprints</h3>
</CardHeader>
<CardContent>
<VelocityChart
sprintHistory={analytics.velocityMetrics.sprintHistory}
className="h-64"
/>
</CardContent>
</Card>
</div>
{/* Métriques de temps et cycle time */}
<div className="grid grid-cols-1 lg:grid-cols-2 gap-6">
<Card>
<CardHeader>
<h3 className="font-semibold"> Cycle Time par type</h3>
</CardHeader>
<CardContent>
<CycleTimeChart
cycleTimeByType={analytics.cycleTimeMetrics.cycleTimeByType}
className="h-64"
/>
<div className="mt-4 text-center">
<div className="text-2xl font-bold text-[var(--primary)]">
{analytics.cycleTimeMetrics.averageCycleTime}
</div>
<div className="text-sm text-[var(--muted-foreground)]">
jours en moyenne globale
</div>
</div>
</CardContent>
</Card>
<Card>
<CardHeader>
<h3 className="font-semibold">🚀 Vélocité</h3>
</CardHeader>
<CardContent>
<div className="mb-4">
<div className="text-3xl font-bold text-green-500">
{analytics.velocityMetrics.averageVelocity}
</div>
<div className="text-sm text-[var(--muted-foreground)]">
points par sprint
</div>
</div>
<div className="space-y-2">
{analytics.velocityMetrics.sprintHistory.map(sprint => (
<div key={sprint.sprintName} className="text-sm">
<div className="flex justify-between">
<span>{sprint.sprintName}</span>
<span className="font-mono">
{sprint.completedPoints}/{sprint.plannedPoints}
</span>
</div>
<div className="w-full bg-[var(--muted)] rounded-full h-1.5 mt-1">
<div
className="bg-green-500 h-1.5 rounded-full"
style={{ width: `${sprint.completionRate}%` }}
></div>
</div>
</div>
))}
</div>
</CardContent>
</Card>
</div>
{/* Heatmap d'activité de l'équipe */}
<Card>
<CardHeader>
<h3 className="font-semibold">🔥 Heatmap d&apos;activité de l&apos;équipe</h3>
</CardHeader>
<CardContent>
<TeamActivityHeatmap
workloadByAssignee={analytics.workInProgress.byAssignee}
statusDistribution={analytics.workInProgress.byStatus}
className="min-h-96"
/>
</CardContent>
</Card>
</div>
)}
</div>
</div>
</div>
);
}

View File

@@ -0,0 +1,14 @@
import { userPreferencesService } from '@/services/user-preferences';
import { JiraDashboardPageClient } from './JiraDashboardPageClient';
// Force dynamic rendering
export const dynamic = 'force-dynamic';
export default async function JiraDashboardPage() {
// Récupérer la config Jira côté serveur
const jiraConfig = await userPreferencesService.getJiraConfig();
return (
<JiraDashboardPageClient initialJiraConfig={jiraConfig} />
);
}