|
|
|
@@ -0,0 +1,98 @@
|
|
|
|
|
from __future__ import annotations
|
|
|
|
|
|
|
|
|
|
from govoplan_core.core.access import CAPABILITY_AUTH_PERMISSION_EVALUATOR, CAPABILITY_AUTH_PRINCIPAL_RESOLVER
|
|
|
|
|
from govoplan_core.core.modules import (
|
|
|
|
|
DocumentationTopic,
|
|
|
|
|
ModuleInterfaceProvider,
|
|
|
|
|
ModuleInterfaceRequirement,
|
|
|
|
|
ModuleManifest,
|
|
|
|
|
PermissionDefinition,
|
|
|
|
|
RoleTemplate,
|
|
|
|
|
)
|
|
|
|
|
|
|
|
|
|
MODULE_ID = "scheduling"
|
|
|
|
|
MODULE_NAME = "Scheduling"
|
|
|
|
|
MODULE_VERSION = "0.1.8"
|
|
|
|
|
READ_SCOPE = "scheduling:schedule:read"
|
|
|
|
|
WRITE_SCOPE = "scheduling:schedule:write"
|
|
|
|
|
ADMIN_SCOPE = "scheduling:schedule:admin"
|
|
|
|
|
RESPOND_SCOPE = "scheduling:availability:write"
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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="Scheduling",
|
|
|
|
|
level="tenant",
|
|
|
|
|
module_id=module_id,
|
|
|
|
|
resource=resource,
|
|
|
|
|
action=action,
|
|
|
|
|
)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
PERMISSIONS = (
|
|
|
|
|
_permission(READ_SCOPE, "View scheduling", "Read scheduling polls, proposals, participant state, and selected outcomes."),
|
|
|
|
|
_permission(WRITE_SCOPE, "Manage scheduling", "Create and update scheduling polls, candidate slots, reminders, and decision handoff."),
|
|
|
|
|
_permission(ADMIN_SCOPE, "Administer scheduling", "Configure tenant-level scheduling policies, external participation, and retention defaults."),
|
|
|
|
|
_permission(RESPOND_SCOPE, "Respond to scheduling polls", "Submit and update own scheduling availability responses."),
|
|
|
|
|
)
|
|
|
|
|
|
|
|
|
|
ROLE_TEMPLATES = (
|
|
|
|
|
RoleTemplate(
|
|
|
|
|
slug="scheduling_manager",
|
|
|
|
|
name="Scheduling manager",
|
|
|
|
|
description="Create scheduling polls, manage candidate slots, and decide outcomes.",
|
|
|
|
|
permissions=(READ_SCOPE, WRITE_SCOPE, RESPOND_SCOPE),
|
|
|
|
|
),
|
|
|
|
|
RoleTemplate(
|
|
|
|
|
slug="scheduling_participant",
|
|
|
|
|
name="Scheduling participant",
|
|
|
|
|
description="Read assigned scheduling polls and submit own availability.",
|
|
|
|
|
permissions=(READ_SCOPE, RESPOND_SCOPE),
|
|
|
|
|
),
|
|
|
|
|
)
|
|
|
|
|
|
|
|
|
|
DOCUMENTATION = (
|
|
|
|
|
DocumentationTopic(
|
|
|
|
|
id="scheduling.module-boundary",
|
|
|
|
|
title="Scheduling module boundary",
|
|
|
|
|
summary="Meeting scheduling and Terminfindung built on reusable Poll availability primitives.",
|
|
|
|
|
body=(
|
|
|
|
|
"Scheduling owns meeting scheduling workflows, candidate slots, participant availability "
|
|
|
|
|
"collection, conflict explanation, reminders, and decision handoff. It depends on Poll "
|
|
|
|
|
"for reusable availability matrices and can optionally trigger Evaluation for post-event feedback."
|
|
|
|
|
),
|
|
|
|
|
layer="available",
|
|
|
|
|
documentation_types=("admin",),
|
|
|
|
|
audience=("operator", "module_admin", "product_owner"),
|
|
|
|
|
related_modules=("poll", "evaluation", "calendar", "appointments", "mail", "notifications", "portal"),
|
|
|
|
|
metadata={"seed": True},
|
|
|
|
|
),
|
|
|
|
|
)
|
|
|
|
|
|
|
|
|
|
manifest = ModuleManifest(
|
|
|
|
|
id=MODULE_ID,
|
|
|
|
|
name=MODULE_NAME,
|
|
|
|
|
version=MODULE_VERSION,
|
|
|
|
|
dependencies=("access", "poll"),
|
|
|
|
|
optional_dependencies=("calendar", "appointments", "evaluation", "mail", "notifications", "portal", "workflow", "tasks", "idm", "organizations"),
|
|
|
|
|
required_capabilities=(CAPABILITY_AUTH_PRINCIPAL_RESOLVER, CAPABILITY_AUTH_PERMISSION_EVALUATOR),
|
|
|
|
|
provides_interfaces=(
|
|
|
|
|
ModuleInterfaceProvider(name="scheduling.candidate_slots", version="0.1.8"),
|
|
|
|
|
ModuleInterfaceProvider(name="scheduling.decision_handoff", version="0.1.8"),
|
|
|
|
|
),
|
|
|
|
|
requires_interfaces=(
|
|
|
|
|
ModuleInterfaceRequirement(name="poll.availability_matrix", version_min="0.1.8", version_max_exclusive="0.2.0"),
|
|
|
|
|
ModuleInterfaceRequirement(name="evaluation.feedback", version_min="0.1.8", version_max_exclusive="0.2.0", optional=True),
|
|
|
|
|
),
|
|
|
|
|
permissions=PERMISSIONS,
|
|
|
|
|
role_templates=ROLE_TEMPLATES,
|
|
|
|
|
documentation=DOCUMENTATION,
|
|
|
|
|
)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def get_manifest() -> ModuleManifest:
|
|
|
|
|
return manifest
|