Files
minecraft-account-manager/design/us-010-audit-events.md
T

1.8 KiB

type, title, description, tags, timestamp, story_id, status
type title description tags timestamp story_id status
User Story Preserve a CloudEvents-style audit trail Authentication, UI, account, Discord, network, and game actions create searchable immutable-style events.
audit
cloudevents
security
events
2026-08-01T18:43:58Z US-010 verified

User Story

As an operator, I want security and identity activity recorded consistently, so that incidents and account changes can be reconstructed and later published to Kafka.

Acceptance Criteria

  • Events preserve CloudEvents-style ID, specification version, source, type, subject, time, content type, and JSON data.
  • Events can include user actor, IP address, and correlation ID.
  • Portal access, magic-link creation and consumption, account changes, nickname changes, VPN blocks, and game decisions are recorded.
  • Username changes learned from Velocity create their own event.
  • Administrative actions include the acting SSO identity in event data.
  • Events can be inspected globally and from an individual admin user view.
  • published_at reserves an outbox path for future Kafka publishing.

Implementation

Validation

The shared CloudEvent contract is covered by packages/contracts/test/contracts.test.ts, and event-producing routes pass full type and production-build validation.

Related Stories