Formulaire public : logo et texte d'introduction personnalisables

FormTemplate porte désormais un logo (image, PUT/GET .../form/logo — GET
public comme .../form/public, affiché sur /inscription) et un texte
d'introduction libre (PATCH .../form, description désormais optionnelle
comme is_open). Écran de configuration (/inscriptions) : nouveau panneau
« Personnalisation » pour importer le logo et rédiger le texte. Le
formulaire public affiche le logo en grand au-dessus du panneau et le
texte juste sous le titre.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

backend/app/api/forms.py

@@ -28,6 +28,7 @@ from fastapi import (
     File,
     Form,
     HTTPException,
+    Response,
     UploadFile,
     status,
 )
@@ -96,7 +97,11 @@ def _enabled_fields(session: Session, edition_id: uuid.UUID) -> list[FormFieldTy
 
 def _template_read(template: FormTemplate, fields: list[FormFieldType]) -> FormTemplateRead:
     return FormTemplateRead(
-        edition_id=template.edition_id, is_open=template.is_open, fields=fields
+        edition_id=template.edition_id,
+        is_open=template.is_open,
+        fields=fields,
+        has_logo=template.logo is not None,
+        description=template.description,
     )
 
 
@@ -126,19 +131,66 @@ def set_fields(
 
 
 @router.patch("", response_model=FormTemplateRead)
-def set_open(
+def update_form(
     payload: FormTemplateUpdate,
     edition: Edition = Depends(get_edition),
     _guard: Account = Depends(require_coordinator),
     session: Session = Depends(get_session),
 ) -> FormTemplateRead:
     template = _get_or_create_template(session, edition.id)
-    template.is_open = payload.is_open
+    for field, value in payload.model_dump(exclude_unset=True).items():
+        setattr(template, field, value)
     session.add(template)
     session.commit()
     return _template_read(template, _enabled_fields(session, edition.id))
 
 
+async def _read_logo(file: UploadFile) -> tuple[bytes, str]:
+    content_type = file.content_type or ""
+    if content_type not in _ALLOWED_PHOTO_TYPES:
+        raise HTTPException(
+            status_code=422, detail={"code": "form.logo_type_not_supported"}
+        )
+    content = await file.read()
+    if not content:
+        raise HTTPException(status_code=400, detail={"code": "form.logo_empty"})
+    if len(content) > _MAX_PHOTO_BYTES:
+        raise HTTPException(status_code=413, detail={"code": "form.logo_too_large"})
+    return content, content_type
+
+
+@router.put("/logo", response_model=FormTemplateRead)
+async def set_logo(
+    file: UploadFile = File(...),
+    edition: Edition = Depends(get_edition),
+    _guard: Account = Depends(require_coordinator),
+    session: Session = Depends(get_session),
+) -> FormTemplateRead:
+    template = _get_or_create_template(session, edition.id)
+    content, content_type = await _read_logo(file)
+    template.logo = content
+    template.logo_content_type = content_type
+    session.add(template)
+    session.commit()
+    return _template_read(template, _enabled_fields(session, edition.id))
+
+
+@router.get("/logo")
+def get_logo(
+    edition: Edition = Depends(get_edition),
+    session: Session = Depends(get_session),
+) -> Response:
+    """Public (aucune authentification) : affiché sur `/inscription`, comme
+    `GET .../form/public` — voir le commentaire du module."""
+    template = _get_or_create_template(session, edition.id)
+    if template.logo is None:
+        raise HTTPException(status_code=404, detail={"code": "error.not_found"})
+    return Response(
+        content=template.logo,
+        media_type=template.logo_content_type or "application/octet-stream",
+    )
+
+
 # --------------------------------------------------------------------------- #
 # Formulaire public (aucune authentification)                                  #
 # --------------------------------------------------------------------------- #
@@ -175,7 +227,12 @@ def get_public_form(
         ]
 
     return PublicFormConfig(
-        is_open=template.is_open, fields=fields, positions=positions, artists=artists
+        is_open=template.is_open,
+        fields=fields,
+        positions=positions,
+        artists=artists,
+        has_logo=template.logo is not None,
+        description=template.description,
     )
 
 

backend/app/api/schemas.py

@@ -491,10 +491,16 @@ class FormTemplateRead(ApiModel):
     edition_id: uuid.UUID
     is_open: bool
     fields: list[FormFieldType]
+    has_logo: bool
+    description: str | None
 
 
 class FormTemplateUpdate(ApiModel):
-    is_open: bool
+    """`None`/absent = inchangé pour chaque champ (`exclude_unset`) — permet
+    de changer `is_open` sans toucher `description`, et inversement."""
+
+    is_open: bool | None = None
+    description: str | None = None
 
 
 class PublicPositionOption(ApiModel):
@@ -517,6 +523,8 @@ class PublicFormConfig(ApiModel):
     fields: list[FormFieldType]
     positions: list[PublicPositionOption]
     artists: list[PublicArtistOption]
+    has_logo: bool
+    description: str | None
 
 
 class FormSubmissionResult(ApiModel):

backend/app/i18n/locales/fr.json

@@ -79,6 +79,9 @@
   "form.invalid_payload": "Données du formulaire invalides.",
   "form.photo_type_not_supported": "La photo doit être au format PNG ou JPEG.",
   "form.photo_too_large": "La photo est trop volumineuse.",
+  "form.logo_type_not_supported": "Le logo doit être au format PNG ou JPEG.",
+  "form.logo_empty": "Le logo est vide.",
+  "form.logo_too_large": "Le logo est trop volumineux.",
   "form.too_many_position_wishes": "Deux vœux de poste au maximum.",
   "form.too_many_artists_same_day": "Un seul artiste souhaité par soir de festival.",
   "position_sheets.no_positions": "Aucun poste ne correspond à cette sélection.",

backend/app/migrations/versions/0014_form_logo.py

@@ -0,0 +1,34 @@
+"""Logo et description du formulaire public
+
+Revision ID: 0014_form_logo
+Revises: 0013_signup_form
+Create Date: 2026-09-23
+
+Habillage de la page publique (`/inscription`, `FormTemplate`) : `logo`/
+`logo_content_type` (image, stockée en base comme les autres images de
+l'appli) et `description` (texte libre). Voir `app/api/forms.py`.
+"""
+
+from collections.abc import Sequence
+
+import sqlalchemy as sa
+from alembic import op
+
+revision: str = "0014_form_logo"
+down_revision: str | None = "0013_signup_form"
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
+
+
+def upgrade() -> None:
+    op.add_column("form_template", sa.Column("logo", sa.LargeBinary(), nullable=True))
+    op.add_column(
+        "form_template", sa.Column("logo_content_type", sa.String(), nullable=True)
+    )
+    op.add_column("form_template", sa.Column("description", sa.String(), nullable=True))
+
+
+def downgrade() -> None:
+    op.drop_column("form_template", "description")
+    op.drop_column("form_template", "logo_content_type")
+    op.drop_column("form_template", "logo")

backend/app/models/domain.py

@@ -466,7 +466,11 @@ class BadgeField(TimestampMixin, table=True):
 class FormTemplate(TimestampMixin, table=True):
     """Configuration du formulaire public d'une édition. Une ligne par
     édition (créée à la demande). `is_open` coupe les nouvelles soumissions
-    sans effacer la configuration (les champs activés restent enregistrés)."""
+    sans effacer la configuration (les champs activés restent enregistrés).
+    `logo`/`logo_content_type` et `description` habillent la page publique
+    (`/inscription`) — aucun rapport avec les champs collectés par
+    `FormField` ; stockage en base comme les autres images de l'appli
+    (badges, photo de bénévole), pas de volume de fichiers à gérer."""
 
     __tablename__ = "form_template"
 
@@ -478,6 +482,9 @@ class FormTemplate(TimestampMixin, table=True):
         default=True,
         sa_column=Column(Boolean, nullable=False, server_default="true"),
     )
+    logo: bytes | None = Field(default=None, sa_column=Column(LargeBinary))
+    logo_content_type: str | None = None
+    description: str | None = None
 
 
 class FormField(SQLModel, table=True):