Recipes

Task-focused guides for the things you actually do with Funes. Each recipe assumes you’ve met the Concepts and shows you how to put them to work in a real Rails app — appending events from controllers, translating messages, coordinating with sibling writes, querying history, and shipping projections to whatever destination fits.

• Setting up projections — virtual or persistent (default-database or custom-destination) projections
• Events as first-class Rails citizens — forms, controllers, and I18n all work as you’d expect
• Validating events in interpretation time — add errors from inside an interpretation block, with both event and state in view
• Reading the right error collection — pick between own_errors, state_errors, and the merged errors depending on what you need to show
• Atomic writes — coordinate append! with sibling writes inside a transaction you control
• Attaching meta information to events — record the user and request context behind every event
• Building bi-temporal event streams — query by as_of and at for full historical reconstruction
• Testing projections — exercise interpretations in isolation with ProjectionTestHelper

---

Table of contents

• Setting up projections
• Events as first-class Rails citizens
• Validating events in interpretation time
• Reading the right error collection
• Atomic writes
• Attaching meta information to events
• Building bi-temporal event streams
• Testing projections