Skip to content

ticketing

@mmm/ticketing

Ticketing für mmm-Anwendungen: ein Portal reicht Tickets ein (Formulardaten als JSON), Mitarbeiter arbeiten sie in der Admin-Oberfläche ab (Liste mit Filtern, Detail mit Verlauf, Status und Zuweisung).

Drei Pakete in einem Workspace:

PaketInhalt
@mmm/ticketing-contracts (contracts/)Wire-Typen, Status, Routen. Keine Laufzeit-Abhängigkeiten.
@mmm/server-ticketing (backend/)NestJS-Modul: Endpunkte, Service, Prisma-Repository.
@mmm/ui-ticketing (frontend/)Angular-Komponenten für die @mmm/ui-shell.

Installation

Terminal window
pnpm add @mmm/ticketing-contracts @mmm/server-ticketing # Backend
pnpm add @mmm/ticketing-contracts @mmm/ui-ticketing # Frontend

Das Prisma-Schema (prisma/schema.fragment.prisma) muss in das eigene Schema kopiert werden: zwei Modelle (Ticket, TicketEvent), zwei Enums. requesterId / assigneeId sind absichtlich nur Ids; Relationen zum eigenen User-Modell kann der Host ergänzen.

Einrichtung im Backend siehe backend/README.md, im Frontend frontend/README.md.

Entwicklung

Terminal window
pnpm install
pnpm build # contracts → backend → frontend
pnpm test # Jest im Backend

Der Backend-Build generiert zuerst den Prisma-Client aus dem Schema-Fragment (backend/src/generated, nicht eingecheckt).

Publish passiert über die Bitbucket-Pipeline (Tag v*); die Skripte unter deployment/ setzen die Versionen und ersetzen workspace:*.

Hinweise

  • Keine eigenen Permission-Keys: der Host übergibt pro Slot (create, read, manage) die Permissions, von denen der Aufrufer eine braucht.
  • Keine eigenen Benachrichtigungen: das Modul veröffentlicht nach jeder Änderung ein TicketDomainEvent je Verlaufseintrag; der Host konsumiert sie mit @OnTicketEvent() (in-process) oder ersetzt den TicketEventBus (z. B. durch einen Broker-Producer).
  • Kategorie-Labels liefert der Host über TicketCategoryCatalog (pro Mandant, z. B. aus einer Konfiguration) oder staticTicketCategories(list); unbekannte Schlüssel werden als Schlüssel angezeigt.