🚀 Socialflow

Votre assistant intelligent pour dominer les réseaux sociaux.

Socialflow est une application tout-en-un conçue pour automatiser, créer et analyser votre contenu sur Facebook et Instagram. Plus besoin de jongler entre plusieurs outils : tout est là, centralisé et simplifié.

---

✨ Fonctionnalités

📊 Tableau de Bord Unifié

Vue d'ensemble immédiate de votre activité. Statistiques clés, publications récentes, et suivi de progression des Reels en cours — le tout sur un seul écran.

• Cartes statistiques : Followers, publications programmées, Reels en cours
• Publications récentes : Historique avec statuts de publication
• Actions rapides : Accès direct à la création de contenu
• Suivi en temps réel : Progression des Reels (Encodage → Upload → Publication)

---

🎬 Création de Reels par IA

Créez des vidéos virales en quelques clics sans aucune compétence en montage.

• Montage automatique : Transformez vos images et vidéos en Reels dynamiques via FFmpeg
• Voix-off IA : Narration professionnelle générée automatiquement
• Sous-titres automatiques : Synchronisés avec la voix-off, personnalisables (police, couleur, taille)
• Musique libre de droits : Intégration FreeSound et Jamendo pour des milliers de pistes
• Hébergement Cloudinary : Upload automatique vers le cloud pour une diffusion rapide
• Webcam & Caméra : Enregistrement intégré directement depuis l'application

---

✍️ Création de Posts Multi-Plateformes

Composez vos publications pour Facebook et Instagram depuis une interface unifiée.

• Éditeur riche : Gestion complète des médias (images, vidéos), emojis, et texte
• Drag & Drop : Réorganisez vos médias avec le glisser-déposer
• Génération IA : Génération de textes (légendes, hashtags) via OpenRouter avec choix du modèle IA
• Multi-pages : Publiez sur plusieurs pages Facebook/Instagram simultanément
• Publication immédiate ou programmée : Planifiez pour plus tard ou publiez maintenant

---

🖼️ Éditeur d'Images Intégré

Retouchez vos visuels sans quitter l'application.

• Textes & annotations : Ajout de titres, légendes, watermarks
• Overlays : Superposition de logos et éléments graphiques
• Recadrage intelligent : Optimisé pour les formats réseaux sociaux
• Export direct : Réutilisation immédiate dans vos posts et Reels

---

📅 Planification & Calendrier

Organisez votre stratégie de contenu sur semaines et mois.

• Vue calendrier : Visualisez toutes vos publications planifiées
• Vue liste : Accès chronologique avec filtres
• Drag & Drop : Réorganisez les dates de publication en les déplaçant
• Publication automatique : Le scheduler publie automatiquement aux horaires prévus
• Édition en ligne : Modifiez les posts planifiés directement

---

📈 Analytics & Statistiques

Suivez la croissance de vos pages avec des données actualisées automatiquement.

• 4 métriques clés : Abonnés, Portée (impressions uniques), Engagement, Vues de page
• Graphique d'évolution : Courbe de croissance jour par jour
• Tendances : Comparaison avec la période précédente (variation en %)
• Synchronisation automatique : CRON bi-quotidien (8h & 20h), une entrée par jour
• Connexion Graph API : Données directes depuis Facebook

---

📱 Mobile First

L'application est conçue pour fonctionner aussi bien sur mobile que sur desktop.

• Interface adaptative : Chaque page possède sa version mobile dédiée
• Création mobile : Posts, Reels, et planification accessibles depuis le téléphone
• Caméra intégrée : Enregistrement photo/vidéo via la webcam du téléphone
• Gestion complète : Pages, analytics, médias, et paramètres depuis n'importe quel écran

---

�️ Sécurité & Administration

Architecture Production-Ready avec sécurité renforcée.

