Better Software Design

W 2015 roku Meta, a właściwie ówczesny Facebook wydaje pierwszą wersję specyfikacji GraphQL, języka opisu zapytań do API, którego celem jest wydajne i mocno elastyczne pobieranie danych. A ten właśnie problem mocno doskwierał Facebookowi przy implementacji natywnych aplikacji mobilnych. Nadszedł rok 2024 i wiele organizacji przekonało się, że wdrożenie rozbudowanego i wydajnego GraphQL API nie jest zadaniem prostym...

O GraphQL powiedziano już wiele, warto przybliżyć trochę ciemniejszych stron używania tego rozwiązania w projekcie. Dziś zapraszam na rozmowę o cieniach GraphQL-a, a moim gościem jest Sebastian Rabiej, który z tą technologią ma sporo doświadczenia produkcyjnego.

W tym odcinku wspólnie z Sebastianem rozmawiamy między innymi o:

• raporcie Postmana i trendach w stosowaniu poszczególnych styli budowy API
• czym jest GraphQL i jakie problemy rozwiązuje
• zasadach, popularnych narzędziach i frameworkach do budowy GraphQL API
• sposobach atakowania serwera GraphQL
• potencjalnych problemach z wydajnością, bezpieczeństwem i wersjonowaniem takich API
• best practices i sposobach rozwiązania typowych problemów w GraphQL

Materiały dodatkowe:

