Opanowanie diagramów jako kodu: Kompleksowy przewodnik VPasCode dla nowoczesnych zespołów deweloperskich

graph TD
    A[Użytkownik wprowadza dane logowania] --> B{Poprawny format?}
    B -->|Nie| C[Pokaż błąd walidacji]
    B -->|Tak| D[Wyślij do usługi uwierzytelniania]
    C --> A
    D --> E{Dane logowania się zgadzają?}
    E -->|Nie| F[Zwróć 401 Unauthorized]
    E -->|Tak| G[Wygeneruj token JWT]
    G --> H[Zapisz token w ciasteczku HttpOnly]
    H --> I[Przekieruj do panelu]
    F --> A
    
    style A fill:#e1f5ff,stroke:#0066cc
    style I fill:#d4edda,stroke:#28a745
    style F fill:#f8d7da,stroke:#dc3545

graph LR
    subgraph Client["Warstwa klienta"]
        Web[Aplicacja webowa<br/>React]
        Mobile[Aplicacja mobilna<br/>Flutter]
    end
    
    subgraph API["Brama API"]
        Gateway[ Brama Kong ]
        Auth[Usługa uwierzytelniania]
        Rate[Limiter szybkości]
    end
    
    subgraph Services["Usługi biznesowe"]
        User[Usługa użytkownika]
        Order[Usługa zamówień]
        Product[Usługa produktów]
        Payment[Usługa płatności]
    end
    
    subgraph Data["Warstwa danych"]
        UserDB[(Baza danych użytkowników<br/>PostgreSQL)]
        OrderDB[(Baza danych zamówień<br/>MongoDB)]
        ProductDB[(Baza danych produktów<br/>PostgreSQL)]
        Cache[(Pamięć podręczna Redis)]
    end
    
    Web --> Gateway
    Mobile --> Gateway
    Gateway --> Auth
    Gateway --> Rate
    Rate --> User
    Rate --> Order
    Rate --> Product
    User --> UserDB
    User --> Cache
    Order --> OrderDB
    Order --> Payment
    Product --> ProductDB
    Payment --> OrderDB
    
    style Gateway fill:#ff6b6b,stroke:#c92a2a,color:white
    style UserDB fill:#4ecdc4,stroke:#087f5b
    style OrderDB fill:#4ecdc4,stroke:#087f5b
    style ProductDB fill:#4ecdc4,stroke:#087f5b
    style Cache fill:#ffe66d,stroke:#f08c00

sequenceDiagram
    autonumber
    participant C jako Klient
    participant W jako Aplikacja Webowa
    participant O jako Usługa Zamówień
    participant P jako Usługa Płatności
    participant I jako Usługa Magazynu
    participant N jako Usługa Powiadomień
    
    C->>W: Dodaj przedmioty do koszyka
    C->>W: Kliknij "Zakończ zakup"
    W->>O: POST /orders {items, shipping}
    O->>I: Rezerwuj zapasy
    I-->>O: Rezerwacja potwierdzona
    O->>P: Przetwórz płatność
    P-->>O: Płatność udana
    O->>O: Utwórz rekord zamówienia
    O->>N: Wyślij potwierdzenie zamówienia
    N-->>C: Potwierdzenie e-mail
    O-->>W: 201 Created {orderId}
    W-->>C: Pokaż stronę sukcesu
    
    Note over O,P: Krytyczny obszar<br/>musi być transakcyjny
    rect rgba(200, 200, 0, 0.2)
        O->>P: Obciąż kartę
        P-->>O: ID transakcji
    end

gantt
    tytuł Sprint 24 - Moduł uwierzytelniania
    format daty  YYYY-MM-DD
    format osi  %m/%d
    
    sekcja Backend
    Projektowanie kontraktów API       :zrobione,    des1, 2024-06-01, 2d
    Implementacja usługi JWT      :aktywna,  des2, 2024-06-03, 3d
    Migracja bazy danych         :         des3, po des2, 2d
    Testy jednostkowe              :         des4, po des3, 2d
    
    sekcja Frontend
    Komponent logowania           :         front1, 2024-06-03, 3d
    Zarządzanie tokenami          :         front2, po front1, 2d
    Chronione trasy          :         front3, po front2, 2d
    
    sekcja Integracja
    Integracja API           :         int1, po des4, 2d
    Testy E2E              :         int2, po int1, 3d
    Audyt bezpieczeństwa           :         int3, po int2, 2d

