Skip to content

JNY-CRM-ACT-003Claim, release and transfer shared queue work

Markdown

JNY-CRM-ACT-003

Claim, release and transfer shared queue work

Markdown
  • DocumentDraft
  • Product intentProposed
  • ImplementationPartially observed

KindJourneyProduct areaCRMModuleActivities, Follow-ups and Task WorkRevision2End-to-endRequired

Read atservices-crm a8d1364freact-console baf6dae3

The Formal Contract

The narrative above explains; the sections below are authoritative — the rules, scenarios and tests this document binds.

Goal
Reserve shared work for one holder, preserve its arrival place on hand-back and identify its overdue audience.
Screens
/console/{tenantId}/configuration/crm/taskQueues/console/{tenantId}/tasks

Steps

#SurfaceActionCapabilityExpectedProvenance
1/console/{tenantId}/configuration/crm/taskQueuesCreate Membership services and Events queues as an administrator.CAP-CRM-ACT-016Both entries appear in configuration and selection lists.test
2createTaskCreate two unassigned tasks in Membership services at different times.CAP-CRM-ACT-012The records retain their queue arrival instants.test
3/console/{tenantId}/tasksOpen the queue view and claim the earlier task.CAP-CRM-ACT-014The claimant becomes holder without removing queue membership.test
4releaseTaskRelease the task.CAP-CRM-ACT-012The holder clears while the earlier arrival position remains.test
5assignTaskClaim again and transfer the task to Events.CAP-CRM-ACT-012The new queue receives a new arrival instant.test
6crm.tasks_overdueAllow unclaimed queued work to pass its due day.CAP-CRM-ACT-015When publishing is enabled, the item names queue responsibility and scope; Home delivery is beyond this test.test
services-crm:modules/tasks/tests/integration/services/persistence/task-attention-items.integration.spec.js#addresses a queued task nobody holds to the task queue responsibility at its queue

Alternate and Failure Paths

PathFrom stepConditionPath takenOutcomeProvenance
alternate3Several workers claim the same task together.The reservation permits one winner.Other attempts identify the successful holder.test
failure1An administrator deletes a queue still referenced by a task.The service rejects deletion of the used queue.Queue and task references remain.test
failure3The queue is inactive when a worker claims.Current claim behavior still permits reservation.Deactivation has not stopped queue work.test

Assertions

IdStatementProvenance
01Release retains the task’s prior queue position.test
02Concurrent claims leave exactly one holder.test
03A queue referenced by work cannot be deleted.test

End-to-end policy: required: Queue views and action controls need browser proof in addition to service concurrency and configuration assertions.

The Markdown files under specs/ in rhythmsoftware/rhythm-v2-docs are the canonical source of truth. This reader is a generated, read-only projection of them.