CS.09, CASE STUDY · CÔTÉ SYSTÈME
Plateforme de partage communautaire
Communauté de joueurs · en binôme
CONTEXTE
La plateforme existe depuis 2018 : les joueurs d'un jeu en ligne y déposent leurs créations (décors, objets, tenues), téléchargeables gratuitement. Le site tournait sur un WordPress détourné en boutique, ses fichiers éparpillés sur un Google Drive partagé. Il fallait tout reconstruire sans casser les liens que Google et la communauté connaissaient depuis des années.
MON RÔLE
Refonte menée à deux. Mon binôme a signé la nouvelle interface, le socle Convex et l'authentification. Ma part : l'extraction et la migration des données de l'ancien site, la chaîne d'images et de fichiers, la modération des envois, la gestion des créateurs et la console d'administration.
RÉALISATIONS
- Migration WordPress vers Convex : 6 581 créations, 736 créateurs, 27 421 images et 6 664 fichiers, contrôlés à 99,9 % sur le CDN
- 1 992 redirections permanentes : fiches, catégories, créateurs et pages d'archives retombent chacune sur leur équivalent
- Chaîne d'images : réception, filigrane identique à celui des archives, stockage CDN, origine verrouillée derrière Cloudflare
- Console d'administration : file de modération, revendication de profils réversible, journal d'audit, cockpit Search Console et Analytics
CHIFFRES
6 581 créations migrées · 27 421 images · 1 992 redirections · 736 créateurs
OUTILS
- Next.js
- TypeScript
- Convex
- Bunny CDN
- Cloudflare
- Python
- sharp
CS.09.M, LES MODULES, PIÈCE PAR PIÈCE
Sous le capot
01 · Migrer sans perdre une adresse
1 992 redirections permanentes
WordPress servait une page par catégorie, par sous-catégorie et par créateur. Le nouveau site n'a qu'un catalogue piloté par ses filtres : chaque ancienne adresse devait retomber sur son équivalent, jusqu'à la page 7 ou 30 d'une archive paginée. 251 fiches avaient en plus changé d'adresse au fil des changements de pseudo de leurs auteurs. Les redirections sont générées depuis l'arbre des catégories plutôt qu'écrites à la main, ce qui garantit qu'aucune source n'apparaît deux fois.
def ajoute(source, destination):
if source in vus:
return
vus.add(source)
red.append({"source": source, "destination": destination, "permanent": True})
# Les archives de catégories étaient paginées : /page/2/, /page/7/…
# `:n` est repris tel quel côté destination, notre /browse lit ?page=.
red.append(
{
"source": f"{source}/page/:n",
"destination": f"{destination}{'&' if '?' in destination else '?'}page=:n",
"permanent": True,
}
)02 · Vérifier contre l'usage, pas contre la source
21,85 Gio poussés au lieu de 59
Mon premier export était exact : chaque total tombait juste face à la base. Il était pourtant inutilisable. En le chargeant, l'outil de mon binôme a buté en trois minutes sur 1 382 fiches, 21 % du catalogue, dont la catégorie ne se déduisait pas : je n'avais exporté qu'un niveau d'un arbre qui en compte trois. Depuis, je valide un jeu de données comme son destinataire va s'en servir, et je contrôle la forme de chaque champ, pas seulement sa présence. La même rigueur a écarté les 313 000 vignettes que WordPress avait générées et que rien ne pouvait réclamer.
03 · Un filigrane qui refuse de mentir
Les 336 543 images des archives portent un filigrane, posé après qu'un site tiers a recopié le catalogue. Chaque nouvel envoi reçoit le même, pour que l'avant et l'après refonte se ressemblent. Sauf qu'en production, l'image Docker ne contenait aucune police : le moteur de rendu dessinait un rectangle vide par lettre, sans la moindre erreur. Quatre envois sont partis comme ça jusque sur le CDN. La police est désormais embarquée dans le dépôt, et un contrôle refuse l'envoi plutôt que de tamponner pour rien.
/**
* Vérifie que le texte sort en lettres, pas en rectangles.
*
* Une police absente ne lève rien, elle dégrade en silence : c'est ce qui
* rend la panne coûteuse. Le contrôle exploite la seule signature sûre du
* glyphe manquant, à savoir qu'il est le MÊME pour tous les caractères. On
* rend « iiii » et « MMMM » : avec une vraie police les deux images n'ont
* rien à voir, sans police elles sont identiques au bit près.
*/
async function verifierPolice(): Promise<void> {
if (policeVerifiee) return;
const rendre = (texte: string) =>
sharp({
create: {
width: 200,
height: 60,
channels: 3,
background: { r: 0, g: 0, b: 0 },
},
})
.composite([
{
input: Buffer.from(
`<svg xmlns="http://www.w3.org/2000/svg" width="200" height="60"><text x="4" y="44" font-family="${POLICE}" font-size="40" font-weight="bold" fill="#fff">${texte}</text></svg>`,
),
top: 0,
left: 0,
},
])
.png()
.toBuffer();
const [etroit, large] = await Promise.all([rendre("iiii"), rendre("MMMM")]);
if (etroit.equals(large))
throw new Error(
"Filigrane : aucune police utilisable, le texte sortirait en rectangles vides. Envoi refusé plutôt que marqué pour rien.",
);
policeVerifiee = true;
}04 · Publier sans compte, valider à la main
N'importe qui peut partager une création sans s'inscrire : c'est la promesse du site. En contrepartie, chaque envoi passe par une file de modération avant publication. Côté créateurs, l'ancien site ne connaissait que des noms : une archive héritée se distingue désormais d'un vrai créateur partout où un nom s'affiche, un profil peut être revendiqué, et une fusion de profils s'annule proprement si elle était une erreur. Chaque action de la console laisse une trace dans un journal d'audit.
05 · Le cockpit Search Console
La console d'administration lit directement Search Console et Analytics. Un taux de clic nu ne dit rien : 4,2 % est mauvais en 2ᵉ position et excellent en 14ᵉ. Le cockpit compare donc chaque page à ce qu'elle devrait obtenir à sa position et désigne celles dont le titre ne donne pas envie de cliquer, le seul levier qui se corrige en dix minutes.
/** Index 0 = 1ʳᵉ place. Fractions, pas pourcentages. */
export const CTR_ATTENDU: readonly number[] = [
0.276, 0.156, 0.104, 0.078, 0.061, 0.049, 0.04, 0.033, 0.028, 0.024,
];
/** Au delà de la 10ᵉ place, décroissance douce plutôt qu'un mur à zéro : la
* 2ᵉ page rapporte peu mais pas rien, et c'est justement là que se trouvent
* les pages à pousser. */
const DECROISSANCE = 0.87;
/**
* CTR qu'on attendrait à cette position.
*
* Search Console rend des positions fractionnaires (6,4), moyenne pondérée de
* plusieurs journées : on interpole entre les deux paliers plutôt que
* d'arrondir, sinon deux pages voisines tombent dans la même case.
*/
export function ctrAttendu(position: number): number {
if (!Number.isFinite(position) || position < 1) return CTR_ATTENDU[0];
if (position <= 10) {
const bas = Math.floor(position);
const haut = Math.ceil(position);
if (bas === haut) return CTR_ATTENDU[bas - 1];
const part = position - bas;
return CTR_ATTENDU[bas - 1] * (1 - part) + CTR_ATTENDU[haut - 1] * part;
}
return CTR_ATTENDU[9] * DECROISSANCE ** (position - 10);
}