@startuml
!theme plain
skinparam backgroundColor #FFFFFF
skinparam componentStyle uml2

tytuł "Platforma e-commerce - Architektura komponentów"

pakiet "Warstwa prezentacji" {
    [Frontend Webowy] jako Web
    [Aplikacja mobilna] jako Mobile
    [Pulpit administratora] jako Admin
}

pakiet "Warstwa API" {
    [Brama API] jako Gateway
    [Uwierzytelnianie] jako Auth
    [Ogranicznik szybkości] jako RateLimit
}

pakiet "Usługi biznesowe" {
    [Usługa katalogu] jako Catalog
    [Usługa zamówień] jako Order
    [Usługa płatności] jako Payment
    [Usługa wysyłki] jako Shipping
    [Usługa powiadomień] jako Notify
}

pakiet "Warstwa danych" {
    baza danych "Baza produktów" jako ProdDB
    baza danych "Baza zamówień" jako OrderDB
    baza danych "Baza użytkowników" jako UserDB
    kolejka "Kolejka wiadomości" jako MQ
}

Web --> Gateway
Mobile --> Gateway
Admin --> Gateway

Gateway --> Auth
Gateway --> RateLimit
Gateway --> Catalog
Gateway --> Order

Order --> Payment
Order --> Shipping
Order --> Notify

Catalog --> ProdDB
Order --> OrderDB
Auth --> UserDB

Payment ..> MQ : publikuj zdarzenia
Shipping ..> MQ : subskrybuj zdarzenia
Notify ..> MQ : subskrybuj zdarzenia

@enduml

@startuml
|Klient|
start
:Przeglądaj produkty;
:Dodaj do koszyka;
:Przejdź do kasy;

|System|
:Zweryfikuj przedmioty w koszyku;
:Oblicz całkowitą kwotę;
if (Czy przedmioty są dostępne?) then (tak)
  :Rezerwuj stan magazynowy;
else (nie)
  :Wyświetl brak towaru;
  stop
endif

|Klient|
:Wprowadź adres dostawy;
:Wybierz metodę płatności;

|System|
:Przetwórz płatność;
if (Czy płatność się powiodła?) then (tak)
  :Utwórz zamówienie;
  :Wyślij e-mail potwierdzający;
  :Zaktualizuj stan magazynowy;
else (nie)
  :Wyświetl błąd płatności;
  detach
endif

:Wysyłka zamówienia;
:Zaktualizuj status zamówienia;
stop

partition "Zadania w tle" {
  :Generuj fakturę;
  :Powiadom magazyn;
}

@enduml

digraph MicroservicesDependencies {
    rankdir=TB;
    node [shape=box, style="rounded,filled", fontname="Arial"];
    edge [fontname="Arial", fontsize=10];
    
    // Definicje węzłów z kolorami
    node [fillcolor="#e3f2fd"];
    "API Gateway" [fillcolor="#ffcdd2"];
    "Service Mesh" [fillcolor="#fff9c4"];
    
    // Usługi podstawowe
    "User Service";
    "Auth Service";
    "Order Service";
    "Payment Service";
    "Inventory Service";
    "Notification Service";
    "Analytics Service";
    
    // Bazy danych
    node [shape=cylinder, fillcolor="#c8e6c9"];
    "User DB";
    "Order DB";
    "Product DB";
    "Analytics DB";
    
    // Usługi zewnętrzne
    node [shape=box, fillcolor="#f3e5f5", style="dashed,filled"];
    "Payment Gateway";
    "Email Service";
    "SMS Service";
    
    // Relacje
    "API Gateway" -> "Service Mesh";
    "Service Mesh" -> "User Service";
    "Service Mesh" -> "Auth Service";
    "Service Mesh" -> "Order Service";
    "Service Mesh" -> "Payment Service";
    "Service Mesh" -> "Inventory Service";
    
    "User Service" -> "User DB";
    "Auth Service" -> "User DB";
    "Order Service" -> "Order DB";
    "Order Service" -> "Inventory Service";
    "Order Service" -> "Payment Service";
    "Inventory Service" -> "Product DB";
    "Payment Service" -> "Payment Gateway";
    "Notification Service" -> "Email Service";
    "Notification Service" -> "SMS Service";
    "Analytics Service" -> "Analytics DB";
    
    "Order Service" -> "Notification Service" [style=dashed];
    "Payment Service" -> "Notification Service" [style=dashed];
    
    // Podgrafy do grupowania
    {
        rank=same;
        "User Service";
        "Auth Service";
    }
    
    {
        rank=same;
        "Order Service";
        "Payment Service";
        "Inventory Service";
    }
}

