feat: module budgets complet avec sécurité, performance et métier
## Fonctionnalités - Module Budgets : enveloppes, lignes budgétaires, arbitrage DSI/Direction - Suivi de l'exécution budgétaire avec alertes visuelles (dépassement, seuil 80%) - Blocage des commandes si budget insuffisant (store + update) - Audit trail complet des arbitrages via HistoriqueBudget - Page d'index budgets refaite en tableau avec filtres et tri côté client - Page Services avec sélecteur d'icônes FontAwesome (solid + regular + brands) ## Sécurité - BudgetPolicy centralisée (viewAny, view, create, update, addLigne, updateLigne, deleteLigne, arbitrerLigne) - Autorisation sur tous les endpoints LigneBudget et Budget - Protection XSS : remplacement v-html par classes dynamiques - Validation des paramètres d'export (type, envelope) - Validation montant_arbitre ≤ montant_propose côté serveur ## Performance - Eager loading lignes.commandes.commune dans execution() et exportPdf() - Calculs montant_consomme/engage en mémoire sur collections déjà chargées - Null-safety sur montant_arbitre dans getMontantDisponibleAttribute ## Technique - Migration historique_budgets, budgets, ligne_budgets, rôle raf - SearchableSelect avec affichage du disponible budgétaire - FontAwesome enregistré globalement (fas, far, fab) - 33 tests Feature (sécurité, performance, métier) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
85
app/Models/LigneBudget.php
Normal file
85
app/Models/LigneBudget.php
Normal file
@@ -0,0 +1,85 @@
|
||||
<?php
|
||||
|
||||
namespace App\Models;
|
||||
|
||||
use Illuminate\Database\Eloquent\Factories\HasFactory;
|
||||
use Illuminate\Database\Eloquent\Model;
|
||||
use Illuminate\Database\Eloquent\Relations\BelongsTo;
|
||||
use Illuminate\Database\Eloquent\Relations\HasMany;
|
||||
|
||||
class LigneBudget extends Model
|
||||
{
|
||||
use HasFactory;
|
||||
|
||||
protected $fillable = [
|
||||
'budget_id',
|
||||
'commune_id',
|
||||
'nom',
|
||||
'description',
|
||||
'type_depense',
|
||||
'montant_propose',
|
||||
'montant_arbitre',
|
||||
'statut_arbitrage',
|
||||
];
|
||||
|
||||
protected $appends = [
|
||||
'montant_consomme',
|
||||
'montant_engage',
|
||||
'montant_disponible',
|
||||
];
|
||||
|
||||
protected $casts = [
|
||||
'montant_propose' => 'decimal:2',
|
||||
'montant_arbitre' => 'decimal:2',
|
||||
];
|
||||
|
||||
public function budget(): BelongsTo
|
||||
{
|
||||
return $this->belongsTo(Budget::class);
|
||||
}
|
||||
|
||||
public function commune(): BelongsTo
|
||||
{
|
||||
return $this->belongsTo(Commune::class);
|
||||
}
|
||||
|
||||
public function commandes(): HasMany
|
||||
{
|
||||
return $this->hasMany(Commande::class, 'ligne_budget_id');
|
||||
}
|
||||
|
||||
public function historique(): HasMany
|
||||
{
|
||||
return $this->hasMany(HistoriqueBudget::class)->latest();
|
||||
}
|
||||
|
||||
/**
|
||||
* Calcule le total des commandes réelles liées à cette ligne
|
||||
*/
|
||||
public function getMontantConsommeAttribute(): float
|
||||
{
|
||||
// On somme le montant total des commandes validées ou plus loin
|
||||
return $this->commandes()
|
||||
->whereIn('statut', ['validee', 'commandee', 'partiellement_recue', 'recue_complete', 'cloturee'])
|
||||
->sum('montant_ttc') ?? 0;
|
||||
}
|
||||
|
||||
/**
|
||||
* Calcule le total des commandes en brouillon ou attente
|
||||
*/
|
||||
public function getMontantEngageAttribute(): float
|
||||
{
|
||||
return $this->commandes()
|
||||
->whereIn('statut', ['brouillon', 'en_attente_validation'])
|
||||
->sum('montant_ttc') ?? 0;
|
||||
}
|
||||
|
||||
/**
|
||||
* Calcule le montant restant (Arbitré - Consommé - Engagé).
|
||||
* Retourne 0.0 si aucun montant n'a encore été arbitré.
|
||||
*/
|
||||
public function getMontantDisponibleAttribute(): float
|
||||
{
|
||||
return (float) ($this->montant_arbitre ?? 0) - ($this->montant_consomme + $this->montant_engage);
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user