Files
govoplan-permits/README.md
2026-07-11 16:49:03 +02:00

69 lines
1.9 KiB
Markdown

# GovOPlaN Permits
<!-- govoplan-repository-type:start -->
**Repository type:** module (domain).
<!-- govoplan-repository-type:end -->
`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](docs/PERMITS_DOMAIN_BOUNDARY.md).
## Integrations
Expected optional integrations:
- cases
- inspections
- forms-runtime
- files
- portal
- certificates
- records
## Development Install
From the core checkout:
```bash
cd /mnt/DATA/git/govoplan-core
./.venv/bin/python -m pip install -e ../govoplan-permits
```
Focused manifest verification:
```bash
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:
```bash
cd /mnt/DATA/git/govoplan-core
/mnt/DATA/git/govoplan/tools/gitea/gitea-sync-labels.py --root /mnt/DATA/git/govoplan-permits --apply
```