digraph OrgChart {
    rankdir=TB;
    node [shape=box, style="rounded,filled", fontname="Helvetica"];
    edge [fontname="Helvetica", arrowsize=0.7];
    
    // Poziom zarządu
    CEO [label="CEOnJohn Smith", fillcolor="#1976d2", fontcolor="white"];
    
    // Poziom C-Level
    subgraph cluster_exec {
        label="Zespół Zarządu";
        style=dashed;
        color="#90caf9";
        
        CTO [label="CTOnSarah Johnson", fillcolor="#42a5f5"];
        CFO [label="CFOnMichael Brown", fillcolor="#42a5f5"];
        COO [label="COOnEmily Davis", fillcolor="#42a5f5"];
        CPO [label="CPOnDavid Wilson", fillcolor="#42a5f5"];
    }
    
    // Inżynieria
    subgraph cluster_eng {
        label="Inżynieria";
        style=filled;
        color="#e3f2fd";
        
        VP_Eng [label="Wiceprezes Inżynierii", fillcolor="#64b5f6"];
        
        subgraph cluster_eng_teams {
            label="Zespoły";
            style=dotted;
            
            Backend [label="Zespół Backendn(12 inżynierów)", fillcolor="#bbdefb"];
            Frontend [label="Zespół Frontendn(8 inżynierów)", fillcolor="#bbdefb"];
            DevOps [label="Zespół DevOpsn(5 inżynierów)", fillcolor="#bbdefb"];
            QA [label="Zespół QAn(6 inżynierów)", fillcolor="#bbdefb"];
        }
    }
    
    // Produkt
    subgraph cluster_product {
        label="Produkt";
        style=filled;
        color="#fff3e0";
        
        VP_Product [label="Wiceprezes Produktu", fillcolor="#ffb74d"];
        PM1 [label="Kierownik ProduktunPlatforma", fillcolor="#ffcc80"];
        PM2 [label="Kierownik ProduktunMobilny", fillcolor="#ffcc80"];
        PM3 [label="Kierownik ProduktunAnalityka", fillcolor="#ffcc80"];
    }
    
    // Relacje
    CEO -> CTO;
    CEO -> CFO;
    CEO -> COO;
    CEO -> CPO;
    
    CTO -> VP_Eng;
    VP_Eng -> Backend;
    VP_Eng -> Frontend;
    VP_Eng -> DevOps;
    VP_Eng -> QA;
    
    CPO -> VP_Product;
    VP_Product -> PM1;
    VP_Product -> PM2;
    VP_Product -> PM3;
    
    // Przerywane linie dla współpracy
    PM1 -> Backend [style=dotted, color="#757575"];
    PM2 -> Frontend [style=dotted, color="#757575"];
    PM3 -> Backend [style=dotted, color="#757575"];
}

