78 lines
2.3 KiB
Markdown
78 lines
2.3 KiB
Markdown
# GovOPlaN Helpdesk
|
|
|
|
<!-- govoplan-repository-type:start -->
|
|
**Repository type:** module (domain).
|
|
<!-- govoplan-repository-type:end -->
|
|
|
|
`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](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:
|
|
|
|
```bash
|
|
cd /mnt/DATA/git/govoplan-core
|
|
./.venv/bin/python -m pip install -e ../govoplan-helpdesk
|
|
```
|
|
|
|
Focused verification:
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
cd /mnt/DATA/git/govoplan-core
|
|
/mnt/DATA/git/govoplan/tools/gitea/gitea-sync-labels.py --root /mnt/DATA/git/govoplan-helpdesk --apply
|
|
```
|