Initialize GovOPlaN module seed

README.md

@@ -0,0 +1,63 @@
+# GovOPlaN Issue Reporting
+
+`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](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:
+
+```bash
+cd /mnt/DATA/git/govoplan-core
+./.venv/bin/python -m pip install -e ../govoplan-issue-reporting
+```
+
+Focused manifest verification:
+
+```bash
+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:
+
+```bash
+cd /mnt/DATA/git/govoplan-core
+./scripts/gitea-sync-labels.py --root /mnt/DATA/git/govoplan-issue-reporting --apply
+```