digraph DataFlow {
    rankdir=LR;
    nodesep=1.0;
    node [shape=ellipse, style="filled", fontname="Arial"];
    edge [fontname="Arial", fontsize=9];
    
    // Podmioty zewnętrzne
    node [fillcolor="#ffccbc", shape=box];
    Customer [label="Klient"];
    Vendor [label="Dostawca"];
    Bank [label="System Bankowy"];
    
    // Procesy
    node [fillcolor="#c5cae9", shape=circle];
    P1 [label="Złóż zamówienie"];
    P2 [label="Przetwórz płatność"];
    P3 [label="Zaktualizuj stan magazynowy"];
    P4 [label="Wygeneruj fakturę"];
    P5 [label="Wydaj zamówienie"];
    P6 [label="Wyślij powiadomienie"];
    
    // Przechowywanie danych
    node [fillcolor="#c8e6c9", shape=box3d];
    D1 [label="Baza zamówień"];
    D2 [label="Baza magazynowa"];
    D3 [label="Baza klientów"];
    D4 [label="Rejestry faktur"];
    
    // Przepływy danych
    Customer -> P1 [label="Żądanie zamówienia"];
    P1 -> D1 [label="Zapisz zamówienie"];
    P1 -> D3 [label="Zaktualizuj klienta"];
    P1 -> P2 [label="Dane płatności"];
    
    P2 -> Bank [label="Żądanie płatności"];
    Bank -> P2 [label="Potwierdzenie płatności"];
    P2 -> P3 [label="Płatność udana"];
    
    P3 -> D2 [label="Zmniejsz stan"];
    P3 -> P4 [label="Zamówienie potwierdzone"];
    
    P4 -> D4 [label="Zapisz fakturę"];
    P4 -> P6 [label="Dane faktury"];
    
    P3 -> P5 [label="Żądanie wysyłki"];
    P5 -> Vendor [label="Etykieta wysyłkowa"];
    P5 -> P6 [label="Informacje o śledzeniu"];
    
    P6 -> Customer [label="Potwierdzenie zamówienian+ Śledzenie"];
    
    // Przerywane linie dla zapytań
    D1 -> P5 [label="Pobierz szczegóły zamówienia", style=dashed];
    D2 -> P1 [label="Sprawdź dostępność", style=dashed];
    D3 -> P1 [label="Pobierz dane klienta", style=dashed];
}

graph LR
    subgraph Source["Kontrola źródłowa"]
        Git[Repozytorium GitHub]
        PR[Pull Request]
    end
    
    subgraph CI["Nieprzerwana integracja"]
        Lint[Linting]
        Test[Testy jednostkowe]
        Build[Artefakty budowania]
        Scan[Skanowanie bezpieczeństwa]
    end
    
    subgraph CD["Nieprzerwane wdrażanie"]
        Dev[Wdrożenie do środowiska deweloperskiego]
        Stage[Wdrożenie do środowiska testowego]
        E2E[Testy E2E]
        Prod[Wdrożenie do produkcji]
    end
    
    subgraph Monitor["Monitorowanie"]
        Logs[Agregacja logów]
        Metrics[Pulpit metryk]
        Alerts[System alertów]
    end
    
    Git --> PR
    PR --> Lint
    Lint --> Test
    Test --> Build
    Build --> Scan
    Scan --> Dev
    Dev --> Stage
    Stage --> E2E
    E2E --> Prod
    Prod --> Logs
    Prod --> Metrics
    Metrics --> Alerts
    
    style Git fill:#f0f0f0,stroke:#333
    style Prod fill:#d4edda,stroke:#28a745,color:black
    style Alerts fill:#f8d7da,stroke:#dc3545,color:black

