fix(pagination) : éviter la troncature silencieuse des collections paginées (LST-52)

API Platform pagine par défaut à 30 éléments/page et le helper front
extractHydraMembers ne lit que la première page (il ignore hydra:view.next),
ce qui tronque silencieusement toute liste de plus de 30 éléments.

- Back : paginationEnabled false sur les GetCollection consommées en entier
  et à volume borné/modéré (Client, Project, User, TaskTag, TaskGroup,
  TaskStatus, TaskPriority, TaskEffort, Workflow).
- Front : nouveau helper fetchAllHydra() qui parcourt toutes les pages ;
  utilisé pour /notifications (volume non borné, reste paginé côté back).
- Doc : règle anti-troncature ajoutée au CLAUDE.md.

Déjà protégés (vérifiés) : Task, TimeEntry, TaskDocument, TaskRecurrence,
AbsenceRequest/Policy/Balance (paginationEnabled false) et /time_entries/range.
This commit is contained in:
Matthieu
2026-06-15 11:07:59 +02:00
parent 4e430cca43
commit 4d3879156d
12 changed files with 59 additions and 11 deletions
+43
View File
@@ -8,3 +8,46 @@ export type HydraCollection<T> = {
export function extractHydraMembers<T>(response: HydraCollection<T>): T[] {
return response['hydra:member'] ?? response['member'] ?? []
}
function extractHydraTotal<T>(response: HydraCollection<T>): number | undefined {
return response['hydra:totalItems'] ?? response['totalItems']
}
/**
* Récupère TOUS les éléments d'une collection Hydra paginée en parcourant les pages.
*
* `extractHydraMembers` ne lit que la première page (30 éléments par défaut côté
* API Platform) : toute liste plus longue est tronquée silencieusement. Utiliser
* ce helper dès qu'une collection potentiellement > 30 éléments doit être
* affichée en entier alors que sa ressource back reste paginée.
*
* `fetchPage` reçoit le numéro de page (1-indexé) et doit renvoyer la collection
* Hydra correspondante (passer `page` en query param de l'appel API).
*
* @param maxPages garde-fou anti-boucle infinie (par défaut 1000 pages).
*/
export async function fetchAllHydra<T>(
fetchPage: (page: number) => Promise<HydraCollection<T>>,
maxPages = 1000,
): Promise<T[]> {
const first = await fetchPage(1)
const all = extractHydraMembers(first)
const total = extractHydraTotal(first)
if (total === undefined) {
return all
}
let page = 2
while (all.length < total && page <= maxPages) {
const next = await fetchPage(page)
const members = extractHydraMembers(next)
if (members.length === 0) {
break
}
all.push(...members)
page += 1
}
return all
}