GovOPlaN Tickets

Repository type: module (domain).

govoplan-tickets is the generic GovOPlaN work-intake and service-ticket module. It covers public and internal reports, requests, incidents, problems, queues, triage, routing, assignment, service-level state, and auditable resolution.

Its runtime module ID is tickets.

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

ticket identity, type, priority, state, and queue
public and internal intake profiles
reporter/requester and affected-object references
triage, routing, assignment, and service-level facts
resolution evidence and escalation links

Boundaries

Tickets are operational work items. They may be resolved entirely within a queue or linked to a task, project, asset, facility, or formal case.

Cases are different: govoplan-cases owns the authoritative procedural record for an administrative matter, including parties, evidence, decisions, procedural deadlines, and retention. Escalating a ticket creates a stable link; it does not rewrite the ticket as a case.

Detailed boundary notes are in docs/TICKETS_DOMAIN_BOUNDARY.md.

Integrations

Expected optional integrations:

cases
projects
wiki
assets
facilities
forms_runtime
portal
files
workflow
tasks
mail
notifications
search

Development Install

From the core checkout:

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

Focused manifest verification:

cd /mnt/DATA/git/govoplan-tickets
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/tickets.

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-tickets --apply

2.4 KiB Raw Blame History