App de prospection B2B automatisée pour les acteurs pétroliers Afrique

CONTENU DU DOCUMENT
Section 01 — Contexte et Objectifs

Présentation événement (Journées Pétrole 2026)
Problématique actuelle (prospection manuelle inefficace)
Solution proposée (4 agents IA)
Objectifs quantitatifs (500+ entreprises, taux réponse >15%)
Utilisateurs cibles

Section 02 — Spécifications Fonctionnelles

Module 1 : Base de données (import CSV, scraping, recherche, filtres, déduplication)
Module 2 : 4 Agents IA détaillés (Intelligence, Rédaction, Orchestration, Analyse NLP)
Module 3 : Dashboard (5 écrans : Home, Entreprises, Fiche détail, Carte Afrique, Analytics)
Module 4 : Gestion réponses (inbox, qualification, actions)
Module 5 : Paramètres & Sécurité (utilisateurs, rôles, SMTP, audit log)

Section 03 — Spécifications Techniques

Stack complet : React 19 + TypeScript + Vite + TailwindCSS + FastAPI + PostgreSQL + Prisma + Redis + Google Gemini
Architecture 3-tiers : Frontend (Vercel) → Backend API (Railway) → PostgreSQL + Redis
19 endpoints API détaillés (auth, companies, agents, pipeline, responses, analytics, settings)
Schéma PostgreSQL complet (4 tables avec indexes)
Sécurité : JWT, bcrypt, HTTPS, rate limiting, CORS, SQL injection protection, RGPD
Performance : Cibles Lighthouse >90, bundle <200KB, API <500ms

Section 04 — Design et Charte Graphique

Palette couleurs : 8 couleurs définies avec hex + usage
Typographie : 7 éléments avec police, taille, style
Composants UI : Cards, boutons, badges, inputs, modals, tables, icons
Animations : Transitions, hovers, loading, toasts
Maquettes : Guidelines pour reproduire le design actuel

Section 05 — User Stories

4 parcours utilisateur complets avec critères de succès
Story 1 : Prospection automatique entreprise
Story 2 : Qualification réponse prospect
Story 3 : Analyse géographique
Story 4 : Export données reporting

Section 06 — API et Intégrations

Google Gemini API (obligatoire) : Configuration modèles, retry logic, timeout, exemples code
Service Email (obligatoire) : Resend/SendGrid, config SMTP, warm-up domaine
n8n (optionnel) : Workflow automation relances
Autres intégrations : LinkedIn, Clearbit, Slack, Google Sheets

Section 07 — Livrables Attendus

Code source (Frontend + Backend + Tests)
Documentation (README, API, Guide utilisateur, Guide admin)
Déploiement (Vercel + Railway + domaine custom)
Formation (2h équipe + 1h admin + vidéos tutoriels)

Section 08 — Critères d'Acceptation

12 tests fonctionnels obligatoires
5 tests performance (Lighthouse, bundle, API latency, DB query)
5 tests sécurité (JWT, SQL injection, XSS, API key, rate limiting)
Scénario E2E complet (Playwright)

Section 09 — Planning

Phase 0 (3j) : Setup infrastructure
Phase 1 (1 sem) : Backend Core
Phase 2 (1 sem) : Agents IA
Phase 3 (1 sem) : Frontend Core
Phase 4 (1 sem) : Features avancées
Phase 5 (1 sem) : Tests & Deploy
Total : 5 semaines