docs(design): add user story knowledge bundle
CI / build (push) Successful in 3m35s
Release / release (push) Successful in 4m6s

This commit is contained in:
dmg
2026-08-08 12:31:15 -04:00
parent baed3b4901
commit c76ea5b434
9 changed files with 198 additions and 0 deletions
@@ -0,0 +1,25 @@
---
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)