kbcrm/Client/models/kunde.ts

import m from "mithril"

/**
 * Datenmodell für einen Kunden.
 *
 * Modèle de données pour un client.
 */
export interface iKunde {
    id: number
    name: string
    strasse: string
    plz: string
    ort: string
    land: string
}

/**
 * In-Memory-Datenspeicher für Kunden. Wird als Fallback solange verwendet,
 * bis die serverseitigen REST-Endpunkte verfügbar sind.
 *
 * Stockage en mémoire des clients. Utilisé comme solution de repli tant
 * que les points de terminaison REST côté serveur ne sont pas disponibles.
 */
export const kundenDaten: iKunde[] = [
    {id: 1, name: "Musterfirma GmbH", strasse: "Musterstraße 1", plz: "12345", ort: "Musterstadt", land: "Deutschland"},
    {id: 2, name: "Beispiel AG", strasse: "Beispielweg 2", plz: "54321", ort: "Beispielstadt", land: "Deutschland"},
    {id: 3, name: "Test Unternehmen", strasse: "Testallee 3", plz: "67890", ort: "Testdorf", land: "Österreich"}
]

/**
 * Liefert die nächste freie Kunden-ID auf Basis des In-Memory-Speichers.
 * Sobald die serverseitige ID-Vergabe verfügbar ist, entfällt diese Funktion.
 *
 * Retourne le prochain identifiant client libre à partir du stockage en
 * mémoire. Cette fonction deviendra obsolète dès que l'attribution des
 * identifiants côté serveur sera disponible.
 */
export function getNewKundeId(): number {
    if (kundenDaten.length === 0) {
        return 1
    }
    return Math.max(...kundenDaten.map((kunde: iKunde) => kunde.id)) + 1
}

/**
 * Fügt einen neuen Kunden dem In-Memory-Speicher hinzu.
 *
 * Ajoute un nouveau client au stockage en mémoire.
 */
export function addKunde(kunde: iKunde): void {
    kundenDaten.push(kunde)
}

/**
 * Aktualisiert einen bestehenden Kunden im In-Memory-Speicher.
 *
 * Met à jour un client existant dans le stockage en mémoire.
 */
export function updateKunde(kunde: iKunde): void {
    const index = kundenDaten.findIndex((k: iKunde) => k.id === kunde.id)
    if (index !== -1) {
        kundenDaten[index] = kunde
    }
}

/**
 * Liefert eine Kopie aller Kunden aus dem In-Memory-Speicher.
 *
 * Retourne une copie de tous les clients du stockage en mémoire.
 */
export function getKunden(): iKunde[] {
    return [...kundenDaten]
}

/* ------------------------------------------------------------------ */
/* REST-API-Aufrufe (Client-Seite)                                     */
/* ------------------------------------------------------------------ */
/* Die folgenden Funktionen kapseln die Kommunikation mit den           */
/* serverseitigen REST-Endpunkten. Die Endpunkte sind noch nicht       */
/* implementiert und werden später nachgereicht.                      */
/*                                                                      */
/* Les fonctions suivantes encapsulent la communication avec les       */
/* points de terminaison REST côté serveur. Ceux-ci ne sont pas encore */
/* implémentés et seront fournis ultérieurement.                       */
/* ------------------------------------------------------------------ */

/**
 * Basis-Pfad der Kunden-REST-Endpunkte.
 *
 * Chemin de base des points de terminaison REST des clients.
 */
const KUNDE_REST_BASE = "/xhr/kunde"

/**
 * Lädt die Kundenliste vom Server.
 *
 * Charge la liste des clients depuis le serveur.
 */
export function fetchKunden(): Promise<iKunde[]> {
    return m.request({
        method: "GET",
        url: KUNDE_REST_BASE + "/list"
    }).then((result) => result as iKunde[])
}

/**
 * Lädt einen einzelnen Kunden anhand seiner ID vom Server.
 *
 * Charge un client unique identifié par son id depuis le serveur.
 */
export function fetchKundeById(id: number): Promise<iKunde> {
    return m.request({
        method: "GET",
        url: KUNDE_REST_BASE + "/get",
        params: {id: id}
    }).then((result) => result as iKunde)
}

/**
 * Legt einen neuen Kunden serverseitig an.
 *
 * Crée un nouveau client côté serveur.
 */
export function createKundeREST(kunde: iKunde): Promise<iKunde> {
    return m.request({
        method: "POST",
        url: KUNDE_REST_BASE + "/create",
        body: kunde
    }).then((result) => result as iKunde)
}

/**
 * Aktualisiert einen bestehenden Kunden serverseitig.
 *
 * Met à jour un client existant côté serveur.
 */
export function updateKundeREST(kunde: iKunde): Promise<iKunde> {
    return m.request({
        method: "PUT",
        url: KUNDE_REST_BASE + "/update",
        body: kunde
    }).then((result) => result as iKunde)
}

/**
 * Löscht einen Kunden serverseitig anhand seiner ID.
 *
 * Supprime un client côté serveur identifié par son id.
 */
export function deleteKundeREST(id: number): Promise<void> {
    return m.request({
        method: "DELETE",
        url: KUNDE_REST_BASE + "/delete",
        params: {id: id}
    }).then(() => undefined)
}