Architektura systemów z Claude Code

Architektura systemów z Claude Code

Claude Code służy jako doskonały konsultant architektoniczny, pomagając projektować skalowalne systemy, podejmować decyzje technologiczne i tworzyć kompleksową dokumentację techniczną. Ta lekcja pokazuje, jak wykorzystać Claude Code do pracy architektonicznej.

Analiza architektoniczna

Ocena projektu

1. Analiza istniejącej architektury

   claude "Przeanalizuj obecną architekturę tego projektu:
   - Zidentyfikuj wzorce architektoniczne
   - Mapuj zależności usług
   - Znajdź potencjalne wąskie gardła
   - Zasugeruj ulepszenia
   Utwórz szczegółowy raport z diagramami"

2. Ocena stosu technologicznego

   claude "Oceń nasz stos technologiczny:
   - Oceń dopasowanie każdej technologii
   - Zidentyfikuj przestarzałe zależności
   - Znajdź luki bezpieczeństwa
   - Polec aktualizacje lub zamienniki
   Uwzględnij ścieżki migracji"

3. Profilowanie wydajności

   claude "Profiluj architekturę tej aplikacji pod kątem wydajności:
   - Zidentyfikuj wolne zapytania do bazy danych
   - Znajdź problemy zapytań N+1
   - Przeanalizuj czasy odpowiedzi API
   - Sprawdź efektywność cachowania
   Wygeneruj rekomendacje optymalizacji"

Implementacja wzorców projektowych

Architektura mikrousług

Dekompozycja usług

claude "Pomóż mi zdekomponować ten monolit na mikrousługi:
- Zidentyfikuj bounded contexts
- Zasugeruj granice usług
- Zdefiniuj kontrakty API
- Zaplanuj strategię separacji danych
- Utwórz mapę drogową migracji"

Architektura sterowana zdarzeniami

Kolejka wiadomości

claude "Zaprojektuj architekturę sterowaną zdarzeniami używając RabbitMQ:
- Zdefiniuj schematy zdarzeń
- Utwórz wzorzec publisher/subscriber
- Zaimplementuj dead letter queues
- Dodaj mechanizmy ponawiania
- Wygeneruj konfigurację monitoringu"

Streaming zdarzeń

claude "Zaimplementuj streaming zdarzeń z Kafka:
- Zaprojektuj strukturę tematów
- Utwórz kod producer/consumer
- Zaimplementuj semantykę exactly-once
- Dodaj schema registry
- Wygeneruj przewodnik tuningowania wydajności"

Zdarzenia serverless

claude "Utwórz architekturę zdarzeń serverless:
- Użyj AWS EventBridge/Azure Event Grid
- Zaprojektuj reguły routingu zdarzeń
- Zaimplementuj wzorce fan-out
- Dodaj obsługę błędów
- Oblicz szacunki kosztów"

Projektowanie API

1. Projektowanie RESTful API

   claude "Zaprojektuj RESTful API dla tej domeny:
   - Przestrzegaj zasad REST
   - Utwórz modele zasobów
   - Zdefiniuj endpointy i metody
   - Dodaj paginację i filtrowanie
   - Wygeneruj specyfikację OpenAPI"

2. Schemat GraphQL

   claude "Utwórz schemat GraphQL dla tej aplikacji:
   - Zdefiniuj typy i relacje
   - Utwórz zapytania i mutacje
   - Dodaj subskrypcje dla czasu rzeczywistego
   - Zaimplementuj wzorzec DataLoader
   - Wygeneruj szablony resolverów"

3. Usługi gRPC

   claude "Zaprojektuj architekturę usług gRPC:
   - Utwórz definicje protocol buffer
   - Zdefiniuj metody usług
   - Dodaj wsparcie streamingu
   - Zaimplementuj interceptory
   - Wygeneruj biblioteki klientów"

Architektura bazy danych

Projektowanie schematu

Projektowanie relacyjne

claude "Zaprojektuj schemat relacyjnej bazy danych:
- Normalizuj do 3NF
- Dodaj odpowiednie indeksy
- Utwórz ograniczenia foreign key
- Zaplanuj strategię partycjonowania
- Wygeneruj skrypty migracji"

Modelowanie NoSQL

