govoplan-issue-reporting is the GovOPlaN platform module seed for public or internal problem reporting for broken infrastructure, damaged rooms, IT outages, safety issues, accessibility issues, triage, and routing.

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

issue intake
problem category taxonomy
triage and routing facts
public reporter references
handoff targets

Boundaries

This module does not own:

internal service desk execution
legal case handling
asset lifecycle management

Detailed boundary notes are in docs/ISSUE_REPORTING_DOMAIN_BOUNDARY.md.

Integrations

Expected optional integrations:

helpdesk
cases
assets
facilities
forms-runtime
portal
files
workflow

Development Install

From the core checkout:

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

Focused manifest verification:

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

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