events-patterns

What problem does it solve?

It helps you design event-driven Rails systems that treat events as rich domain records while reliably powering activity feeds, webhook delivery, client tracking, and audit trails.

Core Features & Use Cases

• Domain event records over generic tracking: create typed models (e.g., CardMoved, CommentAdded) with associations and callbacks that trigger side effects.
• Polymorphic activity feeds: store activities that reference the real event records and render descriptions/icons via subject delegation.
• Webhook delivery pipeline: persist webhook endpoints and deliveries, sign payloads with HMAC-SHA256, and process delivery asynchronously with retries.
• Client-side interaction tracking: capture page views and user actions via Stimulus and store flexible metadata in JSONB.
• Immutable audit trails (event sourcing pattern): record attribute diffs as immutable change payloads for compliance-friendly history.
• Event aggregation for reporting: compute summaries (counts, top boards/users, daily breakdowns) from persisted event/activity records.

Quick Start

Use the events-patterns skill to implement a Rails pattern where actions like moving a card create a typed CardMoved event that automatically generates an activity feed entry and enqueues signed webhook deliveries.