Skip to content

feat(observabilité): les erreurs JS des joueurs remontent dans l'admin et sur Discord - #234

Merged
CodeByHaamza merged 5 commits into
developfrom
feat/remontee_erreurs_js
Nov 11, 2026
Merged

CodeByHaamza merged 5 commits into
developfrom
feat/remontee_erreurs_js

Conversation

@CodeByHaamza

@CodeByHaamza CodeByHaamza commented Oct 20, 2026 •

Copy link
Copy Markdown
Owner

Pourquoi

Les derniers incidents de prod (titres en 500 en 2.2.6, bouton Rejouer disparu en 2.3.3) ont été signalés par des joueurs. Aucun code ne captait les erreurs du navigateur : on voyait les bugs après eux.

Quoi

Client — js/error_reporter.js, installé une fois par page depuis api.js (désactivé en local) :

  • écoute error et unhandledrejection ;
  • au plus 5 envois par page, chaque erreur une seule fois ;
  • bruit écarté : extensions, « Script error. », ResizeObserver, réseau coupé ;
  • envoie le message, l'endroit, la pile, le chemin de la page (sans query string) et le navigateur. Ni saisie, ni identité.
  • sendBeacon : l'envoi survit à la fermeture de la page.

Serveur — api/client_errors.php + api/lib/client_errors.php :

  • ouvert aux invités, limité à 30 / 15 min par IP, corps tronqué champ par champ ;
  • empreinte = message + première ligne de pile, sans ?v= ni chiffres : même bug chez 200 joueurs = une seule empreinte ;
  • rangé dans error_log (source client, visible dans l'admin) et signalé sur Discord une fois par heure et par empreinte. La déduplication passe par rate_limits : aucune migration ;
  • alerte Discord optionnelle (DISCORD_ERRORS_WEBHOOK), qui ne mentionne jamais personne.

Vérifications

  • npm test (1555/1555) · npm run lint · npm run docs:check · php -l
  • tests/error_reporter.test.js (7), tests/php/ClientErrorsTest.php (7)
  • Nouveau test d'intégration sur rate_limits : testClientErrorFingerprintIsNewOncePerWindow
  • PHPUnit pas lancé tel quel : phar.phpunit.de est bloqué dans mon environnement. ClientErrorsTest a tourné sur un exécuteur minimal local (7/7) ; le job lint-php de la CI fera foi, intégration comprise.

Selon le type de changement

  • PHP — PDO préparé ligne par ligne (2 requêtes, toutes deux en ?) ; pas de concaténation SQL
  • Nouveau .php — à la racine d'api/ (pas dans user//admin/), donc pas de RewriteRule ; fichier plat sans dossier homonyme (piège du 301)

Docs

  • DEV_CHANGELOG.md 2.3 ; TODO.md (étape optionnelle de release : webhook Discord privé) ; api/config.example.php

Angles morts

  • error_log n'a pas de rétention : borné à une ligne par heure et par empreinte, mais à surveiller les premiers jours.
  • Les pages sans api.js (FAQ, confidentialité) ne remontent rien.

Les derniers incidents de prod (titres en 500, bouton Rejouer disparu) ont été
signalés par des joueurs : rien ne captait les erreurs du navigateur.

js/error_reporter.js écoute error / unhandledrejection (installé depuis
api.js, coupé en local) : 5 envois max par page, chaque erreur une fois, bruit
écarté (extensions, Script error, réseau coupé), chemin de page sans query
string. api/client_errors.php, ouvert aux invités : limité par IP, corps
tronqué, puis rangé dans error_log (source client) et signalé sur Discord
(DISCORD_ERRORS_WEBHOOK, optionnel) une seule fois par heure et par empreinte
— la déduplication passe par rate_limits, sans migration.
La constante vaut '' dans config.example.php, que PHPStan charge : il en
déduisait que la garde de l'alerte Discord était toujours fausse et
rejetait la PR (« Result of && is always false »). Même traitement que
DISCORD_DAILY_WEBHOOK et DISCORD_WEEKLY_WEBHOOK.
Chiffres de doc recalculés. Dans TODO.md, le rappel du webhook Discord des
erreurs rejoint les deux lignes de la 2.3.4 au lieu de les remplacer, et
passe en 2.4. L'entrée de changelog quitte le dossier 2.3 pour le 2.4.
Après le merge de #233 : les deux entrées du 2026-10-20 sont gardées dans le
changelog 2.4, les lignes de lots 2.4 sortent du tableau de la 2.3, et les
chiffres de doc sont recalculés.
@CodeByHaamza
CodeByHaamza merged commit 25312d0 into develop Nov 11, 2026
3 checks passed
CodeByHaamza added a commit that referenced this pull request Nov 11, 2026
Après le merge de #234 : changelog 2.4 et chiffres de doc.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant