Diagram-as-Code の完全マスター：現代の開発チームのための VPasCode 完全チュートリアル

graph TD
    A[ユーザーが認証情報を入力] --> B{形式は有効?}
    B -->|いいえ| C[検証エラーを表示]
    B -->|はい| D[認証サービスへ送信]
    C --> A
    D --> E{認証情報が一致?}
    E -->|いいえ| F[401 未認証を返す]
    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[Web アプリ<br/>React]
        Mobile[モバイルアプリ<br/>Flutter]
    end
    
    subgraph API["API ゲートウェイ"]
        Gateway[ Kong Gateway ]
        Auth[認証サービス]
        Rate[レートリミッター]
    end
    
    subgraph Services["ビジネスサービス"]
        User[ユーザーサービス]
        Order[注文サービス]
        Product[商品サービス]
        Payment[決済サービス]
    end
    
    subgraph Data["データ層"]
        UserDB[(ユーザー DB<br/>PostgreSQL)]
        OrderDB[(注文 DB<br/>MongoDB)]
        ProductDB[(商品 DB<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 Customer
    participant W as Web App
    participant O as Order Service
    participant P as Payment Service
    participant I as Inventory Service
    participant N as Notification Service
    
    C->>W: Add items to cart
    C->>W: Click "Checkout"
    W->>O: POST /orders {items, shipping}
    O->>I: Reserve inventory
    I-->>O: Reservation confirmed
    O->>P: Process payment
    P-->>O: Payment successful
    O->>O: Create order record
    O->>N: Send order confirmation
    N-->>C: Email confirmation
    O-->>W: 201 Created {orderId}
    W-->>C: Show success page
    
    Note over O,P: Critical section<br/>must be transactional
    rect rgba(200, 200, 0, 0.2)
        O->>P: Charge card
        P-->>O: Transaction ID
    end

gantt
    タイトル スプリント 24 - 認証モジュール
    日付形式  YYYY-MM-DD
    軸形式  %m/%d
    
    セクション バックエンド
    API 契約の設計       :完了,    des1, 2024-06-01, 2日
    JWT サービスの実装      :進行中,  des2, 2024-06-03, 3日
    データベースマイグレーション         :         des3, des2 の後, 2日
    ユニットテスト              :         des4, des3 の後, 2日
    
    セクション フロントエンド
    ログインコンポーネント           :         front1, 2024-06-03, 3日
    トークン管理          :         front2, front1 の後, 2日
    保護されたルート          :         front3, front2 の後, 2日
    
    セクション 統合
    API 統合           :         int1, des4 の後, 2日
    E2E テスト              :         int2, int1 の後, 3日
    セキュリティ監査           :         int3, int2 の後, 2日

@startuml
!テーマ プレーン
skinparam 背景色 #FFFFFF
skinparam コンポーネントスタイル uml2

タイトル "E コマースプラットフォーム - コンポーネントアーキテクチャ"

パッケージ "プレゼンテーションレイヤー" {
    [Web フロントエンド] as Web
    [モバイルアプリ] as Mobile
    [管理ダッシュボード] as Admin
}

パッケージ "API レイヤー" {
    [API ゲートウェイ] as Gateway
    [認証] as Auth
    [レートリミッター] as RateLimit
}

パッケージ "ビジネスサービス" {
    [カタログサービス] as Catalog
    [注文サービス] as Order
    [支払いサービス] as Payment
    [配送サービス] as Shipping
    [通知サービス] as Notify
}

パッケージ "データレイヤー" {
    データベース "製品 DB" as ProdDB
    データベース "注文 DB" as OrderDB
    データベース "ユーザー DB" as UserDB
    キュー "メッセージキュー" 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="CEOnJohn Smith", fillcolor="#1976d2", fontcolor="white"];
    
    // Cレベル
    subgraph cluster_exec {
        label="経営チーム";
        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"];
    }
    
    // エンジニアリング
    subgraph cluster_eng {
        label="エンジニアリング";
        style=filled;
        color="#e3f2fd";
        
        VP_Eng [label="VP Engineering", fillcolor="#64b5f6"];
        
        subgraph cluster_eng_teams {
            label="チーム";
            style=dotted;
            
            Backend [label="バックエンドチームn(12名のエンジニア)", fillcolor="#bbdefb"];
            Frontend [label="フロントエンドチームn(8名のエンジニア)", fillcolor="#bbdefb"];
            DevOps [label="DevOpsチームn(5名のエンジニア)", fillcolor="#bbdefb"];
            QA [label="QAチームn(6名のエンジニア)", fillcolor="#bbdefb"];
        }
    }
    
    // プロダクト
    subgraph cluster_product {
        label="プロダクト";
        style=filled;
        color="#fff3e0";
        
        VP_Product [label="VP Product", 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="注文DB"];
    D2 [label="在庫DB"];
    D3 [label="顧客DB"];
    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[開発環境へデプロイ]
        Stage[ステージング環境へデプロイ]
        E2E[E2E テスト]
        Prod[本番環境へデプロイ]
    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/>マルチ 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 "フロントエンド" {
    component [React アプリ]
    component [Redux ストア]
}

package "バックエンド" {
    component [Node.js API]
    component [Express サーバー]
    database [MongoDB]
}

[React アプリ] --> [Redux ストア]
[Redux ストア] --> [Node.js API]
[Node.js API] --> [Express サーバー]
[Express サーバー] --> [MongoDB]

note right of [Redux ストア]
  アプリケーション全体の集中型状態管理
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="Web アプリケーション<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 ゲートウェイ", fillcolor="#ffb74d", fontcolor="black"];
    }
    
    subgraph cluster_data {
        label="データ層";
        style=filled;
        color="#e8f5e9";
        fontcolor="#2e7d32";
        
        Primary [label="プライマリ DB<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];
}