govoplan-procurement is the GovOPlaN platform module seed for procurement procedures for purchase requests, approvals, vendor comparison, tender references, contract handoff, goods receipt, and invoice matching.

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

purchase request lifecycle
vendor comparison records
tender references
goods receipt facts
contract handoff state
invoice matching context

Boundaries

This module does not own:

XRechnung parsing
payment execution
general ledger postings

Detailed boundary notes are in docs/PROCUREMENT_DOMAIN_BOUNDARY.md.

Integrations

Expected optional integrations:

approvals
contracts
xrechnung
payments
erp
ledger
files
workflow

Development Install

From the core checkout:

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

Focused manifest verification:

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

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