97 lines
5.2 KiB
Python
97 lines
5.2 KiB
Python
from __future__ import annotations
|
|
|
|
from pathlib import Path
|
|
|
|
from govoplan_core.core.institutional import CAPABILITY_PARTY_RESOLVER
|
|
from govoplan_core.core.module_guards import drop_table_retirement_provider, persistent_table_uninstall_guard
|
|
from govoplan_core.core.modules import CapabilityDocumentation, DocumentationLink, DocumentationTopic, MigrationSpec, ModuleContext, ModuleInterfaceProvider, ModuleManifest, PermissionDefinition, RoleTemplate
|
|
from govoplan_core.core.provider_governance import declared_module_architecture
|
|
from govoplan_core.db.base import Base
|
|
from govoplan_parties.backend.db import models as party_models
|
|
from govoplan_parties.backend.service import SqlPartyResolver
|
|
|
|
|
|
MODULE_ID = "parties"
|
|
MODULE_NAME = "Parties"
|
|
MODULE_VERSION = "0.1.16"
|
|
READ_SCOPE = "parties:procedure:read"
|
|
WRITE_SCOPE = "parties:procedure:write"
|
|
ADMIN_SCOPE = "parties:procedure:admin"
|
|
|
|
|
|
def _permission(scope: str, label: str, description: str) -> PermissionDefinition:
|
|
module_id, resource, action = scope.split(":", 2)
|
|
return PermissionDefinition(scope=scope, label=label, description=description, category="Parties", level="tenant", module_id=module_id, resource=resource, action=action)
|
|
|
|
|
|
def _router(_context: ModuleContext):
|
|
from govoplan_parties.backend.router import router
|
|
|
|
return router
|
|
|
|
|
|
def _resolver(_context: ModuleContext) -> SqlPartyResolver:
|
|
return SqlPartyResolver()
|
|
|
|
|
|
manifest = ModuleManifest(
|
|
id=MODULE_ID,
|
|
name=MODULE_NAME,
|
|
version=MODULE_VERSION,
|
|
optional_dependencies=("identity", "organizations", "addresses", "cases", "workflow_engine", "decisions", "policy", "audit"),
|
|
provides_interfaces=(ModuleInterfaceProvider(name="parties.procedure", version="0.1.0"), ModuleInterfaceProvider(name="parties.representation", version="0.1.0")),
|
|
permissions=(
|
|
_permission(READ_SCOPE, "View procedure parties", "View procedure-local roles, contact snapshots, and representation evidence."),
|
|
_permission(WRITE_SCOPE, "Manage procedure parties", "Create and revise procedure parties and revoke representation powers."),
|
|
_permission(ADMIN_SCOPE, "Administer procedure parties", "Administer party lifecycle, access, and recovery."),
|
|
),
|
|
role_templates=(
|
|
RoleTemplate(slug="party_manager", name="Party manager", description="Manage procedure-local parties and representation.", permissions=(READ_SCOPE, WRITE_SCOPE)),
|
|
RoleTemplate(slug="party_reader", name="Party reader", description="Inspect procedure parties and authority evidence.", permissions=(READ_SCOPE,)),
|
|
),
|
|
route_factory=_router,
|
|
capability_factories={CAPABILITY_PARTY_RESOLVER: _resolver},
|
|
capability_documentation={CAPABILITY_PARTY_RESOLVER: CapabilityDocumentation(label="Procedure Party resolver", summary="Returns effective, tenant-bound procedure parties and representation powers.", contract_version="0.1.0")},
|
|
migration_spec=MigrationSpec(
|
|
module_id=MODULE_ID,
|
|
metadata=Base.metadata,
|
|
script_location=str(Path(__file__).with_name("migrations") / "versions"),
|
|
retirement_supported=True,
|
|
retirement_provider=drop_table_retirement_provider(party_models.ProcedurePartyRevision, label="Parties"),
|
|
retirement_notes="Destructive retirement requires a database snapshot and removes procedure Party history.",
|
|
),
|
|
uninstall_guard_providers=(persistent_table_uninstall_guard(party_models.ProcedurePartyRevision, label="Parties"),),
|
|
documentation=(
|
|
DocumentationTopic(
|
|
id="parties.procedure-and-representation",
|
|
title="Procedure parties and representation",
|
|
summary="Keep procedure roles and authority distinct from subject master data.",
|
|
body="Parties stores immutable procedure participation and explicit representation powers. Powers cannot disappear silently and delivery uses frozen contact snapshots. Unversioned reads follow the titlebar valid-time and recorded-time selection; explicit procedure resolution times take precedence and current authorization is unchanged.",
|
|
layer="configured",
|
|
documentation_types=("admin", "user"),
|
|
audience=("user", "operator", "module_admin", "auditor"),
|
|
links=(DocumentationLink(label="Parties domain and recovery", href="govoplan-parties/docs/PARTIES_DOMAIN.md", kind="repository"),),
|
|
),
|
|
),
|
|
architecture=declared_module_architecture(
|
|
layer="human_work_procedure",
|
|
kind="domain",
|
|
maturity="vertical_slice",
|
|
documentation_ref="docs/PARTIES_DOMAIN.md",
|
|
test_ref="tests/test_parties.py",
|
|
known_limits=("No dedicated WebUI is included; procedure modules present Party data in context.",),
|
|
supported_authority_modes=("native_authoritative",),
|
|
owned_concepts=("procedure party", "representation power", "procedure delivery authority"),
|
|
non_owned_concepts=("identity master", "organization master", "contact point", "case lifecycle"),
|
|
reference_packages=("product.service-to-decision",),
|
|
migration_docs=("docs/PARTIES_DOMAIN.md",),
|
|
recovery_docs=("docs/PARTIES_DOMAIN.md",),
|
|
security_docs=("docs/PARTIES_DOMAIN.md",),
|
|
operations_docs=("docs/PARTIES_DOMAIN.md",),
|
|
),
|
|
)
|
|
|
|
|
|
def get_manifest() -> ModuleManifest:
|
|
return manifest
|