Étape 5 : API CRUD, matrice et validation branchée

- CRUD complet, scopé par édition, sur Position, Shift, Volunteer, Assignment
  (routers app/api/*, schémas Pydantic, dépendance get_edition partagée)
- Volunteer : gestion des compétences par codes (création à la volée),
  suppression = effacement complet en cascade (RGPD)
- Shift : contrôle fin > début, poste de la même édition, compétences requises
- Assignment : toute écriture active passe par le moteur de validation ;
  violation bloquante -> 422 error.validation_failed, avertissements renvoyés
  dans la réponse. Endpoint POST .../assignments/validate en simulation.
  app/validation/loader.py construit la ValidationInput depuis la base.
- GET /editions/{id}/matrix : postes -> créneaux -> {min, ideal, confirmed,
  proposed}, source de l'écran principal
- 30 tests d'API (CRUD, 404/409/422, cascade, blocage, avertissements, matrice,
  loader) ; 104 tests au total ; alembic check toujours vert
- Clés de traduction shift.* / assignment.* / volunteer.* ajoutées

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017uUsRg7XzopkCPWimwg9ZM

backend/tests/test_api_matrix.py

@@ -0,0 +1,62 @@
+
+from app.models import Assignment, AssignmentStatus
+from tests.factories import dt_at, make_position, make_shift, make_volunteer
+
+
+def test_matrix_shape_and_counts(client, edition, session):
+    bar = make_position(session, edition, name="Bar")
+    parking = make_position(session, edition, name="Parking")
+
+    shift_a = make_shift(
+        session, edition, bar, start=dt_at(10, 18), end=dt_at(10, 22),
+        min_staff=2, ideal_staff=5,
+    )
+    shift_b = make_shift(
+        session, edition, bar, start=dt_at(11, 18), end=dt_at(11, 22)
+    )
+    make_shift(
+        session, edition, parking, start=dt_at(10, 8), end=dt_at(10, 12)
+    )
+
+    for i, status in enumerate(
+        [
+            AssignmentStatus.CONFIRMED,
+            AssignmentStatus.CONFIRMED,
+            AssignmentStatus.PROPOSED,
+            AssignmentStatus.DECLINED,
+        ]
+    ):
+        volunteer = make_volunteer(
+            session, edition, first_name=f"V{i}", last_name="X", email=f"v{i}@ex.fr"
+        )
+        session.add(
+            Assignment(
+                edition_id=edition.id,
+                volunteer_id=volunteer.id,
+                shift_id=shift_a.id,
+                status=status,
+            )
+        )
+    session.commit()
+
+    body = client.get(f"/editions/{edition.id}/matrix").json()
+    assert body["edition_id"] == str(edition.id)
+    assert [p["name"] for p in body["positions"]] == ["Bar", "Parking"]
+
+    bar_shifts = body["positions"][0]["shifts"]
+    assert [s["shift_id"] for s in bar_shifts] == [str(shift_a.id), str(shift_b.id)]
+
+    first = bar_shifts[0]
+    assert first["confirmed"] == 2
+    assert first["proposed"] == 1  # la DECLINEE n'est pas comptée
+    assert first["min_staff"] == 2
+    assert first["ideal_staff"] == 5
+
+    assert bar_shifts[1]["confirmed"] == 0
+    assert body["positions"][1]["shifts"][0]["proposed"] == 0
+
+
+def test_matrix_unknown_edition_is_404(client):
+    import uuid
+
+    assert client.get(f"/editions/{uuid.uuid4()}/matrix").status_code == 404