🔎 API de gestion des bénéficiaires effectifs

📋 Contexte du projet

Cette API REST développée avec Java 21 et Spring Boot vise à déterminer les bénéficiaires effectifs d’une entreprise dans le cadre des obligations réglementaires liées à la conformité (KYC). Elle identifie toute personne physique détenant plus de 25 % du capital, directement ou indirectement.

🎯 Objectif principal

Développer une API REST permettant, via une route unique GET, de récupérer les bénéficiaires effectifs d’une entreprise, en tenant compte des détentions directes et indirectes. Cette fonctionnalité est clé pour les organismes financiers.

🛠️ Fonctionnalité implémentée

• Route GET pour l’obtention des bénéficiaires (>25%) d'une entreprise
• Paramètres : ID de l’entreprise + filtre optionnel sur les bénéficiaires
• Réponses possibles :
  • 200 : liste des bénéficiaires trouvés
  • 204 : aucun bénéficiaire ne dépasse le seuil
  • 404 : entreprise non trouvée

🔧 Réalisation technique

• Modélisation métier : entreprise, personne physique, relations de détention
• Calcul récursif des participations pour détecter les seuils >25%
• Application des principes de la Clean Architecture (Hexagonale)
• Tests unitaires complets de la logique de calcul
• Stockage des entités en mémoire (sans base de données)

📊 Résultats

• ✅ API REST conforme aux exigences métier
• ✅ Traitement efficace des cas complexes de détention indirecte
• ✅ Réponses normalisées avec gestion complète des statuts HTTP
• ✅ Structure propre et évolutive grâce à l’architecture hexagonale

🔍 Enseignements clés

Ce projet m’a permis d’appliquer des concepts avancés de modélisation métier, de mettre en œuvre un algorithme de calcul récursif robuste et de structurer une API selon les bonnes pratiques de la clean architecture. Il démontre ma capacité à développer un MVP complet avec logique métier claire et tests automatisés.