improve registration flows

api/storages.py

@@ -0,0 +1,26 @@
+"""Storage backends for the api app."""
+
+from django.conf import settings
+from django.core.files.storage import FileSystemStorage
+
+
+class IdCardStorage(FileSystemStorage):
+    """Filesystem storage for uploaded ID/passport photos.
+
+    Location/URL come from settings (IDCARD_STORAGE_ROOT / IDCARD_STORAGE_URL)
+    so the directory can be bind-mounted as a persistent volume in production.
+    """
+
+    def __init__(self, **kwargs):
+        kwargs.setdefault("location", settings.IDCARD_STORAGE_ROOT)
+        kwargs.setdefault("base_url", settings.IDCARD_STORAGE_URL)
+        super().__init__(**kwargs)
+
+
+def idcard_storage():
+    """Callable referenced by the model field.
+
+    Using a named callable keeps the resolved location out of migrations, so
+    changing the mount path never requires a new migration.
+    """
+    return IdCardStorage()