Files
benevoles/backend/tests/test_api_volunteers.py
T
AdamThomasandClaude Sonnet 5 a2b748566b
ci-cd / build-backend (push) Successful in 30s
ci-cd / build-frontend (push) Successful in 18s
ci-cd / deploy (push) Successful in 12s
Inscription en deux temps, emails de confirmation et export Excel des bénévoles
Formulaire public — paiement en ligne :
- Le bénévole n'est plus compté en base tant qu'un paiement en ligne choisi
  n'est pas confirmé (PendingFormSubmission, promu en Volunteer à la
  confirmation, webhook ou vérification en direct).
- Type de paiement « mécénat » : étape d'adresse postale avant le paiement,
  conservée sur le bénévole pour un reçu fiscal (cerfa) ultérieur.
- Page de confirmation au retour de SumUp, avec relance possible après
  échec/expiration sans ressaisir le formulaire.
- « Je paierai sur place » remplace « je ne participe pas » ; tous les
  champs activés par la coordination sont désormais obligatoires.
- La fiche bénévole n'affiche plus l'état des cases à cocher, seulement le
  résultat réel du paiement (libellé, montant, statut).

Emails :
- Email de confirmation d'inscription à la création du bénévole (tient lieu
  de reçu de paiement quand une cotisation est payée en ligne).
- Mise en forme HTML au thème de l'application (logo de l'édition en
  en-tête) pour tous les emails envoyés, texte brut conservé en repli.

Export Excel des bénévoles (COORDINATION) : coordonnées, vœux résolus en
noms lisibles, cotisation et mécénat.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-30 07:41:58 +02:00

433 lines
14 KiB
Python

