Aller au contenu

Portfolio — Wealth

Contrôleur HTTP exposant les métriques de richesse du portefeuille investisseur (valeur courante, montant investi, balance disponible, gift balance). Source : portfolio.wealth.controller.ts.

Tous les endpoints requièrent un JWT investisseur valide (JwtAuthGuard) et le rôle CUSTOMER (UserRoleGuard).

Tous les endpoints sont préfixés par /investor/portfolio/wealth (cf. @Controller).

GET /investor/portfolio/wealth/home-metrics

Retourne les métriques agrégées affichées sur l'écran d'accueil portfolio investisseur.

Handler : getPortfolioWealthHomeMetrics.

Pré-conditions

  • JWT investisseur valide (JwtAuthGuard)
  • Rôle CUSTOMER (UserRoleGuard)
  • Feature flag DISPLAY_PORTFOLIO_VALUE actif — sinon erreur métier (cf. ci-dessous)

Response

{
  "portfolioCurrentValue": 125000,
  "investedAmount": 120000,
  "balanceAvailable": 5000,
  "giftBalance": 0
}

investedAmount est optionnel (cents.optional()) : absent de la réponse si l'investisseur n'a pas accès aux royalties (canSeeRoyalty faux).

Validé via PortfolioWealth.homeMetrics (depuis @bricks-common/api-communication). Tous les montants sont en cents.

  • portfolioCurrentValue — somme de la composition courante du portefeuille (obligations / loans / royalties valorisés)
  • investedAmount — présent uniquement si l'investisseur a accès aux royalties (canSeeRoyalty)
  • balanceAvailable — solde Lemonway disponible
  • giftBalance — solde des cadeaux (parrainage, bonus)

Erreurs

Code Statut Cause
portfolio-wealth.portfolio-current-value-not-available 403 Feature flag DISPLAY_PORTFOLIO_VALUE désactivé

Liens