Documentation

Rôle métier

Point d'entrée sécurisé de la plateforme. L'utilisateur s'authentifie avec son identifiant et son mot de passe. Une fois connecté, il est redirigé vers son espace selon son rôle. Sans session valide, toutes les pages protégées sont inaccessibles.

Architecture technique

NextAuth.js v5 avec un credentials provider. Session JWT avec expiration de 2 minutes. Hachage des mots de passe via bcryptjs. Validation des champs par schéma Zod (LoginSchema). Formulaire piloté par React Hook Form.

Fonctionnalités clés

• Validation des champs en temps réel
• Session JWT sécurisée
• Redirection automatique post-connexion
• Affichage des erreurs d'authentification

Rôle métier

Permet la création d'un nouveau compte utilisateur. Le rôle (VISITOR par défaut) et le statut (INACTIF jusqu'à validation) sont gérés par un administrateur après création.

Architecture technique

Formulaire React Hook Form validé par RegisterSchema (Zod). Le mot de passe est haché côté serveur avant persistance en base via Prisma. La session n'est pas créée automatiquement à l'inscription.

Fonctionnalités clés

• Validation du format email
• Confirmation du mot de passe
• Hachage sécurisé bcryptjs
• Gestion des erreurs de doublon

Rôle métier

Référentiel géographique central de la plateforme. Chaque pays est le pivot autour duquel s'organisent les actifs financiers, les utilisateurs et les indicateurs macroéconomiques. La couverture des marchés émergents dépend de ce référentiel.

Architecture technique

Liste paginée (20 entrées/page) avec recherche full-text insensible à la casse. CRUD complet (créer, lire, modifier, supprimer). Relations Prisma avec Continent, Currency et StaticInfoCountry. Breadcrumb dynamique.

Fonctionnalités clés

• Recherche par nom de pays
• Pagination (20 pays par page)
• Création / modification / suppression
• Vue détail par pays
• Association devise et continent
• Affichage du drapeau (code ISO)

Rôle métier

Administration centralisée des comptes. Permet de définir les droits d'accès (rôle), l'état du compte (ACTIF, INACTIF, SUSPENDU) et le périmètre géographique de chaque utilisateur. Critique pour contrôler qui accède à quelles données.

Architecture technique

Pagination (10 utilisateurs/page), recherche sur username. CRUD complet. Champs gérés : username, email, rôle (enum UserRoles), statut (enum UserStatuses), pays et continent rattachés.

Fonctionnalités clés

• Recherche par nom d'utilisateur
• Pagination (10 par page)
• Attribution de rôle et statut
• Rattachement géographique (pays/continent)
• Création / modification / suppression

Rôle métier

Gestion des demandes entrantes soumises via le formulaire public. Chaque message suit un workflow : NOUVEAU → EN COURS → TERMINÉ. Permet un suivi rigoureux des sollicitations clients ou prospects.

Architecture technique

Liste des entrées Contact en base Prisma. Statut géré par l'enum ContactStatuses (NOUVEAU, ENCOURS, TERMINE). CRUD complet avec vue détail. Pagination et filtrage disponibles.

Fonctionnalités clés

• Suivi des statuts (NOUVEAU / EN COURS / TERMINÉ)
• Vue détail de chaque message
• Modification et suppression
• Pagination de la liste

Rôle métier

Un indice boursier est un panier d'actifs représentant la performance d'un marché, d'un secteur ou d'une zone géographique (ex : MSCI Emerging Markets, S&P 500). Outil de benchmarking essentiel pour mesurer la performance des portefeuilles exposés aux marchés émergents.

Architecture technique

Liste paginée avec recherche. Chaque entrée StaticInfoIndex est liée à un pays. Vue grille ou tableau selon le breakpoint. Données historiques (HistoricalDataIndex) avec prix de clôture, variation journalière et date.

Fonctionnalités clés

• Recherche par nom ou ticker
• Pagination
• Lien vers la vue détail
• Données historiques quotidiennes
• Filtrage par pays

Rôle métier

Fiche complète d'un indice : composition, historique de performance, pays de référence. Permet une analyse approfondie avant toute décision d'investissement ou de benchmarking.

Architecture technique

Route dynamique Next.js. Chargement du StaticInfoIndex par ID avec ses relations (pays, données historiques). Graphique de performance via Recharts/Tremor. Breadcrumb contextualisé.

