80 lines
2.7 KiB
PHP
80 lines
2.7 KiB
PHP
<?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;
|
|
});
|
|
}
|
|
}
|