Aller au contenu

Sous le capot

Comment ce site est construit.

Un portfolio doit prouver des compétences, pas seulement les lister. Voici l'architecture, les garde-fous de l'assistant IA et les vérifications exécutées à chaque modification.

(01)AI

L'assistant IA, étape par étape

  1. (01)

    Recherche locale instantanée

    Chaque projet, expérience et formation est indexé dans le navigateur. Taper dans la palette ⌘K classe les résultats immédiatement, sans appel réseau ni IA.

  2. (02)

    Génération ancrée dans les faits

    Pour une vraie question, le serveur envoie tout le portfolio comme contexte à un modèle Mistral à faible température (0,2). Le prompt interdit d'inventer chiffres, entreprises ou dates.

  3. (03)

    Garde-fous

    Les questions sont limitées à 400 caractères, l'historique à 6 messages, les réponses à 400 tokens. Chaque IP est limitée à 15 requêtes par 10 minutes et l'appel amont expire après 25 secondes. Les instructions cachées dans une question sont ignorées.

  4. (04)

    Dégradation maîtrisée

    Si la clé IA est absente, le quota atteint ou le fournisseur en panne, l'assistant bascule sur les résultats de la recherche locale au lieu d'afficher une erreur.

(02)Stack

Choix d'architecture

  • Statique d'abord

    Next.js 16, React 19 et Tailwind CSS 4. Les pages sont pré-rendues au build ; seul l'assistant est dynamique.

  • Contenu en données

    Projets, expériences et profil sont des fichiers YAML typés édités via Keystatic. Chaque modification est un commit Git : le contenu a un historique complet.

  • Bilingue par conception

    Anglais à la racine, français sous /fr avec des URL traduites, alternates hreflang et sitemap pour les deux langues.

  • Lisible aussi par les machines

    llms.txt et llms-full.txt exposent le portfolio aux robots IA ; les données structurées (JSON-LD) décrivent chaque page aux moteurs de recherche.

(03)CI

Vérifications à chaque modification

  • ESLint avec les règles Next.js
  • Vérification de types TypeScript stricte
  • Build de production complet (toutes les pages dans les deux langues)
  • Bases d'accessibilité : lien d'évitement, états de focus, prise en charge de reduced-motion, contrôles étiquetés