Files
spigot-event-producer/design/user-stories/us-002-produce-standard-cloud-events.md
dmg c76ea5b434
CI / build (push) Successful in 3m35s
Release / release (push) Successful in 4m6s
docs(design): add user story knowledge bundle
2026-08-08 12:31:15 -04:00

26 lines
1.2 KiB
Markdown

---
type: User Story
title: "US-002: Produce standard CloudEvents"
description: Represent captured Minecraft activity as consistently identifiable CloudEvents 1.0 records.
status: done
---
# US-002: Produce standard CloudEvents
As an **event consumer**, I want Minecraft activity represented by a consistent CloudEvents envelope so that I can process records from multiple servers and players reliably.
## Acceptance criteria
- [x] Every record is a structured CloudEvents 1.0 JSON object with a unique stable event ID, UTC time, source, type, and JSON content type.
- [x] Event types use the `games.dmg.minecraft.*` namespace.
- [x] Every event includes the stable server ID, server name, and game version as extensions and in its data.
- [x] Player events include the player UUID as an extension and include the player UUID and current name in their data.
- [x] An event retains the same ID and payload while it is retried from the outbox.
## Related
- [US-001: Configure the event producer](us-001-configure-event-producer.md)
- [US-003: Capture player and server activity](us-003-capture-player-activity.md)
- [US-004: Capture periodic player snapshots](us-004-capture-player-snapshots.md)
- [Event reference](../../README.md#events)