Освоение подхода «диаграммы как код»: полное руководство по VPasCode для современных команд разработки

graph TD
    A[Пользователь вводит учётные данные] --> B{Корректный формат?}
    B -->|Нет| C[Показать ошибку валидации]
    B -->|Да| D[Отправить в службу аутентификации]
    C --> A
    D --> E{Учётные данные совпадают?}
    E -->|Нет| F[Вернуть 401 Unauthorized]
    E -->|Да| G[Сгенерировать JWT-токен]
    G --> H[Сохранить токен в HttpOnly Cookie]
    H --> I[Перенаправить на панель управления]
    F --> A
    
    style A fill:#e1f5ff,stroke:#0066cc
    style I fill:#d4edda,stroke:#28a745
    style F fill:#f8d7da,stroke:#dc3545

graph LR
    subgraph Client["Слой клиента"]
        Web[Веб-приложение<br/>React]
        Mobile[Мобильное приложение<br/>Flutter]
    end
    
    subgraph API["API-шлюз"]
        Gateway[Шлюз Kong]
        Auth[Служба аутентификации]
        Rate[Ограничитель частоты запросов]
    end
    
    subgraph Services["Бизнес-сервисы"]
        User[Сервис пользователей]
        Order[Сервис заказов]
        Product[Сервис товаров]
        Payment[Сервис платежей]
    end
    
    subgraph Data["Слой данных"]
        UserDB[(База данных пользователей<br/>PostgreSQL)]
        OrderDB[(База данных заказов<br/>MongoDB)]
        ProductDB[(База данных товаров<br/>PostgreSQL)]
        Cache[(Кэш 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 as Клиент
    participant W as Веб-приложение
    participant O как Сервис заказов
    participant P как Сервис платежей
    participant I как Сервис инвентаризации
    participant N как Сервис уведомлений
    
    C->>W: Добавить товары в корзину
    C->>W: Нажать «Оформить заказ»
    W->>O: POST /orders {товары, доставка}
    O->>I: Зарезервировать инвентарь
    I-->>O: Резервирование подтверждено
    O->>P: Обработать платеж
    P-->>O: Платеж успешен
    O->>O: Создать запись о заказе
    O->>N: Отправить подтверждение заказа
    N-->>C: Подтверждение по электронной почте
    O-->>W: 201 Created {orderId}
    W-->>C: Показать страницу успеха
    
    Note over O,P: Критическая секция<br/>должна быть транзакционной
    rect rgba(200, 200, 0, 0.2)
        O->>P: Списать средства с карты
        P-->>O: ID транзакции
    end

gantt
    title Спринт 24 - Модуль аутентификации
    dateFormat  YYYY-MM-DD
    axisFormat  %m/%d
    
    section Backend
    Разработка контрактов API       :выполнено,    des1, 2024-06-01, 2д
    Внедрение JWT-сервиса      :активно,  des2, 2024-06-03, 3д
    Миграция базы данных         :         des3, после des2, 2д
    Модульное тестирование              :         des4, после des3, 2д
    
    section Frontend
    Компонент входа           :         front1, 2024-06-03, 3д
    Управление токенами          :         front2, после front1, 2д
    Защищённые маршруты          :         front3, после front2, 2д
    
    section Integration
    Интеграция API           :         int1, после des4, 2д
    E2E-тестирование              :         int2, после int1, 3д
    Аудит безопасности           :         int3, после int2, 2д

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

title "Платформа электронной коммерции - Компонентная архитектура"

package "Слой представления" {
    [Веб-интерфейс] as Web
    [Мобильное приложение] as Mobile
    [Админ-панель] as Admin
}

package "API-слой" {
    [API-шлюз] as Gateway
    [Аутентификация] as Auth
    [Ограничитель частоты] as RateLimit
}

package "Бизнес-сервисы" {
    [Сервис каталога] as Catalog
    [Сервис заказов] as Order
    [Сервис оплаты] as Payment
    [Сервис доставки] as Shipping
    [Сервис уведомлений] as Notify
}

package "Слой данных" {
    database "База данных товаров" as ProdDB
    database "База данных заказов" as OrderDB
    database "База данных пользователей" as UserDB
    queue "Очередь сообщений" as 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 : публиковать события
Shipping ..> MQ : подписываться на события
Notify ..> MQ : подписываться на события

@enduml

@startuml
|Клиент|
start
:Просмотр товаров;
:Добавить в корзину;
:Перейти к оформлению заказа;

|Система|
:Проверить товары в корзине;
:Рассчитать итоговую сумму;
if (Товары в наличии?) then (да)
  :Зарезервировать товар;
else (нет)
  :Показать отсутствие товара;
  stop
endif

|Клиент|
:Ввести адрес доставки;
:Выбрать способ оплаты;

|Система|
:Обработать оплату;
if (Оплата успешна?) then (да)
  :Создать заказ;
  :Отправить подтверждение по электронной почте;
  :Обновить остатки;
else (нет)
  :Показать ошибку оплаты;
  detach
endif

:Отправить заказ;
:Обновить статус заказа;
stop

partition "Фоновые задачи" {
  :Сформировать счёт;
  :Уведомить склад;
}

@enduml

digraph MicroservicesDependencies {
    rankdir=TB;
    node [shape=box, style="rounded,filled", fontname="Arial"];
    edge [fontname="Arial", fontsize=10];
    
    // Определения узлов с цветами
    node [fillcolor="#e3f2fd"];
    "API Gateway" [fillcolor="#ffcdd2"];
    "Service Mesh" [fillcolor="#fff9c4"];
    
    // Основные сервисы
    "User Service";
    "Auth Service";
    "Order Service";
    "Payment Service";
    "Inventory Service";
    "Notification Service";
    "Analytics Service";
    
    // Базы данных
    node [shape=cylinder, fillcolor="#c8e6c9"];
    "User DB";
    "Order DB";
    "Product DB";
    "Analytics DB";
    
    // Внешние сервисы
    node [shape=box, fillcolor="#f3e5f5", style="dashed,filled"];
    "Payment Gateway";
    "Email Service";
    "SMS Service";
    
    // Связи
    "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];
    
    // Подграфы для группировки
    {
        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];
    
    // Руководящий уровень
    CEO [label="CEOnДжон Смит", fillcolor="#1976d2", fontcolor="white"];
    
    // Уровень C-Level
    subgraph cluster_exec {
        label="Руководящая команда";
        style=dashed;
        color="#90caf9";
        
        CTO [label="CTOnСара Джонсон", fillcolor="#42a5f5"];
        CFO [label="CFOnМайкл Браун", fillcolor="#42a5f5"];
        COO [label="COOnЭмили Дэвис", fillcolor="#42a5f5"];
        CPO [label="CPOnДэвид Уилсон", fillcolor="#42a5f5"];
    }
    
    // Инженерный отдел
    subgraph cluster_eng {
        label="Инженерный отдел";
        style=filled;
        color="#e3f2fd";
        
        VP_Eng [label="Вице-президент по инженерии", fillcolor="#64b5f6"];
        
        subgraph cluster_eng_teams {
            label="Команды";
            style=dotted;
            
            Backend [label="Команда бэкендаn(12 инженеров)", fillcolor="#bbdefb"];
            Frontend [label="Команда фронтендаn(8 инженеров)", fillcolor="#bbdefb"];
            DevOps [label="Команда DevOpsn(5 инженеров)", fillcolor="#bbdefb"];
            QA [label="Команда QAn(6 инженеров)", fillcolor="#bbdefb"];
        }
    }
    
    // Продуктовый отдел
    subgraph cluster_product {
        label="Продуктовый отдел";
        style=filled;
        color="#fff3e0";
        
        VP_Product [label="Вице-президент по продукту", fillcolor="#ffb74d"];
        PM1 [label="Менеджер продуктаnПлатформа", fillcolor="#ffcc80"];
        PM2 [label="Менеджер продуктаnМобильные приложения", fillcolor="#ffcc80"];
        PM3 [label="Менеджер продуктаnАналитика", fillcolor="#ffcc80"];
    }
    
    // Связи
    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;
    
    // Пунктирные линии для сотрудничества
    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];
    
    // Внешние сущности
    node [fillcolor="#ffccbc", shape=box];
    Customer [label="Клиент"];
    Vendor [label="Поставщик"];
    Bank [label="Банковская система"];
    
    // Процессы
    node [fillcolor="#c5cae9", shape=circle];
    P1 [label="Оформить заказ"];
    P2 [label="Обработать оплату"];
    P3 [label="Обновить складские запасы"];
    P4 [label="Сформировать счет"];
    P5 [label="Отправить заказ"];
    P6 [label="Отправить уведомление"];
    
    // Хранилища данных
    node [fillcolor="#c8e6c9", shape=box3d];
    D1 [label="База данных заказов"];
    D2 [label="База данных складских запасов"];
    D3 [label="База данных клиентов"];
    D4 [label="Записи счетов"];
    
    // Потоки данных
    Customer -> P1 [label="Запрос на заказ"];
    P1 -> D1 [label="Сохранить заказ"];
    P1 -> D3 [label="Обновить клиента"];
    P1 -> P2 [label="Данные об оплате"];
    
    P2 -> Bank [label="Запрос на оплату"];
    Bank -> P2 [label="Подтверждение оплаты"];
    P2 -> P3 [label="Успешная оплата"];
    
    P3 -> D2 [label="Уменьшить остаток"];
    P3 -> P4 [label="Заказ подтвержден"];
    
    P4 -> D4 [label="Сохранить счет"];
    P4 -> P6 [label="Данные счета"];
    
    P3 -> P5 [label="Запрос на доставку"];
    P5 -> Vendor [label="Этикетка для доставки"];
    P5 -> P6 [label="Информация о трекинге"];
    
    P6 -> Customer [label="Подтверждение заказаn+ Трекинг"];
    
    // Пунктирные линии для запросов
    D1 -> P5 [label="Получить детали заказа", style=dashed];
    D2 -> P1 [label="Проверить наличие", style=dashed];
    D3 -> P1 [label="Получить информацию о клиенте", style=dashed];
}
}

graph LR
    subgraph Source["Контроль исходного кода"]
        Git[Репозиторий GitHub]
        PR[Запрос на слияние]
    end
    
    subgraph CI["Непрерывная интеграция"]
        Lint[Проверка кода]
        Test[Модульные тесты]
        Build[Сборка артефактов]
        Scan[Сканирование безопасности]
    end
    
    subgraph CD["Непрерывное развертывание"]
        Dev[Развертывание в Dev]
        Stage[Развертывание в Staging]
        E2E[Интеграционные тесты]
        Prod[Развертывание в Production]
    end
    
    subgraph Monitor["Мониторинг"]
        Logs[Агрегация логов]
        Metrics[Дашборд метрик]
        Alerts[Система оповещений]
    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
  Хранит учетные записи клиентов
  и данные аутентификации
end note

note left of Orders
  Основная запись транзакции
  с деталями доставки
end note

@enduml

graph TB
    subgraph AWS["Инфраструктура облака AWS"]
        direction TB
        
        subgraph Networking["Сеть"]
            VPC[VPC 10.0.0.0/16]
            IGW[Шлюз интернета]
            NAT[Шлюз NAT]
            
            subgraph Public["Публичные подсети"]
                ALB[Балансировщик нагрузки приложений]
                Bastion[Хост-шлюз]
            end
            
            subgraph Private["Частные подсети"]
                subgraph AppTier["Прикладной уровень"]
                    ECS1[Задача ECS 1]
                    ECS2[Задача ECS 2]
                    ECS3[Задача ECS 3]
                end
                
                subgraph DataTier["Уровень данных"]
                    RDS[RDS PostgreSQL<br/>Multi-AZ]
                    Redis[ElastiCache Redis]
                end
            end
        end
        
        subgraph Storage["Хранилище"]
            S3[Бакеты S3<br/>Активы и резервные копии]
            EFS[Общее хранилище EFS]
        end
        
        subgraph Security["Безопасность"]
            WAF[Правила WAF]
            SG[Группы безопасности]
            IAM[Роли IAM]
        end
        
        subgraph Monitoring["Мониторинг и логирование"]
            CW[CloudWatch]
            XRay[AWS X-Ray]
            SNS[Уведомления SNS]
        end
    end
    
    User[Конечные пользователи] --> 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[Начало] --> B{Решение}
    B -->|Да| C[Процесс A]
    B -->|Нет| D[Процесс B]
    C --> E[Конец]
    D --> E
    
    style A fill:#2196F3,stroke:#1976D2,color:white
    style E fill:#F44336,stroke:#D32F2F,color:white

@startuml
' Глобальное оформление
skinparam backgroundColor #FFFFFF
skinparam shadowing false
skinparam roundcorner 10
skinparam linetype ortho

' Оформление компонентов
skinparam component {
    BackgroundColor #E3F2FD
    BorderColor #1976D2
    ArrowColor #1976D2
}

' Оформление пакетов
skinparam package {
    BackgroundColor #FFF3E0
    BorderColor #F57C00
    FontSize 14
}

' Оформление заметок
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]
  Централизованное управление состоянием
  для всего приложения
