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.
 * kontaktadresse_id ist Pflichtfeld: Jede Notiz gehört zu genau einer
 * Kontaktadresse (Fremdschlüssel auf kontaktadressen.id).
 * user_id erfasst den Ersteller (Mitarbeiter, der den Anruf getätigt hat);
 * sie wird serverseitig beim Anlegen gesetzt und nie vom Client gesendet.
 * Alt-Notizen ohne erfassten Ersteller haben null.
 * mitarbeiter_name ist keine Spalte, sondern wird serverseitig aus der
 * user_id gegen die Auth-Datenbank aufgelöst (null ohne user_id).
 * Ein Erledigt-Status ist bewusst kein Feld der Notiz: Er ergibt sich
 * daraus, ob einer der zugeordneten Tags is_erledigend=True hat (siehe
 * Kontaktadresse.is_erledigt).
 * 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
    kontaktadresse_id: number
    /** Ersteller (Mitarbeiter), serverseitig gesetzt; null bei Alt-Notizen. */
    user_id: number | null
    projekt_name: string
    kunden_name: string
    /** Aufgelöster Username des Erstellers; null bei Alt-Notizen. */
    mitarbeiter_name: string | null
    datum: string
    uhrzeit_beginn: string
    dauer: string
    betreff: string
    name_ansprechpartner: string
    telefon: string
    notiz: string
    wiedervorlage_datum: string
    /** 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)
}

/**
 * Lädt die Gesprächsnotizen eines einzelnen Kontakts (Kontaktadresse)
 * vom Server — serverseitig nach kontaktadresse_id gefiltert. Wird für
 * die Historie in der Tages-Workflow-Maske genutzt.
 */
export function fetchCallLogsByKontaktadresse(kontaktadresseId: number): Promise<iCallLog[]> {
    return m.request({
        method: "GET",
        url: CALLLOG_REST_BASE + "/list",
        params: {kontaktadresse_id: kontaktadresseId}
    }).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)
}