kbcrm/Client/models/call_log.ts

import m from "mithril"
import {iTag} from "./tag"

/**
 * Datenmodell für eine Gesprächsnotiz (Call-Log).
 * Die Feldnamen entsprechen den serverseitigen ORM-Spalten (snake_case).
 * projekt_name und kunden_name sind keine ORM-Spalten, sondern werden
 * serverseitig aus der Projekt-Relationship abgeleitet und im JSON ergänzt.
 * tags (vom Server beim Lesen) und tag_ids (vom Client beim Schreiben)
 * steuern die n:m-Beziehung zu den Tags.
 */
export interface iCallLog {
    id: number
    projekt_id: number
    projekt_name: string
    kunden_name: string
    datum: string
    uhrzeit_beginn: string
    dauer: string
    betreff: string
    name_ansprechpartner: string
    telefon: string
    notiz: string
    wiedervorlage_datum: string
    erledigt: boolean
    /** Vom Server gelieferte zugeordnete Tags (nur beim Lesen). */
    tags?: iTag[]
    /** Vom Client zu übermittelnde Tag-IDs (nur beim Schreiben). */
    tag_ids?: number[]
}

/* ------------------------------------------------------------------ */
/* REST-API-Aufrufe (Client-Seite)                                     */
/* ------------------------------------------------------------------ */
/* Die folgenden Funktionen kapseln die Kommunikation mit den           */
/* serverseitigen REST-Endpunkten (/xhr/calllog/*).                    */
/* ------------------------------------------------------------------ */

/**
 * Basis-Pfad der Call-Log-REST-Endpunkte.
 */
const CALLLOG_REST_BASE = "/xhr/calllog"

/**
 * Lädt die Liste der Gesprächsnotizen vom Server.
 * Ist projektId gesetzt (>= 0), werden nur die Notizen dieses Projekts
 * geliefert (serverseitige Filterung). Ohne Parameter werden alle
 * Notizen geliefert.
 */
export function fetchCallLogs(projektId?: number): Promise<iCallLog[]> {
    const params: Record<string, any> = {}
    if (projektId !== undefined && projektId >= 0) {
        params.projekt_id = projektId
    }
    return m.request({
        method: "GET",
        url: CALLLOG_REST_BASE + "/list",
        params: params
    }).then((result) => result as iCallLog[])
}

/**
 * Lädt eine einzelne Gesprächsnotiz anhand ihrer ID vom Server.
 */
export function fetchCallLogById(id: number): Promise<iCallLog> {
    return m.request({
        method: "GET",
        url: CALLLOG_REST_BASE + "/get",
        params: {id: id}
    }).then((result) => result as iCallLog)
}

/**
 * Legt eine neue Gesprächsnotiz serverseitig an.
 */
export function createCallLogREST(log: iCallLog): Promise<iCallLog> {
    return m.request({
        method: "POST",
        url: CALLLOG_REST_BASE + "/create",
        body: log
    }).then((result) => result as iCallLog)
}

/**
 * Aktualisiert eine bestehende Gesprächsnotiz serverseitig.
 */
export function updateCallLogREST(log: iCallLog): Promise<iCallLog> {
    return m.request({
        method: "PUT",
        url: CALLLOG_REST_BASE + "/update",
        body: log
    }).then((result) => result as iCallLog)
}

/**
 * Löscht eine Gesprächsnotiz serverseitig anhand ihrer ID.
 */
export function deleteCallLogREST(id: number): Promise<void> {
    return m.request({
        method: "DELETE",
        url: CALLLOG_REST_BASE + "/delete",
        params: {id: id}
    }).then(() => undefined)
}