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`.

src/actions/jira-analytics.ts

@@ -0,0 +1,59 @@
+'use server';
+
+import { JiraAnalyticsService } from '@/services/jira-analytics';
+import { userPreferencesService } from '@/services/user-preferences';
+import { JiraAnalytics } from '@/lib/types';
+
+export type JiraAnalyticsResult = {
+  success: boolean;
+  data?: JiraAnalytics;
+  error?: string;
+};
+
+/**
+ * Server Action pour récupérer les analytics Jira du projet configuré
+ */
+export async function getJiraAnalytics(): Promise<JiraAnalyticsResult> {
+  try {
+    // Récupérer la config Jira depuis la base de données
+    const jiraConfig = await userPreferencesService.getJiraConfig();
+    
+    if (!jiraConfig.enabled || !jiraConfig.baseUrl || !jiraConfig.email || !jiraConfig.apiToken) {
+      return {
+        success: false,
+        error: 'Configuration Jira manquante. Configurez Jira dans les paramètres.'
+      };
+    }
+
+    if (!jiraConfig.projectKey) {
+      return {
+        success: false,
+        error: 'Aucun projet configuré pour les analytics. Configurez un projet dans les paramètres Jira.'
+      };
+    }
+    
+    // Créer le service d'analytics
+    const analyticsService = new JiraAnalyticsService({
+      baseUrl: jiraConfig.baseUrl,
+      email: jiraConfig.email,
+      apiToken: jiraConfig.apiToken,
+      projectKey: jiraConfig.projectKey
+    });
+
+    // Récupérer les analytics
+    const analytics = await analyticsService.getProjectAnalytics();
+
+    return {
+      success: true,
+      data: analytics
+    };
+
+  } catch (error) {
+    console.error('❌ Erreur lors du calcul des analytics Jira:', error);
+    
+    return {
+      success: false,
+      error: error instanceof Error ? error.message : 'Erreur lors du calcul des analytics'
+    };
+  }
+}

src/app/api/jira/sync/route.ts

@@ -19,6 +19,7 @@ export async function POST() {
         baseUrl: jiraConfig.baseUrl,
         email: jiraConfig.email,
         apiToken: jiraConfig.apiToken,
+        projectKey: jiraConfig.projectKey,
         ignoredProjects: jiraConfig.ignoredProjects || []
       });
     } else {
@@ -92,6 +93,7 @@ export async function GET() {
         baseUrl: jiraConfig.baseUrl,
         email: jiraConfig.email,
         apiToken: jiraConfig.apiToken,
+        projectKey: jiraConfig.projectKey,
         ignoredProjects: jiraConfig.ignoredProjects || []
       });
     } else {
@@ -110,9 +112,21 @@ export async function GET() {
 
     const connected = await jiraService.testConnection();
     
+    // Si connexion OK et qu'un projet est configuré, tester aussi le projet
+    let projectValidation = null;
+    if (connected && jiraConfig.projectKey) {
+      projectValidation = await jiraService.validateProject(jiraConfig.projectKey);
+    }
+    
     return NextResponse.json({
       connected,
-      message: connected ? 'Connexion Jira OK' : 'Impossible de se connecter à Jira'
+      message: connected ? 'Connexion Jira OK' : 'Impossible de se connecter à Jira',
+      project: projectValidation ? {
+        key: jiraConfig.projectKey,
+        exists: projectValidation.exists,
+        name: projectValidation.name,
+        error: projectValidation.error
+      } : null
     });
 
   } catch (error) {

src/app/api/jira/validate-project/route.ts

@@ -0,0 +1,70 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { createJiraService } from '@/services/jira';
+import { userPreferencesService } from '@/services/user-preferences';
+
+/**
+ * POST /api/jira/validate-project
+ * Valide l'existence d'un projet Jira
+ */
+export async function POST(request: NextRequest) {
+  try {
+    const body = await request.json();
+    const { projectKey } = body;
+
+    if (!projectKey || typeof projectKey !== 'string') {
+      return NextResponse.json(
+        { error: 'projectKey est requis' },
+        { status: 400 }
+      );
+    }
+
+    // Récupérer la config Jira depuis la base de données
+    const jiraConfig = await userPreferencesService.getJiraConfig();
+    
+    if (!jiraConfig.enabled || !jiraConfig.baseUrl || !jiraConfig.email || !jiraConfig.apiToken) {
+      return NextResponse.json(
+        { error: 'Configuration Jira manquante. Configurez Jira dans les paramètres.' },
+        { status: 400 }
+      );
+    }
+
+    // Créer le service Jira
+    const jiraService = createJiraService();
+    if (!jiraService) {
+      return NextResponse.json(
+        { error: 'Impossible de créer le service Jira. Vérifiez la configuration.' },
+        { status: 500 }
+      );
+    }
+
+    // Valider le projet
+    const validation = await jiraService.validateProject(projectKey.trim().toUpperCase());
+    
+    if (validation.exists) {
+      return NextResponse.json({
+        success: true,
+        exists: true,
+        projectName: validation.name,
+        message: `Projet "${projectKey}" trouvé : ${validation.name}`
+      });
+    } else {
+      return NextResponse.json({
+        success: false,
+        exists: false,
+        error: validation.error,
+        message: validation.error || `Projet "${projectKey}" introuvable`
+      }, { status: 404 });
+    }
+
+  } catch (error) {
+    console.error('Erreur lors de la validation du projet Jira:', error);
+    return NextResponse.json(
+      { 
+        success: false,
+        error: 'Erreur lors de la validation du projet',
+        message: error instanceof Error ? error.message : 'Erreur inconnue'
+      },
+      { status: 500 }
+    );
+  }
+}

src/app/api/user-preferences/jira-config/route.ts

@@ -26,7 +26,7 @@ export async function GET() {
 export async function PUT(request: NextRequest) {
   try {
     const body = await request.json();
-    const { baseUrl, email, apiToken, ignoredProjects } = body;
+    const { baseUrl, email, apiToken, projectKey, ignoredProjects } = body;
 
     // Validation des données requises
     if (!baseUrl || !email || !apiToken) {
@@ -60,6 +60,7 @@ export async function PUT(request: NextRequest) {
       email: email.trim(),
       apiToken: apiToken.trim(),
       enabled: true,
+      projectKey: projectKey ? projectKey.trim().toUpperCase() : undefined,
       ignoredProjects: Array.isArray(ignoredProjects) 
         ? ignoredProjects.map((p: string) => p.trim().toUpperCase()).filter((p: string) => p.length > 0)
         : []

src/app/jira-dashboard/JiraDashboardPageClient.tsx

@@ -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>
+  );
+}

src/app/jira-dashboard/page.tsx

@@ -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} />
+  );
+}