# Event Driven

> Event-Driven — Event Sourcing, Saga, CQRS

- Skill: `thebeardedbearsas/event-driven` (Agent Skill)
- Install (CLI): `npx get-skill add thebeardedbearsas/event-driven`
- Raw SKILL.md: https://api.skillmd.com/api/skills/thebeardedbearsas/event-driven/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: TheBeardedBearSAS (https://skillmd.com/u/thebeardedbearsas)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/thebeardedbearsas/event-driven

---


# Event-Driven — Event Sourcing, Saga, CQRS

Architecture événementielle pour découplage et scalabilité.

## Patterns

**Event Sourcing** — Stocker events, pas état (audit, replay)  
**CQRS** — Séparer Read/Write models (projections)  
**Saga** — Transaction distribuée (microservices)  
**Event Bus** — Pub/Sub découplé (Kafka, RabbitMQ)

## Event Sourcing

```python
events = [OrderCreated(...), OrderPaid(...), OrderShipped(...)]

def rebuild(events):
    state = {}
    for e in events: state = apply(state, e)
    return state
```

## Saga — Choreography vs Orchestration

**Choreography** — Events chain services (découplé, debug dur)  
**Orchestration** — Central coordinator (visible, couplé)

```
Choreo: OrderCreated → Payment → Shipping
Orchestrator: ProcessPayment() → ShipOrder()
```

## Kafka Event Bus

```javascript
// Producer
producer.send({ topic: 'orders', messages: [{ ... }] });

// Consumer
consumer.run({
  eachMessage: async ({ message }) => {
    handleEvent(JSON.parse(message.value));
  }
});
```

## Domain Events (Symfony)

```php
class OrderCreatedEvent {
    public function __construct(public Order $order) {}
}

class SendEmail {
    public function __invoke(OrderCreatedEvent $e) {
        $this->mailer->send($e->order->email, 'Confirmation');
    }
}
```

---

Voir `@.claude/rules/21-cqrs.md`, `@.claude/skills/async/SKILL.md`

