tristan
998368f1f6
Le tableau des tickets démarre désormais à 25 items/page (au lieu de 10) via defaultItemsPerPage de usePaginatedList. 25 fait partie des options [10, 25, 50] et reste sous le max serveur (50) ; l'utilisateur peut toujours rebasculer via le sélecteur. Test de contrat du repository ajouté.
73 lines
3.3 KiB
TypeScript
73 lines
3.3 KiB
TypeScript
import { usePaginatedList } from '~/shared/composables/usePaginatedList'
|
||
import type { WeighingTicketStatus } from '~/modules/logistique/composables/useWeighingTicketForm'
|
||
|
||
/**
|
||
* Vue MINIMALE d'une contrepartie embarquee (Client M1 ou Fournisseur M2) dans la
|
||
* LISTE des tickets de pesee. Seul `companyName` alimente les colonnes
|
||
* « Client » / « Fournisseur » ; l'objet sort embarque (`client:read` /
|
||
* `supplier:read`) ou est carrement absent du JSON quand null (`skip_null_values`,
|
||
* spec-back § 4.0.bis) — d'ou le `?? null` systematique cote page.
|
||
*/
|
||
export interface WeighingTicketParty {
|
||
id: number
|
||
companyName: string | null
|
||
}
|
||
|
||
/**
|
||
* Vue MINIMALE d'un ticket de pesee pour la datatable (M5, ERP-188). Volontairement
|
||
* partielle : seuls les champs des colonnes (docx p.3) + l'id (navigation) sont
|
||
* types. Le detail complet (pesees vide/plein, immatriculation, site, DSD) releve
|
||
* de l'ecran Modification (ERP-190) — hors perimetre de cet ecran.
|
||
*
|
||
* Contrepartie mutuellement exclusive (RG-5.03) : un seul de `client` / `supplier`
|
||
* / `otherLabel` est renseigne ; les deux autres sont omis du JSON (null).
|
||
* `displayDate` = getter serveur `fullDate ?? emptyDate` (spec-back § 4.0).
|
||
* `netWeight` = plein − vide en kg (RG-5.05).
|
||
*/
|
||
export interface WeighingTicket {
|
||
id: number
|
||
/** Cycle de vie : DRAFT (« En attente ») ou VALIDATED (« Terminée ») — ERP-193. */
|
||
status: WeighingTicketStatus
|
||
/** Numero metier `{siteCode}-TP-{NNNN}` — null tant que brouillon (RG-5.02). */
|
||
number: string | null
|
||
/** Embarque uniquement si contrepartie = Client (RG-5.03), sinon absent. */
|
||
client: WeighingTicketParty | null
|
||
/** Embarque uniquement si contrepartie = Fournisseur (RG-5.03), sinon absent. */
|
||
supplier: WeighingTicketParty | null
|
||
/** Libelle libre si contrepartie = Autre (RG-5.03), sinon absent. */
|
||
otherLabel: string | null
|
||
/** Date ISO du ticket (`fullDate ?? emptyDate`) — colonne « Date ». */
|
||
displayDate: string | null
|
||
/** Poids net en kg (= plein − vide, RG-5.05) — colonne « Poids ». */
|
||
netWeight: number | null
|
||
}
|
||
|
||
/**
|
||
* Filtres de la liste des tickets de pesee, branches sur les query params de
|
||
* `GET /api/weighing_tickets` (spec-back § 4.1). La liste est par ailleurs
|
||
* cloisonnee par site courant cote back (`SiteScopedQueryExtension`, § 2.3) — le
|
||
* front n'a pas a envoyer le site.
|
||
*/
|
||
export interface WeighingTicketFilters {
|
||
search?: string
|
||
}
|
||
|
||
/**
|
||
* Liste des tickets de pesee (M5, ERP-188) — simple enveloppe de
|
||
* `usePaginatedList<WeighingTicket>` sur la ressource `/weighing_tickets`
|
||
* (URL API en snake_case ; la route Nuxt reste `/weighing-tickets`). Pagination
|
||
* serveur obligatoire (regle ABSOLUE n°13), etat 100 % local (regle ABSOLUE n°6).
|
||
*
|
||
* Miroir de `useCarriersRepository` (M4). Volontairement PAR INSTANCE (pas de
|
||
* singleton) : l'etat tableau est propre a l'ecran et meurt avec lui.
|
||
*/
|
||
export function useWeighingTicketsRepository() {
|
||
// Defaut 25 items/page (au lieu de 10) : la liste des tickets de pesee est
|
||
// consultee en volume. 25 fait partie des options [10, 25, 50] et reste sous le
|
||
// max serveur (50). L'utilisateur peut toujours basculer via le selecteur.
|
||
return usePaginatedList<WeighingTicket, WeighingTicketFilters>({
|
||
url: '/weighing_tickets',
|
||
defaultItemsPerPage: 25,
|
||
})
|
||
}
|