• Dokumentacja i strona domowa GraphQL
• Dostępne wydania specyfikacji GraphQL
• Artykuł na blogu Meta opisujący jak to się wszystko zaczęło
• Zestaw zaleceń Principled GraphQL
• Praca Migrating to GraphQL: A Practical Assessment
• Wspomniany w odcinku blog post The rise and fall of GraphQL at sennder
• Artykuł Public versus Published Interfaces Martina Fowlera
• [Dokumentacja limitów GraphQL[(https://docs.github.com/en/graphql/overview/rate-limits-and-node-limits-for-the-graphql-api) w API GitHub
• Netflix DGS Framework do implementacji i uruchamiania usług opartych o GraphQL
• GraphQL Voyager, narzędzie wizualizacji schematu API w formie interkatywnego grafu
• GraphQL Cop, narzędzie audytu security API opartych o GraphQL

Frontend i jego technologie rozwijają się szybko. Tym razem na horyzoncie w świecie Angulara są Signals, które mogą dość mocno zmienić podejście do projektowania systemu.

Po mocnym otwarciu serii o architekturze frontendu rozmową z Bartkiem Cytrowskim o makro-frontendzie Atlassiana, pora na temat typowo techniczny, związany jak to często w tym światku bywa, z konkretnym frameworkiem. Gościem Tomka Ducina dziś jest Maciej Wójckik, Software Engineer i Technical Leader w Cisco, a tematem rozmowy są wspomiane już sygnały.

W dzisiejszej rozmowie:

• czym są sygnały i jaki problem rozwiązują
• w czym są podobne, a czym różnią się od istniejących narzędzi reaktywnych typu RxJs
• komponentach, zależnościach, zmianach, template'ach i wydajności systemu
• jak sygnały wpływają na projektowanie i testowanie aplikacji
• z czym wiąże się migracja aplikacji na Signals i jakie problemy mogą się pojawić

Materiały dodatkowe:

• Oficjalna dokumentacja Angular Signals
• Darmowy kurs Angular Signals autorstwa Macieja

Zostać CTO i móc samodzielnie podejmować wszystkie decyzje techniczne w projekcie i mieć ostateczne zdanie na każdy temat... Taka wizja przyszłości w nawet średniej wielkości organizacji często nie ma jednak zbyt wiele wspólnego z rzeczywistością. Na czym więc polega rola Chief Technology Officera i ile jest w niej realnie technologii?

W wiadomościach od was, na równi z tematami o architekturę, EventStorming czy Domain-Driven Design przewijają się bardo często pytania o dalszą karierę. W jakim kierunku się rozwijać, czy wiązać dalsze plany w IT ze ścieżką stricte techniczną i zostać np. architektem, czy może całkowicie skręcić w stronę managementu i kierowania zespołem czy projektem... W tym wszystkim pytania związane z funkcją i rolą CTO padały chyba najczęściej. Tak więc temat w końcu zagościł na antenie.

Dziś zapraszam Cię na rozmowę z Danielem Owsiańskim, na tematy związane właśnie z funkcją Chief Technology Officera i zarządzania technologią w firmie. Wybór gościa był jak zwykle nieprzypadkowy — Daniel pełni rolę CTO w Volt.io, gdzie mamy okazję na codzień współpracować.

Jeśli chciałbyś/-abyś dołączyć do jednego z naszych projektów w Java, Go lub PHP, tutaj znajdziesz aktualne oferty pracy.

Zapraszam Cię także do odwiedzenia bloga Daniela, owsianski.com, który ostatnio pojawił się w sieci.

Wiele osób chciałoby przy każdym projekcie pracować w green-fieldzie i móc wszystkie decyzje podejmować samodzielnie. Rzeczywistość jest jednak zwykle całkowicie inna, musimy żyć z odziedziczonym kodem i zaprojektowanym modelem. Taki green-field, w którym można zacząć projektować i wdrażać nowy model i techniki DDD, można jednak sobie wykroić.

Wspólnie z Marcinem Markowskim rozmawiamy dziś o technikach Bubble Context, Autonomous Context i Legacy As Exposed Service Erica Evansa, dzięki którym można zacząć refaktoryzację legacy. Z mniejszym lub większym związaniem z legacy, w zależności od potrzeb i możliwości w projekcie.

W dzisiejszej rozmowie:

• na czym polegają techniki Bubble i Autonomous Context,
• kiedy warto, a kiedy nie, korzystać z ich możliwości,
• wykorzystaniu istniejących danych w nowym modelu domenowych,
• ACL-backed repository, Ports & Adapters i innych przydatkach tu technikach,
• jakie synchronizować dane między kontekstami i jakie inne wyzwania staną prawdopodobnie na drodze ku lepszemu,
• współpracy w zespole przy wdrażaniu takich technik.

Materiały dodatkowe:

• Artykuł Getting Started with DDD when surrounded by legacy systems Erica Evans, 2013

"Jak mamy pozyskać świetnych architektów, jeśli w swojej karierze będą mieli okazję ją tworzyć mniej niż pół tuzina razy?". Dokładnie takie pytania postawił Ted Neward, szukając sposobu na doskonalenie umiejętności tworzenia architektury. I trudno się tu nie zgodzić, patrząc jak często w zespołach duże projekty powstają od samego początku. Istnieje jednak prosty sposób na rozwiązanie tego problemu.

Sesje Architectural Kata pozwala jednak zdobywać potrzebne doświadczenie znacznie szybciej. Tym bardziej, jeśli feedbacku na temat twojego designu udzielają Mark Richards i Jacqui Read, autorzy książek poświęconych architekturze oprogramowania. W tym roku, kolejną edycję O'Reilly Software Architecture Katas wygrywa po razy pierwszy zespół z Polski, w którego skład wchodzą Artur Kruszewski, Wojciech Kasa, Sebastian Dąbkowski i Piotr Filipowicz, mój dzisiejszy gość.

Razem z Piotrem rozmawiamy dziś między innymi o:

• czym jest Architectural Kata i jak może wspomóc Cię w procesie projektowania architektury
• sześciu perspektywach, które można wziąć pod uwagę szukając właściwej dla projektu architektury
• charakterystykach architektonicznych, ograniczeniach, macierzy styli Marka Richardsa
• komunikowaniu architektury różnym jej odbiorcom, nie tylko zespołowi developerskiemu
• konkretnych przykładach Fitness Function z architektury ewolucyjnej

Zapraszam!

Materiały dodatkowe:

• Fundamentals of Software Architecture: An Engineering Approach, książka Marka Richardsa i Neala Forda
• Software Architecture: The Hard Parts: Modern Trade-Off Analyses for Distributed Architectures, kolejna pozycja, której współautorami są Mark Richards i Neal Ford
• The Architecture Kata Log, repozytorium Jacqui Read z listą zwycięzców poszczególnych edycji konkursu O'Reilly Software Architecture Katas
• StayHealthy.MonitorMe, repozytorium z wspominanym w rozmowie opisem architektury
• Architectural Katas, katalog różnych kat Teda Newarda

Zapraszam także do obserwowania profilu Piotra na LinkedIn.

Jeśli wycena projektu podawana jest w dwóch wersjach, z uwzględnieniem testów i bez, to z software craftsmanshipem ma to niewiele wspólnego. To tak, jakby pytać chirurga, czy może przyspieszyć operację nie dezynfekując skalpela. Jakość nie powinna być elementem przetargowym. Chyba, że pracujemy nad proof-of-concept, ale tego rodzaju projekty często lubią płynnie przejść w fazę protoduction...

Jeśli szukasz sprawdzonych w boju receptur na implementację jakościowych testów, które nie będą wymagały co chwilę refaktoryzacji i modyfikacji przy zmianie kodu projektu, zapraszam Cię na dzisiejszą rozmowę z Piotrem Stawirejem. Napisać test w projekcie to w zasadzie żadna sztuka. Ale napisać test, który dostarczy realną wartość biznesową, będzie łatwy do utrzymania, a przy okazji może zostać wykorzystany na różnych poziomach piramidy testów, to trochę bardziej skomplikowane zadanie.

I pewnie niektóre strategie mogą być trochę kontrowersyjne, jak na przykład rezygnacja z typowego mockowania zależności, czy silnego podziału na wiele różnych testów w projekcie. Ale skoro działa to w praktyce, to w czym rzecz?

W tym odcinku rozmawiamy wraz z Piotrem między innymi o:

• organizacyjnych i technicznych problemach z implementacją jakościowych testów w backendzie
• metryce code-coverage i jej różnym stopniu przydatności w projekcie
• profesjonalnym podejściu do problemu "z testami, czy bez?"
• dobrych praktykach doboru strategii testowania
• szarej strefie testów Kevlina Henney'a
• legacy, testach charakterystyki, szwach i odcinaniu fragmentów systemu dla testów
• unitach, czyli fragmentach kodu o pojedynczej odpowiedzialności, mierzonego kohezją
• implementacji architektury otwartej na testowanie
• eliminacji problemów z nadużywaniem mocków w projekcie

Zapraszam!

Materiały dodatkowe:

• Sub-second acceptance tests, prezentacja Aslaka Hellesøy z konferencji SeleniumConf Chicago
• Growing Object-Oriented Software, Guided by Tests, wspomniana w rozmowie książka Steve'a Freemana i Nata Pryce'a
• Style Guide for Object Design, książka Matthiasa Nobacka
• Financial System, repozytorium z przykładowym kodem Piotra

Odpowiedzialność za zapewnienie jakości w projekcie nie spoczywa na pojedynczej osobie, tylko na całym zespole. A rola QA nie sprowadza się tylko i wyłącznie do projektowania i implementacji przypadków testowych w procesie inspekcji systemu, ale także na byciu adwokatem jakości w projekcie, i czasem zadawaniu trudnych pytań o to, dlaczego pewne funkcjonalności są zrobione w ten, a nie inny sposób.

Do tej pory temat jakości oprogramowania przewijał się głównie z perspektywy developerskiej w rozmowach o testach jednostkowych, Test Driven Development czy różnych odmianach piramidy testów. Na strukturę testów w projekcie warto też spojrzeć z jej drugiej strony, black-boxowych testów end-to-end całego systemu.

Gościem w podkaście jest dziś Arkadiusz Jelonek, pracujący na co dzień jako Senior Quality Assurance Engineer w eSky Group. A rozmawiać będziemy nie tylko i testach E2E systemu, ale także o tym, jaką rolę QA pełni w projekcie i dlaczego QA warto czasem przetłumaczyć jako Questions Asker.

W dzisiejszym odcinku wspólnie z Arkiem rozmawiamy między innymi o:

• roli Quality Assurance w projekcie
• zdobywaniu doświadczenia pracując w Software House, dojrzałej firmie produktowej i startupie
• pytaniach, jakie warto zadać w zespole wchodząc w rolę Questions Asker
• roli testów end-to-end w projekcie
• klasyfikacji, różnicach i doborze właściwych narzędzi wspierających automatyzację testów
• powstaniu Playwrighta i problemach, które to narzędzie rozwiązuje
• testach regresji wizualnej
• sposobach unikania kruchości w testach E2E

Ten odcinek jest także pierwszym z mini-serii rozmów poświęconych rozwojowi własnej kariery w IT, nie tylko na stanowisku developera. Myślisz o tym, aby pracować w tej branży np. jako Solution Architect, Engineering Manager, Chief Technology Officer czy zostać konsultantem? To tylko niektóre role i stanowiska, które pojawią się w przyszłych odcinkach Better Software Design…

Materiały dodatkowe:

• The Evolution of Browser Automation, artykuł i prezentacja Christiana Bromanna z Sauce Labs
• Zawód tester - Od decyzji do zdobycia doświadczenia, książka Radosława Smilgina, dla osób początkujących
• Pasja testowania (wydanie 2, rozszerzone), książka Krzysztofa Jadczyka, także dla początkujących

Tworzenie oprogramowania nie sprowadza się jedynie do backendu, natomiast tematyka architektury front-endu do tej pory była w zasadzie zupełnie nieobecna w Better Software Design. Do tej pory, ponieważ dzisiejszy odcinek otwiera nowy rozdział w podkaście i tego rodzaju zagadnienia będą się co jakiś czas pojawiać. A rozmowy na takie właśnie tematy prowadzić będzie najlepszy znami mi architekt front-endu, Tomasz Ducin.

Tak, tak, nie jest to przejęzyczenie. Przy dzisiejszym poziomie złożoności technik i narzędzi, po prostu nie można znać się na wszystkim. Dlatego mam dużą satysfakcję z tego, że Tomek będzie gościł w Better Software Design w nowej roli, dostarczając wiedzę z najwyższej front-endowej półki. Pozostaje zacząć nowy etap z przysłowioego "wysokiego C" i bardzo interesującym tematem.

Gościem specjalnym dzisiejszego odcinka jest Bartosz Cytrowski, Senior Software Engineer w Atlassianie. Jeśli chcesz się dowiedzieć, jak wygląda architektura makro front-endu w Atlassianie i Jira Cloud, czy jak pracuje się w tak ogromnym i popularnym ekosystemie, to ten odcinek jest właśnie dla Ciebie!

W tym odcinku usłyszysz między innymi o:

• czym jest monorepo, jego zaletach i wadach, a także o tym jak pracuje się z nim w Atlassianie,
• narzędziach wykorzystywanych do rozwoju systemu o takiej skali jak Jira Cloud,
• sposobie pracy w systemie, w którym pojawia się ponad 1000 pull-requestów dziennie,
• kontrolowaniu zależności pomiędzy modułami,
• stosowaniu feature flags i bezpiecznym wprowadzaniu zmian dotykających wielu zespołów,
• testowaniu zmian, dog-foodingu i bezpiecznym wdrażaniu nowych wersji.

Zapraszam!

Błędów nie popełnia tylko ten, co nic nie robi, a szramy Wietnamu biorą się z nie z czytania książek, tylko z osadzania zawartych w nich idei w złożonej rzeczywistości konkretnych projektów. Dziś zapraszam na rozmowę o często trudnych realiach wprowadzania Domain-Driven Design do organizacji i procesach Domain Discovery.

Moimi gośćmi są Dariusz Pawlukiewicz i Michał Wilczyński, programiści i architekci, zaangażowani w inicjatywę DevMentors. A rozmawiamy przede wszystkim o doświadczeniach związanych z wprowadzaniem DDD do zespołów i organizacji, oraz o częstych problemach występujących w procesach poznawania domeny.

Materiały dodatkowe:

• Domain model purity vs. domain model completeness (DDD Trilemma), wspomniany w rozmowie artykuł Vladimira Khorikova
• The failed promise of Domain-Driven Design - part 1, artykuł Sebastiana Gębskiego
• The failed promise of Domain-Driven Design - part 2, kontynuacja powyższego artykułu

Czy kilka twoich projektów dla różnych klientów ma dokładnie taką samą strukturę wewnętrzną, stosowane są dokładnie te same wzorce organizacji kodu i architektury? Albo wszędzie widzisz możliwość zastosowania CQRS, rozdziału na komendy i query, czy możliwość zaimplementowania taktycznych wzorców z DDD? W wielu przypadkach będzie to zapewne całkowicie uzasadnione, poza tymi, w których nie ma to większego sensu...

Abraham Maslow kiedyś opisał to zjawisko mówiąc: dla człowieka, który dysponuje tylko młotkiem, wszystko, co spotyka zaczyna wyglądać jak gwóźdź. Idąc tym torem, posługiwanie się tylko jednym młotkiem nie jest ani wygodne, ani zdrowe.

Po ostatnich odcinkach podcastu poświęconych architekturze, zapraszam na luźniejszą rozmowę z Piotrem Przybyłem o chorobach, które czasami można zauważyć w naszych projektach i zespołach. A rozmawiamy m.in. o ostrej zasadzie Pareto, projektowym "good enough" i kilku chorobach, które warto mieć na swojej developerskiej uwadze.

Materiały dodatkowe:

• Cztery choroby, prezentacja Piotra z konferencji Boiling Frogs 2019
• Architecture antipatterns and how to beat them, część 1, prezentacja Łukasza Szydło z konferencji 4Developers 2017
• Architecture antipatterns and how to beat them, część 2, kontynuacja powyższej prezentacji