govoplan-helpdesk is the GovOPlaN platform module seed for internal service desk workflows for IT, facilities, HR, finance, procurement, access requests, assignment, escalation, and resolution tracking.

This repository is initialized as a discoverable module seed. It exposes a module manifest, initial permissions, role templates, documentation metadata, Gitea workflow templates, and a focused manifest test. It intentionally does not yet add HTTP routes, database models, migrations, or WebUI navigation.

Initial Ownership

internal support tickets
service categories
assignment and escalation state
resolution records
SLA-facing timestamps

Boundaries

This module does not own:

public issue intake forms
domain case adjudication
asset inventory

Detailed boundary notes are in docs/HELPDESK_DOMAIN_BOUNDARY.md.

Integrations

Expected optional integrations:

issue-reporting
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 manifest 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

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