claude "Zaprojektuj model danych NoSQL:
- Wybierz między document/key-value/graph
- Optymalizuj pod wzorce zapytań
- Zaplanuj strategię shardingu
- Obsłuż wymagania spójności
- Utwórz przykładowe zapytania"

Wzorce warstwy danych

# Implementacja wzorca Repository
claude "Zaimplementuj wzorzec repository dla dostępu do danych:
- Utwórz abstrakcyjny interfejs repository
- Zaimplementuj dla wielu baz danych
- Dodaj warstwę cachowania
- Uwzględnij wsparcie transakcji
- Wygeneruj testy jednostkowe"

Architektura bezpieczeństwa

Autentykacja i autoryzacja

OAuth 2.0

claude "Zaimplementuj architekturę OAuth 2.0:
- Zaprojektuj serwer autoryzacji
- Utwórz serwer zasobów
- Zaimplementuj typy grant
- Dodaj rotację refresh tokenów
- Wygeneruj dokumentację bezpieczeństwa"

JWT

claude "Zaprojektuj system auth oparty na JWT:
- Utwórz strukturę tokenów
- Zaimplementuj podpisywanie/weryfikację
- Dodaj mechanizm refresh tokenów
- Obsłuż revokację tokenów
- Wygeneruj kod middleware"

mTLS

claude "Zaimplementuj autentykację mutual TLS:
- Zaprojektuj hierarchię certyfikatów
- Utwórz zarządzanie certyfikatami
- Zaimplementuj weryfikację klientów
- Dodaj rotację certyfikatów
- Wygeneruj przewodnik wdrożenia"

Wzorce bezpieczeństwa

1. Architektura Zero Trust

   claude "Zaprojektuj model bezpieczeństwa zero trust:
   - Zaimplementuj mikrosegmentację
   - Dodaj weryfikację tożsamości na każdej warstwie
   - Utwórz punkty egzekwowania polityk
   - Zaprojektuj logowanie audytu
   - Wygeneruj listę kontrolną compliance"

2. Obrona w głąb

   claude "Zaimplementuj strategię obrony w głąb:
   - Dodaj wiele warstw bezpieczeństwa
   - Utwórz reguły WAF
   - Zaimplementuj rate limiting
   - Dodaj wykrywanie włamań
   - Zaprojektuj plan reagowania na incydenty"

Wzorce skalowalności

Skalowanie horyzontalne

claude "Zaprojektuj architekturę skalowania horyzontalnego:
- Zaimplementuj usługi bezstanowe
- Dodaj strategię load balancingu
- Zaprojektuj zarządzanie sesjami
- Utwórz polityki auto-scalingu
- Wygeneruj manifesty wdrożenia"

Strategia cachowania

Cache wielopoziomowy

claude "Zaprojektuj cache wielopoziomowy:
- Nagłówki cache przeglądarki
- Konfiguracja CDN
- Cache na poziomie aplikacji
- Cache zapytań bazodanowych
- Wygeneruj logikę unieważniania cache"

Cache rozproszony

claude "Zaimplementuj cache rozproszony:
- Wybierz Redis/Memcached
- Zaprojektuj klucze cache
- Zaimplementuj wzorzec cache-aside
- Dodaj warming cache
- Monitoruj współczynniki trafień"

Generowanie dokumentacji

Architecture Decision Records (ADR)

claude "Utwórz ADR dla [konkretnej decyzji]:
- Kontekst i opis problemu
- Czynniki decyzyjne
- Opcje rozważane z pro/kontra
- Wynik decyzji
- Konsekwencje i trade-offy
Przestrzegaj szablonu ADR"

Dokumentacja systemowa

1. Diagramy modelu C4

   claude "Utwórz diagramy modelu C4 dla tego systemu:
   - Diagram kontekstu
   - Diagram kontenerów
   - Diagram komponentów
   - Diagram kodu (dla krytycznych części)
   Użyj składni PlantUML lub Mermaid"

2. Diagramy sekwencji

   claude "Wygeneruj diagramy sekwencji dla kluczowych przepływów:
   - Przepływ autentykacji użytkownika
   - Workflow przetwarzania zamówień
   - Przepływ transakcji płatności
   - Scenariusze obsługi błędów
   Użyj składni Mermaid"

