From dede70f70f7fc9dd1eade24b18d0c5e41f7dd37e Mon Sep 17 00:00:00 2001
From: Sam DEPARDIEU <samdepardieu@hotmail.com>
Date: Tue, 7 Jul 2026 20:00:12 +0200
Subject: [PATCH] =?UTF-8?q?feat:=20formulaire=20de=20suggestions=20cr?=
 =?UTF-8?q?=C3=A9ant=20un=20ticket=20Gitea?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Les utilisateurs connectés peuvent proposer une modification / un ajout /
une correction via un formulaire. La soumission crée automatiquement une
issue dans le dépôt Gitea via son API (GiteaIssueService), avec le titre
préfixé par le type et l'auteur dans le corps.

- config/services.php + .env.example : GITEA_URL/TOKEN/REPO (token secret)
- SuggestionController (create/store) + validation
- vue suggestions/create + lien dans le header (utilisateurs connectés)
- tests: auth requise, création OK, validation, échec API

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 .env.example                                  |   7 ++
 app/Http/Controllers/SuggestionController.php |  58 ++++++++++
 app/Services/GiteaIssueService.php            |  53 +++++++++
 config/services.php                           |   8 ++
 resources/views/layout/header.blade.php       |   3 +
 resources/views/suggestions/create.blade.php  | 107 ++++++++++++++++++
 routes/web.php                                |   5 +
 tests/Feature/SuggestionTest.php              |  95 ++++++++++++++++
 8 files changed, 336 insertions(+)
 create mode 100644 app/Http/Controllers/SuggestionController.php
 create mode 100644 app/Services/GiteaIssueService.php
 create mode 100644 resources/views/suggestions/create.blade.php
 create mode 100644 tests/Feature/SuggestionTest.php

diff --git a/.env.example b/.env.example
index f076da4..2d93b2e 100644
--- a/.env.example
+++ b/.env.example
@@ -69,4 +69,11 @@ AWS_DEFAULT_REGION=us-east-1
 AWS_BUCKET=
 AWS_USE_PATH_STYLE_ENDPOINT=false
 
+# --- Gitea (tickets de suggestion créés depuis le site) ---
+# Token d'accès Gitea avec le scope "write:issue" (Paramètres > Applications > Générer un token).
+# À garder secret (ne jamais committer la vraie valeur).
+GITEA_URL=https://gitea.sam-coffre.duckdns.org
+GITEA_TOKEN=
+GITEA_REPO=Groupe1/Ressources-relationnel
+
 VITE_APP_NAME="${APP_NAME}"
