Aller au contenu

Les lectures d'un écran

Un écran, un aller-retour : le patron à suivre et ce qu'il ne faut pas faire.

Voir en Markdown

Entre l’application et la base, chaque appel coûte une cinquantaine de millisecondes. Un écran qui fait quarante-cinq appels met plus de deux secondes à s’afficher. Ces règles ramènent ce nombre à un.

LECT-01 · Lisez la base une seule fois par écran

Section intitulée « LECT-01 · Lisez la base une seule fois par écran »

Pourquoi. Un écran qui fait quarante-cinq appels met plus de deux secondes à s’afficher avant même de calculer quoi que ce soit.

À éviter
// app/suivi/page.tsx
const lignes = await db.lire("operation").select("*");
const compteurs = await db.appeler("compteurs_du_suivi");
const alertes = await db.appeler("alertes_du_suivi");
À faire
// app/suivi/page.tsx
const { data } = await db.appeler("page_suivi", { p_annee: annee, p_suivi: suivi });
const { lignes, compteurs, alertes } = data;

Outil Chaque route a un budget de lectures ; un contrôle compte les appels réels et refuse la mise en ligne s’il est dépassé.

Voir aussi. Nommer les fonctions d’écran

LECT-02 · Lancez en parallèle ce qui est indépendant

Section intitulée « LECT-02 · Lancez en parallèle ce qui est indépendant »
À éviter
const page = await db.appeler("page_suivi", { p_annee: annee });
const portefeuille = await db.appeler("mon_portefeuille");
À faire
const [{ data: page }, { data: portefeuille }] = await Promise.all([
db.appeler("page_suivi", { p_annee: annee }),
db.appeler("mon_portefeuille"),
]);

Relecture Un await de plus sur une lecture est un aller-retour de plus.

Pourquoi. Chaque tour de boucle est un aller-retour : quarante-cinq opérations, quarante-cinq appels.

À éviter
for (const op of operations) {
const { data } = await db.lire("piece").select("*").eq("operation_id", op.id);
}
À faire
// une lecture regroupée côté base (nom de fonction donné en exemple)
const { data } = await db.appeler("pieces_des_operations", {
p_ids: operations.map((o) => o.id),
});

Outil Le budget de lectures de la route échoue.

Relecture Seule la page lit la base : les composants enfants reçoivent leurs données.

LECT-04 · Comptez, sommez et paginez côté serveur

Section intitulée « LECT-04 · Comptez, sommez et paginez côté serveur »

Pourquoi. L’API tronque à mille lignes sans erreur : un total calculé dans le navigateur est faux, et personne ne le voit.

À éviter
const { data } = await db.lire("piece").select("montant_ht");
const total = data.reduce((s, p) => s + p.montant_ht, 0); // faux au-delà de 1000 lignes
À faire
const { data: total } = await db.appeler("total_des_pieces", { p_annee: annee });

Relecture Une liste entière se lit par la fonction qui lève si le compte ne tombe pas.

LECT-05 · N’appelez pas une fonction SQL pour chaque ligne

Section intitulée « LECT-05 · N’appelez pas une fonction SQL pour chaque ligne »
À éviter
select l.*, taux_reel(l.id) from ligne l; -- une exécution par ligne
À faire
select l.*, t.valeur from ligne l join taux t on t.ligne_id = l.id; -- calculé une fois

Relecture Et jamais de vue en union dans une sous-requête corrélée : agrégez une fois, à part.

LECT-06 · Mettez la société dans la clé de la mémoire

Section intitulée « LECT-06 · Mettez la société dans la clé de la mémoire »

Pourquoi. Sans la société dans la clé, un compte lit la liste d’un autre.

À éviter
memo("clients", () => lireLesClients());
À faire
memo(["clients", societeId], () => lireLesClients());

Relecture Une page qui lit l’adresse, un cookie ou la session sort du cache.

Pourquoi. La copie locale compare deux versions, elle ne donne pas les temps de la production.

À éviter
{ "/suivi": "pas de budget, on verra" }
À faire
{ "/suivi": { "lectures": 1 } }

Outil Le budget de lectures de chaque route est dans tests/vitesse.json ; ajouter une lecture, c’est modifier ce budget et le justifier.

Outil Un seul composant du cadre pose l’état « en route » au clic sur un lien ou un envoi.

Règle À retenir Tenue par
LECT-01 Lisez la base une seule fois par écran Outil
LECT-02 Lancez en parallèle ce qui est indépendant Relecture
LECT-03 Ne lisez jamais dans une boucle Outil, Relecture
LECT-04 Comptez, sommez et paginez côté serveur Relecture
LECT-05 N’appelez pas une fonction SQL pour chaque ligne Relecture
LECT-06 Mettez la société dans la clé de la mémoire Relecture
LECT-07 Mesurez avant d’optimiser Outil
LECT-08 Répondez au clic tout de suite Outil