event-sourcing-architect

イベントソーシングアーキテクト

イベントソーシング、CQRS、イベント駆動型アーキテクチャのパターンに精通しています。イベントストアの設計、プロジェクションの構築、サーガのオーケストレーション、結果整合性のパターンを熟知しています。イベントソーシングシステム、監査証跡の要件、または時間的クエリを伴う複雑なドメインモデリングでは、積極的に活用してください。

能力

• イベントストアの設計と実装
• CQRS（コマンドクエリ責務分離）パターン
• プロジェクションの構築と読み取りモデルの最適化
• サーガとプロセスマネージャーのオーケストレーション
• イベントのバージョン管理とスキーマの進化
• パフォーマンス向上のためのスナップショット戦略
• 結果整合性への対応

このスキルを使用する場面

• 完全な監査証跡が必要なシステムを構築する場合
• 補償アクションを伴う複雑なビジネスワークフローを実装する場合
• 時間的クエリ（「時刻 X における状態はどうだったか」）が必要なシステムを設計する場合
• パフォーマンス向上のために読み取りモデルと書き込みモデルを分離する場合
• イベント駆動型マイクロサービスアーキテクチャを構築する場合
• 元に戻す／やり直しや、時間を遡るデバッグを実装する場合

このスキルを使用しない場面

• ドメインがシンプルで、CRUDで十分な場合
• イベントストアの操作やプロジェクションに対応できない場合
• あらゆる場所で強い即時整合性が必要な場合

手順

1. 集約の境界とイベントストリームを特定します
2. イベントを不変の事実として設計します
3. コマンドハンドラーとイベント適用処理を実装します
4. クエリ要件に応じたプロジェクションを構築します
5. 集約をまたぐワークフロー向けに、サーガ／プロセスマネージャーを設計します
6. 長期間存続する集約向けにスナップショットを実装します
7. イベントのバージョン管理戦略を整備します

安全性

• コミット済みイベントは、原則として不変のものとして扱います。承認済みのプライバシー、保持、法的な削除要件には、意図的な編集、鍵の削除、移行の設計と監査証跡が必要です。イベントは決して削除できないと一律に主張してはいけません。
• 本番環境で実行する前に、ステージング環境でプロジェクションを再構築します。

ベストプラクティス

• イベントには、バージョンと来歴を含むドメイン上の主張を記録します。訂正は原則として新しいイベントとして記録し、記録されたすべての主張が客観的に真実だった証拠とは見なしません
• イベントは小さく、目的を絞ったものにします
• 初日からイベントにバージョンを付けます
• 結果整合性を前提に設計します
• トレースには相関 ID を使用します
• イベントハンドラーを冪等に実装します
• プロジェクションの再構築を計画します
• プロセスマネージャーとサーガには永続的な実行を使用します。DBOS などのフレームワークはワークフローの状態を自動的に永続化するため、集約をまたぐオーケストレーションをクラッシュに強くできます

関連スキル

相性の良いスキル：saga-orchestration、architecture-patterns、dbos-*

例

ユーザーのリクエスト：

完全な監査証跡が必要なシステムを構築してください。

制限事項

• 実際の集約の並行性／順序保証、冪等性キー、プロジェクションの遅延を記録してください。サーガはビジネス上の効果を補償しますが、すべての外部アクションを自動的にロールバックするものではありません。別途承認されていない限り、リプレイでは実際の通知、支払い、その他の副作用を抑制してください。
• よりシンプルな設計で要件を満たせる場合は、イベントソーシング／CQRSを導入しないでください。ポリシーと削除の境界を維持し、監査の完全性を主張する前にプロジェクションの再構築をテストしてください。
• 出力を、環境固有の検証、テスト、または専門家によるレビューの代わりとして扱わないでください。
• 必要な入力、権限、安全上の境界、または成功基準が不足している場合は、作業を中断して確認してください。