Compétence Portefeuille
Déclencheur
- Mots-clés : Portefeuille, portefeuille, position, {PRIMARY_PROVIDER}, protocole, prêt, staking, liquidité
Quand NE PAS Utiliser
- Requêtes de jetons générales (pas les positions de portefeuille)
- Construction de transactions (utiliser le fournisseur correspondant)
- Problèmes d'API non liés au portefeuille
Fichiers Principaux
| Type | Fichier | Objectif |
|---|
| Contrôleur | src/entity/portfolio/portfolio.controller.ts | API REST |
| Routeur | src/service/portfolio/source-router/*.service.ts | Orchestration du routage |
| Client | src/service/portfolio/providers/{provider}/*.ts | Intégration {PRIMARY_PROVIDER} |
| Agrégateur | src/service/portfolio/aggregation/*.service.ts | Calcul d'agrégation |
| DTO | src/dto/portfolio/position.types.ts | Modèle de position |
Aperçu de l'API
Base : /onchain/v1/portfolio
| Point de terminaison | Méthode | Objectif |
|---|
/positions | POST | Obtenir les positions de portefeuille |
/chains | GET | Liste des chaînes prises en charge |
/protocols | GET | Liste des protocoles pris en charge |
Résultat
- Résultats de requête spécifiques au domaine avec références de code
- Analyse et recommandations basées sur l'architecture actuelle
Vérification
- Données de position correctement normalisées
- Cache hit/miss fonctionne correctement
- Calculs d'agrégation précis
Guide de Développement
Ajouter un Support de Protocole
- Vérifier si {PRIMARY_PROVIDER} le prend en charge
- Si une construction personnalisée est nécessaire : implémenter
PortfolioPositionExtractor + enregistrer + configurer le routage
Ajouter une Source de Données
- Implémenter
ProviderClient + Adapter
- Enregistrer avec
SourceRouter
- Configurer la stratégie de routage
Déboguer
redis-cli keys "portfolio:{provider}:*"
redis-cli get "portfolio:{provider}:positions:0x...:v2:..."
curl -X POST /positions -d '{"isForceRefresh": true, ...}'
Références
references/architecture.md - Architecture système + stratégie de cache
references/api.md - Référence API + modèles de données
- @docs/features/portfolio/ - Documentation détaillée
Tests
| Type | Emplacement |
|---|
| Unitaire | test/unit/service/portfolio/ |
| Intégration | test/integration/portfolio/ |
Exemples
Entrée : Comment interroger les positions de portefeuille ?
Action : Expliquer l'API POST /positions + la stratégie de routage
Entrée : Comment fonctionne l'intégration {PRIMARY_PROVIDER} ?
Action : Expliquer le flux {PRIMARY_PROVIDER}Client + {PRIMARY_PROVIDER}Adapter