BookStore Cheat Sheet
IDs & Timestamps
var id = Guid.CreateVersion7(); // ✅ UUIDv7
var now = DateTimeOffset.UtcNow; // ✅ UTC timestamp
Event (past tense, record)
public record BookAdded(Guid Id, string Title, decimal Price);
Command (record)
public record AddBookCommand(string Title, decimal Price);
Aggregate Apply Method
public void Apply(BookAdded @event)
{
Id = @event.Id;
Title = @event.Title;
}
Handler (static, Wolverine)
public static class AddBookHandler
{
public static BookAdded Handle(AddBookCommand cmd) =>
new(Guid.CreateVersion7(), cmd.Title, cmd.Price);
}
HybridCache Query
var result = await cache.GetOrCreateAsync(
$"books:{culture}",
async ct => await session.Query<BookProjection>().ToListAsync(ct),
tags: [CacheTags.BookList],
cancellationToken: ct);
Cache Invalidation
await cache.RemoveByTagAsync(CacheTags.BookList, ct);
SSE Notification
public record BookUpdatedNotification(Guid Id) : IDomainEventNotification;
TUnit Test
[Test]
public async Task Should_Create_Book()
{
var result = await client.CreateBookAsync(request);
await Assert.That(result.Id).IsNotNull();
}
Namespace
namespace BookStore.ApiService.Handlers; // ✅ File-scoped
Related Skills
/wolverine__guide - All Wolverine write operations (create, update, delete)/marten__guide - Aggregates, projections, and query endpoints
majiayu000