Notre avis

Ce skill fournit une aide-mémoire rapide pour les conventions de codage BookStore, incluant les identifiants, les horodatages, les événements, les commandes, le cache et la multi-tenance.

Points forts

Recherche rapide des modèles courants
Favorise la cohérence du code
Réduit les erreurs
Couvre les domaines clés comme le cache et les événements

Limites

Spécifique aux conventions BookStore uniquement
Pas un tutoriel complet
Peut devenir obsolète avec l'évolution du codebase

Quand l'utiliser

Utilisez ce skill lorsque vous avez besoin d'un rappel rapide des conventions ou des modèles de codage BookStore.

Quand l'éviter

Ne l'utilisez pas lorsque vous avez besoin d'un guide pas à pas pour des workflows complexes ; préférez alors le skill scaffold approprié.

name: meta__cheat_sheet description: 'Quick reference for BookStore code rules and patterns. Use this when you need a fast lookup of conventions for IDs (Guid.CreateVersion7), timestamps (DateTimeOffset.UtcNow), event naming, logging (LoggerMessage), caching, or multi-tenancy. DO NOT USE FOR: step-by-step workflows — use the relevant scaffold skill instead.'

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

Aide-mémoire BookStore

Recommandé pour