[bpepple]

Summary

Adds django-compressor so production serves local CSS and JS as minified bundles with content-hashed filenames. Pages make fewer requests, and every deploy changes the filenames, so browsers fetch new assets instead of using cached copies from Spaces (cached for 7 days).

Development and tests are unchanged: compression is off whenever DEBUG is on, so templates load the original files.

Changes

• Dependency: django-compressor 4.6.0
• Settings:
  • Register the compressor app and CompressorFinder
  • Production compresses offline and writes the bundles and CACHE/manifest.json to the Spaces bucket
  • Set COMPRESS_ROOT explicitly because production has no STATIC_ROOT
  • Set the offline manifest storage name explicitly. 4.6.0 defaults to the misspelled "compressor-offine"; this is fixed upstream in #1325 but not released yet.
• Templates:
  • base.html bundles base.css, izaya/layout.css and izaya.css into one stylesheet; izaya.js keeps defer
  • Bundle page-level assets on home, timeline, statistics, the issue and attribution forms, and the collection form, detail and stats pages
  • {% bulma %}, {% font_awesome %}, CDN scripts and inline scripts that use template variables stay outside the bundles
  • issue-form-usability.js now loads next to bulma-calendar so the two share a bundle (it doesn't depend on the inline form script)
• Tests: tests/metron/test_compress.py checks that the home page uses bundles when compression is on and the original files when it's off
• Docs: DEPLOYMENT.md adds the compress step

Deployment

manage.py compress --force must run on every deploy. In production, any page whose {% compress %} block isn't in the manifest fails with OfflineGenerationError, and that includes the first deploy before any manifest exists.

Run it from the new image before restarting:

podman run --rm --network host --env-file ~/.config/containers/metron.env \
    localhost/metron:latest python manage.py compress --force
systemctl --user restart metron-web metron-anubis

Each gunicorn worker caches the manifest in memory, so restart after compressing. The "Invalid template django_filters/rest_framework/crispy_form.html" warning that compress prints is harmless.

Testing

• pytest: 2240 passed, 2 skipped
• ruff check and ruff format --check pass
• A local offline compress --force built 10 bundles from 156 templates with no errors
• Production settings (dummy credentials) resolve compressor's bundle and manifest storage to S3
• Browser check with compression on: styles, Font Awesome icons, the date picker, izaya lookups, and charts
• After deploying, confirm static/CACHE/manifest.json exists in the Spaces bucket