@startuml
!define TABLE(name) entity name << (T,#FFAAAA) >>
!define PK(x) x <<PK>>
!define FK(x) x <<FK>>

TABLE(Users) {
    PK(user_id) : INT
    --
    email : VARCHAR(255)
    password_hash : VARCHAR(255)
    created_at : TIMESTAMP
    last_login : TIMESTAMP
    status : ENUM
}

TABLE(Products) {
    PK(product_id) : INT
    --
    sku : VARCHAR(50)
    name : VARCHAR(255)
    description : TEXT
    price : DECIMAL(10,2)
    stock_quantity : INT
    category_id : INT
}

TABLE(Categories) {
    PK(category_id) : INT
    --
    name : VARCHAR(100)
    parent_id : INT
}

TABLE(Orders) {
    PK(order_id) : INT
    --
    FK(user_id) : INT
    order_date : TIMESTAMP
    total_amount : DECIMAL(10,2)
    status : ENUM
    shipping_address : TEXT
}

TABLE(OrderItems) {
    PK(item_id) : INT
    --
    FK(order_id) : INT
    FK(product_id) : INT
    quantity : INT
    unit_price : DECIMAL(10,2)
}

TABLE(Payments) {
    PK(payment_id) : INT
    --
    FK(order_id) : INT
    payment_method : ENUM
    transaction_id : VARCHAR(255)
    amount : DECIMAL(10,2)
    status : ENUM
    processed_at : TIMESTAMP
}

Users ||--o{ Orders : places
Orders }o--|{ Users : belongs_to
Orders ||--|{ OrderItems : contains
OrderItems }o--|| Products : references
Products }o--|| Categories : categorized_in
Orders ||--o{ Payments : paid_by

note right of Users
  Przechowuje konta klientów
  oraz dane uwierzytelniające
end note

note left of Orders
  Główny rekord transakcji
  z danymi wysyłki
end note

@enduml

graph TB
    subgraph AWS["Infrastruktura chmury AWS"]
        direction TB
        
        subgraph Networking["Sieć"]
            VPC[VPC 10.0.0.0/16]
            IGW[Brama internetowa]
            NAT[Brama NAT]
            
            subgraph Public["Podsieci publiczne"]
                ALB[Load Balancer aplikacji]
                Bastion[Host bastionowy]
            end
            
            subgraph Private["Podsieci prywatne"]
                subgraph AppTier["Warstwa aplikacji"]
                    ECS1[Zadanie ECS 1]
                    ECS2[Zadanie ECS 2]
                    ECS3[Zadanie ECS 3]
                end
                
                subgraph DataTier["Warstwa danych"]
                    RDS[RDS PostgreSQL<br/>Wielo-obszarowa]
                    Redis[ElastiCache Redis]
                end
            end
        end
        
        subgraph Storage["Przechowywanie"]
            S3[Bukiety S3<br/>Zasoby i kopie zapasowe]
            EFS[Wspólne przechowywanie EFS]
        end
        
        subgraph Security["Bezpieczeństwo"]
            WAF[Reguły WAF]
            SG[Grupy zabezpieczeń]
            IAM[Role IAM]
        end
        
        subgraph Monitoring["Monitorowanie i logowanie"]
            CW[CloudWatch]
            XRay[AWS X-Ray]
            SNS[Powiadomienia SNS]
        end
    end
    
    User[Koncowi użytkownicy] --> CloudFront[CloudFront CDN]
    CloudFront --> WAF
    WAF --> ALB
    ALB --> ECS1
    ALB --> ECS2
    ALB --> ECS3
    
    ECS1 --> RDS
    ECS2 --> RDS
    ECS3 --> RDS
    
    ECS1 --> Redis
    ECS2 --> Redis
    ECS3 --> Redis
    
    ECS1 --> S3
    ECS2 --> S3
    ECS3 --> S3
    
    ECS1 --> EFS
    ECS2 --> EFS
    ECS3 --> EFS
    
    ECS1 --> CW
    ECS2 --> CW
    ECS3 --> CW
    
    RDS --> CW
    Redis --> CW
    
    CW --> SNS
    
    style VPC fill:#f9f9f9,stroke:#333,stroke-width:2px
    style ALB fill:#ff9900,stroke:#cc7a00,color:white
    style RDS fill:#2e73b8,stroke:#1a4d80,color:white
    style User fill:#95a5a6,stroke:#7f8c8d

%%{init: {'theme':'base', 'themeVariables': {
    'primaryColor': '#4CAF50',
    'primaryTextColor': '#fff',
    'primaryBorderColor': '#388E3C',
    'lineColor': '#757575',
    'secondaryColor': '#FFC107',
    'tertiaryColor': '#fff'
}}}%%

graph TD
    A[Start] --> B{Decision}
    B -->|Yes| C[Process A]
    B -->|No| D[Process B]
    C --> E[End]
    D --> E
    
    style A fill:#2196F3,stroke:#1976D2,color:white
    style E fill:#F44336,stroke:#D32F2F,color:white

@startuml
' Globalne stylowanie
skinparam backgroundColor #FFFFFF
skinparam shadowing false
skinparam roundcorner 10
skinparam linetype ortho

' Stylowanie komponentów
skinparam component {
    BackgroundColor #E3F2FD
    BorderColor #1976D2
    ArrowColor #1976D2
}

' Stylowanie pakietów
skinparam package {
    BackgroundColor #FFF3E0
    BorderColor #F57C00
    FontSize 14
}

' Stylowanie notatek
skinparam note {
    BackgroundColor #F1F8E9
    BorderColor #689F38
    FontColor #33691E
}

package "Frontend" {
    component [React App]
    component [Redux Store]
}

package "Backend" {
    component [Node.js API]
    component [Express Server]
    database [MongoDB]
}

[React App] --> [Redux Store]
[Redux Store] --> [Node.js API]
[Node.js API] --> [Express Server]
[Express Server] --> [MongoDB]

note right of [Redux Store]
  Zcentralizowane zarządzanie stanem
  dla całej aplikacji
end note

@enduml

digraph AdvancedStyling {
    // Globalne atrybuty grafu
    graph [
        bgcolor="#f8f9fa"
        fontname="Helvetica"
        fontsize=16
        label="Architektura systemu przedsiębiorstwanŚrodowisko produkcyjne"
        labelloc="t"
        pad=0.5
        ranksep=1.5
        nodesep=1.0
    ];
    
    // Domyślne atrybuty węzłów
    node [
        fontname="Helvetica"
        fontsize=11
        style="filled,rounded"
        penwidth=2
    ];
    
    // Domyślne atrybuty krawędzi
    edge [
        fontname="Helvetica"
        fontsize=9
        penwidth=1.5
        arrowsize=0.8
    ];
    
// Klaster węzłów z niestandardowym stylowaniem
    subgraph cluster_presentation {
        label="Warstwa prezentacji";
        style=filled;
        color="#e3f2fd";
        fontcolor="#1565c0";
        
        Web [label="Aplikacja webowa<br/>React 18", fillcolor="#64b5f6", fontcolor="white"];
        Mobile [label="Aplikacja mobilna<br/>Flutter", fillcolor="#64b5f6", fontcolor="white"];
    }
    
    subgraph cluster_business {
        label="Warstwa logiki biznesowej";
        style=filled;
        color="#fff3e0";
        fontcolor="#e65100";
        
        API [label="REST API<br/>Node.js", fillcolor="#ffb74d", fontcolor="black"];
        GraphQL [label="Brama GraphQL", fillcolor="#ffb74d", fontcolor="black"];
    }
    
    subgraph cluster_data {
        label="Warstwa danych";
        style=filled;
        color="#e8f5e9";
        fontcolor="#2e7d32";
        
        Primary [label="Baza danych główna<br/>PostgreSQL 14", shape=cylinder, fillcolor="#a5d6a7"];
        Replica [label="Replika do odczytu<br/>PostgreSQL 14", shape=cylinder, fillcolor="#c8e6c9"];
        Cache [label="Pamięć podręczna Redis<br/>Tryb klastra", shape=cylinder, fillcolor="#c8e6c9"];
    }
    
    // Krawędzie z niestandardowym stylowaniem
    Web -> API [label="HTTPS/REST", color="#1976d2", fontcolor="#1976d2"];
    Mobile -> API [label="HTTPS/REST", color="#1976d2", fontcolor="#1976d2"];
    Web -> GraphQL [label="WebSocket", color="#1976d2", fontcolor="#1976d2", style=dashed];
    
    API -> Primary [label="Odczyt/Zapis", color="#388e3c", fontcolor="#388e3c"];
    API -> Cache [label="Pamięć podręczna", color="#f57c00", fontcolor="#f57c00", style=dashed];
    GraphQL -> Replica [label="Tylko odczyt", color="#388e3c", fontcolor="#388e3c"];
    
    Primary -> Replica [label="Replikacja strumieniowa", color="#757575", style=dotted];
}