Files
team-tryouts/tests/test_query_shape.py
T
GGThedandClaude Opus 5 9d0456c2fd perf: borner le calendrier et remplacer trois boucles par des requetes
PERF-002, PERF-003, PERF-004. Aucun changement de comportement : chaque
reecriture est accompagnee de tests qui enoncent la reponse attendue, pas
la methode.

PERF-002 -- /matches/api/events
Le flux parcourait `tryout.matches` pour chaque tryout visible -- pour un
president, tout l historique du club -- puis posait une requete
MatchParticipant PAR match pour savoir si la personne qui regarde y figure.
Le cout du calendrier croissait avec l historique, a chaque navigation.

FullCalendar envoie deja `start` et `end` sur une source d evenements de
type URL. Personne ne les lisait. La requete est desormais bornee, et les
participants de tous les matchs de la fenetre sont charges en une fois,
joueur compris. Des bornes illisibles sont ignorees plutot que refusees :
un calendrier qui en montre trop est un probleme de performance, un
calendrier qui renvoie 400 est une page blanche.

PERF-003 -- get_players_available_at_time
Chargeait tous les joueurs actifs, puis une requete PlayerDisponibility par
joueur, sur une colonne non indexee. Deux requetes desormais, quelle que
soit la taille du club. Mesure dans le test : 7 requetes pour 6 joueurs
avant, 2 apres.

PERF-004 -- decompte des evaluations en attente
Chargeait toutes les inscriptions du club et toutes les evaluations du
coach, construisait deux ensembles Python et les soustrayait -- deux
lectures de table entiere pour produire un entier. Un COUNT DISTINCT avec
NOT EXISTS.

Les tests couvrent ce que la reecriture aurait pu changer sans bruit : fin
de creneau exclusive, compte desactive exclu, joueur a cheval sur deux
creneaux compte une fois, evaluation d un autre coach qui ne libere pas la
ligne, double inscription comptee une fois (DB-006 n a pas encore atterri,
donc le cas existe).

PERF-001 (view_tryout) n est pas fait : c est le plus gros des quatre, il
touche la page la plus consultee et merite son propre lot.

23 tests ajoutes, 371 au total.

Co-Authored-By: Claude Opus 5 <[email protected]>
2026-08-08 18:00:36 -04:00

234 lines
8.4 KiB
Python

