mirror of
https://github.com/R0m1k3/Socialflow.git
synced 2026-10-11 17:26:45 +02:00
227 lines
9.0 KiB
Markdown
227 lines
9.0 KiB
Markdown
# 🚀 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](https://www.docker.com/) & Docker Compose
|
||
- [Node.js](https://nodejs.org/) v18+ (pour le développement local)
|
||
|
||
### 1. Récupérer l'application
|
||
|
||
```bash
|
||
git clone https://github.com/R0m1k3/Socialflow.git
|
||
cd socialflow
|
||
```
|
||
|
||
### 2. Configurer l'environnement
|
||
|
||
```bash
|
||
cp .env.example .env
|
||
# Éditez .env avec vos clés API
|
||
```
|
||
|
||
Variables essentielles :
|
||
|
||
```env
|
||
# 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
|
||
|
||
```bash
|
||
# 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](INSTALLATION.md) 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.*
|