feat(workflow): Tages-Workflow-UI für Telefon-Akquise (Liste + Maske)

Server: neuer Endpunkt /xhr/workflow/list aggregiert pro Kontaktadresse
die letzte Gesprächsnotiz, das effektiv gültige Wiedervorlage-Datum
(jüngste Notiz mit Wert), den Erledigt-Status und eine priorisierte
Sortierung (überfällig → ohne Notizen → Rest). Filter: kunden_id, status
(offen/erledigt), wiedervorlage (heute/3tage/ueberfaellig/woche).
Sichtbarkeit wie kontaktadressen über projekt_users.

CallLog erfasst den Ersteller serverseitig (user_id, Migration _db_V01_14,
kein FK wegen separater Auth-DB); to_dict ergänzt mitarbeiter_name.
calllog_list unterstützt kontaktadresse_id als Filter.

Client: TagesWorkflowListe (Route /tagesworkflow, Filterleiste) und
TagesWorkflowMaske (Route /tagesworkflowkontakt, lesende Historie,
Notiz-Formular mit "Speichern und weiter"), Routes + Menüpunkt erster
Eintrag. berechneWiedervorlageDatum aus der Call_Log-Maske nach
models/tag.ts ausgelagert (gemeinsame Nutzung).

Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>

Client/models/call_log.ts

@@ -8,6 +8,11 @@ import {iTag} from "./tag"
  * 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).
  * tags (vom Server beim Lesen) und tag_ids (vom Client beim Schreiben)
  * steuern die n:m-Beziehung zu den Tags.
  */
@@ -15,8 +20,12 @@ 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
@@ -73,6 +82,19 @@ export function fetchCallLogById(id: number): Promise<iCallLog> {
     }).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.
  */

Client/models/kontaktadresse.ts

@@ -4,16 +4,17 @@ import m from "mithril"
  * Datenmodell für eine Kontaktadresse (Akquise-Ziel innerhalb eines Projekts).
  * Jede Kontaktadresse ist genau einem Projekt zugeordnet (FK projekt_id).
  * Die Feldnamen entsprechen den serverseitigen ORM-Spalten (snake_case).
- * projekt_name ist keine ORM-Spalte, sondern wird serverseitig aus der
- * Projekt-Relationship abgeleitet und im JSON ergänzt. is_erledigt ist
- * ebenfalls keine Spalte, sondern wird serverseitig dynamisch berechnet:
- * True, sobald mindestens eine Gesprächsnotiz des Kontakts einen Tag mit
- * is_erledigend=True hat.
+ * projekt_name und kunden_name sind keine ORM-Spalten, sondern werden
+ * serverseitig aus den Projekt-/Kunde-Relationships abgeleitet und im
+ * JSON ergänzt. is_erledigt ist ebenfalls keine Spalte, sondern wird
+ * serverseitig dynamisch berechnet: True, sobald mindestens eine
+ * Gesprächsnotiz des Kontakts einen Tag mit is_erledigend=True hat.
  */
 export interface iKontaktadresse {
     id: number
     projekt_id: number
     projekt_name: string
+    kunden_name: string
     anrede: string
     name: string
     firma: string

Client/models/tag.ts

@@ -112,3 +112,32 @@ export function deleteTagREST(id: number): Promise<void> {
         params: {id: id}
     }).then(() => undefined)
 }
+
+/* ------------------------------------------------------------------ */
+/* Fachliche Hilfsfunktionen                                           */
+/* ------------------------------------------------------------------ */
+
+/**
+ * Berechnet das Wiedervorlage-Datum automatisch aus den ausgewählten
+ * Tags. Basis ist das übergebene Basisdatum (z.B. das Datum der Notiz
+ * oder heute). Aus allen ausgewählten Tags mit
+ * loest_wiedervorlage_aus=True wird das Minimum von
+ * wiedervorlage_abstand_tage ermittelt und zum Basisdatum addiert.
+ * Liefert einen leeren String, wenn kein Tag mit
+ * loest_wiedervorlage_aus=True ausgewählt ist.
+ *
+ * Wird von der Call_Log-Maske und der Tages-Workflow-Maske genutzt,
+ * damit die Berechnungslogik nur an einer Stelle gepflegt wird.
+ */
+export function berechneWiedervorlageDatum(tagIds: number[],
+                                           tagListe: iTag[],
+                                           basisdatum: string): string {
+    const wvTags = tagListe.filter((t: iTag) =>
+        tagIds.includes(t.id) && t.loest_wiedervorlage_aus && t.wiedervorlage_abstand_tage != null
+    )
+    if (wvTags.length === 0) return ""
+    const minAbstand = Math.min(...wvTags.map(t => t.wiedervorlage_abstand_tage as number))
+    const basisDate = new Date(basisdatum)
+    basisDate.setDate(basisDate.getDate() + minAbstand)
+    return basisDate.toISOString().split('T')[0]
+}