3. Przegląd architektury

   claude "Napisz kompleksowy dokument architektury:
   - Streszczenie wykonawcze
   - Przegląd systemu
   - Opisy komponentów
   - Diagramy przepływu danych
   - Architektura wdrożenia
   - Uwagi dotyczące bezpieczeństwa"

Architektura chmury

Strategia multi-cloud

AWS

claude "Zaprojektuj architekturę AWS dla tej aplikacji:
- Konfiguracja VPC i sieci
- Compute (EC2/ECS/Lambda)
- Storage (S3/EFS/RDS)
- Kolejkowanie wiadomości (SQS/SNS)
- Wygeneruj CloudFormation/CDK"

Azure

claude "Utwórz architekturę Azure:
- Struktura grup zasobów
- Compute (VMs/AKS/Functions)
- Konta storage i bazy danych
- Messaging Service Bus
- Wygeneruj szablony ARM/Bicep"

GCP

claude "Zaprojektuj architekturę GCP:
- Struktura projektów i folderów
- Compute Engine/GKE/Cloud Run
- Cloud Storage i bazy danych
- Messaging Pub/Sub
- Wygeneruj konfiguracje Terraform"

Optymalizacja kosztów

claude "Przeanalizuj i zoptymalizuj koszty chmury:
- Przejrzyj bieżące użycie zasobów
- Zidentyfikuj nadmiernie provisioned zasoby
- Zasugeruj reserved instances
- Zaimplementuj polityki auto-shutdown
- Utwórz alerty monitoringu kosztów"

Monitoring i obserwowalność

Stos obserwowalności

Kompleksowa obserwowalność

claude "Zaprojektuj architekturę obserwowalności:
- Zbieranie metryk (Prometheus)
- Agregacja logów (ELK/Loki)
- Distributed tracing (Jaeger)
- Integracja APM
- Utwórz dashboardy i alerty"

Najlepsze praktyki

Zasady architektoniczne

• Zasady SOLID - Zastosuj do projektowania usług
• DRY - Don’t repeat yourself
• KISS - Keep it simple
• YAGNI - You aren’t gonna need it
• Luźne sprzężenie - Wysoka kohezja

Popularne antywzorce do unikania

Ważne

• Rozproszony monolit
• Gadatliwe interfejsy
• Współdzielone bazy danych między usługami
• Komunikacja synchroniczna wszędzie
• Brak circuit breakerów
• Brak rate limitingu

Ćwiczenia praktyczne

1. Projektowanie nowej funkcji

   • Zbieranie wymagań
   • Tworzenie propozycji architektonicznej
   • Projektowanie modelu danych
   • Planowanie kontraktów API
   • Dokumentowanie decyzji

2. Refaktoryzacja istniejącego systemu

   • Analiza obecnej architektury
   • Identyfikacja punktów bólu
   • Propozycja ulepszeń
   • Tworzenie planu migracji
   • Szacowanie nakładu pracy

3. Optymalizacja wydajności

   • Profilowanie obecnego systemu
   • Identyfikacja wąskich gardeł
   • Projektowanie rozwiązań
   • Implementacja cachowania
   • Pomiar ulepszeń

Lista kontrolna przeglądu architektury

Przegląd techniczny

• ✅ Uwagi dotyczące skalowalności
• ✅ Środki bezpieczeństwa
• ✅ Wymagania wydajnościowe
• ✅ Strategia spójności danych
• ✅ Podejście do obsługi błędów
• ✅ Monitoring i alerting

Przegląd biznesowy

• ✅ Szacunki kosztów
• ✅ Czas wejścia na rynek
• ✅ Obciążenie utrzymaniem
• ✅ Dopasowanie ekspertyzy zespołu
• ✅ Wymagania compliance

Następne kroki

Kontynuuj swoją podróż architektoniczną z:

• Konteneryzacja dla architektury wdrożenia
• Integracja przedsiębiorstwa dla systemów na dużą skalę
• Kontrola kosztów dla strategii optymalizacji

Pamiętaj: dobra architektura to nie używanie najnowszych technologii, ale podejmowanie świadomych decyzji, które równoważą doskonałość techniczną z potrzebami biznesowymi. Claude Code pomaga eksplorować opcje i rozumieć trade-offy.