[SDESK-7470] - Create new async Agenda resource, service & REST API

server/planning/agendas.py

@@ -30,6 +30,7 @@ class AgendasResource(Resource):
         "PATCH": "planning_agenda_management",
         "DELETE": "planning_agenda_management",
     }
+    internal_resource = True
 
 
 class AgendasService(Service):

server/planning/agendas_async/__init__.py

@@ -0,0 +1,4 @@
+from .agendas_async_service import AgendasAsyncService
+from .module import agendas_resource_config
+
+__all__ = ["AgendasAsyncService", "agendas_resource_config"]

server/planning/agendas_async/agendas_async_service.py

@@ -0,0 +1,57 @@
+from typing import Any
+from planning.core.service import BasePlanningAsyncService
+from planning.types import AgendasResourceModel
+from planning.common import set_original_creator
+from apps.auth import get_user_id
+from superdesk import get_resource_service
+from superdesk.errors import SuperdeskApiError
+from superdesk.notification import push_notification
+
+
+class AgendasAsyncService(BasePlanningAsyncService[AgendasResourceModel]):
+    # TODO-ASYNC: on_fetched mechanism to be added to the base REST API class
+    # async def _generate_planning_info(self, docs):
+    #     # TODO-ASYNC: Change this when async planning service is done
+    #     planning_service = get_resource_service("planning")
+    #     for doc in docs:
+    #         doc["plannings"] = planning_service.get_planning_by_agenda_id(doc.get(ID_FIELD)).docs
+    #
+    # async def on_fetched(self, docs):
+    #     await self._generate_planning_info(docs.get(ITEMS))
+    #
+    # async def on_fetched_item(self, doc):
+    #     await self._generate_planning_info([doc])
+
+    async def on_create(self, docs: list[AgendasResourceModel]) -> None:
+        for doc in docs:
+            doc_dict = doc.to_dict()
+            set_original_creator(doc_dict)
+
+    async def on_created(self, docs: list[AgendasResourceModel]) -> None:
+        for doc in docs:
+            push_notification(
+                "agenda:created", item=str(doc.id), user=str(doc.original_creator) if doc.original_creator else None
+            )
+
+    async def on_update(self, updates: dict[str, Any], original: AgendasResourceModel) -> None:
+        user_id = get_user_id()
+        if user_id:
+            updates["version_creator"] = get_user_id()
+
+    async def on_updated(self, updates: dict[str, Any], original: AgendasResourceModel) -> None:
+        # await self._generate_planning_info([updates])
+        push_notification(
+            "agenda:updated",
+            item=str(original.id),
+            user=str(updates.get("version_creator", "")),
+        )
+
+    async def on_delete(self, doc: AgendasResourceModel):
+        # TODO-ASYNC: Change this when async planning service is done
+        if get_resource_service("planning").get_planning_by_agenda_id(doc.id).count() > 0:
+            raise SuperdeskApiError.badRequestError(
+                message="Agenda is referenced by Planning items. " "Cannot delete Agenda"
+            )
+
+    async def on_deleted(self, doc: AgendasResourceModel):
+        push_notification("agenda:deleted", item=str(doc.id))

server/planning/agendas_async/module.py

@@ -0,0 +1,14 @@
+from superdesk.core.resources import (
+    ResourceConfig,
+    RestEndpointConfig,
+)
+
+from .agendas_async_service import AgendasAsyncService
+from planning.types import AgendasResourceModel
+
+agendas_resource_config = ResourceConfig(
+    name="agenda",
+    data_class=AgendasResourceModel,
+    service=AgendasAsyncService,
+    rest_endpoints=RestEndpointConfig(resource_methods=["GET", "POST"], item_methods=["GET", "PATCH", "DELETE"]),
+)

server/planning/module.py

@@ -1,4 +1,5 @@
 from superdesk.core.module import Module
+from planning.agendas_async import agendas_resource_config
 from planning.events import events_resource_config, events_history_resource_config
 from planning.planning import planning_resource_config, planning_history_resource_config
 from planning.assignments import assignments_resource_config, delivery_resource_config
@@ -17,5 +18,6 @@
         planning_types_resource_config,
         events_history_resource_config,
         planning_history_resource_config,
+        agendas_resource_config,
     ],
 )

server/planning/types/__init__.py

@@ -22,6 +22,7 @@
 from .assignment import AssignmentResourceModel
 from .published import PublishedPlanningModel
 from .enums import PostStates, UpdateMethods, WorkflowState
+from .agendas import AgendasResourceModel
 from .planning_types import PlanningTypesResourceModel
 
 
@@ -40,6 +41,7 @@
     "PostStates",
     "UpdateMethods",
     "WorkflowState",
+    "AgendasResourceModel",
 ]
 
 

server/planning/types/agendas.py

@@ -0,0 +1,11 @@
+from pydantic import Field
+from typing import Annotated
+
+from .base import BasePlanningModel
+from superdesk.core.resources import fields
+from superdesk.core.resources.validators import validate_iunique_value_async
+
+
+class AgendasResourceModel(BasePlanningModel):
+    name: Annotated[fields.Keyword, validate_iunique_value_async("agendas", "name")]
+    is_enabled: bool = Field(default=True)