Skip to content

2.5 platform-inbox

Sprint: Sprint 02 - Platform Core Libraries
Feature ID: 2.5
Subtasks: 2.5.1

Objective

Deliver "platform-inbox" within Sprint 02 - Platform Core Libraries.

Dependencies

Aggregated from the subtasks below (prerequisite task IDs and enablers):

  • 2.3.1

Subtasks

2.5.1 Inbox core types and behavior

  • ID: 2.5.1
  • Title: Implement IdempotentRequest, InboxStore, InboxService, InboxBehavior
  • Description: In com.telco.platform.inbox: IdempotentRequest marker (idempotencyKey()); InboxStore.markProcessed(messageId, handler) returning true when newly inserted; InboxService
  • DefaultInboxService; InboxBehavior (order = INBOX) that supports IdempotentRequest and short-circuits (returns null) when not first-seen.
  • Business Purpose: Exactly-once consumption semantics for event-driven flows (ARC-05, FR-26 reuse).
  • Inputs: PLATFORM-SPEC Section 6.
  • Outputs: Inbox core types and InboxBehavior.
  • Acceptance Criteria:
  • First-seen message proceeds to the handler; a duplicate short-circuits without invoking it (unit test with a fake store).
  • Dependencies: 2.3.1
  • Complexity: M

Acceptance Criteria

Each subtask above carries its own objective, testable acceptance criteria. This feature is complete when every subtask's acceptance criteria are met.

Deliverables

  • Inbox core types and InboxBehavior.

Definition of Done

  • All subtasks (2.5.1) completed and their acceptance criteria verified.
  • All listed dependencies satisfied.
  • Build and tests green per the global conventions in ../README.md (Section 3).