Documentation Overview¶

This documentation covers the pupsourcing stack — a set of Go libraries for building event-sourced systems with PostgreSQL.

Guides¶

Guide	Description
Getting Started	Install the stack, create your first event, and run a consumer.
Core Concepts	Event sourcing fundamentals, design principles, and common patterns.

Components¶

Component	Description
Event Store	Append-only event log with optimistic concurrency and PostgreSQL storage.
Consumers & Projections	Interfaces for processing events and building read models.
Worker	Distributed consumer processing with leader election and automatic rebalancing.
Code Generation	Type-safe mapping between domain events and store events.
Encryption	Envelope encryption for PII and secrets in event-sourced systems.

Operations¶

Guide	Description
Outbox	Transactional outbox pattern for reliable integration messaging.
Deployment	Production deployment, scaling, and configuration.
Observability	Logging, distributed tracing, and metrics.

Quick Links¶

New to event sourcing? Start with Core Concepts, then Getting Started.
Setting up a new project? Follow Getting Started, then Event Store and Worker.
Adding encryption? See Encryption for PII protection and secret management.
Going to production? Read Deployment and Observability.