0ad77de412
## 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>
86 lines
2.2 KiB
PHP
86 lines
2.2 KiB
PHP
<?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);
|
|
}
|
|
}
|