Aller au contenu principal

🚀 Démarrage rapide

Ce guide vous permet d'avoir BlocMail & BlocNumEtSMS fonctionnel en moins de 10 minutes.

Prérequis​

OutilVersion minimaleVérification
Node.js≥ 18 LTSnode --version
npm≥ 9npm --version
Gittoute version récentegit --version
Compte Supabasegratuitsupabase.com

Installation en 4 étapes​

Étape 1 — Cloner le dépôt​

git clone https://github.com/seb001/lovable-dev-hub.git
cd lovable-dev-hub

Étape 2 — Installer les dépendances​

npm install

Étape 3 — Configurer l'environnement​

cp .env.example .env

Ouvrez .env et renseignez vos clés Supabase (disponibles dans Dashboard Supabase > Settings > API) :

VITE_SUPABASE_URL=https://votre-projet.supabase.co
VITE_SUPABASE_PUBLISHABLE_KEY=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

Étape 4 — Lancer en développement​

npm run dev

L'application est accessible sur http://localhost:8080

Première utilisation​

Analyser un email suspect​

  1. Rendez-vous sur Mail Analyseur (/analyzer)
  2. Copiez les en-têtes bruts de votre email suspect depuis votre client mail
  3. Collez-les dans la zone de texte
  4. Cliquez Lancer l'analyse
  5. Observez les 8 étapes d'analyse en temps réel (SSE)

Le résultat vous indique :

  • ✅ / ❌ SPF · DKIM · DMARC
  • Score de 0 à 100 (0 = sûr, 100 = très dangereux)
  • Patterns détectés avec explications

Vérifier un numéro de téléphone​

  1. Rendez-vous sur BlocNum Analyseur (/phone-checker)
  2. Saisissez un numéro (formats acceptés : 0612345678, +33612345678, 06 12 34 56 78)
  3. Cliquez Vérifier
  4. Le résultat affiche le statut ARCEP, l'opérateur et les patterns correspondants

Extraire les en-têtes depuis Gmail​

Email ouvert → ⋮ (trois points) → "Afficher l'original" → Copier tout

Extraire les en-têtes depuis Outlook​

Email ouvert → Fichier → Propriétés → En-têtes Internet → Copier tout

Configuration optionnelle​

Clés API de réputation (recommandé)​

Dans Paramètres (/settings) > section Clés API, vous pouvez activer :

ServiceUtilitéGratuit jusqu'à
IPQualityScoreScore de fraude IP (0-100), VPN/Proxy/Tor5 000 req/mois
AbuseIPDBRéputation IP (signalements communautaires)1 000 req/jour
VirusTotalDétection malveillante par 70+ antivirus4 req/min

Webhooks n8n / Make.com​

Dans Paramètres > section Webhooks :

  1. Collez votre URL webhook n8n ou Make.com
  2. Cliquez OK pour sauvegarder
  3. Toute analyse déclenchera automatiquement le webhook

Activer Google OAuth​

Dans votre projet Supabase :

  1. Authentication > Providers > Google
  2. Activez et renseignez Client ID + Secret Google
  3. Ajoutez l'URL de callback autorisée

Scripts disponibles​

npm run dev        # Serveur de développement (port 8080)
npm run build      # Build production
npm run build:dev  # Build sans minification
npm run preview    # Prévisualisation du build (port 4173)
npm run lint       # ESLint

# Régénérer les patterns spam (optionnel)
node scripts/extract-spam-patterns.cjs --source=all

Structure du projet (résumé)​

lovable-dev-hub/
├── src/
│   ├── pages/          # 10 pages (Home, Analyzer, Dashboard...)
│   ├── components/     # 7 composants métier + 40+ shadcn/ui
│   ├── hooks/          # 6 hooks React
│   ├── data/           # 4 fichiers JSON patterns spam
│   ├── lib/            # credits.ts + utils.ts
│   └── integrations/   # Client Supabase + AuthProvider
├── supabase/
│   ├── functions/      # 5 Edge Functions Deno
│   └── migrations/     # SQL schéma + RLS
├── docs/               # Documentation source
└── scripts/            # Scripts utilitaires

Vérifier que tout fonctionne​

Après npm run dev, vérifiez ces points :

  • Page d'accueil accessible sur http://localhost:8080
  • Connexion / inscription fonctionne (/auth)
  • Mail Analyseur affiche la zone de saisie (/analyzer)
  • BlocNum Analyseur affiche le champ numéro (/phone-checker)
  • Compteur de crédits affiché (5/5 au départ)
  • Page Aide accessible avec 5 onglets (/aide)

Dépannage rapide​

ProblèmeSolution
VITE_SUPABASE_URL manquantVérifier le fichier .env à la racine
Page blanche après loginVérifier les URL de redirection dans Supabase Auth
Analyse qui échoueVérifier que les Edge Functions sont déployées
Crédits à 0Reset automatique à minuit UTC, ou vider localStorage

Pour un dépannage approfondi : TROUBLESHOOTING.md

Étapes suivantes​

Temps estimé pour cette mise en route : 5-10 minutes