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:
| Paket | Inhalt |
|---|---|
@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
pnpm add @mmm/ticketing-contracts @mmm/server-ticketing # Backendpnpm add @mmm/ticketing-contracts @mmm/ui-ticketing # FrontendDas 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
pnpm installpnpm build # contracts → backend → frontendpnpm test # Jest im BackendDer 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
TicketDomainEventje Verlaufseintrag; der Host konsumiert sie mit@OnTicketEvent()(in-process) oder ersetzt denTicketEventBus(z. B. durch einen Broker-Producer). - Kategorie-Labels liefert der Host über
TicketCategoryCatalog(pro Mandant, z. B. aus einer Konfiguration) oderstaticTicketCategories(list); unbekannte Schlüssel werden als Schlüssel angezeigt.