事件溯源（Event Sourcing）技术指南：实现审计追踪、时间点查询与CQRS架构

event-sourcing by aj-geddes/useful-ai-prompts

140 周安装量

141 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/aj-geddes/useful-ai-prompts --skill event-sourcing

方法论微服务架构系统架构

🇨🇳中文介绍

事件溯源

概述

将状态变化存储为一系列事件，而非当前状态，从而支持时间点查询、审计追踪和事件重放。

适用场景

审计追踪需求
时间点查询（任意时间点的状态）
事件驱动的微服务
CQRS 实现
金融系统
复杂的领域模型
调试与分析
合规与监管

快速开始

最小工作示例：

interface DomainEvent {
  id: string;
  aggregateId: string;
  aggregateType: string;
  eventType: string;
  data: any;
  metadata: {
    userId?: string;
    timestamp: number;
    version: number;
  };
}

interface Aggregate {
  id: string;
  version: number;
}

class EventStore {
  private events: DomainEvent[] = [];

  async appendEvents(
    aggregateId: string,
    expectedVersion: number,
    events: Omit<DomainEvent, "id" | "metadata">[],
// ... (完整实现请参阅参考指南)

参考指南

references/ 目录下的详细实现：

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

指南	内容
事件存储 (TypeScript)	事件存储 (TypeScript)
投影（读取模型）	投影（读取模型）
使用 PostgreSQL 的事件存储	使用 PostgreSQL 的事件存储
用于性能优化的快照	用于性能优化的快照

🇺🇸English

Event Sourcing

Overview
When to Use
Quick Start
Reference Guides
Best Practices

Overview

Store state changes as a sequence of events rather than the current state, enabling temporal queries, audit trails, and event replay.

When to Use

Audit trail requirements
Temporal queries (state at any point in time)
Event-driven microservices
CQRS implementations
Financial systems
Complex domain models
Debugging and analysis
Compliance and regulation

Quick Start

Minimal working example:

interface DomainEvent {
  id: string;
  aggregateId: string;
  aggregateType: string;
  eventType: string;
  data: any;
  metadata: {
    userId?: string;
    timestamp: number;
    version: number;
  };
}

interface Aggregate {
  id: string;
  version: number;
}

class EventStore {
  private events: DomainEvent[] = [];

  async appendEvents(
    aggregateId: string,
    expectedVersion: number,
    events: Omit<DomainEvent, "id" | "metadata">[],
// ... (see reference guides for full implementation)

Reference Guides

Detailed implementations in the references/ directory:

Guide	Contents
Event Store (TypeScript)	Event Store (TypeScript)
Projections (Read Models)	Projections (Read Models)
Event Store with PostgreSQL	Event Store with PostgreSQL
Snapshots for Performance	Snapshots for Performance

Best Practices

✅ DO

Store events immutably
Version your events
Use optimistic concurrency
Create snapshots for performance
Use projections for queries
Keep events small and focused
Include metadata (timestamp, user, etc.)
Handle event versioning/migration

❌ DON'T

Mutate past events
Store current state only
Skip concurrency checks
Query event store for reads
Make events too large
Forget about event schema evolution

Weekly Installs

114

Repository

aj-geddes/usefu…-prompts

GitHub Stars

116

First Seen

Jan 21, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

opencode95

claude-code92

gemini-cli90

codex87

cursor82

github-copilot76