refactor: rename issue reporting module to tickets

src/govoplan_tickets/__init__.py

@@ -0,0 +1 @@
+"""GovOPlaN Tickets module."""

src/govoplan_tickets/backend/__init__.py

@@ -0,0 +1 @@
+"""Backend integration for the GovOPlaN Tickets module."""

src/govoplan_tickets/backend/manifest.py

@@ -0,0 +1,133 @@
+from __future__ import annotations
+
+from govoplan_core.core.access import CAPABILITY_AUTH_PERMISSION_EVALUATOR, CAPABILITY_AUTH_PRINCIPAL_RESOLVER
+from govoplan_core.core.modules import DocumentationLink, DocumentationTopic, ModuleManifest, PermissionDefinition, RoleTemplate
+
+MODULE_ID = "tickets"
+MODULE_NAME = "Tickets"
+MODULE_VERSION = "0.1.8"
+READ_SCOPE = "tickets:ticket:read"
+WRITE_SCOPE = "tickets:ticket:write"
+ADMIN_SCOPE = "tickets:ticket:admin"
+OPTIONAL_DEPENDENCIES = (
+    "cases",
+    "projects",
+    "wiki",
+    "assets",
+    "facilities",
+    "forms_runtime",
+    "portal",
+    "files",
+    "workflow",
+    "tasks",
+    "mail",
+    "notifications",
+    "search",
+)
+
+
+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="Tickets",
+        level="tenant",
+        module_id=module_id,
+        resource=resource,
+        action=action,
+    )
+
+
+PERMISSIONS = (
+    _permission(
+        READ_SCOPE,
+        "View tickets",
+        "Read discoverable tickets, queue state, and resolution context.",
+    ),
+    _permission(
+        WRITE_SCOPE,
+        "Manage tickets",
+        "Create, triage, assign, update, resolve, and link tickets.",
+    ),
+    _permission(
+        ADMIN_SCOPE,
+        "Administer tickets",
+        "Configure ticket types, queues, service policies, and intake profiles.",
+    ),
+)
+
+ROLE_TEMPLATES = (
+    RoleTemplate(
+        slug="tickets_manager",
+        name="Tickets manager",
+        description="Triage, assign, update, and resolve tickets.",
+        permissions=(READ_SCOPE, WRITE_SCOPE),
+    ),
+    RoleTemplate(
+        slug="tickets_viewer",
+        name="Tickets viewer",
+        description="Read discoverable tickets and their resolution context.",
+        permissions=(READ_SCOPE,),
+    ),
+)
+
+DOCUMENTATION = (
+    DocumentationTopic(
+        id=f"{MODULE_ID}.module-boundary",
+        title=f"{MODULE_NAME} module boundary",
+        summary=(
+            "Queue-oriented reports, requests, incidents, problems, triage, "
+            "routing, service work, and auditable resolution."
+        ),
+        body=(
+            "This repository is currently a platform module seed. It registers the domain boundary, "
+            "permission surface, role templates, and documentation metadata before runtime APIs, "
+            "database models, migrations, and WebUI routes are introduced."
+        ),
+        layer="available",
+        documentation_types=("admin",),
+        audience=("operator", "module_admin", "product_owner"),
+        order=100,
+        related_modules=OPTIONAL_DEPENDENCIES,
+        links=(
+            DocumentationLink(
+                label="Repository domain boundary",
+                href="govoplan-tickets/docs/TICKETS_DOMAIN_BOUNDARY.md",
+                kind="repository",
+            ),
+        ),
+        metadata={
+            "seed": True,
+            "domain_objects": [
+                "ticket",
+                "ticket type and queue",
+                "triage and routing facts",
+                "reporter and requester references",
+                "assignment and service-level state",
+                "resolution and escalation links",
+            ],
+            "first_slice": (
+                "Define ticket identity, intake profiles, queues, triage, "
+                "assignment, resolution, and stable escalation links to cases."
+            ),
+        },
+    ),
+)
+
+manifest = ModuleManifest(
+    id=MODULE_ID,
+    name=MODULE_NAME,
+    version=MODULE_VERSION,
+    dependencies=("access",),
+    optional_dependencies=OPTIONAL_DEPENDENCIES,
+    required_capabilities=(CAPABILITY_AUTH_PRINCIPAL_RESOLVER, CAPABILITY_AUTH_PERMISSION_EVALUATOR),
+    permissions=PERMISSIONS,
+    role_templates=ROLE_TEMPLATES,
+    documentation=DOCUMENTATION,
+)
+
+
+def get_manifest() -> ModuleManifest:
+    return manifest