Case Study Technique

Kuruma.fr

Plateforme E-commerce Automobile avec Agent IA & WhatsApp

Un projet full-stack complet : design, front-end, back-end, admin panel sécurisé, agent IA conversationnel et intégration WhatsApp temps réel.

14

Jours

de développement

13+

API Routes

back-end

15+

Composants

React/TypeScript

2FA

Sécurité

enterprise-grade

1

Dev

moi !

Kuruma.fr - Interface du site
🎨 Design Premium

Interface sombre élégante, responsive et optimisée UX

🔍 Filtres Avancés

Recherche par marque, prix, année en temps réel

🤖 Agent IA

Assistant GPT-4 intégré avec bridge WhatsApp

Stack Technique

Technologies Utilisées

Front-end

Next.js 16 - App Router + Server Components
React 19 - Dernière version avec Suspense
TypeScript - Typage strict pour fiabilité
TailwindCSS - Design system responsive

Back-end

PostgreSQL - Base de données relationnelle
Prisma ORM - Migrations + type-safe queries
NextAuth.js - Authentification + sessions
API Routes - 13+ endpoints REST

Intelligence Artificielle

OpenAI GPT-4o-mini - Modèle conversationnel
Function Calling - 5 agents autonomes
WhatsApp Web.js - Bot messaging automatisé
Bridge temps réel - Web ↔ WhatsApp

Sécurité

2FA TOTP - Google/Microsoft Authenticator
Rate Limiting - Protection anti-abuse
Zod + Sanitize - Validation XSS
RGPD Article 30 - Logs d'accès aux données

Fonctionnalités

Ce que j'ai développé

Site Public

  • Page d'accueil avec catalogue
  • Filtres de recherche avancés
  • Pages véhicules détaillées
  • Carrousel d'images
  • Formulaire de contact
  • Design responsive

Agent IA

  • GPT-4o-mini intégré
  • Recherche de véhicules
  • Calcul de financement
  • Enregistrement leads
  • Planification essais
  • Mode hybride IA/Humain

Bot WhatsApp

  • Connexion QR code
  • Réponses automatiques
  • Bridge web temps réel
  • API sécurisée
  • Mode whitelist
  • Historique conversations

Admin Panel

  • Dashboard statistiques
  • CRUD véhicules complet
  • Gestion contacts/leads
  • CMS contenu du site
  • Interface webchat
  • Paramètres avancés

Sécurité

  • Auth 2FA obligatoire
  • Rate limiting par endpoint
  • Validation Zod stricte
  • Protection XSS
  • HTTPS forcé
  • Logs RGPD

Base de données

  • 9 modèles Prisma
  • Relations complexes
  • Migrations auto
  • Logs d'accès
  • Conversations stockées
  • Backup JSON

Focus Technique

Agent IA Conversationnel

Un agent IA autonome capable d'interagir avec la base de données, rechercher des véhicules, calculer des financements et enregistrer des prospects automatiquement.

🔍 search_cars

"Je cherche une BMW entre 20k et 30k€" → Recherche intelligente dans la BDD

💰 calculate_financing

"Combien par mois sur 60 mois ?" → Calcul mensualité avec taux

📝 create_lead

Capture automatique nom, email, téléphone → Enregistrement en BDD

🚗 schedule_test_drive

"Je veux essayer cette voiture demain" → Planification automatique

Mode Hybride Intelligent

9h-19h : Mode Bridge

Messages envoyés directement sur WhatsApp du propriétaire. Réponse humaine en temps réel.

19h-9h : Mode IA

GPT-4o-mini prend le relais automatiquement. Disponible 24/7.

Architecture

Structure du Projet

kuruma-project/
├── app/
│   ├── api/                  # 13+ routes API
│   │   ├── auth/             # NextAuth + 2FA
│   │   ├── cars/             # CRUD véhicules
│   │   ├── chat/             # Agent IA
│   │   ├── contacts/         # Gestion contacts
│   │   ├── webchat/          # Bridge WhatsApp
│   │   └── ...
│   ├── sp-admin-secure/      # Admin panel
│   │   ├── dashboard/
│   │   ├── cars/
│   │   ├── contacts/
│   │   ├── security/         # Config 2FA
│   │   └── webchat/
│   └── cars/[id]/            # Pages véhicules
├── components/               # 15+ composants
├── lib/                      # Services
│   ├── auth.ts
│   ├── rate-limiter.ts
│   ├── validation.ts
│   └── prisma.ts
├── prisma/
│   └── schema.prisma         # 9 modèles
└── whatsapp-bot/
    └── server.js             # Bot autonome

9 Modèles Prisma

UserCarContactContentWhatsAppConversationWhatsAppMessageWebChatConversationWebChatMessageDataAccessLog

Dépendances Clés

next@16react@19prisma@6next-auth@4openai@4whatsapp-web.jszod@3speakeasybcryptjssanitize-htmlexpress@5qrcode

Rate Limiting

API Générale50 req/min
Chat20 req/min
Auth5 req/15min
Upload20 req/5min

Résultats

Ce que ce projet démontre

Rapidité d'exécution

Projet complet livré en 14 jours avec toutes les fonctionnalités

🏗️

Architecture Pro

Code modulaire, typé, testable et maintenable

🤖

IA Avancée

Agent avec function calling et mode hybride

🔐

Sécurité Enterprise

2FA, rate limiting, validation, RGPD

Vous voulez un projet similaire ?

Site vitrine, e-commerce, SaaS, agent IA... Je peux créer votre projet sur-mesure.