Fonctionnalités clés

• Graphique de performance historique
• Données de clôture et variation
• Informations statiques (nom, ticker, pays)
• Navigation retour vers la liste

Rôle métier

Une action (equity) représente une part de propriété dans une entreprise cotée. Les marchés émergents offrent un accès à des entreprises à fort potentiel de croissance en Afrique, Asie, Amérique Latine. La plateforme couvre 14 secteurs économiques.

Architecture technique

Vue grille avec recherche. Chaque StaticInfoEquity possède un ISIN, un ticker, un secteur (enum SectorList), un pays. Données historiques quotidiennes via HistoricalDataEquity (prix, variation).

Fonctionnalités clés

• Recherche par ISIN, ticker ou nom
• Filtrage par secteur (14 secteurs)
• Vue grille avec carte par action
• Données historiques de cours
• Pagination

Rôle métier

Fiche détaillée d'un titre : ISIN, ticker, émetteur, secteur, pays de cotation, historique de prix. Utilisée par les analystes pour évaluer un titre avant inscription dans un portefeuille ou recommandation.

Architecture technique

Route dynamique. Chargement par ID avec relations (pays, secteur, historique). Affichage du graphique de cours. Breadcrumb dynamique. Composant allStaticEquities pour les données statiques globales.

Fonctionnalités clés

• Graphique de cours historique
• ISIN et ticker
• Secteur et pays de cotation
• Variation journalière
• Navigation retour

Rôle métier

Une obligation est un instrument de dette : l'émetteur (État, entreprise) emprunte des fonds aux investisseurs en échange de paiements d'intérêts réguliers (coupons) et du remboursement du capital à échéance (maturité). La plateforme catégorise les obligations en 6 types pour une analyse ciblée des marchés émergents.

Architecture technique

Interface à 6 onglets (Tabs Radix UI). Chaque onglet filtre par type via un champ booléen (greenBond, dualCurrency, inflationLinked, callable) ou par enum ACF (ACF_1 = OECD, ACF_2 = Emerging Markets). Tableau avec ScrollArea, pagination indépendante par onglet.

Fonctionnalités clés

• 6 onglets : Emerging Market, OECD, Green, Dual Currency, Inflation-linked, Callable
• Recherche par émetteur ou description
• Colonnes : ISIN, taux de coupon, classe de coupon, devise principale, maturité, marché
• Pagination par onglet (50 entrées/page)
• Compteur total des obligations

Rôle métier

Fiche complète : émetteur, conditions de coupon, devise, marché d'émission, type d'obligation et historique de prix. Essentielle pour l'analyse crédit et la valorisation des portefeuilles obligataires.

Architecture technique

Route dynamique. StaticInfoBond chargé avec relations (principalCurrency, market). Affichage conditionnel des attributs spéciaux (green, callable, inflation-linked). Données historiques HistoricalDataBond.

Fonctionnalités clés

• ISIN et description
• Taux et classe de coupon
• Devise principale et marché d'émission
• Date de maturité
• Indicateurs spéciaux (green, callable...)
• Historique de prix

Rôle métier

Les matières premières sont des produits de base échangés sur les marchés mondiaux : métaux précieux (or, argent), énergie (pétrole, gaz naturel), produits agricoles (café, cacao, blé), métaux industriels (cuivre, aluminium). Indicateurs vitaux de la santé économique des pays producteurs émergents.

Architecture technique

Liste avec commoSelect pour le filtrage par catégorie. StaticInfoCommo avec relations pays. Données historiques via HistoricalDataCommo (prix de clôture, variation). Vue commoBody et commoViews.

Fonctionnalités clés

• Filtrage par catégorie de matière première
• Recherche par nom
• Données historiques quotidiennes
• Lien vers la vue détail
• Pagination

Rôle métier

Fiche d'une commodity : prix spot, historique de cours, marché de référence. Utilisée pour l'analyse des tendances de prix et l'évaluation de l'exposition aux matières premières dans un portefeuille.

Architecture technique

Route dynamique. StaticInfoCommo avec données historiques. Graphique de cours. Composant commoViews pour la vue enrichie. Loading skeleton pour les états de chargement.

Fonctionnalités clés

• Graphique de cours historique
• Prix spot et variation journalière
• Marché de référence
• Catégorie et description

