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:
@@ -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
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user