import datetime as dt
import io
import uuid
from openpyxl import load_workbook
from sqlmodel import select
from app.models import Assignment, Availability, Role, Volunteer
from tests.factories import (
dt_at,
make_artist,
make_availability,
make_position,
make_shift,
make_volunteer,
)
def _url(edition, suffix=""):
return f"/editions/{edition.id}/volunteers{suffix}"
def test_create_volunteer(client, edition):
resp = client.post(
_url(edition),
json={
"first_name": "Alex",
"last_name": "Martin",
"email": "alex@ex.fr",
},
)
assert resp.status_code == 201
body = resp.json()
assert body["edition_id"] == str(edition.id)
assert body["artist_ids"] == []
assert body["wished_position_ids"] == []
def test_several_volunteers_can_share_an_email(client, edition):
# Un couple, une famille : même boîte mail, deux bénévoles distincts.
payload = {"first_name": "A", "last_name": "A", "email": "dup@ex.fr"}
first = client.post(_url(edition), json=payload)
assert first.status_code == 201
second = client.post(_url(edition), json={**payload, "first_name": "B"})
assert second.status_code == 201
assert first.json()["id"] != second.json()["id"]
def test_volunteers_without_email_are_allowed(client, edition):
for name in ("Un", "Deux"):
r = client.post(
_url(edition), json={"first_name": name, "last_name": "SansMail"}
)
assert r.status_code == 201
def test_list_is_ordered_by_name(client, edition, session):
make_volunteer(session, edition, first_name="Bob", last_name="Zoe")
make_volunteer(session, edition, first_name="Ana", last_name="Ada")
names = [v["last_name"] for v in client.get(_url(edition)).json()]
assert names == ["Ada", "Zoe"]
def test_get_unknown_id_is_404(client, edition):
assert client.get(_url(edition, f"/{uuid.uuid4()}")).status_code == 404
def test_get_volunteer_of_another_edition_is_404(client, edition, session):
from app.models import Edition
other = Edition(
year=2027,
start_date=dt.date(2027, 7, 1),
end_date=dt.date(2027, 7, 4),
)
session.add(other)
session.commit()
session.refresh(other)
stranger = make_volunteer(session, other, email="x@ex.fr")
assert client.get(_url(edition, f"/{stranger.id}")).status_code == 404
def test_create_with_artist_and_position_wishes(client, edition, session):
artist = make_artist(session, edition)
position = make_position(session, edition)
resp = client.post(
_url(edition),
json={
"first_name": "Fan",
"last_name": "Zele",
"artist_ids": [str(artist.id)],
"wished_position_ids": [str(position.id)],
},
)
assert resp.status_code == 201
body = resp.json()
assert body["artist_ids"] == [str(artist.id)]
assert body["wished_position_ids"] == [str(position.id)]
def test_unknown_artist_wish_is_422(client, edition):
resp = client.post(
_url(edition),
json={
"first_name": "A",
"last_name": "B",
"artist_ids": [str(uuid.uuid4())],
},
)
assert resp.status_code == 422
assert resp.json()["detail"]["code"] == "artist.unknown"
def test_create_with_companion_wish(client, edition, session):
friend = make_volunteer(session, edition, email="friend@ex.fr")
resp = client.post(
_url(edition),
json={
"first_name": "Alex",
"last_name": "Martin",
"wished_companion_ids": [str(friend.id)],
},
)
assert resp.status_code == 201
assert resp.json()["wished_companion_ids"] == [str(friend.id)]
def test_unknown_companion_wish_is_422(client, edition):
resp = client.post(
_url(edition),
json={
"first_name": "A",
"last_name": "B",
"wished_companion_ids": [str(uuid.uuid4())],
},
)
assert resp.status_code == 422
assert resp.json()["detail"]["code"] == "volunteer.unknown"
def test_cannot_wish_oneself_as_companion(client, edition, session):
volunteer = make_volunteer(session, edition, email="solo@ex.fr")
resp = client.patch(
_url(edition, f"/{volunteer.id}"),
json={"wished_companion_ids": [str(volunteer.id)]},
)
assert resp.status_code == 422
assert resp.json()["detail"]["code"] == "volunteer.cannot_wish_self"
def test_companion_wish_is_one_directional(client, edition, session):
# A souhaite B ne veut pas dire que B souhaite A.
a = make_volunteer(session, edition, email="a@ex.fr")
b = make_volunteer(session, edition, email="b@ex.fr")
client.patch(_url(edition, f"/{a.id}"), json={"wished_companion_ids": [str(b.id)]})
assert client.get(_url(edition, f"/{a.id}")).json()["wished_companion_ids"] == [str(b.id)]
assert client.get(_url(edition, f"/{b.id}")).json()["wished_companion_ids"] == []
def test_deleting_a_wished_companion_clears_the_wish(client, edition, session):
# RGPD : effacement complet, y compris les vœux dont on est la cible.
a = make_volunteer(session, edition, email="a@ex.fr")
b = make_volunteer(session, edition, email="b@ex.fr")
client.patch(_url(edition, f"/{a.id}"), json={"wished_companion_ids": [str(b.id)]})
assert client.delete(_url(edition, f"/{b.id}")).status_code == 204
assert client.get(_url(edition, f"/{a.id}")).json()["wished_companion_ids"] == []
def test_patch_replaces_and_clears_wishes(client, edition, session):
a1 = make_artist(session, edition, name="A1")
a2 = make_artist(session, edition, name="A2")
volunteer = make_volunteer(session, edition, email="w@ex.fr")
r1 = client.patch(
_url(edition, f"/{volunteer.id}"),
json={"artist_ids": [str(a2.id), str(a1.id), str(a2.id)]},
)
# Doublons retirés, tri par (date, nom).
assert r1.json()["artist_ids"] == [str(a1.id), str(a2.id)]
r2 = client.patch(
_url(edition, f"/{volunteer.id}"), json={"artist_ids": []}
)
assert r2.json()["artist_ids"] == []
# Champ absent = inchangé.
r3 = client.patch(
_url(edition, f"/{volunteer.id}"), json={"first_name": "Zoe"}
)
assert r3.json()["artist_ids"] == []
def test_patch_updates_simple_fields(client, edition, session):
volunteer = make_volunteer(session, edition, email="p@ex.fr")
r1 = client.patch(
_url(edition, f"/{volunteer.id}"),
json={"first_name": "Neo", "comment": "dispo tôt"},
)
assert r1.status_code == 200
assert r1.json()["first_name"] == "Neo"
assert r1.json()["comment"] == "dispo tôt"
def test_delete_is_a_full_cascade(client, edition, session):
volunteer = make_volunteer(session, edition, email="gone@ex.fr")
position = make_position(session, edition)
shift = make_shift(
session, edition, position, start=dt_at(10, 9), end=dt_at(10, 12)
)
make_availability(
session,
edition,
volunteer,
date=dt.date(2026, 7, 10),
start_time=dt.time(8, 0),
end_time=dt.time(13, 0),
)
session.add(
Assignment(
edition_id=edition.id,
volunteer_id=volunteer.id,
shift_id=shift.id,
)
)
session.commit()
resp = client.delete(_url(edition, f"/{volunteer.id}"))
assert resp.status_code == 204
assert client.get(_url(edition, f"/{volunteer.id}")).status_code == 404
assert session.exec(select(Volunteer)).all() == []
assert session.exec(select(Assignment)).all() == []
assert session.exec(select(Availability)).all() == []
# Le créneau subsiste.
from app.models import Shift
assert session.get(Shift, shift.id) is not None
# --------------------------------------------------------------------------- #
# Planning enrichi (poste, lieu, référent) — écran bénévole #
# --------------------------------------------------------------------------- #
def test_planning_is_empty_without_assignment(client, edition, session):
volunteer = make_volunteer(session, edition, email="v@ex.fr")
resp = client.get(_url(edition, f"/{volunteer.id}/planning"))
assert resp.status_code == 200
assert resp.json() == []
def test_planning_includes_position_and_referent(client, edition, session):
from app.models import Account
volunteer = make_volunteer(session, edition, email="v@ex.fr")
referent_volunteer = make_volunteer(
session, edition, first_name="Rita", last_name="Referente", email="r@ex.fr"
)
referent_volunteer.phone = "0600000000"
session.add(referent_volunteer)
referent_account = Account(
edition_id=edition.id,
email="rita@ex.fr",
role=Role.LEAD,
volunteer_id=referent_volunteer.id,
)
session.add(referent_account)
session.commit()
session.refresh(referent_account)
position = make_position(session, edition, name="Bar central")
position.location = "Chapiteau"
position.lead_account_id = referent_account.id
session.add(position)
session.commit()
shift = make_shift(
session, edition, position, start=dt_at(10, 9), end=dt_at(10, 12)
)
session.add(
Assignment(edition_id=edition.id, volunteer_id=volunteer.id, shift_id=shift.id)
)
session.commit()
resp = client.get(_url(edition, f"/{volunteer.id}/planning"))
assert resp.status_code == 200
body = resp.json()
assert len(body) == 1
entry = body[0]
assert entry["shift_id"] == str(shift.id)
assert entry["position_name"] == "Bar central"
assert entry["position_location"] == "Chapiteau"
assert entry["referent_name"] == "Rita Referente"
assert entry["referent_phone"] == "0600000000"
def test_planning_referent_fields_are_none_without_referent(
client, edition, session
):
volunteer = make_volunteer(session, edition, email="v@ex.fr")
position = make_position(session, edition)
shift = make_shift(
session, edition, position, start=dt_at(10, 9), end=dt_at(10, 12)
)
session.add(
Assignment(edition_id=edition.id, volunteer_id=volunteer.id, shift_id=shift.id)
)
session.commit()
resp = client.get(_url(edition, f"/{volunteer.id}/planning"))
entry = resp.json()[0]
assert entry["referent_name"] is None
assert entry["referent_phone"] is None
def test_planning_referent_fields_are_none_when_lead_has_no_volunteer_record(
client, edition, session
):
"""Un référent peut être un compte LEAD sans fiche bénévole associée :
pas de nom/téléphone à afficher dans ce cas."""
from app.models import Account
volunteer = make_volunteer(session, edition, email="v@ex.fr")
referent_account = Account(
edition_id=edition.id, email="lead@ex.fr", role=Role.LEAD
)
session.add(referent_account)
session.commit()
session.refresh(referent_account)
position = make_position(session, edition)
position.lead_account_id = referent_account.id
session.add(position)
session.commit()
shift = make_shift(
session, edition, position, start=dt_at(10, 9), end=dt_at(10, 12)
)
session.add(
Assignment(edition_id=edition.id, volunteer_id=volunteer.id, shift_id=shift.id)
)
session.commit()
resp = client.get(_url(edition, f"/{volunteer.id}/planning"))
entry = resp.json()[0]
assert entry["referent_name"] is None
assert entry["referent_phone"] is None
def test_planning_is_ordered_by_start_time(client, edition, session):
volunteer = make_volunteer(session, edition, email="v@ex.fr")
position = make_position(session, edition)
late = make_shift(
session, edition, position, start=dt_at(11, 14), end=dt_at(11, 18)
)
early = make_shift(
session, edition, position, start=dt_at(10, 9), end=dt_at(10, 12)
)
session.add_all(
[
Assignment(edition_id=edition.id, volunteer_id=volunteer.id, shift_id=late.id),
Assignment(edition_id=edition.id, volunteer_id=volunteer.id, shift_id=early.id),
]
)
session.commit()
resp = client.get(_url(edition, f"/{volunteer.id}/planning"))
body = resp.json()
assert [e["shift_id"] for e in body] == [str(early.id), str(late.id)]
def test_planning_is_404_for_unknown_volunteer(client, edition):
resp = client.get(_url(edition, f"/{uuid.uuid4()}/planning"))
assert resp.status_code == 404
def test_volunteer_can_read_own_planning_but_not_anothers(
session, edition, make_account, as_account
):
me = make_volunteer(session, edition, email="me@e.fr")
other = make_volunteer(session, edition, email="other@e.fr")
account = make_account(Role.VOLUNTEER, volunteer_id=me.id, email="me@e.fr")
client = as_account(account)
assert client.get(_url(edition, f"/{me.id}/planning")).status_code == 200
assert client.get(_url(edition, f"/{other.id}/planning")).status_code == 403
def test_lead_can_read_any_volunteers_planning(
session, edition, make_account, as_account
):
other = make_volunteer(session, edition, email="other@e.fr")
lead_account = make_account(Role.LEAD)
client = as_account(lead_account)
assert client.get(_url(edition, f"/{other.id}/planning")).status_code == 200
def test_export_volunteers_as_excel(client, edition, session):
position = make_position(session, edition, name="Bar central")
artist = make_artist(session, edition, name="Chilla")
volunteer = make_volunteer(
session, edition, first_name="Alex", last_name="Martin", email="alex@ex.fr"
)
client.patch(
_url(edition, f"/{volunteer.id}"),
json={
"wished_position_ids": [str(position.id)],
"artist_ids": [str(artist.id)],
},
)
resp = client.get(_url(edition, "/export"))
assert resp.status_code == 200
assert resp.headers["content-type"] == (
"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
)
assert f"benevoles-{edition.year}.xlsx" in resp.headers["content-disposition"]
workbook = load_workbook(io.BytesIO(resp.content))
sheet = workbook.active
rows = list(sheet.iter_rows(values_only=True))
assert rows[0][0] == "Prénom"
row = rows[1]
assert row[0] == "Alex"
assert row[1] == "Martin"
assert row[2] == "alex@ex.fr"
assert row[5] == "Bar central"
assert row[6] == "Chilla"
def test_export_volunteers_is_coordinator_only(edition, make_account, as_account):
lead = make_account(Role.LEAD, email="lead@e.fr")
resp = as_account(lead).get(_url(edition, "/export"))
assert resp.status_code == 403