"""Two rewrites that had to keep answering the same thing — PERF-003/004.
Both replaced a Python loop over rows with a query. The risk of that kind
of change is not that it breaks loudly; it is that it quietly answers
something slightly different — a player counted twice, an inactive account
included, a NULL swallowed. So these tests state the answer, not the plan.
The query counts are asserted too: the whole point was the number of round
trips, and nothing else in the suite would notice it creeping back.
"""
from datetime import date, time
import pytest
from sqlalchemy import event
from app.extensions import db
from app.models import Evaluation, PlayerDisponibility, Tryout, TryoutRegistration, User
@pytest.fixture
def count_queries(app):
"""Count SELECT statements issued inside the block."""
class Counter:
def __init__(self):
self.total = 0
def _counter():
counter = Counter()
def _before(conn, cursor, statement, parameters, context, executemany):
if statement.lstrip().upper().startswith('SELECT'):
counter.total += 1
event.listen(db.engine, 'before_cursor_execute', _before)
counter.stop = lambda: event.remove(db.engine, 'before_cursor_execute', _before)
return counter
return _counter
class TestAvailableAtTime:
"""get_players_available_at_time ran one query per active player."""
@staticmethod
def _slot(player_id, day, start, end):
db.session.add(
PlayerDisponibility(
player_id=player_id, day_of_week=day, start_time=start, end_time=end
)
)
def test_a_player_inside_the_window_is_returned(self, app, make_user):
from app.routes.matches import get_players_available_at_time
player_id = make_user('player')
with app.app_context():
# 2030-04-01 is a Monday, weekday() == 0.
self._slot(player_id, 0, time(18, 0), time(21, 0))
db.session.commit()
assert get_players_available_at_time('2030-04-01', '19:00') == [player_id]
def test_the_end_of_the_window_is_exclusive(self, app, make_user):
from app.routes.matches import get_players_available_at_time
player_id = make_user('player')
with app.app_context():
self._slot(player_id, 0, time(18, 0), time(21, 0))
db.session.commit()
assert get_players_available_at_time('2030-04-01', '21:00') == []
assert get_players_available_at_time('2030-04-01', '18:00') == [player_id]
def test_another_day_does_not_count(self, app, make_user):
from app.routes.matches import get_players_available_at_time
player_id = make_user('player')
with app.app_context():
self._slot(player_id, 2, time(18, 0), time(21, 0))
db.session.commit()
assert get_players_available_at_time('2030-04-01', '19:00') == []
def test_a_deactivated_account_is_excluded(self, app, make_user):
from app.routes.matches import get_players_available_at_time
player_id = make_user('player')
with app.app_context():
db.session.get(User, player_id).is_active_account = False
self._slot(player_id, 0, time(18, 0), time(21, 0))
db.session.commit()
assert get_players_available_at_time('2030-04-01', '19:00') == []
def test_two_overlapping_slots_report_the_player_once(self, app, make_user):
from app.routes.matches import get_players_available_at_time
player_id = make_user('player')
with app.app_context():
self._slot(player_id, 0, time(18, 0), time(21, 0))
self._slot(player_id, 0, time(19, 0), time(22, 0))
db.session.commit()
assert get_players_available_at_time('2030-04-01', '19:30') == [player_id]
def test_bad_input_answers_nothing(self, app):
from app.routes.matches import get_players_available_at_time
with app.app_context():
assert get_players_available_at_time('not-a-date', '19:00') == []
assert get_players_available_at_time('2030-04-01', '99:99') == []
def test_the_cost_does_not_grow_with_the_squad(self, app, make_user, count_queries):
"""One query per player is what this replaced."""
player_ids = [make_user('player') for _ in range(6)]
with app.app_context():
for player_id in player_ids:
self._slot(player_id, 0, time(18, 0), time(21, 0))
db.session.commit()
from app.routes.matches import get_players_available_at_time
counter = count_queries()
try:
result = get_players_available_at_time('2030-04-01', '19:00')
finally:
counter.stop()
assert sorted(result) == sorted(player_ids)
# The lower bound matters as much as the upper one: a listener
# that never fires would make this assertion vacuous.
assert 1 <= counter.total <= 2, f'{counter.total} SELECTs for 6 players'
class TestPendingEvaluations:
"""The coach dashboard loaded every registration in the club and every
evaluation the coach had written, to produce one integer."""
@staticmethod
def _register(player_id, tryout_id, status='registered'):
db.session.add(TryoutRegistration(tryout_id=tryout_id, player_id=player_id, status=status))
@pytest.fixture
def tryout_id(self, app, make_user):
with app.app_context():
tryout = Tryout(
title='Open', game='Valorant', date=date(2030, 3, 1), created_by=make_user('admin')
)
db.session.add(tryout)
db.session.commit()
return tryout.id
def _pending(self, client):
"""The number the dashboard renders, read back from the view."""
from app.routes import main
captured = {}
original = main.render_template
def _capture(template, **context):
captured.update(context)
return original(template, **context)
main.render_template = _capture
try:
client.get('/dashboard')
finally:
main.render_template = original
return captured['stats']['pending_evaluations']
def test_a_registered_player_is_pending(self, app, client, as_role, make_user, tryout_id):
player_id = make_user('player')
as_role('coach')
with app.app_context():
self._register(player_id, tryout_id)
db.session.commit()
assert self._pending(client) == 1
def test_an_evaluated_player_is_not(self, app, client, as_role, make_user, tryout_id):
player_id = make_user('player')
coach_id = as_role('coach')
with app.app_context():
self._register(player_id, tryout_id)
db.session.add(
Evaluation(player_id=player_id, evaluator_id=coach_id, tryout_id=tryout_id)
)
db.session.commit()
assert self._pending(client) == 0
def test_another_coachs_evaluation_does_not_clear_it(
self, app, client, as_role, make_user, tryout_id
):
"""The tally is per coach: someone else's work is not yours."""
player_id = make_user('player')
other_coach = make_user('coach')
as_role('coach')
with app.app_context():
self._register(player_id, tryout_id)
db.session.add(
Evaluation(player_id=player_id, evaluator_id=other_coach, tryout_id=tryout_id)
)
db.session.commit()
assert self._pending(client) == 1
def test_a_withdrawn_registration_is_not_counted(
self, app, client, as_role, make_user, tryout_id
):
player_id = make_user('player')
as_role('coach')
with app.app_context():
self._register(player_id, tryout_id, status='withdrawn')
db.session.commit()
assert self._pending(client) == 0
def test_a_player_registered_twice_counts_once(
self, app, client, as_role, make_user, tryout_id
):
"""DB-006 has not landed yet, so double registrations are possible;
the old set() absorbed them and the new count must too."""
player_id = make_user('player')
as_role('coach')
with app.app_context():
self._register(player_id, tryout_id)
self._register(player_id, tryout_id, status='attended')
db.session.commit()
assert self._pending(client) == 1