Fonctionnalité	Détail
Authentification	Passport.js + bcrypt, sessions PostgreSQL
Rate Limiting	100 req/15min global, 5 tentatives login/15min
Headers de sécurité	Helmet (CSP, HSTS, XSS protection)
Chiffrement des tokens	Tokens Facebook/Instagram chiffrés (AES-256)
Gestion multi-utilisateurs	Rôles Admin / User, permissions par page
Console SQL	Requêtes directes en base (admin uniquement)
Auto-healing tokens	Détection et renouvellement automatique des tokens
CRON jobs	Vérification quotidienne des tokens + analytics

---

🏗️ Architecture Technique

socialflow/
├── client/                    # Frontend React (Vite + TailwindCSS)
│   └── src/
│       ├── pages/             # 17 pages desktop + 13 pages mobile
│       ├── components/        # 47 composants UI (Radix/shadcn)
│       └── hooks/             # Hooks React personnalisés
├── server/                    # Backend Express.js (TypeScript)
│   ├── routes.ts              # 45+ endpoints REST API
│   ├── routes/                # Routes modulaires (analytics, reels)
│   ├── services/              # 12 services métier
│   │   ├── analytics.ts       # Sync Facebook Graph API
│   │   ├── facebook.ts        # Publication Facebook/Instagram
│   │   ├── openrouter.ts      # Génération texte IA
│   │   ├── cloudinary.ts      # Upload cloud médias
│   │   ├── ffmpeg.ts          # Encodage vidéo (microservice)
│   │   ├── freesound.ts       # Musique libre de droits
│   │   ├── jamendo.ts         # Musique libre de droits
│   │   ├── imageProcessor.ts  # Traitement images (Sharp)
│   │   ├── scheduler.ts       # Publications programmées
│   │   └── token_manager.ts   # Gestion tokens OAuth
│   └── cron.ts                # Tâches planifiées
├── shared/                    # Schéma DB partagé (Drizzle ORM)
├── ffmpeg-service/            # Microservice FFmpeg (Python/FastAPI)
├── docker-compose.yml         # Stack Docker (3 services)
└── Dockerfile                 # Image production Node.js

Stack Technique

Couche	Technologies
Frontend	React 18, Vite, TailwindCSS, Radix UI, Recharts, Framer Motion, Wouter
Backend	Express.js, TypeScript, Passport.js, Helmet, node-cron
BDD	PostgreSQL 16, Drizzle ORM, connect-pg-simple (sessions)
IA	OpenRouter (multi-modèle : GPT-4, Claude, Gemini, etc.)
Médias	Cloudinary (upload), Sharp (images), FFmpeg microservice (vidéo)
Musique	FreeSound API, Jamendo API
Réseaux	Facebook Graph API v19 (Pages, Instagram, Insights)
Infra	Docker Compose, Nginx reverse proxy

---

🚀 Installation Rapide

Prérequis

• Docker & Docker Compose
• Node.js v18+ (pour le développement local)

1. Récupérer l'application

git clone https://github.com/R0m1k3/Socialflow.git
cd socialflow

2. Configurer l'environnement

cp .env.example .env
# Éditez .env avec vos clés API

Variables essentielles :

# Base de données
DATABASE_URL=postgresql://socialflow:changeme@postgres:4523/socialflow

# Session (OBLIGATOIRE en production) — openssl rand -hex 32
SESSION_SECRET=votre-cle-secrete-ici
ENCRYPTION_KEY=votre-cle-chiffrement-32-bytes

# IA — https://openrouter.ai/
OPENROUTER_API_KEY=votre-cle-openrouter

# Réseaux Sociaux (optionnel, configurable depuis les Paramètres)
FACEBOOK_APP_ID=...
FACEBOOK_APP_SECRET=...

3. Lancer

# Production (Docker)
docker-compose up -d

# Développement local
npm install
npm run dev

🚀 Rendez-vous sur http://localhost:5555 pour commencer !

Premier lancement : Un compte admin est créé automatiquement (admin / admin). Changez le mot de passe immédiatement dans les Paramètres.

---

📖 Documentation Détaillée

Consultez le Guide d'Installation Complet pour :

• Configuration Nginx reverse proxy
• Certificats SSL (Let's Encrypt)
• Configuration Cloudinary et FreeSound
• Mise à jour et sauvegardes

---

Fait avec ❤️ pour les créateurs de contenu.