govoplan-helpdesk is the optional policy layer for internal service-desk routing and service targets. It configures ordered service profiles for IT, facilities, HR, finance, procurement, and access-request queues without owning the underlying operational tickets.

The implemented slice provides tenant-scoped, revision-guarded service profiles, immutable configuration history, an administrative API and WebUI, and the optional tickets.routing capability. The routing provider returns a queue and service target to Tickets. If Helpdesk is absent or no active profile matches, Ticket intake still succeeds and authorized staff route it manually.

Ownership

helpdesk queue and service-profile configuration
ordered ticket-type and priority matching
service-target policy and its immutable change evidence

Boundaries

This module does not own:

canonical ticket identity, messages, assignment, lifecycle, or resolution
public issue intake forms
domain case adjudication
asset inventory

Detailed boundary notes are in docs/HELPDESK_DOMAIN_BOUNDARY.md.

Integrations

Implemented optional integration:

tickets, through the Core-owned tickets.routing capability

Future integration candidates:

assets
facilities
mail
notifications
workflow
files
tasks

Development Install

From the core checkout:

cd /mnt/DATA/git/govoplan-core
./.venv/bin/python -m pip install -e ../govoplan-helpdesk

Focused verification:

cd /mnt/DATA/git/govoplan-helpdesk
PYTHONPATH=src:/mnt/DATA/git/govoplan-core/src /mnt/DATA/git/govoplan-core/.venv/bin/python -m unittest discover -s tests
PATH=/home/zemion/.nvm/versions/node/v22.22.3/bin:$PATH /home/zemion/.nvm/versions/node/v22.22.3/bin/npm --prefix webui run test

Gitea Workflow

Issue templates are installed under .gitea/, and the shared label taxonomy is copied to docs/gitea-labels.json with the module label module/helpdesk.

From the core checkout, labels can be synced once a local GITEA_TOKEN is available:

cd /mnt/DATA/git/govoplan-core
/mnt/DATA/git/govoplan/tools/gitea/gitea-sync-labels.py --root /mnt/DATA/git/govoplan-helpdesk --apply