govoplan-organizations/AGENTS.md

GovOPlaN Organizations Codex Guide

Documentation Contract

• Treat documentation as part of every behavior change. Update this module's manifest-driven DocumentationTopic contributions for affected user and administrator behavior.
• Keep feature content here; govoplan-docs projects it without importing Organizations internals.
• Maintain a static user/admin baseline and run /mnt/DATA/git/govoplan/tools/checks/check-manifest-shapes.py after behavior or manifest changes.

Scope

This repository owns the canonical GovOPlaN organizational model: tenant-local organization units, parallel structures, functions, and identity-held function assignments.

The module describes responsibility in the institution. It does not decide which rights those responsibilities grant; govoplan-access maps organization facts to roles, rights, permission decisions, and explainability.

Boundaries

• Depend on kernel contracts from govoplan-core.
• Depend on govoplan-tenancy for tenant ownership.
• Depend on identity only through kernel capabilities when resolving account to identity relationships.
• Do not import access, admin, identity, postbox, workflow, or portal internals.
• Expose integration through manifests, capabilities, API routes, events, and typed DTOs.
• Treat function assignment as organizational responsibility, not as a login permission by itself.
• Keep the organization modelling UI as a standalone module route. Admin-only organization policy/settings controls should be contributed by this module through the platform admin.sections WebUI capability.

Local Workflow

Use Gitea issues as the canonical backlog and state log. The shared workflow is installed under .gitea/, with labels in docs/gitea-labels.json.

Focused verification is still driven from /mnt/DATA/git/govoplan-core for cross-repository behavior.