diff --git a/app/Http/Controllers/SuggestionController.php b/app/Http/Controllers/SuggestionController.php
new file mode 100644
index 0000000..861a51a
--- /dev/null
+++ b/app/Http/Controllers/SuggestionController.php
@@ -0,0 +1,58 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Models\Utilisateur;
+use App\Services\GiteaIssueService;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Auth;
+use Illuminate\Validation\Rule;
+
+class SuggestionController extends Controller
+{
+    // Afficher le formulaire de suggestion
+    public function create()
+    {
+        return view('suggestions.create');
+    }
+
+    // Traiter la suggestion et créer un ticket dans Gitea
+    public function store(Request $request, GiteaIssueService $gitea)
+    {
+        $data = $request->validate([
+            'type' => ['required', Rule::in(['Modification', 'Ajout', 'Correction'])],
+            'titre' => ['required', 'string', 'min:5', 'max:120'],
+            'description' => ['required', 'string', 'min:10', 'max:5000'],
+        ], [
+            'type.required' => 'Veuillez choisir un type de demande.',
+            'type.in' => 'Type de demande invalide.',
+            'titre.required' => 'Le titre est requis.',
+            'titre.min' => 'Le titre doit contenir au moins 5 caractères.',
+            'titre.max' => 'Le titre ne peut pas dépasser 120 caractères.',
+            'description.required' => 'La description est requise.',
+            'description.min' => 'Merci de détailler un peu plus votre suggestion (10 caractères minimum).',
+        ]);
+
+        /** @var Utilisateur $user */
+        $user = Auth::user();
+        $auteur = $user->Pseudo ?? 'Utilisateur';
+
+        $title = "[{$data['type']}] {$data['titre']}";
+
+        $body = "**Type de demande :** {$data['type']}\n"
+            ."**Proposé par :** {$auteur} (via le site (RE)Sources Relationnelles)\n\n"
+            ."### Description\n"
+            .$data['description']."\n\n"
+            ."---\n"
+            .'_Ticket créé automatiquement depuis le formulaire de suggestions du site._';
+
+        if ($gitea->createIssue($title, $body)) {
+            return redirect()->route('suggestions.create')
+                ->with('success', 'Merci ! Votre suggestion a bien été transmise à l\'équipe.');
+        }
+
+        return back()->withInput()->withErrors([
+            'gitea' => "L'envoi de votre suggestion a échoué. Merci de réessayer plus tard.",
+        ]);
+    }
+}
diff --git a/app/Services/GiteaIssueService.php b/app/Services/GiteaIssueService.php
new file mode 100644
index 0000000..6de6bf8
--- /dev/null
+++ b/app/Services/GiteaIssueService.php
@@ -0,0 +1,53 @@
+<?php
+
+namespace App\Services;
+
+use Illuminate\Support\Facades\Http;
+use Illuminate\Support\Facades\Log;
+
+class GiteaIssueService
+{
+    /**
+     * Crée un ticket (issue) dans le dépôt Gitea configuré.
+     *
+     * @return bool true si le ticket a bien été créé, false sinon.
+     */
+    public function createIssue(string $title, string $body): bool
+    {
+        $url = rtrim((string) config('services.gitea.url'), '/');
+        $repo = trim((string) config('services.gitea.repo'), '/');
+        $token = (string) config('services.gitea.token');
+
+        if ($url === '' || $repo === '' || $token === '') {
+            Log::warning('Gitea non configuré (URL / token / dépôt manquant) : ticket non créé.');
+
+            return false;
+        }
+
+        try {
+            // Gitea attend l'en-tête "Authorization: token <TOKEN>".
+            $response = Http::withToken($token, 'token')
+                ->acceptJson()
+                ->timeout(10)
+                ->post("{$url}/api/v1/repos/{$repo}/issues", [
+                    'title' => $title,
+                    'body' => $body,
+                ]);
+        } catch (\Throwable $e) {
+            Log::error('Appel API Gitea impossible : '.$e->getMessage());
+
+            return false;
+        }
+
+        if ($response->failed()) {
+            Log::error('Création du ticket Gitea échouée', [
+                'status' => $response->status(),
+                'body' => $response->body(),
+            ]);
+
+            return false;
+        }
+
+        return true;
+    }
+}
diff --git a/config/services.php b/config/services.php
index 6a90eb8..d3d2fcb 100644
--- a/config/services.php
+++ b/config/services.php
@@ -35,4 +35,12 @@ return [
         ],
     ],
 
+    // Gitea : création automatique de tickets (issues) depuis le formulaire
+    // de suggestions du site. Le token doit avoir le scope "write:issue".
+    'gitea' => [
+        'url' => env('GITEA_URL', 'https://gitea.sam-coffre.duckdns.org'),
+        'token' => env('GITEA_TOKEN'),
+        'repo' => env('GITEA_REPO', 'Groupe1/Ressources-relationnel'),
+    ],
+
 ];
diff --git a/resources/views/layout/header.blade.php b/resources/views/layout/header.blade.php
index d9959ec..e23edf5 100644
--- a/resources/views/layout/header.blade.php
+++ b/resources/views/layout/header.blade.php
@@ -24,6 +24,9 @@
 
         <nav class="flex items-center gap-2 whitespace-nowrap">
             @auth
+                <a href="{{ route('suggestions.create') }}" class="hidden sm:inline-flex items-center px-4 py-2.5 text-sm font-bold text-niagara border-2 border-niagara rounded-lg hover:bg-niagara hover:text-white transition-smooth duration-200">
+                    💡 Proposer une amélioration
+                </a>
                 <div class="relative group">
                     <button class="flex items-center gap-2 p-2 rounded-lg hover:bg-gray-100 transition-smooth duration-200">
                         <img 
