Skip to content

ui-ticketing

@mmm/ui-ticketing

Installation

Terminal window
pnpm add @mmm/ticketing-contracts @mmm/ui-ticketing

Peer Dependencies müssen im Service vorhanden sein: @angular/common, @angular/core, @angular/forms, @angular/router, @mmm/designsystem, @mmm/ui-modal, @mmm/ui-notification, @mmm/ui-table, rxjs.

Inhalt

  • provideTicketing(factory): Provider für eine Route; die Factory läuft im Injection-Kontext und liefert die TicketingConfig.
  • ticketingRoutes(): Liste ('') und Detail (':id').
  • TicketingApi: typisierter HTTP-Client (Typen aus @mmm/ticketing-contracts).
  • TicketsPage, TicketDetailPage: die beiden Seiten, falls sie einzeln gemountet werden sollen.

Schnellstart

import { inject } from '@angular/core';
import { Route } from '@angular/router';
import { AuthStore } from '@mmm/auth-ui';
import { provideTicketing, ticketingRoutes } from '@mmm/ui-ticketing';
export const ticketsRoute: Route = {
path: 'tickets',
providers: provideTicketing(() => {
const store = inject(AuthStore);
const anyOf = (...keys: string[]) => () => keys.some((k) => store.hasPermission(k));
return {
apiBase: '/api/tickets',
// dieselben Permissions wie die Slots des Server-Moduls
can: { read: anyOf('content.read', 'user.read'), manage: anyOf('content.manage', 'user.manage') },
currentUserId: () => Number(store.user?.id) || null,
// rendert TicketDetail.payload; Komponente mit Input `payload: JsonValue | null`
payloadView: MyPayloadView,
// optional: Bilder für die Status-Kacheln
statusImages: { OPEN: '/images/tickets/open.png' },
};
}),
children: ticketingRoutes(),
};

Die Liste hält die serverseitigen Filter in der URL; Sortierung, Suche und Paging in der Tabelle macht mmm-table im Browser.

Liste: Filter, Suche, Sortierung

Die Liste hält die serverseitigen Filter in der URL: Status, Kategorie, Zuweisung, Kunde und Erstellungszeitraum sind Filter-Chips von mmm-table (filterMode="none"; die Chips schreiben über den Store in die URL und folgen ihr, z. B. nach einem Klick auf eine Status-Kachel oder der Zurück-Taste). „Filter zurücksetzen“ in der Aktionsleiste leert alle. Suche, Sortierung („Sortiert nach …“) und Paging macht mmm-table im Browser über die geladenen Tickets.

Braucht @mmm/ui-table ab 1.8.0 (Filter-Chips inkl. date-range, Zeilenauswahl mit Bulk-Aktionen, Zellen mit Komponenten).

Liste anpassen (TicketingConfig.list)

Die Zeilen der Liste (TicketListRow) tragen die Rohwerte unter den Spaltenschlüsseln id, category (Label; Schlüssel in categoryKey), requester, createdAt (ISO), status, assignee; Sortierung, Suche und Filter arbeiten darauf. Wie eine Zelle aussieht, entscheidet list.formats je Spalte: Text oder eine Komponente ({ component, inputs }, gerendert über NgComponentOutlet). Standard: createdAt als relative Zeit mit der genauen Zeit als Tooltip (TicketTimeCell), status als farbiges Badge (TicketStatusBadge, Geschlossen rot), der Rest als Text. list.columns bekommt die fertigen Spalten und darf umsortieren, ausblenden oder ergänzen.

list: {
formats: {
createdAt: (row) => absoluteTime(row.createdAt), // Text statt relativ
status: (row) => ({ component: MyBadge, inputs: { status: row.status } }),
},
columns: (defaults) => defaults.filter((c) => c.key !== 'assignee'),
}

Auswahl und Bulk-Löschen

Mit can.manage() ist die Liste auswählbar (Checkbox je Zeile, „alle“ im Kopf); sobald Zeilen gewählt sind, ersetzt die Bulk-Leiste die Kopfzeile mit „N ausgewählt“ und „Löschen“ (Bestätigung, dann POST /tickets/bulk-delete, höchstens 500 auf einmal).

Bearbeiten und Anlegen

Mit can.manage() lassen sich im Detail Status, Zuweisung, Kategorie und Kunde ändern (jede Änderung ein Verlaufseintrag), Tickets löschen und in der Liste über „Neues Ticket“ ein Ticket für einen Kunden anlegen (Kategorie und Kunde, ohne Formulardaten; der Server nimmt requesterId nur von manage-Aufrufern an). Die Kunden kommen aus /tickets/meta (requesters).

Entwicklung

Terminal window
pnpm build # ng-packagr → dist/