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]>
234 lines
8.4 KiB
Python
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
|