59 lines
2.0 KiB
Markdown
59 lines
2.0 KiB
Markdown
# GovOPlaN Organizations
|
|
|
|
<!-- govoplan-repository-type:start -->
|
|
**Repository type:** module (platform).
|
|
<!-- govoplan-repository-type:end -->
|
|
|
|
`govoplan-organizations` is the canonical organizational model module for
|
|
GovOPlaN.
|
|
|
|
It owns organization unit types, organization structures, concrete units, and
|
|
functions. These facts exist independently of authentication and authorization.
|
|
Identity links people to accounts, IDM links identities to organization
|
|
functions, and Access projects accepted 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
|
|
|
|
Organizations does not own:
|
|
|
|
- login accounts, identity lifecycle, or account linking
|
|
- identity-to-function assignments or candidate search; those bridges are owned by `govoplan-idm`
|
|
- 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, and functions.
|
|
|
|
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:
|
|
|
|
```bash
|
|
cd /mnt/DATA/git/govoplan-core
|
|
./.venv/bin/python -m pip install -e ../govoplan-organizations
|
|
```
|