← Tous les articlesInfra et cloud

Comment j'ai construit Klickbee Tracking

Next.js, Postgres, un SDK npm et pas de file d'attente. Ce qui tient, ce qui a changé et ce qui a cassé en production.

Julien Mauclair · ~5 min · intermédiaire
StackNext.jsPostgreSQLPrismaVercelTypeScript

Klickbee Tracking est l'analytics sans cookies que je développe pour Klickbee. Le premier commit date du 25 juin 2026, et le dépôt en compte 489 au 9 novembre. L'architecture tient en trois pièces : une application Next.js qui reçoit les événements et affiche les tableaux de bord, une base Postgres, et un SDK publié sur npm. Pas de file d'attente, pas de base analytique spécialisée.

01L'architecture réelle

Le dépôt est un monorepo pnpm avec Turborepo. Les pièces principales :

·apps/web : l'application Next.js 16 avec React 19. Elle porte à la fois la réception des événements, les tableaux de bord, les tâches planifiées, la facturation et un serveur MCP pour interroger les données depuis un assistant ;
·packages/sdk : le SDK, publié sur npm sous le nom @klickbee-agency/tracking, utilisable aussi par une simple balise script ;
·packages/contracts : le schéma partagé entre le SDK et l'API, pour que les deux parlent exactement le même format.

Les événements sont écrits directement en base. Une seule transaction Prisma crée ou met à jour le visiteur, puis la session, puis insère le lot d'événements. Les doublons sont écartés grâce à un identifiant unique par message. Seules les conversions envoyées côté serveur passent par une table de travaux, vidée toutes les cinq minutes par une tâche planifiée.

La base est un Postgres managé chez Neon, à Francfort. L'application tourne sur Vercel dans la région fra1, juste à côté. Les enregistrements de sessions sont compressés et stockés dans S3.

02Ce que veut dire « sans cookies » ici

Le SDK ne pose aucun cookie. Il garde en revanche un identifiant anonyme aléatoire dans le stockage local du navigateur, renouvelé au bout de 395 jours pour rester sous la limite de 13 mois fixée par la CNIL. L'adresse IP est tronquée avant la géolocalisation et jamais stockée en entier.

Je préfère être précis sur ce point : sans cookies ne veut pas dire sans aucun identifiant côté navigateur. C'est une différence que beaucoup d'outils laissent floue.

Les cartes de chaleur sont construites à partir des clics capturés automatiquement, avec leurs coordonnées, limitées à 4 000 points par carte. Le fond de page vient de l'enregistrement de session. Les résumés et analyses par IA passent par le SDK IA de Vercel avec des modèles Claude, plafonnés à 30 appels par heure et 3 en parallèle.

03Les choix revus en route

Deux décisions ont changé très tôt. Le jour même du premier commit, toute la pile est passée aux dernières versions majeures : Next 16, React 19.2, Prisma 7. Mieux valait partir à jour que migrer plus tard avec des données en production.

Cinq jours plus tard, le 30 juin, l'application a quitté la région de Singapour pour Francfort. La base était à Francfort, et chaque requête payait l'aller-retour entre les deux continents. Comme le temps de chaque requête dépendait surtout de la base, rapprocher le calcul de la base était le choix évident.

04Les trois bugs de production qui m'ont le plus appris

Aucun n'est venu de l'architecture. Tous sont venus d'un détail de configuration.

14 septembre 2026La plupart des appels de collecte répondaient 403 en production, sans aucune trace dans les journaux
29 octobre 2026Le dernier lot d'événements de chaque page était perdu, repéré sur ce site
4 novembre 2026Aucune tâche planifiée ne s'était jamais exécutée

Le deuxième est le plus vicieux. À la fermeture d'une page, le SDK envoie son dernier lot avec sendBeacon, qui part toujours avec les identifiants du navigateur. La réponse de prévalidation CORS ne renvoyait pas l'en-tête Access-Control-Allow-Credentials, donc le navigateur jetait l'envoi sans erreur visible. Sur une visite courte, c'était souvent le seul lot.

Le troisième tient à un fichier mal placé. Le projet Vercel lit sa configuration dans apps/web, et le fichier vercel.json était à la racine du dépôt. Vercel l'ignorait sans rien dire : ni les tâches planifiées, ni les en-têtes de sécurité n'étaient appliqués. Voici l'essentiel du fichier, une fois à sa place :

apps/web/vercel.jsonTEXTCopier
{
"regions": ["fra1"],
"buildCommand": "pnpm build",
"crons": [
{ "path": "/api/internal/cron/purge", "schedule": "0 3 * * *" },
{ "path": "/api/internal/cron/conversions", "schedule": "*/5 * * * *" }
]
}

La leçon commune : une configuration ignorée ne produit pas d'erreur. Depuis, un test vérifie que le fichier est bien à l'endroit que Vercel lit. J'en parle plus largement dans mon article sur la supervision.

05Ce que ça coûte

En octobre 2026, la part Vercel de Klickbee Tracking sur la facture de l'équipe est de 1,00 $ d'utilisation, au-dessus de l'abonnement Pro partagé entre tous nos projets. La base Neon et le stockage S3 sont facturés à part. Une architecture simple sur Vercel coûte peu tant que le trafic reste raisonnable, comme je l'explique dans pourquoi Vercel pour un SaaS.

L'outil est en ligne sur tracking.klickbee.com, avec une offre gratuite jusqu'à 1 000 sessions par mois.

06Questions fréquentes

Pourquoi Postgres plutôt qu'une base analytique comme ClickHouse ?

Parce qu'à ce stade, Postgres avec de bons index suffit, et qu'une seule base est plus simple à tenir. Une base spécialisée aura du sens quand les volumes l'exigeront, pas avant.

Pourquoi pas de file d'attente pour les événements ?

Une transaction par lot, avec dédoublonnage sur un identifiant unique, couvre le besoin actuel. Seules les conversions côté serveur passent par une table de travaux, parce qu'elles appellent des services externes qui peuvent échouer.

Un analytics sans cookies est-il exempté de consentement ?

Pas automatiquement. L'exemption de la CNIL pour la mesure d'audience dépend de conditions précises, dont la durée de vie des identifiants, que le SDK respecte avec son renouvellement à 395 jours. Chaque site reste responsable de sa propre conformité.

En résumé

Klickbee Tracking tient sur une architecture volontairement simple : une app Next.js, une base Postgres et un SDK. Les vrais problèmes sont venus des détails de configuration, pas de l'architecture.

Parlons de ton projet ↗
Julien MauclairJulien Mauclair est cofondateur et CTO de Klickbee : il construit les sites, le tracking et les automatisations IA de l’agence, et développe Klickbee Tracking. Il dirige aussi Stralya, qui conçoit et tient l’infrastructure AWS de scale-ups. Avant, il a construit toute l’infrastructure AWS d’un e-commerce, revendu depuis.

À lire ensuite