François Castets

Journal

16 November 202616 November 2026 8 min de lecturemin read Données personnelles et mesurePersonal data and measurement

Une IA qui assiste sans déciderAn AI that assists without deciding

Un DJ demande un palier et joint ses preuves d'audience. L'API Claude les lit et propose une lecture ; le palier reste validé à la main. Pourquoi cette frontière est posée dans le code, et pas dans une bonne intention.A DJ requests a tier and attaches his proof of audience. The Claude API reads it and proposes a reading; the tier is still approved by hand. Why that boundary lives in the code, rather than in a good intention.

Sur djplays, le palier d’un DJ n’est pas un titre honorifique : il fixe le plafond du prix qu’il peut demander. Pour en obtenir un, le DJ fournit des preuves d’audience — des captures d’écran de sa plateforme, des photos, parfois un PDF. Quelqu’un doit les lire, les comparer à ce qu’il déclare, et trancher.On djplays, a DJ’s tier is not an honorary title: it sets the ceiling on the price he can ask for. To get one, the DJ supplies proof of audience — screenshots from his platform, photos, sometimes a PDF. Someone has to read them, compare them with what he declares, and decide.

Ce travail de lecture est lent et répétitif, et c’est exactement le genre de tâche qu’un modèle de langue fait bien. J’ai donc branché l’API Claude d’Anthropic sur ces pièces. Mais la décision, elle, n’a jamais changé de place : le palier reste validé à la main. Cette note explique pourquoi la frontière est posée là, et comment elle tient dans le code plutôt que dans une promesse.That reading work is slow and repetitive, and it is exactly the sort of task a language model does well. So I wired the Anthropic Claude API onto those items. The decision, though, never moved: the tier is still approved by hand. This note explains why the boundary is drawn there, and how it holds in the code rather than in a promise.

Ce que le palier décideWhat the tier decides

Trois paliers, fixés d’après l’audience vérifiée : Découverte en dessous de 200, Confirmé de 200 à 2 000, Tête d’affiche au-delà. À chacun son plafond de prix pour une écoute et pour un passage prouvé, et le détail de cette grille mérite sa propre note. Ce qui compte ici, c’est la conséquence : le palier décide de ce qu’un DJ peut gagner.Three tiers, set from the verified audience: Découverte below 200, Confirmé from 200 to 2,000, Tête d’affiche above that. Each has its own price cap for a listen and for a proven play, and the detail of that grid deserves a note of its own. What matters here is the consequence: the tier decides what a DJ can earn.

Il décide aussi d’autre chose. Le classement hebdomadaire, publié chaque lundi par famille de styles, est gratuit pour les labels et pour les têtes d’affiche. Un palier n’est donc pas seulement un prix : c’est une place. Se tromper dans un sens coûte de l’argent au DJ, se tromper dans l’autre coûte la confiance du producteur qui paie.It decides something else too. The weekly ranking, published every Monday by style family, is free for labels and for headliners. So a tier is not only a price: it is a position. Getting it wrong in one direction costs the DJ money, getting it wrong in the other costs the trust of the producer who pays.

Et une erreur laisse une trace durable, parce que chaque envoi fige son palier et tous ses montants au moment de la commande. Corriger un palier plus tard ne recalcule jamais une commande passée. Ce gel est voulu, et c’est précisément ce qui rend la décision initiale lourde : elle ne se repasse pas.And a mistake leaves a lasting trace, because every send freezes its tier and all its amounts at the moment of the order. Correcting a tier later never recalculates a past order. That freeze is deliberate, and it is exactly what makes the initial decision heavy: it does not get replayed.

Pourquoi la frontière est posée avant le codeWhy the boundary is drawn before the code

Une décision qui engage de l’argent et le classement d’une personne ne se délègue pas à un modèle. Ce n’est pas une question de performance : un modèle peut avoir raison presque toujours, et c’est le cas restant qui se traduit par un DJ payé moins qu’il ne devrait, ou par un producteur qui achète une audience qui n’existe pas. Aucune de ces deux erreurs ne se répare par des excuses.A decision that commits money and a person’s standing is not delegated to a model. This is not a question of performance: a model can be right almost always, and it is the remaining case that turns into a DJ paid less than he should be, or a producer buying an audience that does not exist. Neither of those two mistakes is repaired by an apology.

L’ordre dans lequel on construit détermine qui décide vraiment. Si j’avais écrit d’abord la décision automatique, puis ajouté une relecture humaine par-dessus, cette relecture serait devenue une formalité : on valide ce qui est déjà écrit, surtout quand la pile de demandes s’allonge. En posant la validation manuelle comme le seul chemin dès la conception, l’analyse arrive là où elle doit être — avant la décision, et non à sa place.The order in which you build decides who really decides. Had I written the automatic decision first and then added a human review on top, that review would have become a formality: you approve what is already written, especially when the queue of requests grows. By making manual approval the only path from the design stage, the analysis lands where it belongs — before the decision, not instead of it.

Concrètement, l’analyse ne remplit rien et ne déclenche rien. Le palier se choisit comme il se choisissait avant qu’elle existe, et ce que le modèle a lu est posé à côté, comme une fiche de lecture. C’est une aide pour l’équipe, et jamais une décision.In practice the analysis fills nothing in and triggers nothing. The tier is chosen the way it was chosen before the analysis existed, and what the model read sits beside it, like a reading note. It is an aid for the team, and never a decision.

Un modèle qui lit une capture d’écran ne se trompe pas de façon visible : il se trompe de façon vraisemblable. C’est la pire sorte d’erreur pour une décision qui engage de l’argent, parce que rien, dans le résultat, ne signale qu’il faut aller vérifier.A model reading a screenshot does not get it wrong in a visible way: it gets it wrong in a plausible way. That is the worst kind of error for a decision that commits money, because nothing in the output signals that it needs checking.

Ce que le module rendWhat the module returns

  • La plateforme reconnue sur la pièce fournie.The platform recognised on the item supplied.
  • L’audience lue, telle qu’elle apparaît.The audience read, as it appears.
  • La cohérence entre cette lecture et ce que le DJ déclare.The consistency between that reading and what the DJ declares.
  • Un palier suggéré, qui n’est qu’une suggestion.A suggested tier, which is only a suggestion.
  • Des alertes, quand quelque chose ne va pas dans la pièce.Alerts, when something is off about the item.

La ligne qui sert le plus n’est pas le palier suggéré : c’est la cohérence et les alertes. Un chiffre qui colle à la déclaration fait gagner une minute ; un chiffre qui ne colle pas fait gagner un quart d’heure, parce qu’il dit où regarder. L’aide la plus utile du modèle, dans ce module, est de désigner le dossier qui mérite du temps.The line that helps most is not the suggested tier: it is the consistency and the alerts. A figure that matches the declaration saves a minute; a figure that does not match saves a quarter of an hour, because it says where to look. The model’s most useful contribution here is to point out the case that deserves time.

Un module qui n'existe pas tant qu'il n'est pas configuréA module that does not exist until it is configured

Tant qu’aucune clé n’est posée dans la configuration, la lecture assistée est simplement masquée. Pas un bouton grisé, pas un message d’indisponibilité : rien du tout. Un bouton grisé est une question qu’on pose à l’équipe, et une question qu’on finit par poser assez souvent devient une demande de support.As long as no key is set in the configuration, the assisted reading is simply hidden. Not a greyed-out button, not an unavailable message: nothing at all. A greyed-out button is a question put to the team, and a question asked often enough becomes a support request.

Cela a une conséquence plus importante que l’affichage : le parcours de demande de palier fonctionne de bout en bout sans l’API. Le DJ dépose ses pièces, l’équipe lit, le palier se valide. Une fonction dont l’absence casse le parcours n’est pas une option, c’est une dépendance — et une dépendance chez un tiers, c’est une part de la disponibilité du site qui ne m’appartient plus.That has a more important consequence than the display: the tier request path works end to end without the API. The DJ uploads his items, the team reads them, the tier is approved. A feature whose absence breaks the path is not an option, it is a dependency — and a third-party dependency is a share of the site’s availability that is no longer mine.

L'appel, sans rien installerThe call, with nothing installed

L’appel part en curl, directement, comme ceux vers Stripe et vers la voix off. Le site n’a aucune dépendance Composer : pas de dossier vendor, pas de composer.json. Ce choix n’est pas gratuit — c’est à moi d’écrire la requête, de lire la réponse et de traiter les erreurs de transport, ce qu’une bibliothèque officielle ferait à ma place.The call goes out through curl, directly, like the ones to Stripe and to the voice-over. The site has no Composer dependency: no vendor directory, no composer.json. That choice is not free — writing the request, reading the response and handling transport errors is on me, where an official library would do it instead.

En échange, il n’y a rien à mettre à jour, rien qui se mette en travers d’une montée de version de PHP, et aucun arbre de dépendances à auditer pour quelques appels HTTP. Le reste du site est bâti pareil : du PHP sur mesure, sans framework, en PHP 8 avec types stricts, et une base SQLite posée hors de la racine web, dont le schéma est versionné par PRAGMA user_version.In exchange there is nothing to update, nothing standing in the way of a PHP version bump, and no dependency tree to audit for a handful of HTTP calls. The rest of the site is built the same way: bespoke PHP, no framework, PHP 8 with strict types, and a SQLite database sitting outside the web root whose schema is versioned by PRAGMA user_version.

Ce qu'on envoie, et ce qu'on gardeWhat gets sent, and what gets kept

Ce que le modèle rend n’est pas affiché puis oublié : il est gardé en JSON, dans la colonne analyse_ia de la table des demandes de palier, ajoutée par la migration v32 du schéma. Une analyse par demande, et relançable.What the model returns is not displayed and then forgotten: it is kept as JSON, in the analyse_ia column of the tier requests table, added by schema migration v32. One analysis per request, and re-runnable.

Garder la donnée brute plutôt qu’un rendu mis en forme change ce qu’on peut en faire. On peut la réafficher autrement, la relire des mois plus tard, et surtout garder la trace du cas intéressant : celui où l’équipe a décidé autre chose que ce que la lecture suggérait. C’est cette trace qui permet de juger l’outil, et pas seulement de s’en servir.Keeping the raw data rather than a formatted rendering changes what can be done with it. It can be displayed differently, read back months later, and above all it keeps a record of the interesting case: the one where the team decided something other than what the reading suggested. That record is what makes the tool judgeable, instead of merely usable.

Relançable, parce que les pièces changent. Un DJ ajoute une capture, remplace un PDF illisible, et la lecture précédente ne vaut plus. Une analyse par demande signifie que la nouvelle prend la place de l’ancienne : on garde l’état courant du dossier, pas son historique.Re-runnable, because the items change. A DJ adds a screenshot, replaces an unreadable PDF, and the previous reading no longer holds. One analysis per request means the new one takes the place of the old: what is kept is the current state of the case, not its history.

Les images sont ramenées à 1 568 pixels sur le grand côté et recodées en JPEG avant l’envoi, par la même bibliothèque GD qui dessine les images partageables du site. Les PDF partent tels quels, jusqu’à 10 Mio.Images are brought down to 1,568 pixels on the long side and re-encoded as JPEG before sending, by the same GD library that draws the site’s shareable images. PDFs go as they are, up to 10 MiB.

Une capture d’écran de téléphone fait plusieurs fois la taille nécessaire pour lire un nombre. L’envoyer entière coûte du transfert et de l’analyse pour rien, et une image réduite se lit aussi bien. Le travail de réduction, lui, était déjà écrit : GD sert à dessiner les badges, donc le module n’ajoute aucun outil au projet.A phone screenshot is several times larger than needed to read a number. Sending it whole costs transfer and analysis for nothing, and a reduced image reads just as well. The shrinking work was already written: GD is there to draw the badges, so the module adds no new tool to the project.

Le plafond mensuel, garde-fou doubleThe monthly ceiling, a double guard rail

300 analyses par mois par défaut. C’est d’abord un garde-fou de coût : un appel payant est une ligne de facture, et une boucle mal écrite ou un dossier relancé en boucle transforme une erreur de code en dépense. Un plafond met une borne haute connue à ce que le module peut coûter, y compris le mois où quelque chose se passe mal.300 analyses a month by default. First and foremost it is a cost guard rail: a paid call is a line on an invoice, and a badly written loop or a case re-run over and over turns a coding mistake into spending. A ceiling puts a known upper bound on what the module can cost, including in the month when something goes wrong.

C’est ensuite un garde-fou d’usage. La plateforme est en accès anticipé : si le plafond est atteint, ce n’est probablement pas le signe qu’il faut le relever, mais qu’une demande est relancée sans fin, ou qu’un dossier sert de terrain d’essai. Un plafond qu’on déplace sans se demander pourquoi il a été touché n’est plus un garde-fou, c’est un réglage.It is also a usage guard rail. The platform is in early access: if the ceiling is reached, that is probably not a sign it should be raised, but that a request is being re-run endlessly, or that a case is being used as a testing ground. A ceiling that gets moved without asking why it was hit is no longer a guard rail, it is a setting.

Au bout, le module ne fait rien d’autre que ce qu’il annonce : il fait gagner du temps de lecture, à décision constante. S’il fallait un jour choisir entre garder l’analyse et garder la validation manuelle, je garderais la validation manuelle — et le module est écrit de façon à ce que ce choix reste possible, puisqu’il suffit de retirer la clé pour qu’il disparaisse.In the end the module does nothing beyond what it claims: it saves reading time, with the decision unchanged. If a choice ever had to be made between keeping the analysis and keeping manual approval, I would keep manual approval — and the module is written so that the choice stays available, since removing the key is enough to make it disappear.

Le projet derrière cette noteThe project behind this note

Tout est parti de djplays, la place de marché. La fiche détaille le contexte, ce qui a été construit et ce que le client en a tiré.It all started with djplays, la place de marché. The project page covers the context, what was built and what the client got out of it.

À lire ensuiteRead next