Faire de la preuve un objet du produitMaking proof an object of the product
La promesse de djplays n'est pas qu'un DJ a aimé un titre, c'est qu'il l'a joué et que ça se vérifie. Ce que cette nuance impose au code.The djplays promise is not that a DJ liked a track, it is that a DJ played it and that this can be checked. What that distinction forces on the code.
« Ton inédit, joué par de vrais DJs. Et tu as la preuve. » C’est la baseline de djplays, et c’est sa troisième phrase qui a coûté le plus cher. Les deux premières décrivent un service, et un service se raconte. La troisième engage la plateforme sur un fait, et un fait ne se raconte pas : il se vérifie, donc il se code.Your unreleased track, played by real DJs. And you have the proof. That is the djplays tagline, and its third sentence is the one that cost the most. The first two describe a service, and a service can be narrated. The third commits the platform to a fact, and a fact cannot be narrated: it gets checked, so it gets coded.
La différence entre les deux promesses paraît mince en réunion et elle est énorme dans le schéma de base. Un DJ a aimé ton titre est un avis : ça se stocke dans un champ texte et personne ne peut le contredire. Un DJ a joué ton titre est un événement daté, rattaché à un lieu ou à un canal, et attribuable à quelqu’un. Tout le produit tient dans cet écart.The difference between those two promises looks thin in a meeting and it is enormous in the database schema. A DJ liked your track is an opinion: it goes into a text field and nobody can contradict it. A DJ played your track is a dated event, attached to a venue or a channel, and attributable to someone. The whole product sits in that gap.
Pourquoi la promesse ne pouvait pas être un avisWhy the promise could not be an opinion
Le problème de départ est celui que le site énonce lui-même : un DJ reçoit cinquante promos par jour et n’en répond aucune. Ce n’est pas de la grossièreté, c’est de l’arithmétique. djplays paie le DJ pour écouter, ce qui change la nature de l’échange : la réponse n’est plus une faveur, c’est une prestation.The starting problem is the one the site states itself: a DJ receives fifty promos a day and answers none of them. That is not rudeness, it is arithmetic. djplays pays the DJ to listen, which changes the nature of the exchange: the reply is no longer a favour, it is a service rendered.
Mais payer pour un avis crée aussitôt un autre problème. Un avis acheté ne vaut rien si rien ne le distingue d’un avis de complaisance, et le producteur qui paie sait très bien poser la question. La seule sortie que j’ai trouvée est de déplacer la promesse d’un cran : non plus ce que le DJ pense du titre, mais ce qu’il en a fait.But paying for an opinion immediately creates another problem. A bought opinion is worth nothing if nothing distinguishes it from a courtesy opinion, and the producer paying for it knows perfectly well to ask. The only way out I found is to move the promise up one notch: no longer what the DJ thinks of the track, but what the DJ did with it.
Trente secondes réellement écoutéesThirty seconds actually listened to
Première conséquence, et la plus visible : le formulaire de réponse ne se déverrouille qu’après trente secondes d’écoute. Pas trente secondes passées sur la page, pas une case à cocher qui affirme que le titre a été écouté. Trente secondes du titre, effectivement jouées. C’est une ligne de spécification et c’est un chantier technique, parce que la plateforme doit savoir ce qui a été écouté au lieu de croire ce qui est déclaré.First consequence, and the most visible one: the reply form only unlocks after thirty seconds of listening. Not thirty seconds spent on the page, not a tick box claiming the track has been listened to. Thirty seconds of the track, actually played. It is one line of specification and it is a piece of engineering, because the platform has to know what was listened to instead of believing what is declared.
S’y ajoute un minimum de deux lignes dans la réponse. Celle-là est facile à écrire, et c’est précisément ce qui la rend instructive : des deux contraintes affichées au même endroit de l’écran, l’une tient en une comparaison de longueur, l’autre impose de suivre un état côté serveur. Une promesse produit ne dit jamais ce qu’elle coûte à tenir, et deux lignes voisines dans une interface peuvent appartenir à deux mondes différents.On top of that sits a minimum of two lines in the reply. That one is easy to write, and that is exactly what makes it instructive: of the two constraints shown in the same place on screen, one comes down to a length comparison, the other requires tracking state on the server. A product promise never says what it costs to keep, and two neighbouring lines in an interface can belong to two different worlds.
Ce qui compte comme preuve, et qui la vérifieWhat counts as proof, and who verifies it
Le passage, lui, ne se mesure pas depuis la plateforme : il a lieu ailleurs, dans un club, sur un flux, à la radio. Il faut donc décider à l’avance ce qui est recevable, et la liste est courte.The play itself cannot be measured from the platform: it happens elsewhere, in a club, on a stream, on the radio. So what is admissible has to be decided in advance, and the list is short.
- Un extrait, une tracklist ou un lien de mix. Trois formes, pas un champ libre.An excerpt, a tracklist or a link to a mix. Three forms, not a free-text field.
- Un canal, pris parmi ceux que la plateforme reconnaît : Twitch, radio, club et bar, Mixcloud et SoundCloud, YouTube, festival.A channel, taken from those the platform recognises: Twitch, radio, club and bar, Mixcloud and SoundCloud, YouTube, festival.
- Une date et une heure, parce qu’un passage sans moment n’est pas un événement.A date and a time, because a play with no moment is not an event.
- Une audience, qui dit devant combien de personnes le titre est passé.An audience figure, which says how many people the track was played to.
Le choix d’une liste fermée plutôt que d’un champ libre est le genre de décision qu’on regrette pendant trois semaines et qu’on remercie ensuite. Un champ libre accepte tout, donc il n’accepte rien de comparable : impossible d’afficher un canal, de regrouper par type, de refuser proprement une preuve insuffisante. Avec trois formes et six canaux, chaque preuve arrive dans un moule, et c’est ce moule qui rend la vérification faisable par quelqu’un qui n’a pas assisté au passage.Choosing a closed list rather than a free-text field is the kind of decision you regret for three weeks and thank yourself for afterwards. A free-text field accepts everything, so it accepts nothing comparable: no way to display a channel, group by type, or cleanly reject an insufficient piece of proof. With three forms and six channels, every piece of proof arrives in a mould, and it is that mould that makes verification feasible for someone who was not at the play.
Une preuve déposée n’est pas une preuve acceptée. L’équipe la vérifie sous quarante-huit heures, à la main. Il n’y a aucune magie derrière ce délai : c’est un engagement d’exploitation, et il se traduit dans le code par une file d’attente, des états successifs et un écran d’administration. Le produit promet un délai humain, donc le code doit rendre ce délai tenable un jour de semaine ordinaire.A submitted piece of proof is not an accepted one. The team checks it within forty-eight hours, by hand. There is no magic behind that deadline: it is an operational commitment, and in the code it translates into a queue, successive states and an admin screen. The product promises a human deadline, so the code has to make that deadline sustainable on an ordinary weekday.
Je tiens à ce que ce soit une personne. Un lien de mix peut mener à un set où le titre ne figure pas, une tracklist peut être copiée, une capture peut être ancienne. Le jour où il faudra aller plus vite, on accélérera le tri, jamais la décision : la valeur de la promesse vient de ce qu’un refus est possible. Une vérification qui accepte tout n’est pas une vérification, c’est un enregistrement.I want it to be a person. A link to a mix can lead to a set the track is not in, a tracklist can be copied, a screenshot can be old. The day we need to go faster, we will speed up the triage, never the decision: the value of the promise comes from the fact that a refusal is possible. A verification that accepts everything is not a verification, it is a recording.
Un passage invérifiable n'est jamais facturéAn unverifiable play is never invoiced
C’est la règle qui relie la promesse à l’argent, et c’est celle qui rassure le producteur. La facturation suit la preuve et pas l’inverse : une facture par DJ et par commande pour l’écoute, puis une facture par passage prouvé. Pas de preuve acceptée, pas de facture de passage. Le producteur ne paie donc jamais pour un passage dont il ne peut pas voir la trace.That is the rule connecting the promise to the money, and the one that reassures the producer. Invoicing follows the proof and not the other way round: one invoice per DJ per order for the listen, then one invoice per proven play. No accepted proof, no play invoice. So the producer never pays for a play whose trace cannot be seen.
Cette règle a une conséquence que je n’avais pas vue venir : elle interdit de recalculer quoi que ce soit après coup. Chaque commande fige son palier et tous ses montants au moment où elle est passée, et un changement de prix, de palier ou de grille ne revient jamais sur une commande antérieure. Une facture doit dire ce qui était vrai le jour de la commande, pas ce qui est vrai aujourd’hui, sinon la preuve et la facture finissent par raconter deux histoires différentes du même passage.That rule has a consequence I had not seen coming: it forbids recalculating anything after the fact. Every order freezes its tier and all of its amounts at the moment it is placed, and a change of price, tier or rate card never goes back over an earlier order. An invoice has to state what was true on the day of the order, not what is true today, otherwise the proof and the invoice end up telling two different stories about the same play.
Même logique pour ce qui est imprimé : chaque facture conserve en JSON tout ce qui apparaît dessus, identités comprises, de sorte qu’une correction faite plus tard dans un profil ne réécrit pas un document déjà émis. Et en bêta, sans clé de paiement, les factures sont émises quand même, avec la mention bêta, non due. Faire tourner le circuit à vide n’est pas une coquetterie : c’est le seul moyen de savoir qu’il tournera le jour où il y aura de l’argent dedans.Same logic for what gets printed: every invoice keeps in JSON everything appearing on it, identities included, so that a correction made later in a profile does not rewrite a document already issued. And in beta, with no payment key, invoices are still issued, carrying a beta, not due note. Running the circuit empty is not an affectation: it is the only way to know it will run on the day there is money in it.
Sept jours, puis le crédit revient tout seulSeven days, then the credit comes back on its own
Le DJ a sept jours pour répondre. Sans réponse, le crédit du producteur revient automatiquement. C’est la ligne la plus courte du parcours et la plus chère du lot, parce que le mot automatiquement ne désigne pas une intention : il désigne du code qui tourne sans personne devant, la nuit, le dimanche, et pendant mes vacances.The DJ has seven days to answer. With no answer, the producer credit comes back automatically. It is the shortest line in the journey and the most expensive of the set, because the word automatically does not denote an intention: it denotes code running with nobody watching, at night, on Sundays, and while I am on holiday.
Concrètement, il faut un horodatage par envoi, une tâche qui passe régulièrement, un état de retour franc et une tâche capable d’être relancée sans rendre deux fois le même crédit. Une plateforme peut tenir cette promesse à la main pendant quelques semaines ; elle ne peut pas la tenir à la main indéfiniment, et une promesse qu’on ne tient que quand on y pense n’en est pas une.In practice you need a timestamp per submission, a task that runs regularly, a clear-cut return state and a task that can be re-run without refunding the same credit twice. A platform can keep that promise by hand for a few weeks; it cannot keep it by hand indefinitely, and a promise kept only when you remember it is not a promise.
Une promesse qu’on ne sait pas vérifier dans le code n’est pas une promesse, c’est une intention. Toute la différence tient à ce qu’un tiers puisse la contredire.A promise you cannot check in the code is not a promise, it is an intention. The whole difference is whether a third party could contradict it.
Le badge, bout de la chaîneThe badge, the end of the chain
Au bout du parcours, il y a un jeton public et une adresse courte sous /b/. Chaque passage y est listé et cliquable, et la page ne demande aucun compte. C’est le dernier maillon, et c’est celui qui donne leur sens à tous les autres : la preuve doit rester consultable par quelqu’un qui n’a rien à voir avec la plateforme.At the end of the journey there is a public token and a short address under /b/. Every play is listed there and clickable, and the page asks for no account. It is the last link, and it is the one giving all the others their point: the proof has to stay viewable by someone with no connection to the platform.
C’est aussi la contrainte la plus inconfortable, parce qu’elle retire à la plateforme le droit d’être crue sur parole. Un producteur qui envoie son badge à un label expose djplays autant que lui-même : si un passage listé ne tient pas, c’est la plateforme qui l’a validé. Publier la preuve, c’est accepter d’être contredit en public, et c’est exactement ce qui rend le badge utile à celui qui le montre.It is also the most uncomfortable constraint, because it takes away the platform right to be taken at its word. A producer sending the badge to a label exposes djplays as much as himself: if a listed play does not hold up, it is the platform that approved it. Publishing the proof means accepting public contradiction, and that is exactly what makes the badge useful to whoever shows it.
Autour du jeton, il y a le widget : une image, une iframe ou un PNG, à coller sur un site, un Linktree ou un presskit, et qui se met à jour tout seul à chaque nouveau passage. Proposer trois formats n’est pas un luxe, c’est la seule façon d’entrer partout, y compris là où on ne peut coller qu’une image sans aucun code.Around the token sits the widget: an image, an iframe or a PNG, to paste on a site, a Linktree or a press kit, updating itself with every new play. Offering three formats is not a luxury, it is the only way to fit everywhere, including the places where only an image can be pasted, with no code at all.
Les visuels sont dessinés par le serveur avec GD, en trois tailles : story en 1080 par 1920, carré en 1080 par 1080, et 1200 par 630 pour le partage. Le texte est vectoriel, avec deux polices embarquées dans le projet. Je les dessine moi-même pour la même raison que le reste du site : une preuve dont l’image dépend d’un service extérieur devient indisponible le jour où ce service change d’avis.The visuals are drawn by the server with GD, in three sizes: story at 1080 by 1920, square at 1080 by 1080, and 1200 by 630 for sharing. The text is vector text, with two fonts shipped inside the project. I draw them myself for the same reason as the rest of the site: proof whose image depends on an outside service becomes unavailable the day that service changes its mind.
Un avis subsiste quand même, et il reste à sa place : le DJ donne une note sur cinq étoiles avec sa réponse, et un badge indiquant que djplays a validé apparaît à partir de quatre étoiles. Les deux objets cohabitent sans se mélanger. L’étoile dit ce qu’un DJ a pensé ; le passage dit ce qu’il a fait. Les confondre ferait retomber le produit dans la promesse qu’il cherchait justement à quitter.An opinion does survive, and it stays in its place: the DJ gives a rating out of five stars with the reply, and a badge stating that djplays has validated appears from four stars up. The two objects coexist without mixing. The star says what a DJ thought; the play says what a DJ did. Confusing them would drop the product back into the very promise it was trying to leave.
Ce que ça coûteWhat it costs
Chaque règle de la promesse est devenue un état de plus en base, une table de plus, un cas d’erreur de plus à écrire : les preuves d’un côté, les passages facturés de l’autre, et une facturation qui ne se déclenche qu’après la vérification. Rien de tout cela ne se voit sur la page d’accueil, et tout cela se paie en temps de développement. La plateforme est en accès anticipé, donc rien n’est encore éprouvé à grande échelle, et je préfère l’écrire que le laisser croire.Every rule of the promise became one more state in the database, one more table, one more error case to write: proofs on one side, invoiced plays on the other, and invoicing triggered only after verification. None of this shows on the home page, and all of it is paid for in development time. The platform is in early access, so nothing has been proven at scale yet, and I would rather write that down than let it be assumed.
Ce que je retiens vaut au-delà de ce projet. Quand une promesse commerciale contient le mot preuve, il faut la lire comme une spécification technique et la chiffrer comme telle. Si on ne sait pas dire qui vérifie, sous quel délai, dans quel moule, ce qui arrive quand la vérification échoue et qui peut aller regarder ensuite, alors la promesse n’est pas encore écrite : elle est seulement annoncée.What I take from it goes beyond this project. When a commercial promise contains the word proof, it should be read as a technical specification and costed as one. If you cannot say who verifies, within what deadline, in what mould, what happens when verification fails and who can go and look afterwards, then the promise is not yet written: it is only announced.
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
Sécuriser WordPress sans extension de sécuritéSecuring WordPress without a security plugin
Lire la noteRead the note 20 November 202620 November 2026Neutraliser une extension qui plante sans la désinstallerDisabling a crashing plugin without uninstalling it
Lire la noteRead the note 19 November 202619 November 2026Thème sur mesure ou thème acheté : le vrai calculCustom theme or bought theme: the real maths
Lire la noteRead the noteVoir les projets que j'ai réalisésSee the projects I have built · Comment je travailleHow I work · Ce qu'en disent mes clientsWhat my clients say