diff --git a/resources/views/suggestions/create.blade.php b/resources/views/suggestions/create.blade.php
new file mode 100644
index 0000000..328ce7a
--- /dev/null
+++ b/resources/views/suggestions/create.blade.php
@@ -0,0 +1,107 @@
+@extends('app')
+
+@section('title', 'Proposer une amélioration - (RE)Sources Relationnelles')
+
+@section('content')
+    <section class="container mx-auto px-4 py-12">
+        <div class="max-w-2xl mx-auto">
+            <!-- En-tête -->
+            <div class="mb-8">
+                <h1 class="text-4xl font-bold text-gray-900 mb-2">💡 Proposer une amélioration</h1>
+                <p class="text-gray-600">
+                    Une idée, une correction, un ajout ? Votre suggestion est directement transmise à
+                    l'équipe sous forme de ticket. Merci de votre contribution !
+                </p>
+            </div>
+
+            <!-- Message de succès -->
+            @if (session('success'))
+                <div class="mb-6 p-4 bg-green-50 border border-green-200 rounded-lg">
+                    <p class="text-green-700 font-semibold">✅ {{ session('success') }}</p>
+                </div>
+            @endif
+
+            <!-- Erreurs -->
+            @if ($errors->any())
+                <div class="mb-6 p-4 bg-red-50 border border-red-200 rounded-lg">
+                    @foreach ($errors->all() as $error)
+                        <p class="text-red-700 text-sm">{{ $error }}</p>
+                    @endforeach
+                </div>
+            @endif
+
+            <div class="bg-white rounded-xl border border-gray-200 p-8">
+                <form action="{{ route('suggestions.store') }}" method="POST" class="space-y-6">
+                    @csrf
+
+                    <!-- Type de demande -->
+                    <div>
+                        <label for="type" class="block text-sm font-bold mb-2 text-gray-700">Type de demande</label>
+                        <select
+                            id="type"
+                            name="type"
+                            required
+                            class="w-full px-4 py-3 border border-gray-300 rounded-lg focus:ring-2 focus:ring-niagara outline-none @error('type') border-red-500 @enderror">
+                            @php($typeChoisi = old('type'))
+                            <option value="Modification" @selected($typeChoisi === 'Modification')>✏️ Modification d'un contenu existant</option>
+                            <option value="Ajout" @selected($typeChoisi === 'Ajout')>➕ Ajout d'un nouveau contenu / fonctionnalité</option>
+                            <option value="Correction" @selected($typeChoisi === 'Correction')>🐛 Correction d'une erreur / d'un bug</option>
+                        </select>
+                        @error('type')
+                            <p class="text-red-600 text-xs mt-1">{{ $message }}</p>
+                        @enderror
+                    </div>
+
+                    <!-- Titre -->
+                    <div>
+                        <label for="titre" class="block text-sm font-bold mb-2 text-gray-700">Titre</label>
+                        <input
+                            type="text"
+                            id="titre"
+                            name="titre"
+                            required
+                            minlength="5"
+                            maxlength="120"
+                            value="{{ old('titre') }}"
+                            placeholder="Résumez votre suggestion en une phrase"
+                            class="w-full px-4 py-3 border border-gray-300 rounded-lg focus:ring-2 focus:ring-niagara outline-none @error('titre') border-red-500 @enderror">
+                        @error('titre')
+                            <p class="text-red-600 text-xs mt-1">{{ $message }}</p>
+                        @enderror
+                    </div>
+
+                    <!-- Description -->
+                    <div>
+                        <label for="description" class="block text-sm font-bold mb-2 text-gray-700">Description détaillée</label>
+                        <textarea
+                            id="description"
+                            name="description"
+                            required
+                            minlength="10"
+                            maxlength="5000"
+                            rows="8"
+                            placeholder="Décrivez précisément votre proposition : quoi, où, pourquoi…"
+                            class="w-full px-4 py-3 border border-gray-300 rounded-lg focus:ring-2 focus:ring-niagara outline-none @error('description') border-red-500 @enderror">{{ old('description') }}</textarea>
+                        @error('description')
+                            <p class="text-red-600 text-xs mt-1">{{ $message }}</p>
+                        @enderror
+                    </div>
+
+                    <!-- Boutons -->
+                    <div class="flex gap-4 pt-2">
+                        <button type="submit" class="px-8 py-3 gradient-niagara text-white font-bold rounded-lg hover:shadow-lg transition-smooth duration-200">
+                            📨 Envoyer ma suggestion
+                        </button>
+                        <a href="{{ route('home') }}" class="px-8 py-3 bg-gray-200 text-gray-900 font-bold rounded-lg hover:bg-gray-300 transition-smooth duration-200">
+                            Annuler
+                        </a>
+                    </div>
+                </form>
+            </div>
+
+            <p class="text-xs text-gray-500 mt-4">
+                ℹ️ Votre suggestion sera examinée par l'équipe avant toute prise en compte. Merci de rester courtois et constructif.
+            </p>
+        </div>
+    </section>
+@endsection
diff --git a/routes/web.php b/routes/web.php
index 3200755..31c48b0 100644
--- a/routes/web.php
+++ b/routes/web.php
@@ -2,6 +2,7 @@
 
 use App\Http\Controllers\LoginController;
 use App\Http\Controllers\ProfileController;