end note

@enduml

digraph AdvancedStyling {
    // Глобальные атрибуты графа
    graph [
        bgcolor="#f8f9fa"
        fontname="Helvetica"
        fontsize=16
        label="Архитектура корпоративной системыnПроизводственная среда"
        labelloc="t"
        pad=0.5
        ranksep=1.5
        nodesep=1.0
    ];
    
    // Атрибуты узлов по умолчанию
    node [
        fontname="Helvetica"
        fontsize=11
        style="filled,rounded"
        penwidth=2
    ];
    
    // Атрибуты рёбер по умолчанию
    edge [
        fontname="Helvetica"
        fontsize=9
        penwidth=1.5
        arrowsize=0.8
    ];
    
// Кластеры узлов с кастомным оформлением
    subgraph cluster_presentation {
        label="Слой представления";
        style=filled;
        color="#e3f2fd";
        fontcolor="#1565c0";
        
        Web [label="Веб-приложение<br/>React 18", fillcolor="#64b5f6", fontcolor="white"];
        Mobile [label="Мобильное приложение<br/>Flutter", fillcolor="#64b5f6", fontcolor="white"];
    }
    
    subgraph cluster_business {
        label="Слой бизнес-логики";
        style=filled;
        color="#fff3e0";
        fontcolor="#e65100";
        
        API [label="REST API<br/>Node.js", fillcolor="#ffb74d", fontcolor="black"];
        GraphQL [label="GraphQL Gateway", fillcolor="#ffb74d", fontcolor="black"];
    }
    
    subgraph cluster_data {
        label="Слой данных";
        style=filled;
        color="#e8f5e9";
        fontcolor="#2e7d32";
        
        Primary [label="Основная БД<br/>PostgreSQL 14", shape=cylinder, fillcolor="#a5d6a7"];
        Replica [label="Реплика для чтения<br/>PostgreSQL 14", shape=cylinder, fillcolor="#c8e6c9"];
        Cache [label="Кэш Redis<br/>Кластерный режим", shape=cylinder, fillcolor="#c8e6c9"];
    }
    
    // Рёбра с кастомным оформлением
    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="Чтение/Запись", color="#388e3c", fontcolor="#388e3c"];
    API -> Cache [label="Кэш", color="#f57c00", fontcolor="#f57c00", style=dashed];
    GraphQL -> Replica [label="Только чтение", color="#388e3c", fontcolor="#388e3c"];
    
    Primary -> Replica [label="Стриминговая репликация", color="#757575", style=dotted];
}