govoplan-organizations/README.md

GovOPlaN Organizations

govoplan-organizations is the canonical organizational model module for GovOPlaN.

It owns organization unit types, organization structures, concrete units, functions, and identity-held function assignments. These facts exist independently of authentication and authorization. Identity links people to accounts, and Access projects organization facts into roles and rights.

Boundary

Organizations owns:

• tenant-local organization unit types
• tenant-local concrete organization units
• parallel organization structures and relation types
• functions in organization units
• whether a function may be delegated or used for acting in place
• identity-held function assignments, optionally constrained to one account
• whether an assignment applies only to one unit or also to subunits

Organizations does not own:

• login accounts, identity lifecycle, or account linking
• role and permission evaluation
• postboxes, workflows, portals, files, or cases
• external IDM connector internals

The WebUI exposed by this repository is a normal module UI at /organizations. It is the editing surface for the meta-model, concrete organization tree, structures, functions, and assignments.

Admin-only controls are contributed by this module through the platform admin.sections WebUI capability, so the admin shell can show them when the organizations module is active. Those controls are limited to governance and policy settings such as tenant model customization, change-request requirements, audit detail, and retention behavior.

Module Contract

The module registers the organizations.directory capability from govoplan_core.core.organizations.

Feature modules should consume the capability instead of importing organization ORM models.

Development Install

From the core checkout:

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