🇫🇷 Rechercher les lignes DPF par institution et période

🇫🇷 Rechercher les lignes DPF par institution et période

Cette fonction permet d’obtenir les lignes (dpf_lines) correspondant à des dépôts à terme (DPF) pour une institution donnée, dans une période spécifiée.

🎯 Objectif

Filtrer et récupérer toutes les lignes de dépôt associées à une institution spécifique et comprises entre deux dates données (from et to). Utile pour les rapports financiers, les audits ou les suivis par institution.

🧠 Fonctionnement

  1. Valide les paramètres de tri pour éviter les erreurs ou injections.
  2. Joint les tables dpf_lines et dpf via dpf_id.
  3. Filtre par institution_id et la colonne date.
  4. Trie les résultats selon les critères spécifiés.
  5. Limite et pagine les résultats.

⚙️ Syntaxe

function dpf_lines_search_from_to_by_institution(
    string $from, 
    string $to, 
    int $institution_id, 
    int $start = 0, 
    int $limit = 999, 
    string $order_col = "order_by", 
    string $order_way = "desc"
): array

📥 Paramètres

Paramètre Type Description
$from string Date de début (YYYY-MM-DD).
$to string Date de fin (YYYY-MM-DD).
$institution_id int ID de l’institution.
$start int Décalage de pagination.
$limit int Nombre maximum de résultats.
$order_col string Colonne de tri.
$order_way string Ordre de tri : asc ou desc.

📤 Retour

Un tableau de lignes DPF avec les colonnes suivantes :

  • id
  • dpf_id
  • date
  • interest
  • retencion
  • collection_date
  • monthly_interest
  • collected_value
  • deposited_in
  • transferred_to
  • income_type
  • order_by
  • status