Skip to main content

Events App

The events app manages the creation, tracking, and replay of events in the Maybern system. Events enable powerful features like rollback, export/import, and audit trails.

Overview

An event is a record of a change in the system. The events app provides:
  • Event models and relationships
  • Import/export functionality
  • Load and replay capabilities
See Events System for detailed architecture.

Event Types

TypeDescription
CustomerEventCustomer-level activity
FundFamilyEventFund family activity
FundFamilySubEventSub-event within fund family event
StateTransitionEventStatus changes

Event Features

Import

Load events from JSON templates:
  1. Upload template file
  2. Create EventTemplate
  3. Replace object IDs (prevent duplicates)
  4. Bulk create events and objects

Export

Export customer events to template:
  1. Export all events in parallel
  2. Dedupe objects
  3. Replace IDs with normalized references
  4. Create versioned template

Load

Load events from template into customer:
  1. Read EventTemplate
  2. Create load events
  3. Process events sequentially
  4. Track completion status

Event Template Models

ModelDescription
EventTemplateCollection of loadable events
EventTemplateVersionVersion tracking
EventTemplateEventIndividual event in template
EventTemplateObjectObject data in template
EventTemplateLoadEventLoad status tracking

Use Cases

  1. Export customer at desired point
  2. Reset customer data
  3. Load exported template
  1. Export customer events
  2. Roll back to before error
  3. Modify problematic event
  4. Re-load events with fix
  1. Export from source
  2. Import to target
  3. Load to new customer