Files
dsi-commander/app/Models/Budget.php
jeremy bayse 0ad77de412 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>
2026-04-11 20:20:05 +02:00

61 lines
1.4 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 Budget extends Model
{
use HasFactory;
protected $fillable = [
'service_id',
'commune_id',
'annee',
'type_budget',
'statut',
];
public function service(): BelongsTo
{
return $this->belongsTo(Service::class);
}
public function commune(): BelongsTo
{
return $this->belongsTo(Commune::class);
}
public function lignes(): HasMany
{
return $this->hasMany(LigneBudget::class);
}
/**
* Calcul du total proposé selon le type de dépense (optionnel: 'investissement' ou 'fonctionnement').
*/
public function totalPropose(?string $typeDepense = null): float
{
$query = $this->lignes();
if ($typeDepense) {
$query->where('type_depense', $typeDepense);
}
return $query->sum('montant_propose') ?? 0;
}
/**
* Calcul du total arbitré (validé) selon le type de dépense.
*/
public function totalArbitre(?string $typeDepense = null): float
{
$query = $this->lignes();
if ($typeDepense) {
$query->where('type_depense', $typeDepense);
}
return $query->sum('montant_arbitre') ?? 0;
}
}