+use App\Http\Controllers\SuggestionController;
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\Route;
 
@@ -48,4 +49,8 @@ Route::middleware('auth')->group(function () {
     Route::get('/profile/settings', [ProfileController::class, 'settings'])->name('profile.settings');
     Route::put('/profile/update', [ProfileController::class, 'update'])->name('profile.update');
     Route::delete('/profile', [ProfileController::class, 'destroy'])->name('profile.destroy');
+
+    // Suggestions des utilisateurs (créent un ticket dans Gitea)
+    Route::get('/suggestions/nouveau', [SuggestionController::class, 'create'])->name('suggestions.create');
+    Route::post('/suggestions', [SuggestionController::class, 'store'])->name('suggestions.store');
 });
diff --git a/tests/Feature/SuggestionTest.php b/tests/Feature/SuggestionTest.php
new file mode 100644
index 0000000..6c1d454
--- /dev/null
+++ b/tests/Feature/SuggestionTest.php
@@ -0,0 +1,95 @@
+<?php
+
+namespace Tests\Feature;
+
+use App\Models\Role;
+use App\Models\Utilisateur;
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use Illuminate\Support\Facades\Hash;
+use Illuminate\Support\Facades\Http;
+use Tests\TestCase;
+
+class SuggestionTest extends TestCase
+{
+    use RefreshDatabase;
+
+    private function utilisateur(): Utilisateur
+    {
+        $role = Role::create(['Nom' => 'Utilisateur']);
+
+        return Utilisateur::create([
+            'Pseudo' => 'JeanTest',
+            'Email' => 'jean.test@example.com',
+            'MotDePasse' => Hash::make('motdepasse123'),
+            'ID_Role' => $role->ID_Role,
+            'Statut' => 'Actif',
+        ]);
+    }
+
+    private function configurerGitea(): void
+    {
+        config([
+            'services.gitea.url' => 'https://gitea.test',
+            'services.gitea.token' => 'fake-token',
+            'services.gitea.repo' => 'Groupe1/Ressources-relationnel',
+        ]);
+    }
+
+    public function test_le_formulaire_de_suggestion_exige_une_authentification(): void
+    {
+        $this->get('/suggestions/nouveau')->assertRedirect('/login');
+    }
+
+    public function test_une_suggestion_valide_cree_un_ticket_gitea(): void
+    {
+        $this->configurerGitea();
+        Http::fake([
+            '*/api/v1/repos/*/issues' => Http::response(['number' => 42], 201),
+        ]);
+
+        $response = $this->actingAs($this->utilisateur())->post('/suggestions', [
+            'type' => 'Correction',
+            'titre' => 'Faute dans une ressource',
+            'description' => 'Il y a une faute à corriger sur la page des ressources.',
+        ]);
+
+        $response->assertRedirect(route('suggestions.create'));
+        $response->assertSessionHas('success');
+
+        Http::assertSent(function ($request) {
+            return str_contains($request->url(), '/api/v1/repos/Groupe1/Ressources-relationnel/issues')
+                && $request['title'] === '[Correction] Faute dans une ressource'
+                && str_contains($request['body'], 'JeanTest');
+        });
+    }
+
+    public function test_une_suggestion_invalide_est_rejetee(): void
+    {
+        Http::fake();
+
+        $response = $this->actingAs($this->utilisateur())->post('/suggestions', [
+            'type' => 'Inconnu',
+            'titre' => 'x',
+            'description' => 'court',
+        ]);
+
+        $response->assertSessionHasErrors(['type', 'titre', 'description']);
+        Http::assertNothingSent();
+    }
+
+    public function test_un_echec_gitea_affiche_une_erreur(): void
+    {
+        $this->configurerGitea();
+        Http::fake([
+            '*/api/v1/repos/*/issues' => Http::response(['message' => 'nope'], 500),
+        ]);
+
+        $response = $this->actingAs($this->utilisateur())->post('/suggestions', [
+            'type' => 'Ajout',
+            'titre' => 'Nouvelle fonctionnalité utile',
+            'description' => 'Ce serait bien d\'ajouter un filtre par thème.',
+        ]);
+
+        $response->assertSessionHasErrors('gitea');
+    }
+}