CollectFlow/src/types/grid.ts

/**
 * CollectFlow - Core Grid Types
 * Maps to the `ventes_produits` table via Drizzle ORM (camelCase).
 */

/** One row in the data grid, representing a product at a store for one period. */
export interface VenteProduit {
    id: number;
    codein: string;
    codeFournisseur: string | null;
    nomFournisseur: string | null;
    libelle1: string | null;
    gtin: string | null;
    reference: string | null;
    codeGamme: GammeCode | null;
    codeGammeInit: GammeCode | null;
    code3: string | null;
    libelle3: string | null;
    magasin: string;
    codeMagasin: string | null;
    annee: number | null;
    mois: number | null;
    periode: string;
    quantite: number | null;
    montantMvt: number | null;
    margeMvt: number | null;
}

/** A/B/C/Z status codes for product categories, but can be any string from DB (like 'Aucune') */
export type GammeCode = string;

/** A product row with its 12-month sales history and computed KPIs */
export interface ProductRow {
    codein: string;
    codeFournisseur: string;
    nomFournisseur: string;
    libelle1: string;
    gtin: string;
    reference: string;
    code1: string;
    libelleNiveau1: string;
    code2: string;
    libelleNiveau2: string;
    code3: string;
    libelle3: string;
    codeGamme: GammeCode | null;
    codeGammeInit: GammeCode | null;
    /** Draft gamme value before saving */
    codeGammeDraft: GammeCode | null;
    /** 12-month sales quantities, indexed by YYYYMM key */
    sales12m: Record<string, number>;
    totalQuantite: number;
    totalCa: number;
    totalMarge: number;
    tauxMarge: number;
    /** Combined performance score (0-10) */
    score: number;
    workingStores: string[];
    aiRecommendation?: string | null;
    /** Moyennes de comparaison pour l'IA */
    avgQtyFournisseur?: number;
    avgQtyRayon?: number;
    /** Poids relatifs (%) du produit chez le fournisseur */
    shareCa?: number;
    shareMarge?: number;
    shareQty?: number;
    /** Référentiels globaux */
    totalFournisseurCa?: number;
}

/** Summary bar totals for the currently visible/filtered rows */
export interface GridSummary {
    totalProducts: number;
    totalRows: number;
    totalQuantite: number;
    totalCa: number;
    totalMarge: number;
    tauxMargeGlobal: number;
}

/** Filters applied to the grid */
export interface GridFilters {
    magasin: string | null;
    codeFournisseur: string | null;
    code1: string | null;
    code2: string | null;
    code3: string | null;
    codeGamme: GammeCode | null;
    search: string;
}