@cosmicdrift/kumiko-samples 0.412.0 → 0.413.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/package.json +1 -1
- package/packages/bundled-features/package.json +13 -13
- package/packages/bundled-features/src/admin-shell/feature.ts +1 -1
- package/packages/bundled-features/src/agent-tools/api-docs/anchors.ts +1 -1
- package/packages/bundled-features/src/auth-email-password/boot-rules.ts +9 -0
- package/packages/bundled-features/src/auth-email-password/feature.ts +6 -19
- package/packages/bundled-features/src/auth-email-password/validate-options.ts +20 -0
- package/packages/bundled-features/src/billing-foundation/boot-rules.ts +26 -0
- package/packages/bundled-features/src/billing-foundation/validate-options.ts +59 -46
- package/packages/bundled-features/src/cap-overview/boot-rules.ts +14 -0
- package/packages/bundled-features/src/cap-overview/feature.ts +12 -5
- package/packages/bundled-features/src/documents/boot-rules.ts +14 -0
- package/packages/bundled-features/src/documents/feature.ts +8 -4
- package/packages/bundled-features/src/file-derivatives/boot-rules.ts +9 -0
- package/packages/bundled-features/src/file-derivatives/feature.ts +6 -3
- package/packages/bundled-features/src/folders/boot-rules.ts +9 -0
- package/packages/bundled-features/src/folders/feature.ts +6 -3
- package/packages/bundled-features/src/helpdesk/boot-rules.ts +9 -0
- package/packages/bundled-features/src/{contact → helpdesk}/challenge.ts +2 -2
- package/packages/bundled-features/src/{contact → helpdesk}/changes.json +6 -0
- package/packages/bundled-features/src/{contact/client/contact-client-source.ts → helpdesk/client/helpdesk-client-source.ts} +4 -4
- package/packages/bundled-features/src/helpdesk/client/helpdesk-website-client.ts +29 -0
- package/packages/bundled-features/src/helpdesk/client/index.ts +9 -0
- package/packages/bundled-features/src/{contact → helpdesk}/entity.ts +35 -31
- package/packages/bundled-features/src/{contact → helpdesk}/feature.ts +56 -52
- package/packages/bundled-features/src/{contact → helpdesk}/handlers/attempts.ts +3 -3
- package/packages/bundled-features/src/{contact → helpdesk}/handlers/challenge.query.ts +10 -10
- package/packages/bundled-features/src/{contact → helpdesk}/handlers/forward-request.write.ts +25 -23
- package/packages/bundled-features/src/{contact → helpdesk}/handlers/mark-done.write.ts +11 -11
- package/packages/bundled-features/src/{contact → helpdesk}/handlers/notify-reporter-in-app.write.ts +14 -14
- package/packages/bundled-features/src/{contact → helpdesk}/handlers/open-count.query.ts +4 -4
- package/packages/bundled-features/src/{contact → helpdesk}/handlers/open-count.ts +2 -2
- package/packages/bundled-features/src/{contact → helpdesk}/handlers/replies.query.ts +6 -6
- package/packages/bundled-features/src/{contact → helpdesk}/handlers/reply.write.ts +30 -30
- package/packages/bundled-features/src/{contact → helpdesk}/handlers/report.write.ts +29 -29
- package/packages/bundled-features/src/{contact → helpdesk}/handlers/request-delivery.query.ts +40 -40
- package/packages/bundled-features/src/{contact → helpdesk}/handlers/request-detail.query.ts +15 -15
- package/packages/bundled-features/src/{contact → helpdesk}/handlers/request-list.query.ts +2 -2
- package/packages/bundled-features/src/{contact → helpdesk}/handlers/send-reply-mail.write.ts +24 -24
- package/packages/bundled-features/src/{contact → helpdesk}/handlers/send-test.write.ts +18 -14
- package/packages/bundled-features/src/{contact → helpdesk}/handlers/submit.write.ts +32 -31
- package/packages/bundled-features/src/{contact → helpdesk}/handlers/take-over-uploads.ts +5 -5
- package/packages/bundled-features/src/{contact → helpdesk}/i18n.ts +78 -75
- package/packages/bundled-features/src/helpdesk/index.ts +29 -0
- package/packages/bundled-features/src/{contact → helpdesk}/lib.ts +32 -28
- package/packages/bundled-features/src/{contact → helpdesk}/mail.ts +56 -56
- package/packages/bundled-features/src/{contact → helpdesk}/options.ts +18 -16
- package/packages/bundled-features/src/helpdesk/panels.ts +28 -0
- package/packages/bundled-features/src/{contact → helpdesk}/payloads.ts +33 -33
- package/packages/bundled-features/src/{contact → helpdesk}/screens.ts +104 -104
- package/packages/bundled-features/src/{contact → helpdesk}/subject.ts +3 -3
- package/packages/bundled-features/src/{contact → helpdesk}/user-data-hooks.ts +17 -17
- package/packages/bundled-features/src/helpdesk/web/constants.ts +160 -0
- package/packages/bundled-features/src/helpdesk/web/index.ts +29 -0
- package/packages/bundled-features/src/host-routing/boot-rules.ts +27 -0
- package/packages/bundled-features/src/host-routing/validate-options.ts +36 -27
- package/packages/bundled-features/src/jobs/boot-rules.ts +9 -0
- package/packages/bundled-features/src/jobs/feature.ts +9 -4
- package/packages/bundled-features/src/legal-pages/boot-rules.ts +19 -0
- package/packages/bundled-features/src/legal-pages/feature.ts +6 -3
- package/packages/bundled-features/src/legal-pages/lib/validate-routes.ts +11 -5
- package/packages/bundled-features/src/metrics/boot-rules.ts +15 -0
- package/packages/bundled-features/src/metrics/validate.ts +8 -2
- package/packages/bundled-features/src/notes-history/boot-rules.ts +9 -0
- package/packages/bundled-features/src/notes-history/feature.ts +6 -3
- package/packages/bundled-features/src/personal-access-tokens/boot-rules.ts +9 -0
- package/packages/bundled-features/src/personal-access-tokens/scope-events-check.ts +6 -3
- package/packages/bundled-features/src/presence/boot-rules.ts +9 -0
- package/packages/bundled-features/src/presence/options.ts +5 -1
- package/packages/bundled-features/src/readiness/boot-rules.ts +14 -0
- package/packages/bundled-features/src/readiness/probe-boot-check.ts +8 -6
- package/packages/bundled-features/src/shared/assert-no-where-rule-in-ownership-write.ts +6 -4
- package/packages/bundled-features/src/shared/boot-rules.ts +9 -0
- package/packages/bundled-features/src/subscription-mollie/boot-rules.ts +19 -0
- package/packages/bundled-features/src/subscription-mollie/feature.ts +18 -10
- package/packages/bundled-features/src/tags/boot-rules.ts +9 -0
- package/packages/bundled-features/src/tags/feature.ts +6 -3
- package/packages/bundled-features/src/template-resolver/boot-rules.ts +19 -0
- package/packages/bundled-features/src/template-resolver/feature.ts +14 -10
- package/packages/bundled-features/src/tenant/boot-rules.ts +9 -0
- package/packages/bundled-features/src/tenant/feature.ts +5 -3
- package/samples/apps/marketing-demo/README.md +1 -1
- package/samples/apps/marketing-demo/playwright.config.ts +1 -1
- package/samples/apps/marketing-demo/src/app/client.tsx +3 -3
- package/samples/apps/marketing-demo/src/app/seed-data.ts +1 -1
- package/samples/apps/marketing-demo/src/app/seed.ts +4 -4
- package/samples/apps/marketing-demo/src/app/server.ts +3 -3
- package/samples/apps/marketing-demo/src/features/{helpdesk → ticketing}/feature.ts +15 -12
- package/samples/apps/marketing-demo/src/features/ticketing/i18n.ts +100 -0
- package/samples/apps/marketing-demo/src/features/{helpdesk → ticketing}/schema/ticket.ts +4 -4
- package/samples/apps/marketing-demo/src/features/ticketing/web/index.ts +7 -0
- package/samples/apps/use-all-bundled/feature-manifest.json +67 -67
- package/samples/apps/use-all-bundled/kumiko/migrations/0064_helpdesk-rename.rebuild.json +4 -0
- package/samples/apps/use-all-bundled/package.json +1 -1
- package/samples/apps/use-all-bundled/src/app/client.tsx +1 -1
- package/samples/apps/use-all-bundled/src/app/screens-feature.ts +10 -10
- package/samples/apps/use-all-bundled/src/run-config.ts +6 -6
- package/samples/recipes/api-docs/README.md +3 -3
- package/samples/recipes/api-docs/api-docs/de/events.md +14 -14
- package/samples/recipes/api-docs/api-docs/de/overview.md +3 -3
- package/samples/recipes/api-docs/api-docs/de/reference/tickets.md +10 -10
- package/samples/recipes/api-docs/api-docs/de/tokens.md +4 -4
- package/samples/recipes/api-docs/api-docs/en/events.md +14 -14
- package/samples/recipes/api-docs/api-docs/en/overview.md +3 -3
- package/samples/recipes/api-docs/api-docs/en/reference/tickets.md +10 -10
- package/samples/recipes/api-docs/api-docs/en/tokens.md +4 -4
- package/samples/recipes/api-docs/api-docs/index.json +22 -22
- package/samples/recipes/api-docs/api-docs/openapi.json +67 -67
- package/samples/recipes/api-docs/api-examples/ticket-close.json +1 -1
- package/samples/recipes/api-docs/api-examples/ticket-create.json +1 -1
- package/samples/recipes/api-docs/api-examples/ticket-detail.json +1 -1
- package/samples/recipes/api-docs/api-examples/ticket-list.json +1 -1
- package/samples/recipes/api-docs/api-examples/ticket-update.json +1 -1
- package/samples/recipes/api-docs/api-examples/webhooks/ticket-closed.json +1 -1
- package/samples/recipes/api-docs/kumiko.config.ts +4 -4
- package/samples/recipes/api-docs/src/feature.ts +44 -44
- package/samples/recipes/golden-path/src/feature.ts +1 -1
- package/samples/recipes/{contact → helpdesk}/README.md +16 -16
- package/samples/recipes/{contact → helpdesk}/package.json +2 -2
- package/samples/recipes/{contact → helpdesk}/src/feature.ts +6 -6
- package/packages/bundled-features/src/contact/client/contact-website-client.ts +0 -29
- package/packages/bundled-features/src/contact/client/index.ts +0 -9
- package/packages/bundled-features/src/contact/index.ts +0 -29
- package/packages/bundled-features/src/contact/panels.ts +0 -28
- package/packages/bundled-features/src/contact/web/constants.ts +0 -160
- package/packages/bundled-features/src/contact/web/index.ts +0 -29
- package/samples/apps/marketing-demo/src/features/helpdesk/i18n.ts +0 -100
- package/samples/apps/marketing-demo/src/features/helpdesk/web/index.ts +0 -7
- /package/packages/bundled-features/src/{contact → helpdesk}/handlers/access.ts +0 -0
- /package/packages/bundled-features/src/{contact → helpdesk}/pow.ts +0 -0
- /package/packages/bundled-features/src/{contact → helpdesk}/user-agent.ts +0 -0
- /package/samples/apps/marketing-demo/src/features/{helpdesk → ticketing}/schema/index.ts +0 -0
|
@@ -88,7 +88,7 @@ export const ticketEditScreen: EntityEditScreenDefinition = {
|
|
|
88
88
|
layout: {
|
|
89
89
|
sections: [
|
|
90
90
|
{
|
|
91
|
-
title: "
|
|
91
|
+
title: "ticketing:section.ticket",
|
|
92
92
|
columns: 2,
|
|
93
93
|
fields: [
|
|
94
94
|
{ field: "title", span: 2 },
|
|
@@ -100,12 +100,12 @@ export const ticketEditScreen: EntityEditScreenDefinition = {
|
|
|
100
100
|
],
|
|
101
101
|
},
|
|
102
102
|
{
|
|
103
|
-
title: "
|
|
103
|
+
title: "ticketing:section.people",
|
|
104
104
|
columns: 2,
|
|
105
105
|
fields: ["reporter", "assignee"],
|
|
106
106
|
},
|
|
107
107
|
{
|
|
108
|
-
title: "
|
|
108
|
+
title: "ticketing:section.tracking",
|
|
109
109
|
columns: 2,
|
|
110
110
|
fields: ["dueDate", "spentMinutes"],
|
|
111
111
|
},
|
|
@@ -131,6 +131,6 @@ export const ticketListScreen: EntityListScreenDefinition = {
|
|
|
131
131
|
pageSize: 25,
|
|
132
132
|
defaultSort: { field: "severity", dir: "desc" },
|
|
133
133
|
rowActions: [
|
|
134
|
-
{ kind: "navigate", id: "edit", label: "
|
|
134
|
+
{ kind: "navigate", id: "edit", label: "ticketing:actions.edit", screen: "ticket-edit" },
|
|
135
135
|
],
|
|
136
136
|
};
|
|
@@ -694,73 +694,6 @@
|
|
|
694
694
|
"recommended": true
|
|
695
695
|
}
|
|
696
696
|
},
|
|
697
|
-
{
|
|
698
|
-
"name": "contact",
|
|
699
|
-
"description": "Contact inbox: an anonymous browser client (GET /contact/client.js) submits questions, contact requests, bug reports and wishes behind a honeypot, a minimum submit time and a single-use proof-of-work challenge; signed-in users file reports from the admin. Every request is stored platform-wide and every SystemAdmin is notified by mail, optionally also in a Telegram chat (option `telegram`, off by default); the notification names only the kind, the app and a link, never name, address, phone, subject or message, because mail and Telegram cannot be shredded. SystemAdmins reply by mail (Reply-To set, attachments, quoting the original) and mark requests done; a website sender gets a fixed acknowledgement, a signed-in reporter a copy and an in-app note. Personal data is crypto-shredding-ready and the EXT_USER_DATA hooks export and erase a user's requests.",
|
|
700
|
-
"toggleableDefault": null,
|
|
701
|
-
"adoptsBundledLists": true,
|
|
702
|
-
"requires": [
|
|
703
|
-
"config",
|
|
704
|
-
"delivery",
|
|
705
|
-
"user-data-rights",
|
|
706
|
-
"files",
|
|
707
|
-
"notes-history"
|
|
708
|
-
],
|
|
709
|
-
"optionalRequires": [
|
|
710
|
-
"channel-telegram"
|
|
711
|
-
],
|
|
712
|
-
"configReads": [],
|
|
713
|
-
"exposesApis": [],
|
|
714
|
-
"usesApis": [],
|
|
715
|
-
"extensionsUsed": [
|
|
716
|
-
{
|
|
717
|
-
"extensionName": "userData",
|
|
718
|
-
"entityName": "contact-request"
|
|
719
|
-
},
|
|
720
|
-
{
|
|
721
|
-
"extensionName": "userData",
|
|
722
|
-
"entityName": "contact-reply"
|
|
723
|
-
}
|
|
724
|
-
],
|
|
725
|
-
"configKeys": [
|
|
726
|
-
{
|
|
727
|
-
"key": "reply-to",
|
|
728
|
-
"qualifiedName": "contact:config:reply-to",
|
|
729
|
-
"type": "text",
|
|
730
|
-
"scope": "system",
|
|
731
|
-
"default": "",
|
|
732
|
-
"encrypted": false,
|
|
733
|
-
"computed": false,
|
|
734
|
-
"validated": false,
|
|
735
|
-
"options": null,
|
|
736
|
-
"bounds": null,
|
|
737
|
-
"pattern": {
|
|
738
|
-
"regex": "^$|^[^\\s@<>]{1,64}@[^\\s@<>]{1,200}\\.[^\\s@<>]{2,24}$"
|
|
739
|
-
},
|
|
740
|
-
"writeRoles": [
|
|
741
|
-
"SystemAdmin"
|
|
742
|
-
],
|
|
743
|
-
"readRoles": [
|
|
744
|
-
"SystemAdmin"
|
|
745
|
-
]
|
|
746
|
-
}
|
|
747
|
-
],
|
|
748
|
-
"secrets": [],
|
|
749
|
-
"writeHandlers": [
|
|
750
|
-
"contact:write:forward-request",
|
|
751
|
-
"contact:write:mark-done",
|
|
752
|
-
"contact:write:notify-reporter-in-app",
|
|
753
|
-
"contact:write:reply",
|
|
754
|
-
"contact:write:report",
|
|
755
|
-
"contact:write:send-reply-mail",
|
|
756
|
-
"contact:write:submit"
|
|
757
|
-
],
|
|
758
|
-
"uiHints": {
|
|
759
|
-
"displayLabel": "Contact",
|
|
760
|
-
"category": "communication",
|
|
761
|
-
"recommended": false
|
|
762
|
-
}
|
|
763
|
-
},
|
|
764
697
|
{
|
|
765
698
|
"name": "crypto-shredding",
|
|
766
699
|
"description": "Operator-level crypto-shredding trigger. `forget-subject` erases a user or tenant subject key in the configured KMS adapter, making every PII field encrypted under it permanently unreadable (reads render the `[[erased]]` sentinel), and appends a `subject-forgotten` audit event. Requires a KMS adapter (`runProdApp({ kms })`). The automated Art.-17 deletion pipeline in `user-data-rights` erases keys itself; this command covers manual forgets (authority requests, operator recovery, tenant destroy).",
|
|
@@ -1466,6 +1399,73 @@
|
|
|
1466
1399
|
"secrets": [],
|
|
1467
1400
|
"writeHandlers": []
|
|
1468
1401
|
},
|
|
1402
|
+
{
|
|
1403
|
+
"name": "helpdesk",
|
|
1404
|
+
"description": "Helpdesk inbox: an anonymous browser client (GET /helpdesk/client.js) submits questions, contact requests, bug reports and wishes behind a honeypot, a minimum submit time and a single-use proof-of-work challenge; signed-in users file reports from the admin. Every request is stored platform-wide and every SystemAdmin is notified by mail, optionally also in a Telegram chat (option `telegram`, off by default); the notification names only the kind, the app and a link, never name, address, phone, subject or message, because mail and Telegram cannot be shredded. SystemAdmins reply by mail (Reply-To set, attachments, quoting the original) and mark requests done; a website sender gets a fixed acknowledgement, a signed-in reporter a copy and an in-app note. Personal data is crypto-shredding-ready and the EXT_USER_DATA hooks export and erase a user's requests.",
|
|
1405
|
+
"toggleableDefault": null,
|
|
1406
|
+
"adoptsBundledLists": true,
|
|
1407
|
+
"requires": [
|
|
1408
|
+
"config",
|
|
1409
|
+
"delivery",
|
|
1410
|
+
"user-data-rights",
|
|
1411
|
+
"files",
|
|
1412
|
+
"notes-history"
|
|
1413
|
+
],
|
|
1414
|
+
"optionalRequires": [
|
|
1415
|
+
"channel-telegram"
|
|
1416
|
+
],
|
|
1417
|
+
"configReads": [],
|
|
1418
|
+
"exposesApis": [],
|
|
1419
|
+
"usesApis": [],
|
|
1420
|
+
"extensionsUsed": [
|
|
1421
|
+
{
|
|
1422
|
+
"extensionName": "userData",
|
|
1423
|
+
"entityName": "helpdesk-request"
|
|
1424
|
+
},
|
|
1425
|
+
{
|
|
1426
|
+
"extensionName": "userData",
|
|
1427
|
+
"entityName": "helpdesk-reply"
|
|
1428
|
+
}
|
|
1429
|
+
],
|
|
1430
|
+
"configKeys": [
|
|
1431
|
+
{
|
|
1432
|
+
"key": "reply-to",
|
|
1433
|
+
"qualifiedName": "helpdesk:config:reply-to",
|
|
1434
|
+
"type": "text",
|
|
1435
|
+
"scope": "system",
|
|
1436
|
+
"default": "",
|
|
1437
|
+
"encrypted": false,
|
|
1438
|
+
"computed": false,
|
|
1439
|
+
"validated": false,
|
|
1440
|
+
"options": null,
|
|
1441
|
+
"bounds": null,
|
|
1442
|
+
"pattern": {
|
|
1443
|
+
"regex": "^$|^[^\\s@<>]{1,64}@[^\\s@<>]{1,200}\\.[^\\s@<>]{2,24}$"
|
|
1444
|
+
},
|
|
1445
|
+
"writeRoles": [
|
|
1446
|
+
"SystemAdmin"
|
|
1447
|
+
],
|
|
1448
|
+
"readRoles": [
|
|
1449
|
+
"SystemAdmin"
|
|
1450
|
+
]
|
|
1451
|
+
}
|
|
1452
|
+
],
|
|
1453
|
+
"secrets": [],
|
|
1454
|
+
"writeHandlers": [
|
|
1455
|
+
"helpdesk:write:forward-request",
|
|
1456
|
+
"helpdesk:write:mark-done",
|
|
1457
|
+
"helpdesk:write:notify-reporter-in-app",
|
|
1458
|
+
"helpdesk:write:reply",
|
|
1459
|
+
"helpdesk:write:report",
|
|
1460
|
+
"helpdesk:write:send-reply-mail",
|
|
1461
|
+
"helpdesk:write:submit"
|
|
1462
|
+
],
|
|
1463
|
+
"uiHints": {
|
|
1464
|
+
"displayLabel": "Helpdesk",
|
|
1465
|
+
"category": "communication",
|
|
1466
|
+
"recommended": false
|
|
1467
|
+
}
|
|
1468
|
+
},
|
|
1469
1469
|
{
|
|
1470
1470
|
"name": "host-routing",
|
|
1471
1471
|
"description": "Host- and path-based tenant routing: an authoritative tenant resolver from the subdomain (tenantBy host), a tenant existence check against enabled, active tenants, and the tenant-key query behind createHostDispatch, which picks the HTML file, CSP, locale redirect or 404 per host for runProdApp's hostDispatch.",
|
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
"screenshots": "bun x playwright test e2e/screenshots.spec.ts --config=playwright.config.ts",
|
|
12
12
|
"billing-gallery": "bun x playwright test --config=playwright.billing-gallery.config.ts",
|
|
13
13
|
"docs-guides": "bun x playwright test e2e/docs-guides.screenshots.spec.ts --config=playwright.config.ts && bun x playwright test --config=playwright.billing-docs.config.ts",
|
|
14
|
-
"
|
|
14
|
+
"helpdesk-shots": "bun x playwright test e2e/helpdesk.screenshots.spec.ts --config=playwright.config.ts",
|
|
15
15
|
"e2e": "bun x playwright test e2e/mfa-login.spec.ts --config=playwright.config.ts",
|
|
16
16
|
"gen:manifest": "bun run scripts/gen-feature-manifest.ts",
|
|
17
17
|
"gen:sample-index": "bun run scripts/gen-sample-index.ts"
|
|
@@ -120,7 +120,7 @@ createKumikoApp({
|
|
|
120
120
|
userProfileClient(),
|
|
121
121
|
customFieldsClient(),
|
|
122
122
|
foldersClient(),
|
|
123
|
-
// The
|
|
123
|
+
// The helpdesk request detail frames its internal notes with the NotesSection extension.
|
|
124
124
|
notesHistoryClient(),
|
|
125
125
|
inboundMailFoundationClient(),
|
|
126
126
|
complianceProfilesClient(),
|
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
// (#1258): an open screen not reachable via nav is no longer an eligible
|
|
6
6
|
// fallback candidate.
|
|
7
7
|
|
|
8
|
-
import {
|
|
8
|
+
import { HelpdeskScreens } from "@cosmicdrift/kumiko-bundled-features/helpdesk";
|
|
9
9
|
import { MAIL_ACCOUNT_LIST_SCREEN_QN } from "@cosmicdrift/kumiko-bundled-features/inbound-mail-foundation";
|
|
10
10
|
import {
|
|
11
11
|
access,
|
|
@@ -18,7 +18,7 @@ const PLATFORM_WORKSPACES = ["admin-shell:workspace:platform"] as const;
|
|
|
18
18
|
|
|
19
19
|
export const appScreensFeature: FeatureDefinition = defineFeature("app-screens", (r) => {
|
|
20
20
|
r.describe("App-side nav placement for the user-profile self-service page and the mailbox list.");
|
|
21
|
-
r.requires({ features: ["user-profile", "inbound-mail-foundation", "
|
|
21
|
+
r.requires({ features: ["user-profile", "inbound-mail-foundation", "helpdesk"] });
|
|
22
22
|
r.nav({
|
|
23
23
|
id: "profile",
|
|
24
24
|
label: "screen:profile.title",
|
|
@@ -48,19 +48,19 @@ export const appScreensFeature: FeatureDefinition = defineFeature("app-screens",
|
|
|
48
48
|
order: 20,
|
|
49
49
|
});
|
|
50
50
|
r.nav({
|
|
51
|
-
id: "
|
|
51
|
+
id: "helpdesk-requests",
|
|
52
52
|
label: "screen:request-list.title",
|
|
53
53
|
icon: "mail",
|
|
54
|
-
screen:
|
|
54
|
+
screen: HelpdeskScreens.requestList,
|
|
55
55
|
order: 25,
|
|
56
56
|
access: { roles: access.systemAdmin },
|
|
57
57
|
workspaces: PLATFORM_WORKSPACES,
|
|
58
58
|
});
|
|
59
59
|
r.nav({
|
|
60
|
-
id: "
|
|
61
|
-
label: "nav:
|
|
60
|
+
id: "helpdesk-forwarding",
|
|
61
|
+
label: "nav:helpdesk-forwarding.title",
|
|
62
62
|
icon: "settings",
|
|
63
|
-
screen:
|
|
63
|
+
screen: HelpdeskScreens.forwarding,
|
|
64
64
|
parent: ADMIN_NAV_QN,
|
|
65
65
|
order: 30,
|
|
66
66
|
access: { roles: access.systemAdmin },
|
|
@@ -74,17 +74,17 @@ export const appScreensFeature: FeatureDefinition = defineFeature("app-screens",
|
|
|
74
74
|
workspaces: ADMIN_NAV_WORKSPACES,
|
|
75
75
|
});
|
|
76
76
|
r.nav({
|
|
77
|
-
id: "
|
|
77
|
+
id: "helpdesk-report",
|
|
78
78
|
label: "screen:report.title",
|
|
79
79
|
icon: "mail",
|
|
80
|
-
screen:
|
|
80
|
+
screen: HelpdeskScreens.report,
|
|
81
81
|
parent: "app-screens:nav:help",
|
|
82
82
|
order: 10,
|
|
83
83
|
workspaces: ADMIN_NAV_WORKSPACES,
|
|
84
84
|
});
|
|
85
85
|
r.translations({
|
|
86
86
|
keys: {
|
|
87
|
-
"nav:
|
|
87
|
+
"nav:helpdesk-forwarding.title": { de: "Weiterleitung", en: "Forwarding" },
|
|
88
88
|
"nav:help.title": { de: "Hilfe", en: "Help" },
|
|
89
89
|
"nav:mail-accounts.title": { de: "Postfächer", en: "Mailboxes" },
|
|
90
90
|
"screen:profile.title": { de: "Profil", en: "Profile" },
|
|
@@ -38,10 +38,6 @@ import { createChannelTeamsFeature } from "@cosmicdrift/kumiko-bundled-features/
|
|
|
38
38
|
import { createChannelTelegramFeature } from "@cosmicdrift/kumiko-bundled-features/channel-telegram";
|
|
39
39
|
import { createComplianceProfilesFeature } from "@cosmicdrift/kumiko-bundled-features/compliance-profiles";
|
|
40
40
|
import { createComplianceProfilesOpsFeature } from "@cosmicdrift/kumiko-bundled-features/compliance-profiles-ops";
|
|
41
|
-
import {
|
|
42
|
-
contactOpenRequestsPanels,
|
|
43
|
-
createContactFeature,
|
|
44
|
-
} from "@cosmicdrift/kumiko-bundled-features/contact";
|
|
45
41
|
import { createCustomFieldsFeature } from "@cosmicdrift/kumiko-bundled-features/custom-fields";
|
|
46
42
|
import { createDataRetentionFeature } from "@cosmicdrift/kumiko-bundled-features/data-retention";
|
|
47
43
|
import { createDeliveryFeature } from "@cosmicdrift/kumiko-bundled-features/delivery";
|
|
@@ -58,6 +54,10 @@ import { createFoldersFeature } from "@cosmicdrift/kumiko-bundled-features/folde
|
|
|
58
54
|
import { createFoldersUserDataFeature } from "@cosmicdrift/kumiko-bundled-features/folders-user-data";
|
|
59
55
|
import { createFormDraftFeature } from "@cosmicdrift/kumiko-bundled-features/form-draft";
|
|
60
56
|
import { createFormDraftUserDataFeature } from "@cosmicdrift/kumiko-bundled-features/form-draft-user-data";
|
|
57
|
+
import {
|
|
58
|
+
createHelpdeskFeature,
|
|
59
|
+
helpdeskOpenRequestsPanels,
|
|
60
|
+
} from "@cosmicdrift/kumiko-bundled-features/helpdesk";
|
|
61
61
|
import { createHostRoutingFeature } from "@cosmicdrift/kumiko-bundled-features/host-routing";
|
|
62
62
|
import { createInboundMailFoundationFeature } from "@cosmicdrift/kumiko-bundled-features/inbound-mail-foundation";
|
|
63
63
|
import { createInboundProviderImapFeature } from "@cosmicdrift/kumiko-bundled-features/inbound-provider-imap";
|
|
@@ -314,7 +314,7 @@ export const APP_FEATURES = [
|
|
|
314
314
|
// CMS / content
|
|
315
315
|
createLegalPagesFeature(),
|
|
316
316
|
createWaitlistFeature(),
|
|
317
|
-
|
|
317
|
+
createHelpdeskFeature({
|
|
318
318
|
appName: "publicstatus",
|
|
319
319
|
appVersion: "2026.10.30",
|
|
320
320
|
fields: { phone: "optional" },
|
|
@@ -410,7 +410,7 @@ export const APP_FEATURES = [
|
|
|
410
410
|
createAdminShellFeature({
|
|
411
411
|
includeCapOverview: true,
|
|
412
412
|
includeDocumentDesigner: true,
|
|
413
|
-
extraPlatformPanels:
|
|
413
|
+
extraPlatformPanels: helpdeskOpenRequestsPanels(),
|
|
414
414
|
}),
|
|
415
415
|
|
|
416
416
|
// app-author-grade
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# API docs
|
|
2
2
|
|
|
3
|
-
API documentation for personal access tokens, generated from the app itself. A
|
|
3
|
+
API documentation for personal access tokens, generated from the app itself. A ticketing
|
|
4
4
|
feature exposes its ticket handlers through token scopes; `kumiko api-docs` turns the
|
|
5
5
|
registry, the translations and recorded requests into Markdown pages, an OpenAPI file and
|
|
6
6
|
an `index.json` that a website or an agent can read.
|
|
@@ -8,7 +8,7 @@ an `index.json` that a website or an agent can read.
|
|
|
8
8
|
## What it shows
|
|
9
9
|
|
|
10
10
|
- **Scopes decide the content.** Only handlers that a scope of the token feature reaches
|
|
11
|
-
appear. `
|
|
11
|
+
appear. `ticketing:write:ticket:purge` is reachable from a screen but in no scope, so it is
|
|
12
12
|
listed under `apiDocs.uiOnlyWrites` with a reason; without that entry the generator reports it.
|
|
13
13
|
- **Texts come from the feature.** Titles, descriptions and field labels per locale use the
|
|
14
14
|
keys `<handler qn>:title`, `:description` and `:field:<name>`; the German pages need the
|
|
@@ -44,7 +44,7 @@ those two files differ from a real run of the command.
|
|
|
44
44
|
|
|
45
45
|
```
|
|
46
46
|
kumiko.config.ts features and the apiDocs block
|
|
47
|
-
src/feature.ts
|
|
47
|
+
src/feature.ts ticketing feature and the token feature with its scopes
|
|
48
48
|
src/__tests__/api-docs.integration.test.ts mints a token, records the examples, checks scope limits
|
|
49
49
|
src/__tests__/api-docs.golden.test.ts generator output equals api-docs/
|
|
50
50
|
api-examples/ recorded requests and responses
|
|
@@ -15,48 +15,48 @@ Ein neues optionales Feld behält die Version. Eine inkompatible Änderung, etwa
|
|
|
15
15
|
|
|
16
16
|
## Ereignisse
|
|
17
17
|
|
|
18
|
-
### ticket.
|
|
18
|
+
### ticket.created
|
|
19
19
|
|
|
20
|
-
Ein
|
|
20
|
+
Ein Datensatz vom Typ Ticket wurde angelegt.
|
|
21
21
|
|
|
22
22
|
- Version: `1`
|
|
23
23
|
- Benötigter Scope: `tickets:read`
|
|
24
24
|
|
|
25
25
|
| Feld | Typ | Pflicht | Beschreibung |
|
|
26
26
|
| --- | --- | --- | --- |
|
|
27
|
-
| `id` | string (uuid) | ja | ID
|
|
28
|
-
| `
|
|
27
|
+
| `id` | string (uuid) | ja | Ticket-ID |
|
|
28
|
+
| `title` | string | ja | Titel |
|
|
29
|
+
| `status` | "open" \| "closed" | ja | Status |
|
|
30
|
+
| `priority` | "low" \| "normal" \| "high" | ja | Priorität |
|
|
29
31
|
|
|
30
32
|
**Beispiel-Nutzlast**
|
|
31
33
|
|
|
32
34
|
```json
|
|
33
35
|
{
|
|
34
36
|
"id": "00000000-0000-4000-8000-000000000001",
|
|
35
|
-
"
|
|
37
|
+
"title": "Scanner jams",
|
|
38
|
+
"status": "open",
|
|
39
|
+
"priority": "low"
|
|
36
40
|
}
|
|
37
41
|
```
|
|
38
42
|
|
|
39
|
-
### ticket.
|
|
43
|
+
### ticket.closed
|
|
40
44
|
|
|
41
|
-
Ein
|
|
45
|
+
Ein Ticket wurde geschlossen und seine Lösung festgehalten.
|
|
42
46
|
|
|
43
47
|
- Version: `1`
|
|
44
48
|
- Benötigter Scope: `tickets:read`
|
|
45
49
|
|
|
46
50
|
| Feld | Typ | Pflicht | Beschreibung |
|
|
47
51
|
| --- | --- | --- | --- |
|
|
48
|
-
| `id` | string (uuid) | ja |
|
|
49
|
-
| `
|
|
50
|
-
| `status` | "open" \| "closed" | ja | Status |
|
|
51
|
-
| `priority` | "low" \| "normal" \| "high" | ja | Priorität |
|
|
52
|
+
| `id` | string (uuid) | ja | ID des geschlossenen Tickets |
|
|
53
|
+
| `resolution` | string | ja | Wie das Ticket gelöst wurde |
|
|
52
54
|
|
|
53
55
|
**Beispiel-Nutzlast**
|
|
54
56
|
|
|
55
57
|
```json
|
|
56
58
|
{
|
|
57
59
|
"id": "00000000-0000-4000-8000-000000000001",
|
|
58
|
-
"
|
|
59
|
-
"status": "open",
|
|
60
|
-
"priority": "low"
|
|
60
|
+
"resolution": "Replaced the roller"
|
|
61
61
|
}
|
|
62
62
|
```
|
|
@@ -19,14 +19,14 @@ Sende einen API-Token im Header `Authorization` als `Bearer <token>`. Anfragen m
|
|
|
19
19
|
|
|
20
20
|
## Request-Body
|
|
21
21
|
|
|
22
|
-
`type` ist der Name des Handlers, zum Beispiel `
|
|
22
|
+
`type` ist der Name des Handlers, zum Beispiel `ticketing:query:ticket:detail`. `payload` enthält die Felder aus der Referenz. `requestId` ist optional, siehe unten. Das Payload darf höchstens 20 Ebenen tief verschachtelt sein.
|
|
23
23
|
|
|
24
24
|
```bash
|
|
25
|
-
curl -X POST https://
|
|
25
|
+
curl -X POST https://ticketing.example.com/api/query \
|
|
26
26
|
-H "Authorization: Bearer $API_TOKEN" \
|
|
27
27
|
-H "Content-Type: application/json" \
|
|
28
28
|
-d '{
|
|
29
|
-
"type": "
|
|
29
|
+
"type": "ticketing:query:ticket:detail",
|
|
30
30
|
"payload": {
|
|
31
31
|
"id": "00000000-0000-4000-8000-000000000001"
|
|
32
32
|
}
|
|
@@ -19,11 +19,11 @@ Liefert ein Ticket.
|
|
|
19
19
|
**Beispielanfrage**
|
|
20
20
|
|
|
21
21
|
```bash
|
|
22
|
-
curl -X POST https://
|
|
22
|
+
curl -X POST https://ticketing.example.com/api/query \
|
|
23
23
|
-H "Authorization: Bearer $API_TOKEN" \
|
|
24
24
|
-H "Content-Type: application/json" \
|
|
25
25
|
-d '{
|
|
26
|
-
"type": "
|
|
26
|
+
"type": "ticketing:query:ticket:detail",
|
|
27
27
|
"payload": {
|
|
28
28
|
"id": "00000000-0000-4000-8000-000000000001"
|
|
29
29
|
}
|
|
@@ -84,11 +84,11 @@ Listet Tickets, neueste zuerst.
|
|
|
84
84
|
**Beispielanfrage**
|
|
85
85
|
|
|
86
86
|
```bash
|
|
87
|
-
curl -X POST https://
|
|
87
|
+
curl -X POST https://ticketing.example.com/api/query \
|
|
88
88
|
-H "Authorization: Bearer $API_TOKEN" \
|
|
89
89
|
-H "Content-Type: application/json" \
|
|
90
90
|
-d '{
|
|
91
|
-
"type": "
|
|
91
|
+
"type": "ticketing:query:ticket:list",
|
|
92
92
|
"payload": {}
|
|
93
93
|
}'
|
|
94
94
|
```
|
|
@@ -136,11 +136,11 @@ Schließt ein Ticket und hält fest, wie es gelöst wurde.
|
|
|
136
136
|
**Beispielanfrage**
|
|
137
137
|
|
|
138
138
|
```bash
|
|
139
|
-
curl -X POST https://
|
|
139
|
+
curl -X POST https://ticketing.example.com/api/write \
|
|
140
140
|
-H "Authorization: Bearer $API_TOKEN" \
|
|
141
141
|
-H "Content-Type: application/json" \
|
|
142
142
|
-d '{
|
|
143
|
-
"type": "
|
|
143
|
+
"type": "ticketing:write:ticket:close",
|
|
144
144
|
"payload": {
|
|
145
145
|
"id": "00000000-0000-4000-8000-000000000001",
|
|
146
146
|
"resolution": "Replaced the cartridge"
|
|
@@ -179,11 +179,11 @@ Legt ein neues Ticket an.
|
|
|
179
179
|
**Beispielanfrage**
|
|
180
180
|
|
|
181
181
|
```bash
|
|
182
|
-
curl -X POST https://
|
|
182
|
+
curl -X POST https://ticketing.example.com/api/write \
|
|
183
183
|
-H "Authorization: Bearer $API_TOKEN" \
|
|
184
184
|
-H "Content-Type: application/json" \
|
|
185
185
|
-d '{
|
|
186
|
-
"type": "
|
|
186
|
+
"type": "ticketing:write:ticket:create",
|
|
187
187
|
"payload": {
|
|
188
188
|
"title": "Printer is on fire",
|
|
189
189
|
"priority": "high"
|
|
@@ -246,11 +246,11 @@ Status: 200
|
|
|
246
246
|
**Beispielanfrage**
|
|
247
247
|
|
|
248
248
|
```bash
|
|
249
|
-
curl -X POST https://
|
|
249
|
+
curl -X POST https://ticketing.example.com/api/write \
|
|
250
250
|
-H "Authorization: Bearer $API_TOKEN" \
|
|
251
251
|
-H "Content-Type: application/json" \
|
|
252
252
|
-d '{
|
|
253
|
-
"type": "
|
|
253
|
+
"type": "ticketing:write:ticket:update",
|
|
254
254
|
"payload": {
|
|
255
255
|
"id": "00000000-0000-4000-8000-000000000001",
|
|
256
256
|
"version": 1,
|
|
@@ -19,11 +19,11 @@ Ein Token läuft nach 90 Tagen ab, wenn du keinen anderen Ablauf wählst. Mögli
|
|
|
19
19
|
Sende den Token im Header `Authorization`. Anfragen mit Token brauchen weder Cookie noch CSRF-Token.
|
|
20
20
|
|
|
21
21
|
```bash
|
|
22
|
-
curl -X POST https://
|
|
22
|
+
curl -X POST https://ticketing.example.com/api/query \
|
|
23
23
|
-H "Authorization: Bearer $API_TOKEN" \
|
|
24
24
|
-H "Content-Type: application/json" \
|
|
25
25
|
-d '{
|
|
26
|
-
"type": "
|
|
26
|
+
"type": "ticketing:query:ticket:detail",
|
|
27
27
|
"payload": {
|
|
28
28
|
"id": "00000000-0000-4000-8000-000000000001"
|
|
29
29
|
}
|
|
@@ -36,8 +36,8 @@ Jeder Scope hat zwei Stufen. `read` erlaubt die lesenden Handler. `write` erlaub
|
|
|
36
36
|
|
|
37
37
|
| Scope | Berechtigung | Handler |
|
|
38
38
|
| --- | --- | --- |
|
|
39
|
-
| `tickets` (Tickets) | `tickets:read` | `
|
|
40
|
-
| `tickets` (Tickets) | `tickets:write` | `
|
|
39
|
+
| `tickets` (Tickets) | `tickets:read` | `ticketing:query:ticket:detail`, `ticketing:query:ticket:list` |
|
|
40
|
+
| `tickets` (Tickets) | `tickets:write` | `ticketing:write:ticket:close`, `ticketing:write:ticket:create`, `ticketing:write:ticket:update` |
|
|
41
41
|
|
|
42
42
|
## Ratenbegrenzung
|
|
43
43
|
|
|
@@ -15,48 +15,48 @@ Adding an optional field keeps the version. A breaking change, such as removing
|
|
|
15
15
|
|
|
16
16
|
## Events
|
|
17
17
|
|
|
18
|
-
### ticket.
|
|
18
|
+
### ticket.created
|
|
19
19
|
|
|
20
|
-
A
|
|
20
|
+
A record of type ticket was created.
|
|
21
21
|
|
|
22
22
|
- Version: `1`
|
|
23
23
|
- Required scope: `tickets:read`
|
|
24
24
|
|
|
25
25
|
| Field | Type | Required | Description |
|
|
26
26
|
| --- | --- | --- | --- |
|
|
27
|
-
| `id` | string (uuid) | yes | ID
|
|
28
|
-
| `
|
|
27
|
+
| `id` | string (uuid) | yes | Ticket ID |
|
|
28
|
+
| `title` | string | yes | Title |
|
|
29
|
+
| `status` | "open" \| "closed" | yes | Status |
|
|
30
|
+
| `priority` | "low" \| "normal" \| "high" | yes | Priority |
|
|
29
31
|
|
|
30
32
|
**Example payload**
|
|
31
33
|
|
|
32
34
|
```json
|
|
33
35
|
{
|
|
34
36
|
"id": "00000000-0000-4000-8000-000000000001",
|
|
35
|
-
"
|
|
37
|
+
"title": "Scanner jams",
|
|
38
|
+
"status": "open",
|
|
39
|
+
"priority": "low"
|
|
36
40
|
}
|
|
37
41
|
```
|
|
38
42
|
|
|
39
|
-
### ticket.
|
|
43
|
+
### ticket.closed
|
|
40
44
|
|
|
41
|
-
A
|
|
45
|
+
A ticket was closed and its resolution recorded.
|
|
42
46
|
|
|
43
47
|
- Version: `1`
|
|
44
48
|
- Required scope: `tickets:read`
|
|
45
49
|
|
|
46
50
|
| Field | Type | Required | Description |
|
|
47
51
|
| --- | --- | --- | --- |
|
|
48
|
-
| `id` | string (uuid) | yes |
|
|
49
|
-
| `
|
|
50
|
-
| `status` | "open" \| "closed" | yes | Status |
|
|
51
|
-
| `priority` | "low" \| "normal" \| "high" | yes | Priority |
|
|
52
|
+
| `id` | string (uuid) | yes | ID of the closed ticket |
|
|
53
|
+
| `resolution` | string | yes | How the ticket was resolved |
|
|
52
54
|
|
|
53
55
|
**Example payload**
|
|
54
56
|
|
|
55
57
|
```json
|
|
56
58
|
{
|
|
57
59
|
"id": "00000000-0000-4000-8000-000000000001",
|
|
58
|
-
"
|
|
59
|
-
"status": "open",
|
|
60
|
-
"priority": "low"
|
|
60
|
+
"resolution": "Replaced the roller"
|
|
61
61
|
}
|
|
62
62
|
```
|
|
@@ -19,14 +19,14 @@ Send an API token in the `Authorization` header as `Bearer <token>`. Requests wi
|
|
|
19
19
|
|
|
20
20
|
## Request body
|
|
21
21
|
|
|
22
|
-
`type` is the handler name, for example `
|
|
22
|
+
`type` is the handler name, for example `ticketing:query:ticket:detail`. `payload` holds the fields from the reference. `requestId` is optional, see below. The payload may be nested at most 20 levels deep.
|
|
23
23
|
|
|
24
24
|
```bash
|
|
25
|
-
curl -X POST https://
|
|
25
|
+
curl -X POST https://ticketing.example.com/api/query \
|
|
26
26
|
-H "Authorization: Bearer $API_TOKEN" \
|
|
27
27
|
-H "Content-Type: application/json" \
|
|
28
28
|
-d '{
|
|
29
|
-
"type": "
|
|
29
|
+
"type": "ticketing:query:ticket:detail",
|
|
30
30
|
"payload": {
|
|
31
31
|
"id": "00000000-0000-4000-8000-000000000001"
|
|
32
32
|
}
|