Remove obsolete implementations for sorting and email notifier tests; add shared OpenAPI helpers and notifications support for Telegram, Mattermost, and Voice Call channels. Expand silences UI with expired-filter history and improve summary navigation. Update service version to 1.0.4-beta.

Author: Aidaho12

app/api/openapi/common.py

@@ -0,0 +1,49 @@
+"""Shared OpenAPI helper builders."""
+
+ERROR_SCHEMA = {
+    "type": "object",
+    "properties": {
+        "error": {"type": "string", "example": "validation_error"},
+        "message": {"type": "string", "nullable": True},
+        "details": {"type": "array", "items": {"type": "object"}},
+    },
+}
+
+
+def path_param(name, description):
+    """Build an integer path parameter."""
+    return {
+        "name": name,
+        "in": "path",
+        "required": True,
+        "description": description,
+        "schema": {"type": "integer", "minimum": 1},
+    }
+
+
+def query_param(name, description, schema=None, required=False):
+    """Build a query parameter."""
+    return {
+        "name": name,
+        "in": "query",
+        "required": required,
+        "description": description,
+        "schema": schema or {"type": "string"},
+    }
+
+
+def json_body(description, schema, required=True):
+    """Build a JSON request body."""
+    return {
+        "required": required,
+        "description": description,
+        "content": {"application/json": {"schema": schema}},
+    }
+
+
+def response(description, schema=None):
+    """Build a JSON response object."""
+    item = {"description": description}
+    if schema:
+        item["content"] = {"application/json": {"schema": schema}}
+    return item