Làm chủ Mô hình hóa dưới dạng Mã: Hướng dẫn Toàn diện về VPasCode cho Các Đội ngũ Phát triển Hiện đại

graph TD
    A[Người dùng nhập thông tin đăng nhập] --> B{Định dạng hợp lệ?}
    B -->|Không| C[Hiển thị lỗi xác thực]
    B -->|Có| D[Gửi đến dịch vụ xác thực]
    C --> A
    D --> E{Thông tin đăng nhập khớp?}
    E -->|Không| F[Trả về 401 Không được phép]
    E -->|Có| G[Tạo mã JWT]
    G --> H[Lưu mã vào HttpOnly Cookie]
    H --> I[Chuyển hướng đến bảng điều khiển]
    F --> A
    
    style A fill:#e1f5ff,stroke:#0066cc
    style I fill:#d4edda,stroke:#28a745
    style F fill:#f8d7da,stroke:#dc3545

graph LR
    subgraph Client["Lớp khách hàng"]
        Web[Ứng dụng Web<br/>React]
        Mobile[Ứng dụng di động<br/>Flutter]
    end
    
    subgraph API["API Gateway"]
        Gateway[ Kong Gateway ]
        Auth[Dịch vụ xác thực]
        Rate[Giới hạn tốc độ]
    end
    
    subgraph Services["Dịch vụ kinh doanh"]
        User[Dịch vụ người dùng]
        Order[Dịch vụ đơn hàng]
        Product[Dịch vụ sản phẩm]
        Payment[Dịch vụ thanh toán]
    end
    
    subgraph Data["Lớp dữ liệu"]
        UserDB[(Cơ sở dữ liệu người dùng<br/>PostgreSQL)]
        OrderDB[(Cơ sở dữ liệu đơn hàng<br/>MongoDB)]
        ProductDB[(Cơ sở dữ liệu sản phẩm<br/>PostgreSQL)]
        Cache[(Bộ nhớ đệm 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 Khách hàng
    participant W as Ứng dụng Web
    participant O as Dịch vụ Đơn hàng
    participant P as Dịch vụ Thanh toán
    participant I as Dịch vụ Tồn kho
    participant N as Dịch vụ Thông báo
    
    C->>W: Thêm mục vào giỏ hàng
    C->>W: Nhấn "Thanh toán"
    W->>O: POST /orders {items, shipping}
    O->>I: Đặt chỗ tồn kho
    I-->>O: Đặt chỗ được xác nhận
    O->>P: Xử lý thanh toán
    P-->>O: Thanh toán thành công
    O->>O: Tạo bản ghi đơn hàng
    O->>N: Gửi xác nhận đơn hàng
    N-->>C: Xác nhận qua email
    O-->>W: 201 Created {orderId}
    W-->>C: Hiển thị trang thành công
    
    Note over O,P: Phần quan trọng<br/>phải có tính giao dịch
    rect rgba(200, 200, 0, 0.2)
        O->>P: Tính tiền thẻ
        P-->>O: ID giao dịch
    end

gantt
    title Sprint 24 - Module Xác thực
    dateFormat  YYYY-MM-DD
    axisFormat  %m/%d
    
    section Backend
    Thiết kế hợp đồng API       :done,    des1, 2024-06-01, 2d
    Triển khai dịch vụ JWT      :active,  des2, 2024-06-03, 3d
    Di chuyển cơ sở dữ liệu     :         des3, sau des2, 2d
    Kiểm thử đơn vị            :         des4, sau des3, 2d
    
    section Frontend
    Thành phần đăng nhập       :         front1, 2024-06-03, 3d
    Quản lý token              :         front2, sau front1, 2d
    Đường dẫn được bảo vệ      :         front3, sau front2, 2d
    
    section Integration
    Tích hợp API               :         int1, sau des4, 2d
    Kiểm thử E2E               :         int2, sau int1, 3d
    Kiểm toán bảo mật          :         int3, sau int2, 2d

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

title "Nền tảng Thương mại điện tử - Kiến trúc thành phần"

package "Lớp Trình bày" {
    [Giao diện Web] as Web
    [Ứng dụng Di động] as Mobile
    [Bảng điều khiển Quản trị] as Admin
}

package "Lớp API" {
    [API Gateway] as Gateway
    [Xác thực] as Auth
    [Bộ giới hạn tốc độ] as RateLimit
}

package "Dịch vụ Kinh doanh" {
    [Dịch vụ Danh mục] as Catalog
    [Dịch vụ Đơn hàng] as Order
    [Dịch vụ Thanh toán] as Payment
    [Dịch vụ Vận chuyển] as Shipping
    [Dịch vụ Thông báo] as Notify
}

package "Lớp Dữ liệu" {
    database "Cơ sở dữ liệu Sản phẩm" as ProdDB
    database "Cơ sở dữ liệu Đơn hàng" as OrderDB
    database "Cơ sở dữ liệu Người dùng" as UserDB
    queue "Hàng đợi Tin nhắn" 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 : phát sự kiện
Shipping ..> MQ : đăng ký sự kiện
Notify ..> MQ : đăng ký sự kiện

@enduml

@startuml
|Khách hàng|
start
:Tìm kiếm sản phẩm;
:Thêm vào giỏ hàng;
:Tiến hành thanh toán;

|Hệ thống|
:Xác thực các mục trong giỏ hàng;
:Tính tổng;
nếu (Còn hàng?) thì (có)
  :Dự trữ hàng tồn kho;
khác (không)
  :Hiển thị hết hàng;
  stop
endif

|Khách hàng|
:Nhập địa chỉ giao hàng;
:Chọn phương thức thanh toán;

|Hệ thống|
:Xử lý thanh toán;
nếu (Thanh toán thành công?) thì (có)
  :Tạo đơn hàng;
  :Gửi email xác nhận;
  :Cập nhật hàng tồn kho;
khác (không)
  :Hiển thị lỗi thanh toán;
  detach
endif

:Giao hàng;
:Cập nhật trạng thái đơn hàng;
stop

partition "Công việc nền" {
  :Tạo hóa đơn;
  :Thông báo kho hàng;
}

@enduml

digraph MicroservicesDependencies {
    rankdir=TB;
    node [shape=box, style="rounded,filled", fontname="Arial"];
    edge [fontname="Arial", fontsize=10];
    
    // Định nghĩa nút với màu sắc
    node [fillcolor="#e3f2fd"];
    "API Gateway" [fillcolor="#ffcdd2"];
    "Service Mesh" [fillcolor="#fff9c4"];
    
    // Các dịch vụ cốt lõi
    "User Service";
    "Auth Service";
    "Order Service";
    "Payment Service";
    "Inventory Service";
    "Notification Service";
    "Analytics Service";
    
    // Cơ sở dữ liệu
    node [shape=cylinder, fillcolor="#c8e6c9"];
    "User DB";
    "Order DB";
    "Product DB";
    "Analytics DB";
    
    // Dịch vụ bên ngoài
    node [shape=box, fillcolor="#f3e5f5", style="dashed,filled"];
    "Payment Gateway";
    "Email Service";
    "SMS Service";
    
    // Mối quan hệ
    "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];
    
    // Đồ thị con để nhóm
    {
        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];
    
    // Cấp điều hành
    CEO [label="CEOnJohn Smith", fillcolor="#1976d2", fontcolor="white"];
    
    // Cấp C-Level
    subgraph cluster_exec {
        label="Đội ngũ điều hành";
        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"];
    }
    
    // Kỹ thuật
    subgraph cluster_eng {
        label="Kỹ thuật";
        style=filled;
        color="#e3f2fd";
        
        VP_Eng [label="Phó Giám đốc Kỹ thuật", fillcolor="#64b5f6"];
        
        subgraph cluster_eng_teams {
            label="Đội nhóm";
            style=dotted;
            
            Backend [label="Đội Backendn(12 kỹ sư)", fillcolor="#bbdefb"];
            Frontend [label="Đội Frontendn(8 kỹ sư)", fillcolor="#bbdefb"];
            DevOps [label="Đội DevOpsn(5 kỹ sư)", fillcolor="#bbdefb"];
            QA [label="Đội QAn(6 kỹ sư)", fillcolor="#bbdefb"];
        }
    }
    
    // Sản phẩm
    subgraph cluster_product {
        label="Sản phẩm";
        style=filled;
        color="#fff3e0";
        
        VP_Product [label="Phó Giám đốc Sản phẩm", fillcolor="#ffb74d"];
        PM1 [label="Quản lý Sản phẩmnNền tảng", fillcolor="#ffcc80"];
        PM2 [label="Quản lý Sản phẩmnDi động", fillcolor="#ffcc80"];
        PM3 [label="Quản lý Sản phẩmnPhân tích", fillcolor="#ffcc80"];
    }
    
    // Mối quan hệ
    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;
    
    // Đường nét đứt để thể hiện hợp tác
    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];
    
    // Các thực thể bên ngoài
    node [fillcolor="#ffccbc", shape=box];
    Customer [label="Khách hàng"];
    Vendor [label="Nhà cung cấp"];
    Bank [label="Hệ thống ngân hàng"];
    
    // Các quy trình
    node [fillcolor="#c5cae9", shape=circle];
    P1 [label="Đặt hàng"];
    P2 [label="Xử lý thanh toán"];
    P3 [label="Cập nhật tồn kho"];
    P4 [label="Tạo hóa đơn"];
    P5 [label="Giao hàng"];
    P6 [label="Gửi thông báo"];
    
    // Kho dữ liệu
    node [fillcolor="#c8e6c9", shape=box3d];
    D1 [label="Cơ sở dữ liệu đơn hàng"];
    D2 [label="Cơ sở dữ liệu tồn kho"];
    D3 [label="Cơ sở dữ liệu khách hàng"];
    D4 [label="Hồ sơ hóa đơn"];
    
    // Luồng dữ liệu
    Customer -> P1 [label="Yêu cầu đặt hàng"];
    P1 -> D1 [label="Lưu đơn hàng"];
    P1 -> D3 [label="Cập nhật khách hàng"];
    P1 -> P2 [label="Chi tiết thanh toán"];
    
    P2 -> Bank [label="Yêu cầu thanh toán"];
    Bank -> P2 [label="Xác nhận thanh toán"];
    P2 -> P3 [label="Thanh toán thành công"];
    
    P3 -> D2 [label="Giảm tồn kho"];
    P3 -> P4 [label="Đơn hàng đã xác nhận"];
    
    P4 -> D4 [label="Lưu hóa đơn"];
    P4 -> P6 [label="Dữ liệu hóa đơn"];
    
    P3 -> P5 [label="Yêu cầu giao hàng"];
    P5 -> Vendor [label="Nhãn giao hàng"];
    P5 -> P6 [label="Thông tin theo dõi"];
    
    P6 -> Customer [label="Xác nhận đơn hàngn+ Theo dõi"];
    
    // Đường nét đứt cho các truy vấn
    D1 -> P5 [label="Lấy chi tiết đơn hàng", style=dashed];
    D2 -> P1 [label="Kiểm tra khả dụng", style=dashed];
    D3 -> P1 [label="Lấy thông tin khách hàng", style=dashed];
}

graph LR
    subgraph Source["Kiểm soát nguồn"]
        Git[Kho lưu trữ GitHub]
        PR[Yêu cầu kéo]
    end
    
    subgraph CI["Tích hợp liên tục"]
        Lint[Kiểm tra mã]
        Test[Đơn vị kiểm thử]
        Build[Sản phẩm xây dựng]
        Scan[Quét bảo mật]
    end
    
    subgraph CD["Triển khai liên tục"]
        Dev[Triển khai sang môi trường Dev]
        Stage[Triển khai sang môi trường Staging]
        E2E[Kiểm thử E2E]
        Prod[Triển khai sang môi trường Production]
    end
    
    subgraph Monitor["Giám sát"]
        Logs[Tổng hợp nhật ký]
        Metrics[Bảng điều khiển chỉ số]
        Alerts[Hệ thống cảnh báo]
    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
  Lưu trữ tài khoản khách hàng
  và dữ liệu xác thực
end note

note left of Orders
  Bản ghi giao dịch chính
  với chi tiết vận chuyển
end note

@enduml

graph TB
    subgraph AWS["Cơ sở hạ tầng đám mây AWS"]
        direction TB
        
        subgraph Networking["Mạng"]
            VPC[VPC 10.0.0.0/16]
            IGW[Cổng Internet]
            NAT[Cổng NAT]
            
            subgraph Public["Mạng con công cộng"]
                ALB[Trình cân bằng tải ứng dụng]
                Bastion[Host Bastion]
            end
            
            subgraph Private["Mạng con riêng tư"]
                subgraph AppTier["Lớp ứng dụng"]
                    ECS1[Nhiệm vụ ECS 1]
                    ECS2[Nhiệm vụ ECS 2]
                    ECS3[Nhiệm vụ ECS 3]
                end
                
                subgraph DataTier["Lớp dữ liệu"]
                    RDS[RDS PostgreSQL<br/>Đa vùng]
                    Redis[ElastiCache Redis]
                end
            end
        end
        
        subgraph Storage["Lưu trữ"]
            S3[Thùng S3<br/>Tài sản & Bản sao lưu]
            EFS[Lưu trữ chia sẻ EFS]
        end
        
        subgraph Security["Bảo mật"]
            WAF[Quy tắc WAF]
            SG[Nhóm bảo mật]
            IAM[Vai trò IAM]
        end
        
        subgraph Monitoring["Giám sát & Ghi nhật ký"]
            CW[CloudWatch]
            XRay[AWS X-Ray]
            SNS[Thông báo SNS]
        end
    end
    
    User[Người dùng cuối] --> 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
' Phong cách toàn cục
skinparam backgroundColor #FFFFFF
skinparam shadowing false
skinparam roundcorner 10
skinparam linetype ortho

' Phong cách thành phần
skinparam component {
    BackgroundColor #E3F2FD
    BorderColor #1976D2
    ArrowColor #1976D2
}

' Phong cách gói
skinparam package {
    BackgroundColor #FFF3E0
    BorderColor #F57C00
    FontSize 14
}

' Phong cách ghi chú
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]
  Quản lý trạng thái tập trung
  cho toàn bộ ứng dụng
end note

@enduml

digraph AdvancedStyling {
    // Thuộc tính đồ thị toàn cục
    graph [
        bgcolor="#f8f9fa"
        fontname="Helvetica"
        fontsize=16
        label="Kiến trúc hệ thống doanh nghiệpnMôi trường sản xuất"
        labelloc="t"
        pad=0.5
        ranksep=1.5
        nodesep=1.0
    ];
    
    // Thuộc tính nút mặc định
    node [
        fontname="Helvetica"
        fontsize=11
        style="filled,rounded"
        penwidth=2
    ];
    
    // Thuộc tính cạnh mặc định
    edge [
        fontname="Helvetica"
        fontsize=9
        penwidth=1.5
        arrowsize=0.8
    ];
    
    // Cụm nút với phong cách tùy chỉnh
    subgraph cluster_presentation {
        label="Lớp trình bày";
        style=filled;
        color="#e3f2fd";
        fontcolor="#1565c0";
        
        Web [label="Ứng dụng Web<br/>React 18", fillcolor="#64b5f6", fontcolor="white"];
        Mobile [label="Ứng dụng di động<br/>Flutter", fillcolor="#64b5f6", fontcolor="white"];
    }
    
    subgraph cluster_business {
        label="Lớp logic nghiệp vụ";
        style=filled;
        color="#fff3e0";
        fontcolor="#e65100";
        
        API [label="REST API<br/>Node.js", fillcolor="#ffb74d", fontcolor="black"];
        GraphQL [label="Cổng GraphQL", fillcolor="#ffb74d", fontcolor="black"];
    }
    
    subgraph cluster_data {
        label="Lớp dữ liệu";
        style=filled;
        color="#e8f5e9";
        fontcolor="#2e7d32";
        
        Primary [label="Cơ sở dữ liệu chính<br/>PostgreSQL 14", shape=cylinder, fillcolor="#a5d6a7"];
        Replica [label="Bản sao đọc<br/>PostgreSQL 14", shape=cylinder, fillcolor="#c8e6c9"];
        Cache [label="Bộ nhớ đệm Redis<br/>Chế độ cụm", shape=cylinder, fillcolor="#c8e6c9"];
    }
    
    // Cạnh với phong cách tùy chỉnh
    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="Đọc/Ghi", color="#388e3c", fontcolor="#388e3c"];
    API -> Cache [label="Bộ nhớ đệm", color="#f57c00", fontcolor="#f57c00", style=dashed];
    GraphQL -> Replica [label="Chỉ đọc", color="#388e3c", fontcolor="#388e3c"];
    
    Primary -> Replica [label="Sao chép luồng", color="#757575", style=dotted];
}