🔧 chore: migrate to Django 5.1 STORAGES API

- Replace deprecated DEFAULT_FILE_STORAGE with STORAGES dict
- Replace deprecated STATICFILES_STORAGE with STORAGES dict
- Configure S3 storage backend in production settings
- Set MEDIA_URL to point to S3 custom domain
- Document storage configuration in CLAUDE.md

Author: matrixise

CLAUDE.md

@@ -223,6 +223,15 @@ After upgrading Wagtail to a new version, you must:
 3. Clear and recollect static files: `docker compose run --rm web python pythonie/manage.py collectstatic --clear --noinput`
 4. **Clear your browser cache** (Ctrl+Shift+R or Cmd+Shift+R) - this is critical as Wagtail admin JavaScript files are cached and stale cache can cause the admin sidebar menu to disappear with errors like `wagtailConfig is undefined`.
 
+### Storage Configuration (Django 5.1+)
+
+Django 5.1 removed `DEFAULT_FILE_STORAGE` and `STATICFILES_STORAGE` settings. The project now uses the `STORAGES` API:
+
+- **base.py**: Defines default storage (FileSystemStorage) and staticfiles (WhiteNoise)
+- **production.py**: Overrides default storage to use S3 (`storages.backends.s3boto3.S3Boto3Storage`)
+
+If you see 404 errors for images after upgrading Django, ensure `STORAGES` is properly configured instead of the deprecated settings.
+
 ### Documentation Language
 
 All documentation and code comments must be written in English to ensure all contributors can collaborate effectively.

pythonie/pythonie/settings/base.py

@@ -156,7 +156,14 @@
 STATIC_ROOT = join(PROJECT_ROOT, "static")
 STATIC_URL = "/static/"
 
-STATICFILES_STORAGE = "whitenoise.storage.CompressedManifestStaticFilesStorage"
+STORAGES = {
+    "default": {
+        "BACKEND": "django.core.files.storage.FileSystemStorage",
+    },
+    "staticfiles": {
+        "BACKEND": "whitenoise.storage.CompressedManifestStaticFilesStorage",
+    },
+}
 
 STATICFILES_FINDERS = (
     "django.contrib.staticfiles.finders.FileSystemFinder",

pythonie/pythonie/settings/production.py

@@ -5,14 +5,26 @@
 # Disable debug mode
 DEBUG = False
 
-DEFAULT_FILE_STORAGE = "storages.backends.s3boto3.S3Boto3Storage"
+# AWS S3 Storage Configuration
 AWS_ACCESS_KEY_ID = os.getenv("AWS_ACCESS_KEY_ID")
 AWS_SECRET_ACCESS_KEY = os.getenv("AWS_SECRET_ACCESS_KEY")
 AWS_STORAGE_BUCKET_NAME = os.getenv("AWS_STORAGE_BUCKET_NAME")
 AWS_S3_CUSTOM_DOMAIN = "s3.python.ie"
 AWS_HOST = "s3-eu-west-1.amazonaws.com"
 AWS_DEFAULT_ACL = "public-read"
 
+# Use S3 for media files (Django 5.1+ STORAGES API)
+STORAGES = {
+    "default": {
+        "BACKEND": "storages.backends.s3boto3.S3Boto3Storage",
+    },
+    "staticfiles": {
+        "BACKEND": "whitenoise.storage.CompressedManifestStaticFilesStorage",
+    },
+}
+
+MEDIA_URL = f"https://{AWS_S3_CUSTOM_DOMAIN}/"
+
 # Compress static files offline
 # http://django-compressor.readthedocs.org/en/latest/settings/#django.conf.settings.COMPRESS_OFFLINE