perf: servir les statiques par nginx, et dire ce que le bot n a pas livre

PERF-006. Le bloc location /static/ etait commente : 59 Ko de CSS et de JS
passaient par Waitress a chaque page. L activer tel quel aurait ete une
regression : ces URL ne changent jamais, donc un cache de 30 jours sert une
feuille de style vieille d un mois apres chaque deploiement, sans moyen de
l invalider. url_for('static') estampille maintenant chaque URL du mtime du
fichier ; c est ce qui rend le immutable vrai et pas seulement rapide.

Deux pieges nginx consignes dans le fichier : un add_header dans un location
annule tous les add_header herites du server (nosniff disparaissait du
JavaScript), et un statique manquant doit renvoyer 404 plutot que retomber
sur Flask, sinon un deploiement casse se cache derriere une page qui marche.

PERF-005. Les objets utilisateur Discord sont mis en cache. A etre precis
sur le gain : un envoi coute deux appels reseau, resoudre puis envoyer, et
seul le premier est economise — un premier match a vingt joueurs fait
toujours vingt resolutions. Ce qui est gagne l est entre notifications, la
ou le bot ecrit aux memes personnes soir apres soir.

Chaque message dit desormais ce qu il est devenu, avec le destinataire et
la raison. Les trois echecs ne se ressemblent pas et ne se lisent plus
pareil : une boite fermee est definitive et ne se retente pas, une erreur
HTTP est passagere, un identifiant sans proprietaire est un compte a
corriger. Le lot quotidien annonce son propre deficit.

Piege trouve en ecrivant les tests : configure_logging met propagate=False
sur le logger 'app', et le handler de caplog est sur la racine. Les
assertions sur les journaux passaient seules et echouaient dans la suite
complete, ou une application avait deja ete construite — elles lisaient un
journal vide, pas un bot silencieux.

417 tests.

app/app.py

@@ -147,6 +147,11 @@ def create_app(config=None):
     """
     app = Flask(__name__)
 
+    # Cache-busting stamps for static files, filled lazily by the url_defaults
+    # hook below. Per application instance, so the test suite does not carry
+    # one app's mtimes into the next.
+    _static_stamps = {}
+
     # --- defaults from the environment ------------------------------------
     app.config['SECRET_KEY'] = os.getenv('SECRET_KEY')
     app.config['SQLALCHEMY_DATABASE_URI'] = os.getenv('DATABASE_URL')
@@ -244,6 +249,35 @@ def create_app(config=None):
         # unconditionally so templates can carry nonce="" beforehand.
         g.csp_nonce = secrets.token_urlsafe(16)
 
+    @app.url_defaults
+    def version_static_urls(endpoint, values):
+        """Stamp every static URL with the file's modification time.
+
+        Without this, nginx cannot be allowed to cache style.css and main.js:
+        their URLs never change, so a 30-day expiry means a 30-day-old stylesheet
+        with no way to invalidate it short of telling people to hard-refresh.
+        With it, a deployed file gets a new URL and the old entry simply stops
+        being asked for — which is what makes the `immutable` in nginx.conf
+        true rather than merely fast (PERF-006).
+
+        The stamp is computed once per file per process. The process restarts
+        on deploy, which is exactly when a file can have changed.
+        """
+        if endpoint != 'static' or 'filename' not in values:
+            return
+        filename = values['filename']
+        stamp = _static_stamps.get(filename)
+        if stamp is None:
+            try:
+                stamp = str(int(os.stat(os.path.join(app.static_folder, filename)).st_mtime))
+            except OSError:
+                # A missing file is the template's problem, not this hook's:
+                # let the URL build and let the 404 say so.
+                stamp = ''
+            _static_stamps[filename] = stamp
+        if stamp:
+            values['v'] = stamp
+
     @app.context_processor
     def inject_csp_nonce():
         return {