Communitygithub.com

ComeOnOliver/skillshub

Contexte auto-chargé pour le développement de Portfolio Buddy 2. À utiliser pour toute tâche impliquant : le développement React 19, TypeScript, les fonctionnalités d'analyse de portefeuille, les calculs de métriques, la comparaison de stratégies de trading ou le travail avec la base de code de Portfolio Buddy 2. Contient la stack technique, les problèmes connus et les contraintes architecturales.

Qu'est-ce que skillshub ?

Ce skill fournit un contexte complet pour le développement de l'application Portfolio Buddy 2, un outil d'analyse de portefeuille pour investisseurs et traders de contrats à terme. Il documente la stack technique complète (React 19, TypeScript, Vite, Tailwind CSS, Chart.js, Supabase, Cloudflare Pages), les fonctionnalités clés comme le calcul du ratio Sortino, le filtrage par plage de dates et le tri multicritères avancé, ainsi que les problèmes connus et la dette technique (composants volumineux, violations de typage TypeScript). Il inclut également la structure des composants et la feuille de route de migration (35/40 fonctionnalités migrées). Ce skill est essentiel pour tout développeur travaillant sur Portfolio Buddy 2 car il centralise les contraintes architecturales, les bugs connus et les dépendances récentes, évitant ainsi la duplication d'efforts et les erreurs de conception.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/aiskillstore/marketplace/5minfutures/portfolio-context

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Portfolio Buddy 2 - Contexte du projet

Stack technique

  • Frontend : React 19, TypeScript, Vite
  • UI : Tailwind CSS, shadcn/ui (système de couleurs uniquement)
  • Graphiques : Chart.js, react-chartjs-2, plugins chartjs (zoom, annotation, adaptateur de date)
  • État : React pur (useState, useMemo, useCallback)
  • Outils de données : date-fns pour la manipulation des dates
  • Backend : Supabase (PostgreSQL)
  • Déploiement : Cloudflare Pages

Objectif du projet

Outil d'analyse de portefeuille pour investisseurs et traders de contrats à terme permettant de :

  • Comparer les stratégies de trading par rapport aux actifs de référence (SPY, GLD)
  • Calculer les matrices de corrélation entre les actifs (Spearman et Pearson)
  • Analyser les métriques de risque et de performance (Sharpe, Sortino, DD max, etc.)
  • Télécharger des données de trading via CSV et visualiser les résultats
  • Appliquer des multiplicateurs de contrat pour ajuster les métriques pour le trading de contrats à terme
  • Filtrer les données par plage de dates pour une analyse spécifique à une période

Problèmes connus et dette technique

Dette technique actuelle

  1. Dépendance inutilisée : Recharts (11.5 Ko) installé mais jamais importé

    • Doit être supprimé de package.json
    • Utilise actuellement Chart.js à la place
  2. Composants surdimensionnés : Violent la norme des 200 lignes

    • PortfolioSection.tsx (591 lignes) → nécessite un refactoring en sous-composants
    • App.tsx (351 lignes) → extraire les sections en composants
    • MetricsTable.tsx (242 lignes) → amélioré mais toujours au-dessus de la limite
  3. Violations TypeScript : 15 instances de type any

    • usePortfolio.ts : 11 occurrences dans les types de trading/métriques
    • useMetrics.ts : 4 occurrences dans les comparaisons de tri
    • dataUtils.ts : 1 occurrence dans l'interface Metrics

Bugs connus

  1. Erreurs de téléchargement Supabase : Erreurs 500 intermittentes sur les gros téléchargements
    • Gestion d'erreurs améliorée ajoutée dans le commit 9fb7fdb
    • Vérifier la gestion des erreurs dans les hooks de téléchargement
    • Vérifier que les limites de lignes ne sont pas dépassées sur le niveau gratuit

Fonctionnalités récentes ajoutées

  • Calcul du ratio Sortino (commits 258ba3a, 9f25040)
    • Emplacement : Implémenté en ligne dans PortfolioSection.tsx (lignes 133-158)
    • État du taux sans risque saisi par l'utilisateur
    • Déviation à la baisse annualisée utilisant le facteur sqrt(365)
    • Correction du calcul de la variance (divise par le nombre total de rendements, pas seulement les négatifs)
    • Affiché dans la section des statistiques du portefeuille (ligne 535)
    • Remarque : PAS dans dataUtils.ts - conservé dans le composant en raison du contexte de niveau portefeuille
  • Filtrage par plage de dates (commit 258ba3a)
    • Filtrer les données du portefeuille par date de début/fin
    • Implémenté dans le hook usePortfolio
  • Tri multicritères avancé (hook useSorting)
    • Trier par plusieurs colonnes avec priorité
    • Logique de comparaison personnalisée par colonne

Contraintes architecturales

  • Limite de composant : Max 200 lignes par composant (actuellement violé par 3 composants)
  • Modèle Hook : Hooks personnalisés dans /src/hooks/
  • Modèle Utils : Fonctions pures dans /src/utils/
  • Sécurité des types : TypeScript strict, aucun type any (15 violations existent comme dette technique)
  • Gestion d'état : Hooks React purs uniquement - pas de Zustand ni TanStack Query

Structure des composants clés

src/
├── composants/
│   ├── AnalyticsControls.tsx     (basculer les vues Métriques/Portefeuille/Corrélation)
│   ├── ContractInput.tsx         (saisies des multiplicateurs de contrat)
│   ├── CorrelationHeatmap.tsx    (visualisation de la corrélation)
│   ├── CorrelationSection.tsx    (wrapper d'analyse de corrélation)
│   ├── CustomTooltip.tsx         (infobulles des graphiques)
│   ├── ErrorList.tsx             (affichage des erreurs)
│   ├── Header.tsx                (en-tête de l'application)
│   ├── MasterContractControl.tsx (appliquer la valeur du contrat à tous)
│   ├── MetricsTable.tsx          (affichage et sélection des métriques)
│   ├── PortfolioSection.tsx      (graphiques et analyse du portefeuille - 591 lignes!)
│   ├── SessionComplete.tsx       (interface de fin)
│   ├── SortableHeader.tsx        (en-tête de tableau avec indicateurs de tri)
│   ├── UploadedFilesList.tsx     (liste des fichiers téléchargés)
│   └── UploadSection.tsx         (téléchargement de fichiers vers Supabase)
├── hooks/
│   ├── useContractMultipliers.ts (gérer les multiplicateurs de contrat)
│   ├── useMetrics.ts             (calculer les métriques de trading)
│   ├── usePortfolio.ts           (données du portefeuille et filtrage par date)
│   └── useSorting.ts             (tri multicritères avancé)
└── utils/
    └── dataUtils.ts              (calculs de métriques, analyse CSV, corrélations)

Contexte de migration

Migration de 40 fonctionnalités de l'ancienne application (35/40 terminées). Voir le skill migration-tracker pour les détails.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Next.js 16+ uses App Router with Server Components by default. Client Components are only used when interactivity is needed (hooks, event handlers, browser APIs).

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

Skills associés