From d19ff998941f1bb6a6ff91e013e0ad5df0b4a33a Mon Sep 17 00:00:00 2001
From: Albrecht Degering <albrecht@degering.name>
Date: Wed, 29 Jul 2026 15:50:31 +0200
Subject: [PATCH] docs: define helpdesk and ticket ownership

---
 README.md                                 |  2 +-
 docs/HELPDESK_DOMAIN_BOUNDARY.md          | 16 ++++++++--------
 src/govoplan_helpdesk/backend/manifest.py |  7 +++++--
 3 files changed, 14 insertions(+), 11 deletions(-)

diff --git a/README.md b/README.md
index 8da50f7..c7beb67 100644
--- a/README.md
+++ b/README.md
@@ -30,7 +30,7 @@ Detailed boundary notes are in [docs/HELPDESK_DOMAIN_BOUNDARY.md](docs/HELPDESK_
 
 Expected optional integrations:
 
-- issue_reporting
+- tickets
 - assets
 - facilities
 - mail
diff --git a/docs/HELPDESK_DOMAIN_BOUNDARY.md b/docs/HELPDESK_DOMAIN_BOUNDARY.md
index c18f9fd..68c27e0 100644
--- a/docs/HELPDESK_DOMAIN_BOUNDARY.md
+++ b/docs/HELPDESK_DOMAIN_BOUNDARY.md
@@ -6,21 +6,20 @@ Internal service desk workflows for IT, facilities, HR, finance, procurement, ac
 
 ## Owns
 
-- internal support tickets
-- service categories
-- assignment and escalation state
-- resolution records
-- SLA-facing timestamps
+- helpdesk queue and service-category profiles
+- SLA and escalation policy profiles
+- IT/facilities service-desk defaults and reporting vocabulary
 
 ## Does Not Own
 
-- public issue intake forms
+- canonical ticket identity, messages, assignment, and resolution state
+- public ticket intake forms
 - domain case adjudication
 - asset inventory
 
 ## Integration Candidates
 
-- issue_reporting
+- tickets
 - assets
 - facilities
 - mail
@@ -44,4 +43,5 @@ No runtime API, database model, migration, WebUI route, or navigation item is re
 
 ## First Implementation Slice
 
-Create service ticket types, status flow, assignee ownership, and linking hooks for issue-reporting, assets, and facilities.
+Define Helpdesk queue, SLA, and escalation profiles over `govoplan-tickets`.
+Do not create a second ticket persistence model.
diff --git a/src/govoplan_helpdesk/backend/manifest.py b/src/govoplan_helpdesk/backend/manifest.py
index 17c51e1..e2661d4 100644
--- a/src/govoplan_helpdesk/backend/manifest.py
+++ b/src/govoplan_helpdesk/backend/manifest.py
@@ -10,7 +10,7 @@ READ_SCOPE = "helpdesk:workspace:read"
 WRITE_SCOPE = "helpdesk:workspace:write"
 ADMIN_SCOPE = "helpdesk:workspace:admin"
 OPTIONAL_DEPENDENCIES = (
-    "issue_reporting",
+    "tickets",
     "assets",
     "facilities",
     "mail",
@@ -81,7 +81,10 @@ DOCUMENTATION = (
         metadata={
             "seed": True,
             "domain_objects": ['internal support tickets', 'service categories', 'assignment and escalation state', 'resolution records', 'SLA-facing timestamps'],
-            "first_slice": "Create service ticket types, status flow, assignee ownership, and linking hooks for issue-reporting, assets, and facilities.",
+            "first_slice": (
+                "Define Helpdesk queue, SLA, and escalation profiles over the "
+                "canonical Tickets model without introducing duplicate ticket storage."
+            ),
         },
     ),
 )