Rôle métier

Le taux de change mesure la valeur d'une devise par rapport à une autre. Sur les marchés émergents, la volatilité des devises est un facteur de risque et d'opportunité majeur. La plateforme couvre les paires de devises clés des marchés émergents.

Architecture technique

StaticInfoFx avec paires de devises. fxSelect pour le filtrage. Données historiques HistoricalDataFx (taux de clôture, variation journalière). Composants fxBody, fxCountryView, allStaticFx.

Fonctionnalités clés

• Filtrage par pays ou devise
• Paires de devises (ex : EUR/USD, USD/NGN)
• Variation journalière en %
• Données historiques quotidiennes
• Lien vers le détail

Rôle métier

Analyse d'une paire de devises : historique du taux, variation, pays concernés. Permet de suivre l'évolution du taux de change pour couvrir un risque de change ou identifier des opportunités d'arbitrage.

Architecture technique

Route dynamique. StaticInfoFx avec relations pays et données historiques. Graphique via Recharts/Tremor. fxViews et fxDetails pour l'affichage enrichi.

Fonctionnalités clés

• Graphique d'évolution du taux
• Taux spot et variation
• Pays de référence
• Historique complet

Rôle métier

Un fonds d'investissement regroupe des capitaux de plusieurs investisseurs pour les placer dans un portefeuille diversifié géré professionnellement. Les fonds des marchés émergents permettent une exposition géographique et sectorielle optimisée. La plateforme référence les acteurs clés : gestionnaire (advisor), dépositaire (custodian), administrateur et promoteur.

Architecture technique

StaticInfoFund avec relations vers les entités custodian, advisor, administrator, promoter. Recherche, pagination. Composants fundViews pour la vue enrichie.

Fonctionnalités clés

• Recherche par nom de fonds
• Relations : gestionnaire, dépositaire, administrateur, promoteur
• Pays de domiciliation
• Pagination
• Vue détail complète

Rôle métier

Fiche complète du fonds : nom, domicile, acteurs impliqués (gestionnaire, dépositaire, administrateur, promoteur). Indispensable pour la due diligence et l'analyse des structures de distribution.

Architecture technique

Route dynamique. Chargement StaticInfoFund avec toutes ses relations. Affichage des entités associées (Person, Company). Breadcrumb dynamique.

Fonctionnalités clés

• Nom et domicile du fonds
• Gestionnaire (advisor)
• Dépositaire (custodian)
• Administrateur
• Promoteur

Rôle métier

Vitrine de la plateforme Convergence. Présente la proposition de valeur et oriente les visiteurs vers la connexion. Premier point de contact avec les prospects et les utilisateurs non connectés.

Architecture technique

Page statique Next.js (Server Component). Section hero avec call-to-action vers /auth/login. Responsive, supporte les thèmes dark/light via next-themes.

Fonctionnalités clés

• Section hero marketing
• Bouton de connexion
• Compatible thème dark/light
• Responsive mobile/desktop

Rôle métier

Canal de communication ouvert au public. Permet aux visiteurs, prospects ou clients de soumettre une demande. Chaque message est enregistré en base avec le statut NOUVEAU pour être traité par l'équipe.

Architecture technique

React Hook Form validé par ContactSchema (Zod). Server Action pour la persistance en base Prisma. Notification toast (Sonner) après envoi. Champs : nom, email, sujet, message.

Fonctionnalités clés

• Validation des champs (nom, email, message)
• Envoi en base de données
• Notification de confirmation
• Accessible sans connexion

Rôle métier

Navigation géographique de la plateforme. Permet d'explorer les données par grande zone (AFRICA, AMERICA, ASIA, EUROPE, OCEANIA, WORLD). Les agents sont automatiquement restreints à leur continent assigné, garantissant la segmentation des données.

Architecture technique

Routing dynamique /continents/[contId]/[[...slug]]. Accordion Radix UI pour la navigation par continent. Restriction AGENT : lecture du continent en session JWT, redirection si hors périmètre. Composant General Overview (Go) par pays.

Fonctionnalités clés

• Navigation par continent
• Accordion de navigation
• Restriction géographique AGENT
• Vue détail par pays
• Indicateurs macroéconomiques (StaticInfoCountry)
• Courbe des taux (YieldCurve)