Lista zamówień ładuje się szybko, ale po kliknięciu „Anuluj” ten sam model danych musi jeszcze obsłużyć walidację, zmianę statusu i historię operacji. CQRS rozdziela odczyt od zapisu, choć nie wymaga od razu dwóch baz danych ani osobnych serwerów. Różnica między prostym podziałem w kodzie a rozbudowaną architekturą potrafi jednak zmienić poziom złożoności całego backendu.

CQRS oddziela intencje zapisu od potrzeb odczytu
- Command opisuje zmianę stanu, na przykład anulowanie zamówienia.
- Query pobiera dane i nie zmienia stanu aplikacji.
- Osobne modele można wdrożyć, korzystając z jednej bazy danych.
- Event Sourcing jest odrębnym wzorcem, który można łączyć z CQRS, ale nie trzeba.
- Próg opłacalności pojawia się wtedy, gdy odczyty i zapisy mają wyraźnie różne wymagania lub reguły domenowe.
W CQRS zapis i odczyt odpowiadają na różne pytania
Wyobraź sobie ekran szczegółów zamówienia. Użytkownik chce zobaczyć nazwę produktu, status, przewidywaną dostawę i kwotę, ale zapis wymaga sprawdzenia płatności, dostępności towaru oraz reguł anulowania. Jeden model danych często nie pasuje równie dobrze do obu zadań.
CQRS, czyli Command Query Responsibility Segregation, dzieli te obowiązki. Command wyraża zamiar zmiany, na przykład „Anuluj zamówienie”, a query prosi o dane, na przykład „Pobierz szczegóły zamówienia”. Polecenie przechodzi przez walidację i reguły biznesowe; zapytanie zwraca dane w formie wygodnej dla ekranu lub API.
Ten podział dotyczy odpowiedzialności, niekoniecznie infrastruktury. Jak opisuje wzorzec CQRS w Azure Architecture Center, można rozdzielić modele odczytu i zapisu, a mimo to korzystać ze wspólnego magazynu danych. Właśnie od tego prostszego wariantu zwykle rozsądnie zacząć.
Osobne modele nie oznaczają automatycznie osobnych baz
W nazwie CQRS łatwo dostrzec obietnicę dużej architektury, ale pierwszy krok może być niewielki: osobne ścieżki kodu do zapisu i odczytu w tej samej aplikacji. Model zapisu pilnuje reguł, a model odczytu zwraca gotowy widok, na przykład wiersz tabeli zamówień z nazwą klienta i statusem.
Dopiero gdy obciążenie lub sposób prezentacji danych tego wymaga, można rozważyć osobne magazyny. Wtedy projekcja, czyli przygotowany do odczytu zestaw danych, musi być aktualizowana po zmianach po stronie zapisu. Zyskujesz swobodę optymalizacji, lecz pojawia się koszt synchronizacji i możliwość krótkiego opóźnienia.
| Wariant | Co jest rozdzielone | Co zyskujesz | Jaki koszt dochodzi |
|---|---|---|---|
| CRUD | Operacje korzystają ze wspólnego modelu | Mniej elementów do utrzymania | Model może być niewygodny, gdy reguły zapisu i potrzeby ekranów mocno się różnią |
| CQRS w jednej bazie | Modele lub ścieżki zapisu i odczytu | Czytelniejsze intencje i niezależne kształtowanie odpowiedzi | Dodatkowe handlery, modele i testy |
| CQRS z osobnymi magazynami | Modele oraz fizyczne źródła danych | Możliwość niezależnego skalowania i doboru technologii | Synchronizacja, obsługa opóźnień, ponowień i duplikatów zdarzeń |
Moim zdaniem najlepszy pierwszy krok to rozdzielenie logiki bez rozdzielania baz. Jeżeli problem nie znika po takim podziale, dopiero wtedy architektura daje powód, by dodawać kolejne elementy.
Event Sourcing i CQRS rozwiązują różne problemy
W rozmowach o CQRS często pojawia się Event Sourcing, jakby oba terminy oznaczały ten sam zestaw decyzji. Nie oznaczają. CQRS rozdziela modele zapisu i odczytu, natomiast Event Sourcing przechowuje historię zmian jako zdarzenia, z których można odtworzyć stan.
Można wdrożyć CQRS, zapisując bieżący stan w zwykłej relacyjnej bazie. Można też połączyć ten wzorzec z Event Sourcingiem, ale wtedy dochodzą między innymi projekcje, odtwarzanie danych i migracje schematów zdarzeń. Martin Fowler w omówieniu CQRS zwraca uwagę na koszt i ryzyko nadmiernego stosowania tego podejścia.
Prawdę mówiąc, przy prostym formularzu edycji profilu, który zapisuje kilka pól i odczytuje je w podobnej postaci, Event Sourcing zwykle oznaczałby więcej mechaniki niż korzyści. Inaczej wygląda system, w którym trzeba odtworzyć, dlaczego saldo lub status przyjęły daną wartość; wtedy historia zdarzeń może odpowiadać na potrzebę, której sam podział komend i zapytań nie rozwiązuje.
Opóźniony odczyt wymaga świadomego zachowania API
Po zapisie użytkownik klika „Anuluj”, dostaje potwierdzenie, a lista nadal pokazuje „W realizacji”. Taki objaw może wynikać z tego, że widok odczytu aktualizuje się asynchronicznie, a potwierdzenie zapisu nie gwarantuje natychmiastowego odświeżenia projekcji.
| Sytuacja | Prawdopodobna przyczyna | Co zrobić |
|---|---|---|
| Po udanym zapisie widok pokazuje stary status | Model odczytu jeszcze się nie zsynchronizował | Zwróć wynik komendy i pokaż stan tymczasowy albo odśwież widok po potwierdzeniu projekcji |
| To samo zdarzenie aktualizujące widok przychodzi ponownie | System wiadomości ponowił dostarczenie | Zaprojektuj obsługę zdarzeń tak, by ponowne przetworzenie nie tworzyło błędnego stanu |
| Zapis w bazie się udał, ale zdarzenie nie dotarło do kolejki | Zapis i publikacja zdarzenia nie były atomowe | Rozważ wzorzec Transactional Outbox, który zapisuje zmianę i zdarzenie w ramach jednej transakcji |
| Ekran musi pokazać natychmiast aktualną wartość | Opóźniona spójność nie pasuje do tej ścieżki | Odczytaj wynik bezpośrednio po zapisie lub zaprojektuj dla tej operacji synchroniczną ścieżkę |
To decyzja produktowa, nie wyłącznie techniczna: czy ekran może przez chwilę pokazywać poprzedni stan? Jeśli nie, trzeba zaprojektować odczyt „po zapisie” zamiast liczyć, że osobny model zdąży się odświeżyć. Dla interfejsu użytecznego UX ta chwila niepewności powinna mieć czytelny komunikat, a nie wyglądać jak utracona akcja.
Wybierz CQRS dopiero wtedy, gdy prosty CRUD zaczyna przeszkadzać
Oddzielenie ma sens, gdy reguły zapisu są bogate, a widoki wymagają wielu różnych zestawień albo ruch odczytowy i zapisowy potrzebują innego skalowania. Jeśli odczyt i zapis korzystają z tych samych danych, a logika sprowadza się do prostego CRUD, zostań przy prostszym rozwiązaniu.
| Sytuacja w aplikacji | Rozsądny kierunek |
|---|---|
| Formularz zapisuje kilka pól, a ekran pokazuje je niemal bez zmian | Pozostań przy CRUD |
| Zapis wymaga reguł biznesowych, których nie da się czytelnie ująć w prostych aktualizacjach | Rozdziel obsługę komend od zapytań, początkowo w jednej bazie |
| Różne ekrany potrzebują innych, kosztownych zestawień tych samych danych | Rozważ wyspecjalizowane modele odczytu |
| Odczyt i zapis mają różne profile obciążenia, a pomiary pokazują wąskie gardło | Sprawdź sens osobnego skalowania i magazynu dla odczytu |
Przed wdrożeniem odpowiedz na trzy pytania: co konkretnie jest trudne w obecnym modelu, jak odczyt ma reagować po zapisie i kto będzie utrzymywać synchronizację? Gdy nie ma jasnej odpowiedzi na pierwsze pytanie, architektoniczny podział może jedynie rozrzucić ten sam problem po większej liczbie klas.
Najbezpieczniej zacząć od jednej ścieżki, nie od przebudowy systemu
Weź jeden przypadek, na przykład anulowanie zamówienia. Zdefiniuj komendę opisującą intencję, umieść reguły walidacji po stronie zapisu, a po stronie odczytu przygotuj dane potrzebne konkretnemu ekranowi. Oddziel modele, zachowaj wspólną bazę i sprawdź, czy kod stał się czytelniejszy.
Jeżeli ta zmiana rozwiązuje problem, nie trzeba od razu wdrażać brokera wiadomości, osobnej bazy ani Event Sourcingu. Gdy zaś prawdziwym kłopotem okaże się opóźnienie aktualizacji widoku lub obciążenie zapytań, kolejne elementy można dodać w odpowiedzi na ten właśnie koszt. Tak CQRS pozostaje narzędziem do porządkowania backendu, a nie celem samym w sobie.