Client/models/tages_workflow.ts

@@ -0,0 +1,84 @@
+import m from "mithril"
+import {iTag} from "./tag"
+
+/**
+ * Datenmodell für einen Eintrag der Tages-Workflow-Liste. Der Server
+ * aggregiert pro Kontaktadresse: die letzte Gesprächsnotiz, das aktuell
+ * gültige Wiedervorlage-Datum (jüngste Notiz, die eines gesetzt hat)
+ * und den dynamisch berechneten Erledigt-Status. Die Sortierung erfolgt
+ * serverseitig priorisiert (überfällige Wiedervorlagen, dann Kontakte
+ * ohne Notizen, dann der Rest nach Wiedervorlage).
+ */
+export interface iTagesWorkflowEntry {
+    kontaktadresse_id: number
+    projekt_id: number
+    projekt_name: string
+    kunden_id: number
+    kunden_name: string
+    anrede: string
+    name: string
+    firma: string
+    position: string
+    telefon: string
+    email: string
+    /** Dynamisch berechneter Erledigt-Status (keine ORM-Spalte). */
+    is_erledigt: boolean
+    /** Text der letzten Gesprächsnotiz; null, wenn der Kontakt keine Notiz hat. */
+    letzte_notiz: string | null
+    /** Datum der letzten Gesprächsnotiz (ISO yyyy-MM-dd); null ohne Notizen. */
+    letzte_notiz_datum: string | null
+    /** Uhrzeit Beginn der letzten Gesprächsnotiz; null ohne Notizen. */
+    letzte_notiz_uhrzeit: string | null
+    /** Tags der letzten Gesprächsnotiz; leere Liste ohne Notizen. */
+    letzte_notiz_tags: iTag[]
+    /** Aktuell gültiges Wiedervorlage-Datum (ISO yyyy-MM-dd) oder null. */
+    wiedervorlage_datum: string | null
+}
+
+/**
+ * Filter-Einstellungen der Tages-Workflow-Liste. Alle Felder optional;
+ * nicht gesetzte Felder wirken wie kein Filter. Die Filter werden
+ * serverseitig angewendet.
+ */
+export interface iTagesWorkflowFilter {
+    /** Nur Kontaktadressen von Projekten dieses Kunden. */
+    kunden_id?: number
+    /** 'offen' = nur nicht erledigte, 'erledigt' = nur erledigte Kontakte. */
+    status?: string
+    /** 'heute', '3tage', 'ueberfaellig' oder 'woche' (ISO-Kalenderwoche). */
+    wiedervorlage?: string
+}
+
+/* ------------------------------------------------------------------ */
+/* REST-API-Aufrufe (Client-Seite)                                     */
+/* ------------------------------------------------------------------ */
+
+/**
+ * Basis-Pfad der Tages-Workflow-REST-Endpunkte.
+ */
+const WORKFLOW_REST_BASE = "/xhr/workflow"
+
+/**
+ * Lädt die Tages-Workflow-Liste vom Server: pro Kontaktadresse ein
+ * aggregierter Eintrag (letzte Notiz, Wiedervorlage, Status), gefiltert
+ * und priorisiert sortiert.
+ */
+export function fetchTagesWorkflowList(filter?: iTagesWorkflowFilter): Promise<iTagesWorkflowEntry[]> {
+    const params: Record<string, any> = {}
+    if (filter) {
+        if (filter.kunden_id !== undefined && filter.kunden_id >= 0) {
+            params.kunden_id = filter.kunden_id
+        }
+        if (filter.status) {
+            params.status = filter.status
+        }
+        if (filter.wiedervorlage) {
+            params.wiedervorlage = filter.wiedervorlage
+        }
+    }
+    return m.request({
+        method: "GET",
+        url: WORKFLOW_REST_BASE + "/list",
+        params: params
+    }).then((result) => result as iTagesWorkflowEntry[])
+}