用途:将应用状态保存为不可变的事件序列,而非当前状态快照。适用于合规与财务的完整审计追踪、时间点状态查询(某时刻状态如何)、读写模型分离的 CQRS、需事件回放与调试的系统、最终一致性的微服务。
主要能力:提供领域事件基类(Pydantic,frozen 保证不可变,含 event_id、aggregate_id、event_type、version、timestamp);事件溯源聚合(命令产生事件、_apply 应用事件重建状态、load_from_history 回放);事件存储追加(乐观并发,比较 expected_version,不符抛出 ConcurrencyError);投影、快照与能力模块 event-store、aggregate-pattern、projections、snapshots。
使用方式:事件命名用过去式(如 OrderPlaced);并发采用版本校验的乐观锁;大聚合每 100-500 个事件做快照;事件 schema 需版本化并支持 upcasting;投影用异步处理器且更新幂等;存储可选 PostgreSQL + JSONB 或专用事件存储。禁止修改已存事件、禁止在事件中包含计算数据、不可忽略事件顺序。
限制:资料未提供安装命令、依赖清单、具体运行步骤与收费信息;代码示例为参考模式,未给出完整可运行环境与测试说明。