Social Hub Dashboard — tes stats YouTube, TikTok et Instagram au même endroit
Social Hub Dashboard réunit tes vidéos YouTube, TikTok et Instagram dans un seul tableau de bord.
Il te permet de visualiser rapidement les performances (vues, likes, commentaires, partages) et de comparer l’impact de tes contenus sur chaque plateforme.
Strictement en lecture seule. Les autorisations demandées se limitent à la consultation : Social Hub Dashboard ne publie, ne modifie et ne supprime rien sur tes comptes.
📚 Documentation
Une documentation complète (présentation, fonctionnement, architecture technique, sécurité, intégrations API, vision & roadmap) est disponible sur la branche dédiée Documents :
👉 Consulter la documentation
Écrite à deux niveaux de lecture — grand public et développeurs — avec la même navigation sur chaque page.
🚀 Fonctionnalités
- 🔗 Connexion OAuth à YouTube, TikTok et Instagram — les trois vérifications plateformes ont abouti (TikTok et Meta le 15/09/2026, Google le 16/09/2026)
- 📊 KPIs visibles sous chaque vidéo :
- Vues
- Likes
- Commentaires
- Partages (TikTok uniquement)
- ⚡ Barre de tri fixe :
trie les vidéos par Date, Vues, Likes, Commentaires, Partages
- 📈 Page de statistiques par vidéo : courbes d’évolution horaire et journalière (Recharts)
- ⏰ Historique automatique : un relevé horaire enregistre l’état des compteurs, même quand tu ne consultes pas le dashboard — c’est ce qui permet d’afficher une tendance et pas un chiffre figé
- 🕓 Historique YouTube rétroactif : à la connexion d’un compte Google, l’API YouTube Analytics remonte les données depuis la publication des vidéos, sans attendre l’accumulation des relevés
- 👥 Multi-utilisateurs : authentification Kinde, chaque utilisateur ne voit que ses propres comptes et statistiques
- 🎨 UI responsive : cartes vidéos avec vignettes, titres, KPI toujours visibles
- 🔄 Chargement par lots (+60 vidéos à la fois)
- 🔒 RGPD : jetons chiffrés AES-256-GCM, bandeau de consentement, effacement en self-service, rétention de l’historique limitée à 25 mois
- ☁️ Déploiement automatique sur Vercel
🛠️ Installation locale
Prérequis
- Node.js 22.x — et seulement 22.x (voir
engines dans package.json)
⚠️ Ne pas monter au-dessus de 22.x — la limite vient de Prisma, pas de Node.
Prisma 6 ne supporte pas Node 24 (matrice officielle : 16.13 / 18.x / 20.x / 22.x).
Node 24 n’arrive qu’avec Prisma 7 (^20.19.0, ^22.12.0, ^24.0.0).
Une tentative de passage en Node 24 a bien cassé la connexion Prisma → Neon.
⚠️ Le champ engines des paquets Prisma annonce >=18.18, sans borne haute :
il exprime un plancher, pas la matrice de support. Ne pas s’y fier seul.
Ordre imposé pour lever le plafond : migrer Prisma 6 → 7 d’abord
(@prisma/client 7.x est disponible), puis Node 22 → 24. Jamais l’inverse,
jamais les deux ensemble — une panne ne dirait pas laquelle des deux l’a causée.
Node 20, de son côté, est en fin de vie et ne doit plus servir.
- pnpm (recommandé)
- Une base PostgreSQL accessible (Neon en production)
Étapes
# Cloner le projet
git clone https://github.com/Paullux/SocialHub.git
cd SocialHub
# Installer les dépendances (déclenche prisma generate)
pnpm install
# Lancer en local
pnpm dev
Le site est accessible sur http://localhost:3000.
🔑 Variables d’environnement
À définir dans .env.local (non versionné).
⚠️ env.example est désynchronisé du code : il déclare encore YOUTUBE_CLIENT_ID / YOUTUBE_CLIENT_SECRET (le code lit GOOGLE_*), YT_CHANNEL_ID qui n’est plus utilisé, et il ignore DATABASE_URL, les variables Kinde et CRON_SECRET. La liste ci-dessous est celle réellement lue par le code.
# Base de données
DATABASE_URL= # pooled
DATABASE_URL_UNPOOLED= # direct (migrations Prisma)
# Authentification applicative (Kinde)
KINDE_CLIENT_ID=
KINDE_CLIENT_SECRET=
KINDE_ISSUER_URL=
KINDE_SITE_URL=
KINDE_POST_LOGIN_REDIRECT_URL=
KINDE_POST_LOGOUT_REDIRECT_URL=
# YouTube / Google
YT_API_KEY= # clé serveur, API YouTube Data v3
GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=
GOOGLE_REDIRECT_URI=
# TikTok
TIKTOK_CLIENT_KEY=
TIKTOK_CLIENT_SECRET=
TIKTOK_REDIRECT_URI=
# Instagram (Instagram Login, sans Page Facebook)
IG_LOGIN_APP_ID=
IG_LOGIN_APP_SECRET=
IG_LOGIN_REDIRECT_URI=
# Chiffrement des jetons OAuth stockés (32 octets en base64)
TOKENS_AES_KEY=
# Relevé horaire
CRON_SECRET=
# Divers
NEXT_PUBLIC_BASE_URL=
NEXT_PUBLIC_MATOMO_URL=
NEXT_PUBLIC_MATOMO_SITE_ID=
NEXT_PUBLIC_MATOMO_CONTAINER=
ALLOW_TIKTOK_DEBUG= # "1" pour ouvrir /api/tiktok/diagnostic
TOKENS_AES_KEY doit être défini partout où l’application tourne, y compris là où s’exécute le relevé horaire : sans elle, les jetons stockés sont indéchiffrables.
📦 Déploiement
L’application est déployée sur Vercel :
- Connecte ton repo GitHub à Vercel
- Ajoute les variables d’environnement dans Project → Settings → Environment Variables
- Ajoute ton domaine custom (ex.
https://social-hub.fr)
- Chaque
git push sur main déploie automatiquement en production
Le relevé horaire n’est pas un cron Vercel. vercel.json déclare {"crons": []} : c’est le crontab d’un VPS séparé (Hostinger, orchestré par Coolify) qui appelle /api/cron/snapshot?key=$CRON_SECRET toutes les heures. Ce même VPS héberge l’instance Matomo. Le workflow GitHub Actions hourly-snapshot.yml est désactivé et conservé comme secours manuel.
📈 Roadmap
🤝 Contribution
Les contributions sont les bienvenues !
Fork le repo, crée une branche et fais une PR.
📜 Licence
Distribué sous licence MIT.
