Metadata-Version: 2.4
Name: govoplan-organizations
Version: 0.1.15
Summary: GovOPlaN organizational model module.
Author: GovOPlaN
Requires-Python: >=3.12
Description-Content-Type: text/markdown
Requires-Dist: govoplan-core>=0.1.15
Requires-Dist: govoplan-tenancy>=0.1.15

# 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.

The reviewed surface inventory, consequence classes, availability rules, and
accessibility evidence are recorded in
[`docs/INTERFACE_PATTERN_MIGRATION.md`](docs/INTERFACE_PATTERN_MIGRATION.md).

## Module Contract

The module registers two capabilities from
`govoplan_core.core.organizations`:

- `organizations.directory` for backward-compatible direct unit/function
  lookup;
- `organizations.hierarchyDirectory` for typed, tenant-safe, explicitly
  structure-scoped hierarchy and path resolution.

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
```
