govoplan-permits is the GovOPlaN platform module seed for permit and license workflows for applications, renewals, conditions, inspections, objections, revocations, and compliance evidence.

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

permit application lifecycle
license and permit records
conditions
renewals
objections
revocation state
inspection handoffs

Boundaries

This module does not own:

generic case engine
inspection checklist execution
certificate verification registry

Detailed boundary notes are in docs/PERMITS_DOMAIN_BOUNDARY.md.

Integrations

Expected optional integrations:

cases
inspections
forms-runtime
files
portal
certificates
records

Development Install

From the core checkout:

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

Focused manifest verification:

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

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