henriqueatila/golang-gin-best-practices / skills/golang-gin-architect
golang-gin-architect
VerifiedSoftware architect for Go Gin APIs. Use when making architecture decisions, evaluating complexity, designing systems, choosing patterns, or coordinating across gin skills.
references/data-patterns-event-sourcing-aggregate.md
View on GitHub# Data Patterns — Event Sourcing: Aggregate Reconstruction and Snapshots
Companion to `data-patterns-event-store.md` (gate, schema, EventStore Append/Load).
---
## Aggregate Reconstruction
Reconstruct state by replaying events in version order.
```go
// OrderAggregate reconstructs state by replaying events.
type OrderAggregate struct {
ID string
Status string
Version int
}
func (a *OrderAggregate) Apply(e Event) {
switch e.EventType {
case "OrderCreated":
var p struct{ Status string }
_ = json.Unmarshal(e.Payload, &p)
a.ID = e.AggregateID
a.Status = p.Status
case "OrderShipped":
a.Status = "shipped"
case "OrderCancelled":
a.Status = "cancelled"
}
a.Version = e.Version
}
func RebuildOrder(events []Event) OrderAggregate {
var agg OrderAggregate
for _, e := range events {
agg.Apply(e)
}
return agg
}
```
---
## Snapshot Optimization
Add when replay of >500 events becomes slow:
```go
type Snapshot struct {
AggregateID string `db:"aggregate_id"`
Version int `db:"version"`
State json.RawMessage `db:"state"`
}
func SaveSnapshot(ctx context.Context, db *sqlx.DB, s Snapshot) error {
_, err := db.ExecContext(ctx,
`INSERT INTO snapshots (aggregate_id, version, state)
VALUES ($1, $2, $3)
ON CONFLICT (aggregate_id) DO UPDATE SET version = $2, state = $3`,
s.AggregateID, s.Version, s.State,
)
if err != nil {
return fmt.Errorf("save snapshot: %w", err)
}
return nil
}
```
Load with snapshot: load the latest snapshot first, then replay only events after `snapshot.Version`.
---
## Cost Summary
**Complexity: VERY HIGH (5/5)**
| Trade-off | Detail |
|---|---|
| Benefit | Complete audit trail; rebuild any past state; temporal queries |
| Alternative | `audit_log` table in PostgreSQL (handles 90% of audit requirements) |
| You need it when | Legal/compliance to reproduce state at any past point in time AND complex state machines AND team has event store experience |
| You do NOT need it for | "an audit log" — that's a PostgreSQL table, not event sourcing |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |