Initial commit: Import existing Laravel project

2026-06-15 08:12:33 +02:00
parent 7420d1b466
commit 030d76af53
143 changed files with 21885 additions and 1 deletions
--- a/app/Services/OrderService.php
+++ b/app/Services/OrderService.php
@@ -0,0 +1,79 @@
+<?php
+
+namespace App\Services;
+
+use App\Models\Order;
+use App\Models\OrderStatusLog;
+use App\Models\User;
+use Illuminate\Support\Facades\DB;
+
+class OrderService
+{
+    /**
+     * Génère un numéro de commande unique et séquentiel sous la forme CMD-YYYY-XXXX.
+     * Utilise lockForUpdate() pour éviter les race conditions.
+     */
+    public function generateOrderNumber(): string
+    {
+        return DB::transaction(function () {
+            $year = now()->year;
+
+            // Verrouille la ligne de la dernière commande de cette année pour éviter la lecture simultanée
+            $lastOrder = Order::where('number', 'like', "CMD-{$year}-%")
+                ->lockForUpdate()
+                ->orderBy('number', 'desc')
+                ->first();
+
+            if ($lastOrder) {
+                // Extrait la séquence de la dernière commande (ex: CMD-2026-0005 -> 0005)
+                $parts = explode('-', $lastOrder->number);
+                $sequence = intval(end($parts)) + 1;
+            } else {
+                $sequence = 1;
+            }
+
+            $paddedSequence = str_pad($sequence, 4, '0', STR_PAD_LEFT);
+
+            return "CMD-{$year}-{$paddedSequence}";
+        });
+    }
+
+    /**
+     * Effectue la transition de statut d'une commande d'un statut à un autre.
+     * Valide la transition et l'enregistre dans l'historique des statuts.
+     */
+    public function transitionStatus(Order $order, string $newStatus, User $user): Order
+    {
+        $statuses = ['draft', 'validated', 'ordered', 'delivered', 'closed'];
+
+        $currentIndex = array_search($order->status, $statuses);
+        $newIndex = array_search($newStatus, $statuses);
+
+        if ($currentIndex === false || $newIndex === false) {
+            throw new \InvalidArgumentException("Statut invalide.");
+        }
+
+        // Vérification de la transition linéaire (uniquement le statut suivant dans la liste)
+        if ($newIndex !== $currentIndex + 1) {
+            throw new \InvalidArgumentException("La transition de statut de '{$order->status}' vers '{$newStatus}' n'est pas autorisée. Le cycle de vie doit être respecté séquentiellement.");
+        }
+
+        return DB::transaction(function () use ($order, $newStatus, $user) {
+            $oldStatus = $order->status;
+            
+            $order->status = $newStatus;
+            $order->save();
+
+            // Journalisation de la transition
+            OrderStatusLog::create([
+                'order_id' => $order->id,
+                'user_id' => $user->id,
+                'old_status' => $oldStatus,
+                'new_status' => $newStatus,
+                'changed_at' => now(),
+            ]);
+
+            return $order;
+        });
+    }
+}