cqs-patterns
CQS- und CQRS-Muster anwenden
Clean Architecture erfordert eine klare Trennung zwischen Operationen, die den Zustand ändern, und solchen, die Daten zurückgeben. Dieser Skill bietet Muster und Codebeispiele für die Implementierung von Command Query Separation und CQRS in .NET-Anwendungen.
スキルZIPをダウンロード
Claudeでアップロード
設定 → 機能 → スキル → スキルをアップロードへ移動
オンにして利用開始
テストする
「cqs-patterns」を使用しています。 Konvertiere diese Methode zu CQS: ```csharp public Order GetAndProcessOrder(int orderId) { var order = _repository.GetById(orderId); order.Process(); _repository.Update(order); return order; } ```
期待される結果:
## CQS-konforme Refaktorierung
**Commands (Zustandsänderung):**
```csharp
public void ProcessOrder(int orderId)
{
var order = _repository.GetById(orderId);
order.Process();
_repository.Update(order);
}
```
**Queries (Datenabruf):**
```csharp
public Order? GetOrder(int orderId)
{
return _repository.GetById(orderId);
}
```
**Verwendung:**
```csharp
var order = orderService.GetOrder(orderId);
orderService.ProcessOrder(orderId);
```
「cqs-patterns」を使用しています。 Erstelle einen Command für die Aktualisierung des Bestellstatus
期待される結果:
## Update Order Status Command
```csharp
public record UpdateOrderStatusCommand(
Guid OrderId,
OrderStatus NewStatus,
string? Reason = null
) : ICommand;
public class UpdateOrderStatusCommandHandler
: ICommandHandler<UpdateOrderStatusCommand>
{
private readonly IOrderRepository _repository;
private readonly IEventPublisher _publisher;
public async Task HandleAsync(UpdateOrderStatusCommand command,
CancellationToken ct)
{
var order = await _repository.GetByIdAsync(command.OrderId, ct);
if (order == null)
throw new OrderNotFoundException(command.OrderId);
order.UpdateStatus(command.NewStatus, command.Reason);
await _repository.UpdateAsync(order, ct);
await _publisher.PublishAsync(
new OrderStatusUpdatedEvent(order.Id, command.NewStatus), ct);
}
}
```
「cqs-patterns」を使用しています。 Wann sollte ich CQRS verwenden?
期待される結果:
## Wann CQRS verwendet werden sollte
**Gut geeignet für CQRS:**
- Komplexe Domänen mit unterschiedlichen Lese-/Schreibmustern
- Szenarien mit hohem Leseaufkommen und geringem Schreibaufkommen (Reporting-Dashboards)
- Systeme, die Audit-Trails für Schreiboperationen erfordern
- Event-Sourced-Systeme
- Microservices mit separaten Read-Replicas
**CQRS erhöht die Komplexität. Verwenden Sie einfacheres CQS, wenn:**
- Einfache CRUD-Operationen dominieren
- Lese- und Schreibmodelle ähnlich sind
- Kleines Team oder Projekt
- Konsistenz zwischen Lese- und Schreiboperationen kritisch ist
**Beginnen Sie mit CQS auf Methodenebene und entwickeln Sie dann zu CQRS weiter, wenn die Anforderungen es erfordern.**
セキュリティ監査
安全All 60 static findings are false positives. The scanner misinterpreted documentation keywords (command, query), markdown code fences as backticks, and metadata fields as hardcoded URLs. The skill contains legitimate CQS/CQRS architectural documentation with C# code examples.
品質スコア
作れるもの
Service-Layer-Methoden entwerfen
Bestehende Service-Methoden refaktorieren, um CQS-Prinzipien zu folgen und zustandsändernde Operationen von Datenabruf-Queries zu trennen.
Command/Query-Handler erstellen
Neue Command- und Query-Handler nach etablierten MediatR-artigen Mustern mit ordnungsgemäßer Async-Unterstützung erstellen.
Lese-/Schreibtrennung architektonisch gestalten
CQRS auf Architekturebene anwenden und separate Lese- und Schreibmodelle entwerfen, die für ihre spezifischen Belange optimiert sind.
これらのプロンプトを試す
Konvertiere diese Methode, um CQS-Prinzipien zu folgen. Trenne sie in einen Command, der den Zustand ändert, und eine Query, die Daten zurückgibt:
```csharp
public User CreateAndReturnUser(string email, string name)
{
var user = new User { Email = email, Name = name };
_repository.Add(user);
return user;
}
```Erstelle einen Command-Handler für die Erstellung einer Bestellung mit folgenden Anforderungen: - Akzeptiere CreateOrderCommand mit CustomerId und OrderItems - Validiere, dass der Kunde existiert - Erstelle Order-Domain-Entity mit Items - Persistiere im Repository - Publiziere OrderCreatedEvent - Gib Order-ID zurück
Erstelle einen Query-Handler für den Abruf von Bestellungen nach Kunde mit Paginierung: - Akzeptiere GetOrdersByCustomerQuery mit CustomerId, Page, PageSize - Gib PagedResult<OrderSummaryDto> zurück - Füge optimierte SQL-Query hinzu - Behandle Berechnung der Gesamtanzahl
Entwerfe eine CQRS-Implementierung für einen Produktkatalog mit folgenden Anforderungen: - Separate Lese- und Schreibmodelle - Commands: CreateProduct, UpdatePrice, DiscontinueProduct - Queries: GetProduct, GetProductsByCategory, SearchProducts - Verwende Dispatcher-Muster für Routing - Berücksichtige, wann vollständiges CQRS Mehrwert gegenüber einfachem CQS bietet
ベストプラクティス
- Commands auf eine einzelne Aktion fokussieren und Queries darauf konzentrieren, Daten ohne Seiteneffekte zurückzugeben
- Marker-Interfaces (ICommand, IQuery) verwenden, um generische Dispatching-Muster zu ermöglichen
- Commands validieren, bevor Domain-Modelle berührt werden, und schnell mit klaren Fehlermeldungen fehlschlagen
- Lesemodelle (DTOs) von Schreibmodellen (Entities) trennen, um jedes für seinen Zweck zu optimieren
回避
- Domain-Entities aus Query-Handlers zurückgeben bricht die Lese-/Schreibtrennung
- Geschäftslogik in Commands statt in Domain-Modellen hinzufügen verringert die Testbarkeit
- Dasselbe Modell für Lese- und Schreiboperationen verwenden, wenn sich die Optimierungsanforderungen unterscheiden
- CQRS einheitlich anwenden, wenn einfachere Muster ausreichen würden, fügt unnötige Komplexität hinzu
よくある質問
Was ist der Unterschied zwischen CQS und CQRS?
Kann ein Command einen Wert zurückgeben?
Wann ist CQRS übertrieben?
Wie teste ich CQS-konformen Code?
Sollte ich dieselbe Datenbank für Lese- und Schreiboperationen verwenden?
Was ist das Dispatcher-Muster?
開発者の詳細
作成者
DoubleslashSEライセンス
MIT
リポジトリ
https://github.com/DoubleslashSE/claude-workflows/tree/main/Plugins/dotnet-tdd/skills/cqs-patterns参照
main
ファイル構成
📄 SKILL.md