Laboratorium 5: Wprowadzenie do Domain Driven Design (DDD) oraz Command Query Responsibility Segregation (CQRS)
Celem tego laboratorium jest praktyczne zapoznanie się z kluczowymi aspektami Domain Driven Design (DDD) oraz podstawami Command Query Responsibility Segregation (CQRS). Przed rozpoczęciem, zapoznaj się z dostępnym kodem. W razie pytań, skontaktuj się przez platformę Teams.
-
Pamiętaj o odpowiednim oddzieleniu warstwy domenowej, aplikacji oraz infrastruktury (w ramach uproszczenia w tym projekcie modele domeny oraz infrastruktury są takie same).
-
Staraj się trzymać zasad SOLID w trakcie projektowania klas.
-
Projekt uruchamia się pod adresem http://localhost:8080
-
Do połączenia z bazą danych możesz użyć narzędzi takich jak Studio3T. Wymagany jest następujący ciąg połączeniowy:
mongodb://root:[email protected]:27017
. -
Podczas instalacji Visual Studio upewnij się, że zainstalowałeś pakiet ASP.NET and web development.
-
Zachecam do stworzenia klona tego repozytorum, w przypadku potrzeby dodania poprawek z mojej strony będzie Państwu łatwiej się z nimi integrować.
-
Przykładowe zapytania
- POST /api/v1/customers/{customerId}/orders
- customerId: 3fa85f64-5717-4562-b3fc-2c963f66afa6
- products id bazuje na
ProductPriceDataApi
{ "products": [ { "id": "514f6265-a9b8-46da-a31d-50f4f4c20911", "quantity": 1 } ] }
- POST /api/v1/customers/{customerId}/orders
- customerId: 3fa85f64-5717-4562-b3fc-2c963f66afa6
- products id bazuje na
ProductPriceDataApi
{ "products": [ { "id": "514f6265-a9b8-46da-a31d-50f4f4c20911", "quantity": 1 }, { "id": "514f6265-a9b8-46da-a31d-50f4f4c20912", "quantity": 2 } ] }
- GET /api/v1/orders/{orderId}
- orderd: Wartość zwrócona przez zapytanie POST
- POST /api/v1/customers/{customerId}/orders
-
Z powodów technicznych (serializacja) wszystkie właściwości modeli domnenowych muszą mieć settery i gettery np.
public Guid Id { get; private set; }
Twoim zadaniem jest zaimplementowanie funkcjonalności tworzenia nowych użytkowników przy użyciu agregatu Customer
.
- Utwórz klasy
CreateCustomerCommand
iGetCustomerQuery
. - Zaimplementuj obsługę tych komend i zapytań.
- Dodaj odpowiednie endpointy do API.
- Upewnij się, że po stworzeniu klienta generowane jest zdarzenie
CustomerCreatedEvent
.
Pamiętaj aby stworzyć nową kolekcję dla tego użytkoników w bazie danych.
Zwróć szczegególną uwagę na aby do warstwy API nie dostały się modele domenowe!
Stwórz następujące reguły biznesowe (np. OrderMustHaveAtLeastOneProductRule
):
- Nazwa użytkownika nie może być pusta i powinna składać się tylko z liter.
- Łączny koszt produktów w zamówieniu nie może przekroczyć 15000.
Twoim zadaniem jest zaimplementowanie obsługi koszyka produktów.
- Stwórz nowy agregat do obsługi koszyka z produktami.
- Dodaj odpowiednie komendy (commands) i zapytania (queries) do zarządzania koszykiem.
- Dodaj odpowiednie endpointy do API.
- Przerób implementację
Order
, aby była twrzona w za pomocą następującej metodypublic static Order Create(CheckoutCart checkoutCart)
Uwaga: Utwórz nową kolekcję dla tej funkcjonalności w bazie danych.
Za pomocą Refit (https://github.com/reactiveui/refit) nawiąż połączenie z projektem z laboratorium 2, aby pobrać informacje o produktach. Podczas integracji zwróć uwagę na wykorzystanie kontenerów.
Przykładowy interfejs do wykorzystania:
public interface IProductsApi
{
[Get("/products")]
Task<List<Product>> GetAllProductsAsync();
}
Wykorzystaj zaimplementowany interfejs IProductsApi
w klasie ProductPriceDataApi
.