Chế độ giao diện
2.4. Mô Hình Hóa Yêu Cầu (Requirements Modeling)
IMPORTANT
Nếu bạn chỉ được nhớ một điều duy nhất: Ngôn ngữ tự nhiên (Văn bản tiếng Việt hay tiếng Anh) là phương tiện giao tiếp đầy rẫy sự mơ hồ, nhập nhằng và đa nghĩa: "Một bức tranh có giá trị bằng một vạn dòng chữ đặc tả". Mô hình hóa yêu cầu (Requirements Modeling) là cầu nối biến các mô tả ngôn ngữ lộn xộn thành các mô hình kỹ thuật chuẩn xác về mặt cấu trúc và hành vi: Kết hợp giữa Mô hình Tĩnh (Use Case, User Stories với Acceptance Criteria chuẩn Gherkin), Mô hình Động (State Machine Diagram để kiểm soát chặt chẽ trạng thái giao dịch, Sequence Diagram để bản đồ hóa thông điệp phân tán), và Mô hình Logic Nghiệp Vụ (Decision Tables để vét cạn
1. Kiến trúc Tổng quan & Mô hình Tư duy (Mental Model)
1.1. Ẩn dụ Đời sống: Bản Vẽ Cơ Khí Động Cơ Máy Bay vs Văn Bản Mô Tả
Hãy hình dung khi một kỹ sư hàng không thiết kế động cơ phản lực:
- Nếu chỉ dùng văn bản mô tả suông (Text-based Specification):
- "Động cơ gồm nhiều cánh quạt hút gió vào buồng đốt, sau đó phun nhiên liệu đốt cháy rồi xả khí ra phía sau để đẩy máy bay về phía trước".
- Đoạn văn bản này hoàn toàn vô dụng cho đội ngũ chế tạo cơ khí! Nó không cho biết cánh quạt quay bao nhiêu vòng/phút, góc nghiêng cánh bao nhiêu độ, và áp suất buồng đốt cực đại là bao nhiêu.
- Mô hình hóa kỹ thuật đa góc nhìn (Multidimensional Modeling):
- Bản vẽ mặt cắt tĩnh (Structural Blueprint - Use Case / Domain Model): Cho thấy vị trí chính xác của từng trục bi, van nhiên liệu và buồng đốt.
- Sơ đồ chu trình nhiệt động học (Behavioral State Machine): Mô tả các trạng thái chuyển dịch của buồng đốt:
OFFIGNITINGRUNNINGOVERHEAT_SHUTDOWN. - Bảng ma trận kiểm soát nhiên liệu (Decision Table): Quy định chính xác: Với độ cao
và nhiệt độ , lượng nhiên liệu phun vào bắt buộc phải là bao nhiêu mililit/giây.
graph TD
classDef agile fill:#e1f5fe,stroke:#0288d1,stroke-width:2px;
classDef usecase fill:#fff3e0,stroke:#f57c00,stroke-width:2px;
classDef dynamic fill:#e8f5e9,stroke:#388e3c,stroke-width:2px;
classDef logic fill:#f3e5f5,stroke:#7b1fa2,stroke-width:2px;
Root["CÁC CHIỀU KHÔNG GIAN MÔ HÌNH HÓA YÊU CẦU (MODELING DIMENSIONS)"]
Root --> M1["1. Mô Hình Hóa Linh Hoạt (Agile Modeling)"]:::agile
Root --> M2["2. Mô Hình Hóa Ca Sử Dụng (Use Case Modeling)"]:::usecase
Root --> M3["3. Mô Hình Hóa Động & Hành Vi (Dynamic & Behavioral)"]:::dynamic
Root --> M4["4. Mô Hình Hóa Logic & Quy Tắc (Logic & Rules Modeling)"]:::logic
M1 --> M1A["User Stories (Connextra Template: As a... I want... So that...)"]
M1 --> M1B["Tiêu Chí Chấp Nhận (Acceptance Criteria - Gherkin Given/When/Then)"]
M1 --> M1C["Bản Đồ Hành Trình (User Journey Map)"]
M2 --> M2A["Tác Nhân (Actors: Primary, Secondary, System)"]
M2 --> M2B["Luồng Thực Thi: Happy Path, Alternative, Exception Flows"]
M2 --> M2C["Quan Hệ Use Case: <<include>> vs <<extend>>"]
M3 --> M3A["State Machine Diagram (Trạng Thái, Chuyển Dịch, Guards)"]
M3 --> M3B["Sequence Diagram (Tương Tác Theo Trục Thời Gian)"]
M3 --> M3C["Activity Diagram & BPMN (Quy Trình Nghiệp Vụ)"]
M4 --> M4A["Bảng Quyết Định (Decision Tables Matrix)"]
M4 --> M4B["Cây Quyết Định (Decision Trees)"]
M4 --> M4C["Quy Tắc Nghiệp Vụ Tường Minh (Business Rules)"]
2. Chi tiết từng Keyword (Under-the-Hood Deep Dive)
2.1. Agile Modeling: User Story, Template, Acceptance Criteria & User Journey
1. Mẫu User Story Chuẩn Connextra
Được định hình bởi Rachel Davies tại Connextra vào năm 2001, đây là tiêu chuẩn vàng của Agile:
- Role: Xác định rõ ai là người hưởng lợi (không bao giờ viết chung chung là "người dùng", mà phải là "Khách hàng VIP", "Nhân viên thẩm định tín dụng").
- Action: Năng lực phần mềm cần cung cấp.
- Benefit: Giá trị kinh doanh thực sự mang lại (Nếu không thể chỉ ra được giá trị kinh doanh, tính năng đó không xứng đáng được viết code!).
2. Tiêu Chí Chấp Nhận Chuẩn Gherkin (Acceptance Criteria - BDD)
Chuyển hóa câu chuyện thành bài kiểm thử tự động (Executable Specification) bằng cú pháp Given - When - Then:
- Given (Bối cảnh ban đầu): Trạng thái của hệ thống trước khi hành động diễn ra.
- When (Hành động kích hoạt): Thao tác của người dùng hoặc sự kiện bên ngoài.
- Then (Kết quả mong đợi): Trạng thái mới của hệ thống và các phản hồi có thể kiểm chứng.
gherkin
Scenario: Rút tiền ATM thành công khi số dư khả dụng
Given Tài khoản của "Alice" có số dư là 500 USD
And Thẻ ATM của "Alice" đang hợp lệ
When "Alice" yêu cầu rút 100 USD từ cây ATM
Then Cây ATM phải nhả ra 100 USD tiền mặt
And Số dư tài khoản của "Alice" phải còn lại 400 USD
And Hệ thống phải ghi một dòng Audit Log giao dịch1
2
3
4
5
6
7
2
3
4
5
6
7
2.2. Use Case Modeling: Actor, Scenarios, Main, Alternative & Exception Flows
Phát minh bởi Ivar Jacobson, Use Case là phương pháp mô hình hóa hướng chức năng cực kỳ mạnh mẽ cho các hệ thống lớn:
flowchart TD
Actor["Tác Nhân Chính (Primary Actor):<br/>Khách Hàng"]
subgraph Boundary ["Ranh Giới Hệ Thống Ngân Hàng (System Boundary)"]
UC1["Ca Sử Dụng Chính:<br/>Thanh Toán Đơn Hàng"]
UC_Auth["Ca Sử Dụng Con:<br/>Xác Thực Danh Tính OTP"]
UC_Discount["Ca Sử Dụng Mở Rộng:<br/>Áp Mã Giảm Giá"]
end
Actor --> UC1
UC1 -.->|"<<include>> (Bắt buộc phải có)"| UC_Auth
UC1 -.->|"<<extend>> (Tùy chọn khi thỏa mãn điều kiện)"| UC_Discount
1. Phân Loại Tác Nhân (Actors)
- Primary Actor: Người trực tiếp kích hoạt Use Case để đạt được mục tiêu (ví dụ: Khách hàng).
- Secondary / Supporting Actor: Hệ thống phụ trợ cung cấp dịch vụ cho Use Case (ví dụ: Cổng thanh toán VISA, Dịch vụ gửi SMS).
2. Cấu Trúc Luồng Thực Thi Của Một Use Case
- Main Success Scenario (Happy Path - Luồng thành công chính): Con đường lý tưởng khi mọi thứ diễn ra trôi chảy, không có bất kỳ lỗi nào.
- Alternative Flows (Luồng thay thế): Các con đường khác nhau cũng dẫn đến thành công (ví dụ: Thay vì trả bằng thẻ tín dụng, người dùng chọn chuyển khoản ngân hàng).
- Exception Flows (Luồng ngoại lệ): Các tình huống xảy ra lỗi khiến mục tiêu không thể hoàn thành (ví dụ: Thẻ hết hạn, tài khoản không đủ tiền, hệ thống ngân hàng bị timeout).
3. Quan Hệ <<include>> vs <<extend>>
<<include>>: Hành vi con bắt buộc phải thực hiện trong quá trình chạy Use Case cha (Ví dụ: Thanh toán đơn hàng bắt buộc phải<<include>>Xác thực OTP).<<extend>>: Hành vi mở rộng chỉ được kích hoạt khi có một điều kiện cụ thể (Extension Point) (Ví dụ: Thanh toán đơn hàng có thể được<<extend>>bởi Áp dụng mã giảm giá khi khách hàng có voucher).
2.3. Dynamic & Behavioral Modeling: State Machine & Sequence Diagrams
Trong kỹ nghệ Backend phân tán, mã nguồn thường bị lỗi khi xử lý các giao dịch có vòng đời phức tạp (như Đơn hàng thương mại điện tử hoặc Giao dịch ngân hàng). State Machine Diagram (Biểu đồ Máy trạng thái) là vũ khí tối thượng để loại bỏ các trạng thái không hợp lệ:
stateDiagram-v2
[*] --> PENDING_PAYMENT: Tạo đơn hàng thành công
PENDING_PAYMENT --> AUTHORIZED: Cổng thanh toán giữ tiền (Hold)
PENDING_PAYMENT --> CANCELLED: Người dùng bấm hủy / Timeout 15m
AUTHORIZED --> CAPTURED: Kho hàng xác nhận xuất kho thành công
AUTHORIZED --> VOIDED: Hết hàng trong kho (Hoàn tiền tức thì)
CAPTURED --> REFUNDED: Khách hàng đổi trả hàng trong 7 ngày
CAPTURED --> COMPLETED: Sau 7 ngày đơn hàng hoàn tất vĩnh viễn
CANCELLED --> [*]
VOIDED --> [*]
REFUNDED --> [*]
COMPLETED --> [*]
- Nguyên Tắc Bất Biến (State Invariants & Guard Conditions):
- Một đơn hàng ở trạng thái
CANCELLEDtuyệt đối không bao giờ được phép chuyển sangCAPTURED. - Việc mô hình hóa máy trạng thái giúp lập trình viên viết code với các hàm bảo vệ (State Guard / State Pattern), ngăn chặn hoàn toàn các lỗi gian lận hoặc race condition khi nhiều webhook gọi về cùng lúc.
- Một đơn hàng ở trạng thái
2.4. Logic & Rules Modeling: Business Rules & Decision Tables
Khi một chính sách kinh doanh phụ thuộc vào quá nhiều điều kiện kết hợp (ví dụ: Thuật toán duyệt hồ sơ vay tiền ngân hàng hoặc tính phí bảo hiểm), việc viết các khối lệnh if-else lồng nhau là công thức dẫn đến thảm họa bug:
Ma Trận Bảng Quyết Định (Decision Table Matrix)
| Thành Phần Khảo Sát | Quy Tắc 1 (R1) | Quy Tắc 2 (R2) | Quy Tắc 3 (R3) | Quy Tắc 4 (R4) |
|---|---|---|---|---|
| Điều kiện 1: Điểm tín dụng | Y | Y | N | N |
| Điều kiện 2: Thu nhập | Y | N | Y | N |
| Điều kiện 3: Có tài sản thế chấp | - | Y | Y | N |
| Hành động 1: Duyệt khoản vay tự động | [X] | [X] | [ ] | [ ] |
| Hành động 2: Chuyển sang thẩm định thủ công | [ ] | [ ] | [X] | [ ] |
| Hành động 3: Từ chối hồ sơ lập tức | [ ] | [ ] | [ ] | [X] |
- Bảng quyết định đảm bảo kiểm tra đầy đủ toàn bộ
tổ hợp điều kiện có thể xảy ra, loại bỏ hoàn toàn các trường hợp sót (Missing edge cases) trong mã nguồn.
3. Thực thi Mã nguồn & Mô phỏng Chuyên sâu (Dual-Engine Implementation)
3.1. C++20 Clean Decision Table Engine via Functional Mapping
Chương trình minh chứng cách thức triển khai một Bảng Quyết Định (Decision Table) chuẩn mực bằng C++20: Biểu diễn các điều kiện và hành động dưới dạng các hàm thuần túy (Lambdas), tự động đánh giá ma trận quy tắc và thực thi hành động tương ứng:
cpp
// decision_table_engine.cpp
// Biên dịch: g++ -std=c++20 -O3 decision_table_engine.cpp -o decision_table_engine
#include <iostream>
#include <vector>
#include <string>
#include <functional>
#include <optional>
struct LoanApplication {
std::string applicant_name;
int credit_score;
double monthly_income;
bool has_collateral;
};
enum class LoanDecision {
AUTO_APPROVED,
MANUAL_REVIEW,
REJECTED
};
// Cấu trúc một Rule trong Decision Table
struct DecisionRule {
std::string rule_name;
std::function<bool(const LoanApplication&)> condition_predicate;
LoanDecision action_decision;
};
class LoanDecisionTableEngine {
private:
std::vector<DecisionRule> rules_;
public:
LoanDecisionTableEngine() {
// R1: Điểm tín dụng cao (>=700) và Thu nhập tốt (>=20M) -> Duyệt tự động
rules_.push_back({
"R1: Điểm tín dụng cao & Thu nhập tốt",
[](const LoanApplication& app) {
return app.credit_score >= 700 && app.monthly_income >= 20.0;
},
LoanDecision::AUTO_APPROVED
});
// R2: Điểm tín dụng cao (>=700) nhưng thu nhập thấp, có tài sản thế chấp -> Duyệt tự động
rules_.push_back({
"R2: Điểm cao, có tài sản thế chấp",
[](const LoanApplication& app) {
return app.credit_score >= 700 && app.monthly_income < 20.0 && app.has_collateral;
},
LoanDecision::AUTO_APPROVED
});
// R3: Điểm thấp (<700) nhưng thu nhập tốt và có tài sản -> Thẩm định thủ công
rules_.push_back({
"R3: Điểm thấp, thu nhập tốt & có thế chấp",
[](const LoanApplication& app) {
return app.credit_score < 700 && app.monthly_income >= 20.0 && app.has_collateral;
},
LoanDecision::MANUAL_REVIEW
});
// R4: Mặc định còn lại -> Từ chối
rules_.push_back({
"R4: Không đủ điều kiện an toàn",
[](const LoanApplication&) { return true; }, // Fallback rule
LoanDecision::REJECTED
});
}
void evaluate(const LoanApplication& app) {
std::cout << "[HỒ SƠ KHÁCH HÀNG]: " << app.applicant_name
<< " (Điểm: " << app.credit_score
<< ", Thu nhập: " << app.monthly_income
<< "M, Thế chấp: " << (app.has_collateral ? "CÓ" : "KHÔNG") << ")\n";
for (const auto& rule : rules_) {
if (rule.condition_predicate(app)) {
std::cout << " -> Khớp Quy Tắc: [" << rule.rule_name << "]\n";
std::cout << " >>> QUYẾT ĐỊNH CUỐI CÙNG: ";
switch (rule.action_decision) {
case LoanDecision::AUTO_APPROVED:
std::cout << "DUYỆT TỰ ĐỘNG (LOAN APPROVED)!\n\n";
break;
case LoanDecision::MANUAL_REVIEW:
std::cout << "CHUYỂN THẨM ĐỊNH THỦ CÔNG (MANUAL REVIEW)!\n\n";
break;
case LoanDecision::REJECTED:
std::cout << "TỪ CHỐI HỒ SƠ (APPLICATION REJECTED)!\n\n";
break;
}
return;
}
}
}
};
int main() {
std::cout << "=======================================================================\n";
std::cout << " C++20 REQUIREMENTS LOGIC DECISION TABLE ENGINE \n";
std::cout << "=======================================================================\n\n";
LoanDecisionTableEngine engine;
engine.evaluate({"Alice Nguyen", 750, 35.0, false}); // Khớp R1
engine.evaluate({"Bob Tran", 720, 15.0, true}); // Khớp R2
engine.evaluate({"Charlie Le", 620, 25.0, true}); // Khớp R3
engine.evaluate({"David Pham", 580, 10.0, false}); // Khớp R4
return 0;
}1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
Terminal Output Mẫu:
text
=======================================================================
C++20 REQUIREMENTS LOGIC DECISION TABLE ENGINE
=======================================================================
[HỒ SƠ KHÁCH HÀNG]: Alice Nguyen (Điểm: 750, Thu nhập: 35M, Thế chấp: KHÔNG)
-> Khớp Quy Tắc: [R1: Điểm tín dụng cao & Thu nhập tốt]
>>> QUYẾT ĐỊNH CUỐI CÙNG: DUYỆT TỰ ĐỘNG (LOAN APPROVED)!
[HỒ SƠ KHÁCH HÀNG]: Bob Tran (Điểm: 720, Thu nhập: 15M, Thế chấp: CÓ)
-> Khớp Quy Tắc: [R2: Điểm cao, có tài sản thế chấp]
>>> QUYẾT ĐỊNH CUỐI CÙNG: DUYỆT TỰ ĐỘNG (LOAN APPROVED)!
[HỒ SƠ KHÁCH HÀNG]: Charlie Le (Điểm: 620, Thu nhập: 25M, Thế chấp: CÓ)
-> Khớp Quy Tắc: [R3: Điểm thấp, thu nhập tốt & có thế chấp]
>>> QUYẾT ĐỊNH CUỐI CÙNG: CHUYỂN THẨM ĐỊNH THỦ CÔNG (MANUAL REVIEW)!
[HỒ SƠ KHÁCH HÀNG]: David Pham (Điểm: 580, Thu nhập: 10M, Thế chấp: KHÔNG)
-> Khớp Quy Tắc: [R4: Không đủ điều kiện an toàn]
>>> QUYẾT ĐỊNH CUỐI CÙNG: TỪ CHỐI HỒ SƠ (APPLICATION REJECTED)!1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
3.2. Python 3.11+ Order State Machine & BDD Acceptance Test Simulator
Chương trình minh chứng cách triển khai Máy trạng thái đơn hàng (Order State Machine) với các điều kiện chuyển dịch nghiêm ngặt (Transition Guards) và kiểm chứng tự động theo phong cách BDD Acceptance Criteria:
python
#!/usr/bin/env python3
"""
order_state_machine_bdd.py
Mô phỏng Máy Trạng Thái Đơn Hàng (State Machine) & Kiểm Thử Chấp Nhận BDD Gherkin
"""
from enum import Enum
from dataclasses import dataclass
from typing import Optional
class OrderState(Enum):
PENDING_PAYMENT = "PENDING_PAYMENT"
AUTHORIZED = "AUTHORIZED"
CAPTURED = "CAPTURED"
CANCELLED = "CANCELLED"
REFUNDED = "REFUNDED"
class InvalidStateTransitionError(Exception):
pass
class OrderStateMachine:
def __init__(self, order_id: str, total_amount: float):
self.order_id = order_id
self.total_amount = total_amount
self.current_state = OrderState.PENDING_PAYMENT
def authorize_payment(self, hold_amount: float):
# BDD Rule: Chỉ cho phép Authorize khi đang ở PENDING_PAYMENT
if self.current_state != OrderState.PENDING_PAYMENT:
raise InvalidStateTransitionError(f"Không thể Authorize đơn hàng đang ở trạng thái {self.current_state.value}!")
if hold_amount < self.total_amount:
raise ValueError("Số tiền phong tỏa không đủ để thanh toán đơn hàng!")
self.current_state = OrderState.AUTHORIZED
print(f" [STATE CHANGE] Order {self.order_id}: PENDING_PAYMENT -> AUTHORIZED (Hold ${hold_amount})")
def capture(self):
# BDD Rule: Chỉ cho phép Capture khi đã AUTHORIZED
if self.current_state != OrderState.AUTHORIZED:
raise InvalidStateTransitionError(f"Không thể Capture đơn hàng khi chưa được Authorize (Trạng thái: {self.current_state.value})!")
self.current_state = OrderState.CAPTURED
print(f" [STATE CHANGE] Order {self.order_id}: AUTHORIZED -> CAPTURED (Tiền đã vào tài khoản cửa hàng)")
def cancel(self):
# BDD Rule: Không thể Cancel một đơn hàng đã Capture tiền
if self.current_state in [OrderState.CAPTURED, OrderState.REFUNDED]:
raise InvalidStateTransitionError(f"Đơn hàng đã thanh toán xong ({self.current_state.value}), bắt buộc phải qua quy trình REFUND!")
self.current_state = OrderState.CANCELLED
print(f" [STATE CHANGE] Order {self.order_id}: -> CANCELLED (Đã hủy đơn hàng)")
def run_bdd_acceptance_tests():
print("=" * 80)
print(" KIỂM THỬ CHẤP NHẬN BDD: QUY CHUẨN MÁY TRẠNG THÁI ĐƠN HÀNG ")
print("=" * 80)
# Kịch bản 1: Happy Path
print("\n[KỊCH BẢN 1: Giao dịch thành công trọn vẹn (Happy Path)]")
order1 = OrderStateMachine("ORD-001", 100.0)
order1.authorize_payment(100.0)
order1.capture()
assert order1.current_state == OrderState.CAPTURED
print(">>> KỊCH BẢN 1: ĐẠT CHUẨN (PASSED)")
# Kịch bản 2: Vi phạm State Transition (Cố tình hủy đơn hàng đã Capture)
print("\n[KỊCH BẢN 2: Thử nghiệm vi phạm logic chuyển dịch trạng thái]")
order2 = OrderStateMachine("ORD-002", 200.0)
order2.authorize_payment(200.0)
order2.capture()
try:
print(" Thực hiện thao tác bất hợp pháp: Cố tình Cancel đơn hàng đã Capture...")
order2.cancel()
except InvalidStateTransitionError as ex:
print(f" -> [BẮT NGOẠI LỆ HỢP LỆ]: {ex}")
print(">>> KỊCH BẢN 2: BẢO VỆ TRẠNG THÁI AN TOÀN 100% (PASSED)")
print("\n" + "=" * 80)
if __name__ == "__main__":
run_bdd_acceptance_tests()1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
Terminal Output Mẫu:
text
================================================================================
KIỂM THỬ CHẤP NHẬN BDD: QUY CHUẨN MÁY TRẠNG THÁI ĐƠN HÀNG
================================================================================
[KỊCH BẢN 1: Giao dịch thành công trọn vẹn (Happy Path)]
[STATE CHANGE] Order ORD-001: PENDING_PAYMENT -> AUTHORIZED (Hold $100.0)
[STATE CHANGE] Order ORD-001: AUTHORIZED -> CAPTURED (Tiền đã vào tài khoản cửa hàng)
>>> KỊCH BẢN 1: ĐẠT CHUẨN (PASSED)
[KỊCH BẢN 2: Thử nghiệm vi phạm logic chuyển dịch trạng thái]
[STATE CHANGE] Order ORD-002: PENDING_PAYMENT -> AUTHORIZED (Hold $200.0)
[STATE CHANGE] Order ORD-002: AUTHORIZED -> CAPTURED (Tiền đã vào tài khoản cửa hàng)
Thực hiện thao tác bất hợp pháp: Cố tình Cancel đơn hàng đã Capture...
-> [BẮT NGOẠI LỆ HỢP LỆ]: Đơn hàng đã thanh toán xong (CAPTURED), bắt buộc phải qua quy trình REFUND!
>>> KỊCH BẢN 2: BẢO VỆ TRẠNG THÁI AN TOÀN 100% (PASSED)
================================================================================1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
4. Systems Engineering & Production Pitfalls
4.1. Cạm Bẫy Thực Chiến Thường Gặp (Production Pitfalls)
1. Sự Cố "Missing Edge Case Explosion" Do Viết if-else Tự Phát
- Hiện tượng: Một tính năng tính phí bảo hiểm có 4 điều kiện đầu vào. Lập trình viên viết các khối
iflồng nhau và chỉ bao quát 5 trường hợp. - Hậu quả: Khi một khách hàng có tổ hợp điều kiện thứ 6 xuất hiện trên Production, hệ thống rơi vào nhánh
elsemặc định và tính giá bảo hiểm bằng $0, gây thất thoát hàng trăm nghìn USD! - Giải pháp: Bắt buộc vẽ Decision Table trước khi gõ code. Bảng quyết định bắt buộc lập trình viên phải định nghĩa hành vi cho đầy đủ
trường hợp.
2. Thảm Họa "State Machine Race Conditions" Trong Hệ Thống Phân Tán
- Hiện tượng: Hai Webhook từ cổng thanh toán gửi về gần như cùng một tích tắc: Webhook 1 báo
PaymentSucceeded, Webhook 2 báoPaymentCancelleddo người dùng thao tác nhanh. - Hậu quả: Nếu không có cơ chế khóa lạc quan (Optimistic Locking via Version) hoặc State Machine bảo vệ, trạng thái của đơn hàng có thể bị nhảy lùi từ
COMPLETEDvềCANCELLED. - Giải pháp: Thiết kế bảng Database với ràng buộc trạng thái hoặc kiểm tra version:sql
UPDATE orders SET status = 'CAPTURED', version = version + 1 WHERE id = 101 AND status = 'AUTHORIZED' AND version = 2;1
2
3. Bẫy Biến Sequence Diagram Thành "Văn Bản Bất Di Bất Dịch"
- Hiện tượng: Đội ngũ vẽ một Sequence Diagram chi tiết đến từng tên hàm riêng tư (Private methods) và từng biến nội tại.
- Hậu quả: Mỗi khi lập trình viên đổi tên một hàm con, tài liệu kiến trúc lập tức bị lỗi thời (Outdated).
- Giải pháp: Sequence Diagram chỉ nên mô hình hóa tương tác giữa các ranh giới lớn (Microservices, API Endpoints, Database), không vẽ chi tiết mã nguồn nội bộ bên trong một class.
4.2. CLI Diagnostics & Công Cụ Khảo Sát Mô Hình Hóa
bash
# 1. Chạy bài kiểm thử chấp nhận BDD tự động bằng Behave CLI
behave features/order_lifecycle.feature
# 2. Sinh biểu đồ State Machine trực tiếp từ mã nguồn PlantUML
plantuml -tpng order_state_machine.puml
# 3. Quét kiểm tra độ phức tạp phân nhánh Cyclomatic Complexity của các hàm if-else
lizard src/ -C 101
2
3
4
5
6
7
8
2
3
4
5
6
7
8
5. Bảng So sánh & Decision Matrix
| Kỹ Thuật Mô Hình Hóa | Chiều Không Gian Đại Diện | Độ Chính Xác Kỹ Thuật | Phù Hợp Cho Đối Tượng | Khi Nào Bắt Buộc Dùng |
|---|---|---|---|---|
| User Stories & Gherkin | Tương tác & Chấp nhận (BDD) | Trung bình - Cao | Lập trình viên, Tester, PO | Lập kế hoạch Sprint, Viết Test tự động |
| Use Case Diagram | Ranh giới & Mục tiêu tổng thể | Trung bình | Khách hàng, Ban quản lý | Báo cáo phạm vi dự án trong hợp đồng |
| State Machine Diagram | Vòng đời & Trạng thái thực thể | Rất cao (Nghiêm ngặt) | Kỹ sư Backend, Kiến trúc sư | Quản lý Đơn hàng, Giao dịch tài chính, Game |
| Sequence Diagram | Giao tiếp mạng theo thời gian | Cao | Kỹ sư phân tán, API Designer | Thiết kế tương tác liên dịch vụ gRPC/REST |
| Decision Tables Matrix | Logic phân nhánh điều kiện | Tuyệt đối ( | Lập trình viên thuật toán, BA | Tính thuế, Duyệt hồ sơ vay, Chấm điểm tín dụng |
IyAyLjQuIE3DtCBIw6xuaCBIw7NhIFnDqnUgQ+G6p3UgKFJlcXVpcmVtZW50cyBNb2RlbGluZykNCg0KPiBbIUlNUE9SVEFOVF0NCj4gKipO4bq/dSBi4bqhbiBjaOG7iSDEkcaw4bujYyBuaOG7myBt4buZdCDEkWnhu4F1IGR1eSBuaOG6pXQ6KiogTmfDtG4gbmfhu68gdOG7sSBuaGnDqm4gKFbEg24gYuG6o24gdGnhur9uZyBWaeG7h3QgaGF5IHRp4bq/bmcgQW5oKSBsw6AgcGjGsMahbmcgdGnhu4duIGdpYW8gdGnhur9wIMSR4bqneSBy4bqreSBz4buxIG3GoSBo4buTLCBuaOG6rXAgbmjhurFuZyB2w6AgxJFhIG5naMSpYTogKioiTeG7mXQgYuG7qWMgdHJhbmggY8OzIGdpw6EgdHLhu4sgYuG6sW5nIG3hu5l0IHbhuqFuIGTDsm5nIGNo4buvIMSR4bq3YyB04bqjIioqLiBNw7QgaMOsbmggaMOzYSB5w6p1IGPhuqd1IChSZXF1aXJlbWVudHMgTW9kZWxpbmcpIGzDoCBj4bqndSBu4buRaSBiaeG6v24gY8OhYyBtw7QgdOG6oyBuZ8O0biBuZ+G7ryBs4buZbiB44buZbiB0aMOgbmggY8OhYyAqKm3DtCBow6xuaCBr4bu5IHRodeG6rXQgY2h14bqpbiB4w6FjIHbhu4EgbeG6t3QgY+G6pXUgdHLDumMgdsOgIGjDoG5oIHZpKio6IEvhur90IGjhu6NwIGdp4buvYSAqKk3DtCBow6xuaCBUxKluaCAoVXNlIENhc2UsIFVzZXIgU3RvcmllcyB24bubaSBBY2NlcHRhbmNlIENyaXRlcmlhIGNodeG6qW4gR2hlcmtpbikqKiwgKipNw7QgaMOsbmggxJDhu5luZyAoU3RhdGUgTWFjaGluZSBEaWFncmFtIMSR4buDIGtp4buDbSBzb8OhdCBjaOG6t3QgY2jhur0gdHLhuqFuZyB0aMOhaSBnaWFvIGThu4tjaCwgU2VxdWVuY2UgRGlhZ3JhbSDEkeG7gyBi4bqjbiDEkeG7kyBow7NhIHRow7RuZyDEkWnhu4dwIHBow6JuIHTDoW4pKiosIHbDoCAqKk3DtCBow6xuaCBMb2dpYyBOZ2hp4buHcCBW4bulIChEZWNpc2lvbiBUYWJsZXMgxJHhu4MgdsOpdCBj4bqhbiAkMTAwXCUkIGPDoWMgdOG7lSBo4bujcCDEkWnhu4F1IGtp4buHbiBiacOqbiBtw6Aga2jDtG5nIGLhu48gc8OzdCBi4bqldCBr4buzIGvhu4tjaCBi4bqjbiBuw6BvKSoqLg0KDQotLS0NCg0KIyMgMS4gS2nhur9uIHRyw7pjIFThu5VuZyBxdWFuICYgTcO0IGjDrG5oIFTGsCBkdXkgKE1lbnRhbCBNb2RlbCkNCg0KIyMjIDEuMS4g4bqobiBk4bulIMSQ4budaSBz4buRbmc6IELhuqNuIFbhur0gQ8ahIEtow60gxJDhu5luZyBDxqEgTcOheSBCYXkgdnMgVsSDbiBC4bqjbiBNw7QgVOG6ow0KDQpIw6N5IGjDrG5oIGR1bmcga2hpIG3hu5l0IGvhu7kgc8awIGjDoG5nIGtow7RuZyB0aGnhur90IGvhur8gxJHhu5luZyBjxqEgcGjhuqNuIGzhu7FjOg0KLSAqKk7hur91IGNo4buJIGTDuW5nIHbEg24gYuG6o24gbcO0IHThuqMgc3XDtG5nIChUZXh0LWJhc2VkIFNwZWNpZmljYXRpb24pKio6DQogIC0gKiLEkOG7mW5nIGPGoSBn4buTbSBuaGnhu4F1IGPDoW5oIHF14bqhdCBow7p0IGdpw7MgdsOgbyBideG7k25nIMSR4buRdCwgc2F1IMSRw7MgcGh1biBuaGnDqm4gbGnhu4d1IMSR4buRdCBjaMOheSBy4buTaSB44bqjIGtow60gcmEgcGjDrWEgc2F1IMSR4buDIMSR4bqpeSBtw6F5IGJheSB24buBIHBow61hIHRyxrDhu5tjIiouDQogIC0gxJBv4bqhbiB2xINuIGLhuqNuIG7DoHkgaG/DoG4gdG/DoG4gdsO0IGThu6VuZyBjaG8gxJHhu5lpIG5nxakgY2jhur8gdOG6oW8gY8ahIGtow60hIE7DsyBraMO0bmcgY2hvIGJp4bq/dCBjw6FuaCBxdeG6oXQgcXVheSBiYW8gbmhpw6p1IHbDsm5nL3Bow7p0LCBnw7NjIG5naGnDqm5nIGPDoW5oIGJhbyBuaGnDqnUgxJHhu5ksIHbDoCDDoXAgc3XhuqV0IGJ14buTbmcgxJHhu5F0IGPhu7FjIMSR4bqhaSBsw6AgYmFvIG5oacOqdS4NCi0gKipNw7QgaMOsbmggaMOzYSBr4bu5IHRodeG6rXQgxJFhIGfDs2MgbmjDrG4gKE11bHRpZGltZW5zaW9uYWwgTW9kZWxpbmcpKio6DQogIC0gKipC4bqjbiB24bq9IG3hurd0IGPhuq90IHTEqW5oIChTdHJ1Y3R1cmFsIEJsdWVwcmludCAtIFVzZSBDYXNlIC8gRG9tYWluIE1vZGVsKSoqOiBDaG8gdGjhuqV5IHbhu4sgdHLDrSBjaMOtbmggeMOhYyBj4bunYSB04burbmcgdHLhu6VjIGJpLCB2YW4gbmhpw6puIGxp4buHdSB2w6AgYnXhu5NuZyDEkeG7kXQuDQogIC0gKipTxqEgxJHhu5MgY2h1IHRyw6xuaCBuaGnhu4d0IMSR4buZbmcgaOG7jWMgKEJlaGF2aW9yYWwgU3RhdGUgTWFjaGluZSkqKjogTcO0IHThuqMgY8OhYyB0cuG6oW5nIHRow6FpIGNodXnhu4NuIGThu4tjaCBj4bunYSBideG7k25nIMSR4buRdDogYE9GRmAgJFx0byQgYElHTklUSU5HYCAkXHRvJCBgUlVOTklOR2AgJFx0byQgYE9WRVJIRUFUX1NIVVRET1dOYC4NCiAgLSAqKkLhuqNuZyBtYSB0cuG6rW4ga2nhu4NtIHNvw6F0IG5oacOqbiBsaeG7h3UgKERlY2lzaW9uIFRhYmxlKSoqOiBRdXkgxJHhu4tuaCBjaMOtbmggeMOhYzogVuG7m2kgxJHhu5kgY2FvICRIJCB2w6Agbmhp4buHdCDEkeG7mSAkVCQsIGzGsOG7o25nIG5oacOqbiBsaeG7h3UgcGh1biB2w6BvIGLhuq90IGJ14buZYyBwaOG6o2kgbMOgIGJhbyBuaGnDqnUgbWlsaWxpdC9nacOieS4NCg0KYGBgbWVybWFpZA0KZ3JhcGggVEQNCiAgICBjbGFzc0RlZiBhZ2lsZSBmaWxsOiNlMWY1ZmUsc3Ryb2tlOiMwMjg4ZDEsc3Ryb2tlLXdpZHRoOjJweDsNCiAgICBjbGFzc0RlZiB1c2VjYXNlIGZpbGw6I2ZmZjNlMCxzdHJva2U6I2Y1N2MwMCxzdHJva2Utd2lkdGg6MnB4Ow0KICAgIGNsYXNzRGVmIGR5bmFtaWMgZmlsbDojZThmNWU5LHN0cm9rZTojMzg4ZTNjLHN0cm9rZS13aWR0aDoycHg7DQogICAgY2xhc3NEZWYgbG9naWMgZmlsbDojZjNlNWY1LHN0cm9rZTojN2IxZmEyLHN0cm9rZS13aWR0aDoycHg7DQoNCiAgICBSb290WyJDw4FDIENISeG7gFUgS0jDlE5HIEdJQU4gTcOUIEjDjE5IIEjDk0EgWcOKVSBD4bqmVSAoTU9ERUxJTkcgRElNRU5TSU9OUykiXQ0KDQogICAgUm9vdCAtLT4gTTFbIjEuIE3DtCBIw6xuaCBIw7NhIExpbmggSG/huqF0IChBZ2lsZSBNb2RlbGluZykiXTo6OmFnaWxlDQogICAgUm9vdCAtLT4gTTJbIjIuIE3DtCBIw6xuaCBIw7NhIENhIFPhu60gROG7pW5nIChVc2UgQ2FzZSBNb2RlbGluZykiXTo6OnVzZWNhc2UNCiAgICBSb290IC0tPiBNM1siMy4gTcO0IEjDrG5oIEjDs2EgxJDhu5luZyAmIEjDoG5oIFZpIChEeW5hbWljICYgQmVoYXZpb3JhbCkiXTo6OmR5bmFtaWMNCiAgICBSb290IC0tPiBNNFsiNC4gTcO0IEjDrG5oIEjDs2EgTG9naWMgJiBRdXkgVOG6r2MgKExvZ2ljICYgUnVsZXMgTW9kZWxpbmcpIl06Ojpsb2dpYw0KDQogICAgTTEgLS0+IE0xQVsiVXNlciBTdG9yaWVzIChDb25uZXh0cmEgVGVtcGxhdGU6IEFzIGEuLi4gSSB3YW50Li4uIFNvIHRoYXQuLi4pIl0NCiAgICBNMSAtLT4gTTFCWyJUacOqdSBDaMOtIENo4bqlcCBOaOG6rW4gKEFjY2VwdGFuY2UgQ3JpdGVyaWEgLSBHaGVya2luIEdpdmVuL1doZW4vVGhlbikiXQ0KICAgIE0xIC0tPiBNMUNbIkLhuqNuIMSQ4buTIEjDoG5oIFRyw6xuaCAoVXNlciBKb3VybmV5IE1hcCkiXQ0KDQogICAgTTIgLS0+IE0yQVsiVMOhYyBOaMOibiAoQWN0b3JzOiBQcmltYXJ5LCBTZWNvbmRhcnksIFN5c3RlbSkiXQ0KICAgIE0yIC0tPiBNMkJbIkx14buTbmcgVGjhu7FjIFRoaTogSGFwcHkgUGF0aCwgQWx0ZXJuYXRpdmUsIEV4Y2VwdGlvbiBGbG93cyJdDQogICAgTTIgLS0+IE0yQ1siUXVhbiBI4buHIFVzZSBDYXNlOiA8PGluY2x1ZGU+PiB2cyA8PGV4dGVuZD4+Il0NCg0KICAgIE0zIC0tPiBNM0FbIlN0YXRlIE1hY2hpbmUgRGlhZ3JhbSAoVHLhuqFuZyBUaMOhaSwgQ2h1eeG7g24gROG7i2NoLCBHdWFyZHMpIl0NCiAgICBNMyAtLT4gTTNCWyJTZXF1ZW5jZSBEaWFncmFtIChUxrDGoW5nIFTDoWMgVGhlbyBUcuG7pWMgVGjhu51pIEdpYW4pIl0NCiAgICBNMyAtLT4gTTNDWyJBY3Rpdml0eSBEaWFncmFtICYgQlBNTiAoUXV5IFRyw6xuaCBOZ2hp4buHcCBW4bulKSJdDQoNCiAgICBNNCAtLT4gTTRBWyJC4bqjbmcgUXV54bq/dCDEkOG7i25oIChEZWNpc2lvbiBUYWJsZXMgTWF0cml4KSJdDQogICAgTTQgLS0+IE00QlsiQ8OieSBRdXnhur90IMSQ4buLbmggKERlY2lzaW9uIFRyZWVzKSJdDQogICAgTTQgLS0+IE00Q1siUXV5IFThuq9jIE5naGnhu4dwIFbhu6UgVMaw4budbmcgTWluaCAoQnVzaW5lc3MgUnVsZXMpIl0NCmBgYA0KDQotLS0NCg0KIyMgMi4gQ2hpIHRp4bq/dCB04burbmcgS2V5d29yZCAoVW5kZXItdGhlLUhvb2QgRGVlcCBEaXZlKQ0KDQojIyMgMi4xLiBBZ2lsZSBNb2RlbGluZzogVXNlciBTdG9yeSwgVGVtcGxhdGUsIEFjY2VwdGFuY2UgQ3JpdGVyaWEgJiBVc2VyIEpvdXJuZXkNCg0KIyMjIyAxLiBN4bqrdSBVc2VyIFN0b3J5IENodeG6qW4gQ29ubmV4dHJhDQrEkMaw4bujYyDEkeG7i25oIGjDrG5oIGLhu59pIFJhY2hlbCBEYXZpZXMgdOG6oWkgQ29ubmV4dHJhIHbDoG8gbsSDbSAyMDAxLCDEkcOieSBsw6AgdGnDqnUgY2h14bqpbiB2w6BuZyBj4bunYSBBZ2lsZToNCiQkXHRleHRiZntBcyBhIH0gXGxhbmdsZVx0ZXh0e1JvbGUvUGVyc29uYX1ccmFuZ2xlLCBcOyBcdGV4dGJme0kgd2FudCB0byB9IFxsYW5nbGVcdGV4dHtBY3Rpb24vQ2FwYWJpbGl0eX1ccmFuZ2xlLCBcOyBcdGV4dGJme1NvIHRoYXQgfSBcbGFuZ2xlXHRleHR7QnVzaW5lc3MgVmFsdWUvQmVuZWZpdH1ccmFuZ2xlJCQNCi0gKipSb2xlKio6IFjDoWMgxJHhu4tuaCByw7UgYWkgbMOgIG5nxrDhu51pIGjGsOG7n25nIGzhu6NpIChraMO0bmcgYmFvIGdp4budIHZp4bq/dCBjaHVuZyBjaHVuZyBsw6AgIm5nxrDhu51pIGTDuW5nIiwgbcOgIHBo4bqjaSBsw6AgIktow6FjaCBow6BuZyBWSVAiLCAiTmjDom4gdmnDqm4gdGjhuqltIMSR4buLbmggdMOtbiBk4bulbmciKS4NCi0gKipBY3Rpb24qKjogTsSDbmcgbOG7sWMgcGjhuqduIG3hu4FtIGPhuqduIGN1bmcgY+G6pXAuDQotICoqQmVuZWZpdCoqOiBHacOhIHRy4buLIGtpbmggZG9hbmggdGjhu7FjIHPhu7EgbWFuZyBs4bqhaSAoTuG6v3Uga2jDtG5nIHRo4buDIGNo4buJIHJhIMSRxrDhu6NjIGdpw6EgdHLhu4sga2luaCBkb2FuaCwgdMOtbmggbsSDbmcgxJHDsyBraMO0bmcgeOG7qW5nIMSRw6FuZyDEkcaw4bujYyB2aeG6v3QgY29kZSEpLg0KDQojIyMjIDIuIFRpw6p1IENow60gQ2jhuqVwIE5o4bqtbiBDaHXhuqluIEdoZXJraW4gKEFjY2VwdGFuY2UgQ3JpdGVyaWEgLSBCREQpDQpDaHV54buDbiBow7NhIGPDonUgY2h1eeG7h24gdGjDoG5oIGLDoGkga2nhu4NtIHRo4butIHThu7EgxJHhu5luZyAoRXhlY3V0YWJsZSBTcGVjaWZpY2F0aW9uKSBi4bqxbmcgY8O6IHBow6FwICoqR2l2ZW4gLSBXaGVuIC0gVGhlbioqOg0KLSAqKkdpdmVuIChC4buRaSBj4bqjbmggYmFuIMSR4bqndSkqKjogVHLhuqFuZyB0aMOhaSBj4bunYSBo4buHIHRo4buRbmcgdHLGsOG7m2Mga2hpIGjDoG5oIMSR4buZbmcgZGnhu4VuIHJhLg0KLSAqKldoZW4gKEjDoG5oIMSR4buZbmcga8OtY2ggaG/huqF0KSoqOiBUaGFvIHTDoWMgY+G7p2EgbmfGsOG7nWkgZMO5bmcgaG/hurdjIHPhu7Ega2nhu4duIGLDqm4gbmdvw6BpLg0KLSAqKlRoZW4gKEvhur90IHF14bqjIG1vbmcgxJHhu6NpKSoqOiBUcuG6oW5nIHRow6FpIG3hu5tpIGPhu6dhIGjhu4cgdGjhu5FuZyB2w6AgY8OhYyBwaOG6o24gaOG7k2kgY8OzIHRo4buDIGtp4buDbSBjaOG7qW5nLg0KDQpgYGBnaGVya2luDQpTY2VuYXJpbzogUsO6dCB0aeG7gW4gQVRNIHRow6BuaCBjw7RuZyBraGkgc+G7kSBkxrAga2jhuqMgZOG7pW5nDQogIEdpdmVuIFTDoGkga2hv4bqjbiBj4bunYSAiQWxpY2UiIGPDsyBz4buRIGTGsCBsw6AgNTAwIFVTRA0KICAgIEFuZCBUaOG6uyBBVE0gY+G7p2EgIkFsaWNlIiDEkWFuZyBo4bujcCBs4buHDQogICBXaGVuICJBbGljZSIgecOqdSBj4bqndSByw7p0IDEwMCBVU0QgdOG7qyBjw6J5IEFUTQ0KICAgVGhlbiBDw6J5IEFUTSBwaOG6o2kgbmjhuqMgcmEgMTAwIFVTRCB0aeG7gW4gbeG6t3QNCiAgICBBbmQgU+G7kSBkxrAgdMOgaSBraG/huqNuIGPhu6dhICJBbGljZSIgcGjhuqNpIGPDsm4gbOG6oWkgNDAwIFVTRA0KICAgIEFuZCBI4buHIHRo4buRbmcgcGjhuqNpIGdoaSBt4buZdCBkw7JuZyBBdWRpdCBMb2cgZ2lhbyBk4buLY2gNCmBgYA0KDQotLS0NCg0KIyMjIDIuMi4gVXNlIENhc2UgTW9kZWxpbmc6IEFjdG9yLCBTY2VuYXJpb3MsIE1haW4sIEFsdGVybmF0aXZlICYgRXhjZXB0aW9uIEZsb3dzDQoNClBow6F0IG1pbmggYuG7n2kgSXZhciBKYWNvYnNvbiwgVXNlIENhc2UgbMOgIHBoxrDGoW5nIHBow6FwIG3DtCBow6xuaCBow7NhIGjGsOG7m25nIGNo4bupYyBuxINuZyBj4buxYyBr4buzIG3huqFuaCBt4bq9IGNobyBjw6FjIGjhu4cgdGjhu5FuZyBs4bubbjoNCg0KYGBgbWVybWFpZA0KZmxvd2NoYXJ0IFREDQogICAgQWN0b3JbIlTDoWMgTmjDom4gQ2jDrW5oIChQcmltYXJ5IEFjdG9yKTo8YnIvPktow6FjaCBIw6BuZyJdDQogICAgDQogICAgc3ViZ3JhcGggQm91bmRhcnkgWyJSYW5oIEdp4bubaSBI4buHIFRo4buRbmcgTmfDom4gSMOgbmcgKFN5c3RlbSBCb3VuZGFyeSkiXQ0KICAgICAgICBVQzFbIkNhIFPhu60gROG7pW5nIENow61uaDo8YnIvPlRoYW5oIFRvw6FuIMSQxqFuIEjDoG5nIl0NCiAgICAgICAgVUNfQXV0aFsiQ2EgU+G7rSBE4bulbmcgQ29uOjxici8+WMOhYyBUaOG7sWMgRGFuaCBUw61uaCBPVFAiXQ0KICAgICAgICBVQ19EaXNjb3VudFsiQ2EgU+G7rSBE4bulbmcgTeG7nyBS4buZbmc6PGJyLz7DgXAgTcOjIEdp4bqjbSBHacOhIl0NCiAgICBlbmQNCg0KICAgIEFjdG9yIC0tPiBVQzENCiAgICBVQzEgLS4tPnwiPDxpbmNsdWRlPj4gKELhuq90IGJ14buZYyBwaOG6o2kgY8OzKSJ8IFVDX0F1dGgNCiAgICBVQzEgLS4tPnwiPDxleHRlbmQ+PiAoVMO5eSBjaOG7jW4ga2hpIHRo4buPYSBtw6NuIMSRaeG7gXUga2nhu4duKSJ8IFVDX0Rpc2NvdW50DQpgYGANCg0KIyMjIyAxLiBQaMOibiBMb+G6oWkgVMOhYyBOaMOibiAoQWN0b3JzKQ0KLSAqKlByaW1hcnkgQWN0b3IqKjogTmfGsOG7nWkgdHLhu7FjIHRp4bq/cCBrw61jaCBob+G6oXQgVXNlIENhc2UgxJHhu4MgxJHhuqF0IMSRxrDhu6NjIG3hu6VjIHRpw6p1ICh2w60gZOG7pTogS2jDoWNoIGjDoG5nKS4NCi0gKipTZWNvbmRhcnkgLyBTdXBwb3J0aW5nIEFjdG9yKio6IEjhu4cgdGjhu5FuZyBwaOG7pSB0cuG7oyBjdW5nIGPhuqVwIGThu4tjaCB24bulIGNobyBVc2UgQ2FzZSAodsOtIGThu6U6IEPhu5VuZyB0aGFuaCB0b8OhbiBWSVNBLCBE4buLY2ggduG7pSBn4butaSBTTVMpLg0KDQojIyMjIDIuIEPhuqV1IFRyw7pjIEx14buTbmcgVGjhu7FjIFRoaSBD4bunYSBN4buZdCBVc2UgQ2FzZQ0KMS4gKipNYWluIFN1Y2Nlc3MgU2NlbmFyaW8gKEhhcHB5IFBhdGggLSBMdeG7k25nIHRow6BuaCBjw7RuZyBjaMOtbmgpKio6IENvbiDEkcaw4budbmcgbMO9IHTGsOG7n25nIGtoaSBt4buNaSB0aOG7qSBkaeG7hW4gcmEgdHLDtGkgY2jhuqN5LCBraMO0bmcgY8OzIGLhuqV0IGvhu7MgbOG7l2kgbsOgby4NCjIuICoqQWx0ZXJuYXRpdmUgRmxvd3MgKEx14buTbmcgdGhheSB0aOG6vykqKjogQ8OhYyBjb24gxJHGsOG7nW5nIGtow6FjIG5oYXUgY8WpbmcgZOG6q24gxJHhur9uIHRow6BuaCBjw7RuZyAodsOtIGThu6U6IFRoYXkgdsOsIHRy4bqjIGLhurFuZyB0aOG6uyB0w61uIGThu6VuZywgbmfGsOG7nWkgZMO5bmcgY2jhu41uIGNodXnhu4NuIGtob+G6o24gbmfDom4gaMOgbmcpLg0KMy4gKipFeGNlcHRpb24gRmxvd3MgKEx14buTbmcgbmdv4bqhaSBs4buHKSoqOiBDw6FjIHTDrG5oIGh14buRbmcgeOG6o3kgcmEgbOG7l2kga2hp4bq/biBt4bulYyB0acOqdSBraMO0bmcgdGjhu4MgaG/DoG4gdGjDoG5oICh2w60gZOG7pTogVGjhursgaOG6v3QgaOG6oW4sIHTDoGkga2hv4bqjbiBraMO0bmcgxJHhu6cgdGnhu4FuLCBo4buHIHRo4buRbmcgbmfDom4gaMOgbmcgYuG7iyB0aW1lb3V0KS4NCg0KIyMjIyAzLiBRdWFuIEjhu4cgYDw8aW5jbHVkZT4+YCB2cyBgPDxleHRlbmQ+PmANCi0gYDw8aW5jbHVkZT4+YDogSMOgbmggdmkgY29uICoqYuG6r3QgYnXhu5ljIHBo4bqjaSB0aOG7sWMgaGnhu4duKiogdHJvbmcgcXXDoSB0csOsbmggY2jhuqF5IFVzZSBDYXNlIGNoYSAoVsOtIGThu6U6IFRoYW5oIHRvw6FuIMSRxqFuIGjDoG5nIGLhuq90IGJ14buZYyBwaOG6o2kgYDw8aW5jbHVkZT4+YCBYw6FjIHRo4buxYyBPVFApLg0KLSBgPDxleHRlbmQ+PmA6IEjDoG5oIHZpIG3hu58gcuG7mW5nICoqY2jhu4kgxJHGsOG7o2Mga8OtY2ggaG/huqF0IGtoaSBjw7MgbeG7mXQgxJFp4buBdSBraeG7h24gY+G7pSB0aOG7gyAoRXh0ZW5zaW9uIFBvaW50KSoqIChWw60gZOG7pTogVGhhbmggdG/DoW4gxJHGoW4gaMOgbmcgY8OzIHRo4buDIMSRxrDhu6NjIGA8PGV4dGVuZD4+YCBi4bufaSDDgXAgZOG7pW5nIG3DoyBnaeG6o20gZ2nDoSBraGkga2jDoWNoIGjDoG5nIGPDsyB2b3VjaGVyKS4NCg0KLS0tDQoNCiMjIyAyLjMuIER5bmFtaWMgJiBCZWhhdmlvcmFsIE1vZGVsaW5nOiBTdGF0ZSBNYWNoaW5lICYgU2VxdWVuY2UgRGlhZ3JhbXMNCg0KVHJvbmcga+G7uSBuZ2jhu4cgQmFja2VuZCBwaMOibiB0w6FuLCBtw6Mgbmd14buTbiB0aMaw4budbmcgYuG7iyBs4buXaSBraGkgeOG7rSBsw70gY8OhYyBnaWFvIGThu4tjaCBjw7MgdsOybmcgxJHhu51pIHBo4bupYyB04bqhcCAobmjGsCDEkMahbiBow6BuZyB0aMawxqFuZyBt4bqhaSDEkWnhu4duIHThu60gaG/hurdjIEdpYW8gZOG7i2NoIG5nw6JuIGjDoG5nKS4gKipTdGF0ZSBNYWNoaW5lIERpYWdyYW0gKEJp4buDdSDEkeG7kyBNw6F5IHRy4bqhbmcgdGjDoWkpKiogbMOgIHbFqSBraMOtIHThu5FpIHRoxrDhu6NuZyDEkeG7gyBsb+G6oWkgYuG7jyBjw6FjIHRy4bqhbmcgdGjDoWkga2jDtG5nIGjhu6NwIGzhu4c6DQoNCmBgYG1lcm1haWQNCnN0YXRlRGlhZ3JhbS12Mg0KICAgIFsqXSAtLT4gUEVORElOR19QQVlNRU5UOiBU4bqhbyDEkcahbiBow6BuZyB0aMOgbmggY8O0bmcNCg0KICAgIFBFTkRJTkdfUEFZTUVOVCAtLT4gQVVUSE9SSVpFRDogQ+G7lW5nIHRoYW5oIHRvw6FuIGdp4buvIHRp4buBbiAoSG9sZCkNCiAgICBQRU5ESU5HX1BBWU1FTlQgLS0+IENBTkNFTExFRDogTmfGsOG7nWkgZMO5bmcgYuG6pW0gaOG7p3kgLyBUaW1lb3V0IDE1bQ0KDQogICAgQVVUSE9SSVpFRCAtLT4gQ0FQVFVSRUQ6IEtobyBow6BuZyB4w6FjIG5o4bqtbiB4deG6pXQga2hvIHRow6BuaCBjw7RuZw0KICAgIEFVVEhPUklaRUQgLS0+IFZPSURFRDogSOG6v3QgaMOgbmcgdHJvbmcga2hvIChIb8OgbiB0aeG7gW4gdOG7qWMgdGjDrCkNCg0KICAgIENBUFRVUkVEIC0tPiBSRUZVTkRFRDogS2jDoWNoIGjDoG5nIMSR4buVaSB0cuG6oyBow6BuZyB0cm9uZyA3IG5nw6B5DQogICAgQ0FQVFVSRUQgLS0+IENPTVBMRVRFRDogU2F1IDcgbmfDoHkgxJHGoW4gaMOgbmcgaG/DoG4gdOG6pXQgdsSpbmggdmnhu4VuDQoNCiAgICBDQU5DRUxMRUQgLS0+IFsqXQ0KICAgIFZPSURFRCAtLT4gWypdDQogICAgUkVGVU5ERUQgLS0+IFsqXQ0KICAgIENPTVBMRVRFRCAtLT4gWypdDQpgYGANCg0KLSAqKk5ndXnDqm4gVOG6r2MgQuG6pXQgQmnhur9uIChTdGF0ZSBJbnZhcmlhbnRzICYgR3VhcmQgQ29uZGl0aW9ucykqKjoNCiAgLSBN4buZdCDEkcahbiBow6BuZyDhu58gdHLhuqFuZyB0aMOhaSBgQ0FOQ0VMTEVEYCAqKnR1eeG7h3QgxJHhu5FpIGtow7RuZyBiYW8gZ2nhu50gxJHGsOG7o2MgcGjDqXAgY2h1eeG7g24gc2FuZyBgQ0FQVFVSRURgKiouDQogIC0gVmnhu4djIG3DtCBow6xuaCBow7NhIG3DoXkgdHLhuqFuZyB0aMOhaSBnacO6cCBs4bqtcCB0csOsbmggdmnDqm4gdmnhur90IGNvZGUgduG7m2kgY8OhYyBow6BtIGLhuqNvIHbhu4cgKFN0YXRlIEd1YXJkIC8gU3RhdGUgUGF0dGVybiksIG5nxINuIGNo4bq3biBob8OgbiB0b8OgbiBjw6FjIGzhu5dpIGdpYW4gbOG6rW4gaG/hurdjIHJhY2UgY29uZGl0aW9uIGtoaSBuaGnhu4F1IHdlYmhvb2sgZ+G7jWkgduG7gSBjw7luZyBsw7pjLg0KDQotLS0NCg0KIyMjIDIuNC4gTG9naWMgJiBSdWxlcyBNb2RlbGluZzogQnVzaW5lc3MgUnVsZXMgJiBEZWNpc2lvbiBUYWJsZXMNCg0KS2hpIG3hu5l0IGNow61uaCBzw6FjaCBraW5oIGRvYW5oIHBo4bulIHRodeG7mWMgdsOgbyBxdcOhIG5oaeG7gXUgxJFp4buBdSBraeG7h24ga+G6v3QgaOG7o3AgKHbDrSBk4bulOiBUaHXhuq10IHRvw6FuIGR1eeG7h3QgaOG7kyBzxqEgdmF5IHRp4buBbiBuZ8OibiBow6BuZyBob+G6t2MgdMOtbmggcGjDrSBi4bqjbyBoaeG7g20pLCB2aeG7h2Mgdmnhur90IGPDoWMga2jhu5FpIGzhu4duaCBgaWYtZWxzZWAgbOG7k25nIG5oYXUgbMOgIGPDtG5nIHRo4bupYyBk4bqrbiDEkeG6v24gdGjhuqNtIGjhu41hIGJ1ZzoNCg0KIyMjIyBNYSBUcuG6rW4gQuG6o25nIFF1eeG6v3QgxJDhu4tuaCAoRGVjaXNpb24gVGFibGUgTWF0cml4KQ0KDQp8IFRow6BuaCBQaOG6p24gS2jhuqNvIFPDoXQgfCBRdXkgVOG6r2MgMSAoUjEpIHwgUXV5IFThuq9jIDIgKFIyKSB8IFF1eSBU4bqvYyAzIChSMykgfCBRdXkgVOG6r2MgNCAoUjQpIHwNCnwgOi0tLSB8IDotLS06IHwgOi0tLTogfCA6LS0tOiB8IDotLS06IHwNCnwgKirEkGnhu4F1IGtp4buHbiAxOiDEkGnhu4NtIHTDrW4gZOG7pW5nICRcZ2UgNzAwJCoqIHwgKipZKiogfCAqKlkqKiB8ICoqTioqIHwgKipOKiogfA0KfCAqKsSQaeG7gXUga2nhu4duIDI6IFRodSBuaOG6rXAgJD4gMjAkIHRyaeG7h3UvdGjDoW5nKiogfCAqKlkqKiB8ICoqTioqIHwgKipZKiogfCAqKk4qKiB8DQp8ICoqxJBp4buBdSBraeG7h24gMzogQ8OzIHTDoGkgc+G6o24gdGjhur8gY2jhuqVwKiogfCAtIHwgKipZKiogfCAqKlkqKiB8ICoqTioqIHwNCnwgKipIw6BuaCDEkeG7mW5nIDE6IER1eeG7h3Qga2hv4bqjbiB2YXkgdOG7sSDEkeG7mW5nKiogfCAqKltYXSoqIHwgKipbWF0qKiB8IFsgXSB8IFsgXSB8DQp8ICoqSMOgbmggxJHhu5luZyAyOiBDaHV54buDbiBzYW5nIHRo4bqpbSDEkeG7i25oIHRo4bunIGPDtG5nKip8IFsgXSB8IFsgXSB8ICoqW1hdKiogfCBbIF0gfA0KfCAqKkjDoG5oIMSR4buZbmcgMzogVOG7qyBjaOG7kWkgaOG7kyBzxqEgbOG6rXAgdOG7qWMqKiB8IFsgXSB8IFsgXSB8IFsgXSB8ICoqW1hdKiogfA0KDQotIELhuqNuZyBxdXnhur90IMSR4buLbmggxJHhuqNtIGLhuqNvIGtp4buDbSB0cmEgxJHhuqd5IMSR4bunIHRvw6BuIGLhu5kgJDJeTiQgdOG7lSBo4bujcCDEkWnhu4F1IGtp4buHbiBjw7MgdGjhu4MgeOG6o3kgcmEsIGxv4bqhaSBi4buPIGhvw6BuIHRvw6BuIGPDoWMgdHLGsOG7nW5nIGjhu6NwIHPDs3QgKE1pc3NpbmcgZWRnZSBjYXNlcykgdHJvbmcgbcOjIG5ndeG7k24uDQoNCi0tLQ0KDQojIyAzLiBUaOG7sWMgdGhpIE3DoyBuZ3Xhu5NuICYgTcO0IHBo4buPbmcgQ2h1ecOqbiBzw6J1IChEdWFsLUVuZ2luZSBJbXBsZW1lbnRhdGlvbikNCg0KIyMjIDMuMS4gQysrMjAgQ2xlYW4gRGVjaXNpb24gVGFibGUgRW5naW5lIHZpYSBGdW5jdGlvbmFsIE1hcHBpbmcNCg0KQ2jGsMahbmcgdHLDrG5oIG1pbmggY2jhu6luZyBjw6FjaCB0aOG7qWMgdHJp4buDbiBraGFpIG3hu5l0ICoqQuG6o25nIFF1eeG6v3QgxJDhu4tuaCAoRGVjaXNpb24gVGFibGUpKiogY2h14bqpbiBt4buxYyBi4bqxbmcgQysrMjA6IEJp4buDdSBkaeG7hW4gY8OhYyDEkWnhu4F1IGtp4buHbiB2w6AgaMOgbmggxJHhu5luZyBkxrDhu5tpIGThuqFuZyBjw6FjIGjDoG0gdGh14bqnbiB0w7p5IChMYW1iZGFzKSwgdOG7sSDEkeG7mW5nIMSRw6FuaCBnacOhIG1hIHRy4bqtbiBxdXkgdOG6r2MgdsOgIHRo4buxYyB0aGkgaMOgbmggxJHhu5luZyB0xrDGoW5nIOG7qW5nOg0KDQpgYGBjcHANCi8vIGRlY2lzaW9uX3RhYmxlX2VuZ2luZS5jcHANCi8vIEJpw6puIGThu4tjaDogZysrIC1zdGQ9YysrMjAgLU8zIGRlY2lzaW9uX3RhYmxlX2VuZ2luZS5jcHAgLW8gZGVjaXNpb25fdGFibGVfZW5naW5lDQojaW5jbHVkZSA8aW9zdHJlYW0+DQojaW5jbHVkZSA8dmVjdG9yPg0KI2luY2x1ZGUgPHN0cmluZz4NCiNpbmNsdWRlIDxmdW5jdGlvbmFsPg0KI2luY2x1ZGUgPG9wdGlvbmFsPg0KDQpzdHJ1Y3QgTG9hbkFwcGxpY2F0aW9uIHsNCiAgICBzdGQ6OnN0cmluZyBhcHBsaWNhbnRfbmFtZTsNCiAgICBpbnQgY3JlZGl0X3Njb3JlOw0KICAgIGRvdWJsZSBtb250aGx5X2luY29tZTsNCiAgICBib29sIGhhc19jb2xsYXRlcmFsOw0KfTsNCg0KZW51bSBjbGFzcyBMb2FuRGVjaXNpb24gew0KICAgIEFVVE9fQVBQUk9WRUQsDQogICAgTUFOVUFMX1JFVklFVywNCiAgICBSRUpFQ1RFRA0KfTsNCg0KLy8gQ+G6pXUgdHLDumMgbeG7mXQgUnVsZSB0cm9uZyBEZWNpc2lvbiBUYWJsZQ0Kc3RydWN0IERlY2lzaW9uUnVsZSB7DQogICAgc3RkOjpzdHJpbmcgcnVsZV9uYW1lOw0KICAgIHN0ZDo6ZnVuY3Rpb248Ym9vbChjb25zdCBMb2FuQXBwbGljYXRpb24mKT4gY29uZGl0aW9uX3ByZWRpY2F0ZTsNCiAgICBMb2FuRGVjaXNpb24gYWN0aW9uX2RlY2lzaW9uOw0KfTsNCg0KY2xhc3MgTG9hbkRlY2lzaW9uVGFibGVFbmdpbmUgew0KcHJpdmF0ZToNCiAgICBzdGQ6OnZlY3RvcjxEZWNpc2lvblJ1bGU+IHJ1bGVzXzsNCg0KcHVibGljOg0KICAgIExvYW5EZWNpc2lvblRhYmxlRW5naW5lKCkgew0KICAgICAgICAvLyBSMTogxJBp4buDbSB0w61uIGThu6VuZyBjYW8gKD49NzAwKSB2w6AgVGh1IG5o4bqtcCB04buRdCAoPj0yME0pIC0+IER1eeG7h3QgdOG7sSDEkeG7mW5nDQogICAgICAgIHJ1bGVzXy5wdXNoX2JhY2soew0KICAgICAgICAgICAgIlIxOiDEkGnhu4NtIHTDrW4gZOG7pW5nIGNhbyAmIFRodSBuaOG6rXAgdOG7kXQiLA0KICAgICAgICAgICAgW10oY29uc3QgTG9hbkFwcGxpY2F0aW9uJiBhcHApIHsNCiAgICAgICAgICAgICAgICByZXR1cm4gYXBwLmNyZWRpdF9zY29yZSA+PSA3MDAgJiYgYXBwLm1vbnRobHlfaW5jb21lID49IDIwLjA7DQogICAgICAgICAgICB9LA0KICAgICAgICAgICAgTG9hbkRlY2lzaW9uOjpBVVRPX0FQUFJPVkVEDQogICAgICAgIH0pOw0KDQogICAgICAgIC8vIFIyOiDEkGnhu4NtIHTDrW4gZOG7pW5nIGNhbyAoPj03MDApIG5oxrBuZyB0aHUgbmjhuq1wIHRo4bqlcCwgY8OzIHTDoGkgc+G6o24gdGjhur8gY2jhuqVwIC0+IER1eeG7h3QgdOG7sSDEkeG7mW5nDQogICAgICAgIHJ1bGVzXy5wdXNoX2JhY2soew0KICAgICAgICAgICAgIlIyOiDEkGnhu4NtIGNhbywgY8OzIHTDoGkgc+G6o24gdGjhur8gY2jhuqVwIiwNCiAgICAgICAgICAgIFtdKGNvbnN0IExvYW5BcHBsaWNhdGlvbiYgYXBwKSB7DQogICAgICAgICAgICAgICAgcmV0dXJuIGFwcC5jcmVkaXRfc2NvcmUgPj0gNzAwICYmIGFwcC5tb250aGx5X2luY29tZSA8IDIwLjAgJiYgYXBwLmhhc19jb2xsYXRlcmFsOw0KICAgICAgICAgICAgfSwNCiAgICAgICAgICAgIExvYW5EZWNpc2lvbjo6QVVUT19BUFBST1ZFRA0KICAgICAgICB9KTsNCg0KICAgICAgICAvLyBSMzogxJBp4buDbSB0aOG6pXAgKDw3MDApIG5oxrBuZyB0aHUgbmjhuq1wIHThu5F0IHbDoCBjw7MgdMOgaSBz4bqjbiAtPiBUaOG6qW0gxJHhu4tuaCB0aOG7pyBjw7RuZw0KICAgICAgICBydWxlc18ucHVzaF9iYWNrKHsNCiAgICAgICAgICAgICJSMzogxJBp4buDbSB0aOG6pXAsIHRodSBuaOG6rXAgdOG7kXQgJiBjw7MgdGjhur8gY2jhuqVwIiwNCiAgICAgICAgICAgIFtdKGNvbnN0IExvYW5BcHBsaWNhdGlvbiYgYXBwKSB7DQogICAgICAgICAgICAgICAgcmV0dXJuIGFwcC5jcmVkaXRfc2NvcmUgPCA3MDAgJiYgYXBwLm1vbnRobHlfaW5jb21lID49IDIwLjAgJiYgYXBwLmhhc19jb2xsYXRlcmFsOw0KICAgICAgICAgICAgfSwNCiAgICAgICAgICAgIExvYW5EZWNpc2lvbjo6TUFOVUFMX1JFVklFVw0KICAgICAgICB9KTsNCg0KICAgICAgICAvLyBSNDogTeG6t2MgxJHhu4tuaCBjw7JuIGzhuqFpIC0+IFThu6sgY2jhu5FpDQogICAgICAgIHJ1bGVzXy5wdXNoX2JhY2soew0KICAgICAgICAgICAgIlI0OiBLaMO0bmcgxJHhu6cgxJFp4buBdSBraeG7h24gYW4gdG/DoG4iLA0KICAgICAgICAgICAgW10oY29uc3QgTG9hbkFwcGxpY2F0aW9uJikgeyByZXR1cm4gdHJ1ZTsgfSwgLy8gRmFsbGJhY2sgcnVsZQ0KICAgICAgICAgICAgTG9hbkRlY2lzaW9uOjpSRUpFQ1RFRA0KICAgICAgICB9KTsNCiAgICB9DQoNCiAgICB2b2lkIGV2YWx1YXRlKGNvbnN0IExvYW5BcHBsaWNhdGlvbiYgYXBwKSB7DQogICAgICAgIHN0ZDo6Y291dCA8PCAiW0jhu5IgU8agIEtIw4FDSCBIw4BOR106ICIgPDwgYXBwLmFwcGxpY2FudF9uYW1lIA0KICAgICAgICAgICAgICAgICAgPDwgIiAoxJBp4buDbTogIiA8PCBhcHAuY3JlZGl0X3Njb3JlIA0KICAgICAgICAgICAgICAgICAgPDwgIiwgVGh1IG5o4bqtcDogIiA8PCBhcHAubW9udGhseV9pbmNvbWUgDQogICAgICAgICAgICAgICAgICA8PCAiTSwgVGjhur8gY2jhuqVwOiAiIDw8IChhcHAuaGFzX2NvbGxhdGVyYWwgPyAiQ8OTIiA6ICJLSMOUTkciKSA8PCAiKVxuIjsNCg0KICAgICAgICBmb3IgKGNvbnN0IGF1dG8mIHJ1bGUgOiBydWxlc18pIHsNCiAgICAgICAgICAgIGlmIChydWxlLmNvbmRpdGlvbl9wcmVkaWNhdGUoYXBwKSkgew0KICAgICAgICAgICAgICAgIHN0ZDo6Y291dCA8PCAiICAtPiBLaOG7m3AgUXV5IFThuq9jOiBbIiA8PCBydWxlLnJ1bGVfbmFtZSA8PCAiXVxuIjsNCiAgICAgICAgICAgICAgICBzdGQ6OmNvdXQgPDwgIiAgPj4+IFFVWeG6vlQgxJDhu4pOSCBDVeG7kEkgQ8OZTkc6ICI7DQogICAgICAgICAgICAgICAgc3dpdGNoIChydWxlLmFjdGlvbl9kZWNpc2lvbikgew0KICAgICAgICAgICAgICAgICAgICBjYXNlIExvYW5EZWNpc2lvbjo6QVVUT19BUFBST1ZFRDoNCiAgICAgICAgICAgICAgICAgICAgICAgIHN0ZDo6Y291dCA8PCAiRFVZ4buGVCBU4buwIMSQ4buYTkcgKExPQU4gQVBQUk9WRUQpIVxuXG4iOw0KICAgICAgICAgICAgICAgICAgICAgICAgYnJlYWs7DQogICAgICAgICAgICAgICAgICAgIGNhc2UgTG9hbkRlY2lzaW9uOjpNQU5VQUxfUkVWSUVXOg0KICAgICAgICAgICAgICAgICAgICAgICAgc3RkOjpjb3V0IDw8ICJDSFVZ4buCTiBUSOG6qE0gxJDhu4pOSCBUSOG7piBDw5RORyAoTUFOVUFMIFJFVklFVykhXG5cbiI7DQogICAgICAgICAgICAgICAgICAgICAgICBicmVhazsNCiAgICAgICAgICAgICAgICAgICAgY2FzZSBMb2FuRGVjaXNpb246OlJFSkVDVEVEOg0KICAgICAgICAgICAgICAgICAgICAgICAgc3RkOjpjb3V0IDw8ICJU4buqIENI4buQSSBI4buSIFPGoCAoQVBQTElDQVRJT04gUkVKRUNURUQpIVxuXG4iOw0KICAgICAgICAgICAgICAgICAgICAgICAgYnJlYWs7DQogICAgICAgICAgICAgICAgfQ0KICAgICAgICAgICAgICAgIHJldHVybjsNCiAgICAgICAgICAgIH0NCiAgICAgICAgfQ0KICAgIH0NCn07DQoNCmludCBtYWluKCkgew0KICAgIHN0ZDo6Y291dCA8PCAiPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cbiI7DQogICAgc3RkOjpjb3V0IDw8ICIgICAgICAgICAgQysrMjAgUkVRVUlSRU1FTlRTIExPR0lDIERFQ0lTSU9OIFRBQkxFIEVOR0lORSAgICAgICAgICAgICAgIFxuIjsNCiAgICBzdGQ6OmNvdXQgPDwgIj09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG5cbiI7DQoNCiAgICBMb2FuRGVjaXNpb25UYWJsZUVuZ2luZSBlbmdpbmU7DQoNCiAgICBlbmdpbmUuZXZhbHVhdGUoeyJBbGljZSBOZ3V5ZW4iLCA3NTAsIDM1LjAsIGZhbHNlfSk7IC8vIEto4bubcCBSMQ0KICAgIGVuZ2luZS5ldmFsdWF0ZSh7IkJvYiBUcmFuIiwgICAgIDcyMCwgMTUuMCwgdHJ1ZX0pOyAgLy8gS2jhu5twIFIyDQogICAgZW5naW5lLmV2YWx1YXRlKHsiQ2hhcmxpZSBMZSIsICAgNjIwLCAyNS4wLCB0cnVlfSk7ICAvLyBLaOG7m3AgUjMNCiAgICBlbmdpbmUuZXZhbHVhdGUoeyJEYXZpZCBQaGFtIiwgICA1ODAsIDEwLjAsIGZhbHNlfSk7IC8vIEto4bubcCBSNA0KDQogICAgcmV0dXJuIDA7DQp9DQpgYGANCg0KIyMjIyBUZXJtaW5hbCBPdXRwdXQgTeG6q3U6DQpgYGB0ZXh0DQo9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KICAgICAgICAgIEMrKzIwIFJFUVVJUkVNRU5UUyBMT0dJQyBERUNJU0lPTiBUQUJMRSBFTkdJTkUgICAgICAgICAgICAgICANCj09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQoNCltI4buSIFPGoCBLSMOBQ0ggSMOATkddOiBBbGljZSBOZ3V5ZW4gKMSQaeG7g206IDc1MCwgVGh1IG5o4bqtcDogMzVNLCBUaOG6vyBjaOG6pXA6IEtIw5RORykNCiAgLT4gS2jhu5twIFF1eSBU4bqvYzogW1IxOiDEkGnhu4NtIHTDrW4gZOG7pW5nIGNhbyAmIFRodSBuaOG6rXAgdOG7kXRdDQogID4+PiBRVVnhur5UIMSQ4buKTkggQ1Xhu5BJIEPDmU5HOiBEVVnhu4ZUIFThu7AgxJDhu5hORyAoTE9BTiBBUFBST1ZFRCkhDQoNCltI4buSIFPGoCBLSMOBQ0ggSMOATkddOiBCb2IgVHJhbiAoxJBp4buDbTogNzIwLCBUaHUgbmjhuq1wOiAxNU0sIFRo4bq/IGNo4bqlcDogQ8OTKQ0KICAtPiBLaOG7m3AgUXV5IFThuq9jOiBbUjI6IMSQaeG7g20gY2FvLCBjw7MgdMOgaSBz4bqjbiB0aOG6vyBjaOG6pXBdDQogID4+PiBRVVnhur5UIMSQ4buKTkggQ1Xhu5BJIEPDmU5HOiBEVVnhu4ZUIFThu7AgxJDhu5hORyAoTE9BTiBBUFBST1ZFRCkhDQoNCltI4buSIFPGoCBLSMOBQ0ggSMOATkddOiBDaGFybGllIExlICjEkGnhu4NtOiA2MjAsIFRodSBuaOG6rXA6IDI1TSwgVGjhur8gY2jhuqVwOiBDw5MpDQogIC0+IEto4bubcCBRdXkgVOG6r2M6IFtSMzogxJBp4buDbSB0aOG6pXAsIHRodSBuaOG6rXAgdOG7kXQgJiBjw7MgdGjhur8gY2jhuqVwXQ0KICA+Pj4gUVVZ4bq+VCDEkOG7ik5IIENV4buQSSBDw5lORzogQ0hVWeG7gk4gVEjhuqhNIMSQ4buKTkggVEjhu6YgQ8OUTkcgKE1BTlVBTCBSRVZJRVcpIQ0KDQpbSOG7kiBTxqAgS0jDgUNIIEjDgE5HXTogRGF2aWQgUGhhbSAoxJBp4buDbTogNTgwLCBUaHUgbmjhuq1wOiAxME0sIFRo4bq/IGNo4bqlcDogS0jDlE5HKQ0KICAtPiBLaOG7m3AgUXV5IFThuq9jOiBbUjQ6IEtow7RuZyDEkeG7pyDEkWnhu4F1IGtp4buHbiBhbiB0b8Ogbl0NCiAgPj4+IFFVWeG6vlQgxJDhu4pOSCBDVeG7kEkgQ8OZTkc6IFThu6ogQ0jhu5BJIEjhu5IgU8agIChBUFBMSUNBVElPTiBSRUpFQ1RFRCkhDQpgYGANCg0KLS0tDQoNCiMjIyAzLjIuIFB5dGhvbiAzLjExKyBPcmRlciBTdGF0ZSBNYWNoaW5lICYgQkREIEFjY2VwdGFuY2UgVGVzdCBTaW11bGF0b3INCg0KQ2jGsMahbmcgdHLDrG5oIG1pbmggY2jhu6luZyBjw6FjaCB0cmnhu4NuIGtoYWkgKipNw6F5IHRy4bqhbmcgdGjDoWkgxJHGoW4gaMOgbmcgKE9yZGVyIFN0YXRlIE1hY2hpbmUpKiogduG7m2kgY8OhYyDEkWnhu4F1IGtp4buHbiBjaHV54buDbiBk4buLY2ggbmdoacOqbSBuZ+G6t3QgKFRyYW5zaXRpb24gR3VhcmRzKSB2w6Aga2nhu4NtIGNo4bupbmcgdOG7sSDEkeG7mW5nIHRoZW8gcGhvbmcgY8OhY2ggKipCREQgQWNjZXB0YW5jZSBDcml0ZXJpYSoqOg0KDQpgYGBweXRob24NCiMhL3Vzci9iaW4vZW52IHB5dGhvbjMNCiIiIg0Kb3JkZXJfc3RhdGVfbWFjaGluZV9iZGQucHkNCk3DtCBwaOG7j25nIE3DoXkgVHLhuqFuZyBUaMOhaSDEkMahbiBIw6BuZyAoU3RhdGUgTWFjaGluZSkgJiBLaeG7g20gVGjhu60gQ2jhuqVwIE5o4bqtbiBCREQgR2hlcmtpbg0KIiIiDQpmcm9tIGVudW0gaW1wb3J0IEVudW0NCmZyb20gZGF0YWNsYXNzZXMgaW1wb3J0IGRhdGFjbGFzcw0KZnJvbSB0eXBpbmcgaW1wb3J0IE9wdGlvbmFsDQoNCmNsYXNzIE9yZGVyU3RhdGUoRW51bSk6DQogICAgUEVORElOR19QQVlNRU5UID0gIlBFTkRJTkdfUEFZTUVOVCINCiAgICBBVVRIT1JJWkVEID0gIkFVVEhPUklaRUQiDQogICAgQ0FQVFVSRUQgPSAiQ0FQVFVSRUQiDQogICAgQ0FOQ0VMTEVEID0gIkNBTkNFTExFRCINCiAgICBSRUZVTkRFRCA9ICJSRUZVTkRFRCINCg0KY2xhc3MgSW52YWxpZFN0YXRlVHJhbnNpdGlvbkVycm9yKEV4Y2VwdGlvbik6DQogICAgcGFzcw0KDQpjbGFzcyBPcmRlclN0YXRlTWFjaGluZToNCiAgICBkZWYgX19pbml0X18oc2VsZiwgb3JkZXJfaWQ6IHN0ciwgdG90YWxfYW1vdW50OiBmbG9hdCk6DQogICAgICAgIHNlbGYub3JkZXJfaWQgPSBvcmRlcl9pZA0KICAgICAgICBzZWxmLnRvdGFsX2Ftb3VudCA9IHRvdGFsX2Ftb3VudA0KICAgICAgICBzZWxmLmN1cnJlbnRfc3RhdGUgPSBPcmRlclN0YXRlLlBFTkRJTkdfUEFZTUVOVA0KDQogICAgZGVmIGF1dGhvcml6ZV9wYXltZW50KHNlbGYsIGhvbGRfYW1vdW50OiBmbG9hdCk6DQogICAgICAgICMgQkREIFJ1bGU6IENo4buJIGNobyBwaMOpcCBBdXRob3JpemUga2hpIMSRYW5nIOG7nyBQRU5ESU5HX1BBWU1FTlQNCiAgICAgICAgaWYgc2VsZi5jdXJyZW50X3N0YXRlICE9IE9yZGVyU3RhdGUuUEVORElOR19QQVlNRU5UOg0KICAgICAgICAgICAgcmFpc2UgSW52YWxpZFN0YXRlVHJhbnNpdGlvbkVycm9yKGYiS2jDtG5nIHRo4buDIEF1dGhvcml6ZSDEkcahbiBow6BuZyDEkWFuZyDhu58gdHLhuqFuZyB0aMOhaSB7c2VsZi5jdXJyZW50X3N0YXRlLnZhbHVlfSEiKQ0KICAgICAgICBpZiBob2xkX2Ftb3VudCA8IHNlbGYudG90YWxfYW1vdW50Og0KICAgICAgICAgICAgcmFpc2UgVmFsdWVFcnJvcigiU+G7kSB0aeG7gW4gcGhvbmcgdOG7j2Ega2jDtG5nIMSR4bunIMSR4buDIHRoYW5oIHRvw6FuIMSRxqFuIGjDoG5nISIpDQogICAgICAgIA0KICAgICAgICBzZWxmLmN1cnJlbnRfc3RhdGUgPSBPcmRlclN0YXRlLkFVVEhPUklaRUQNCiAgICAgICAgcHJpbnQoZiIgIFtTVEFURSBDSEFOR0VdIE9yZGVyIHtzZWxmLm9yZGVyX2lkfTogUEVORElOR19QQVlNRU5UIC0+IEFVVEhPUklaRUQgKEhvbGQgJHtob2xkX2Ftb3VudH0pIikNCg0KICAgIGRlZiBjYXB0dXJlKHNlbGYpOg0KICAgICAgICAjIEJERCBSdWxlOiBDaOG7iSBjaG8gcGjDqXAgQ2FwdHVyZSBraGkgxJHDoyBBVVRIT1JJWkVEDQogICAgICAgIGlmIHNlbGYuY3VycmVudF9zdGF0ZSAhPSBPcmRlclN0YXRlLkFVVEhPUklaRUQ6DQogICAgICAgICAgICByYWlzZSBJbnZhbGlkU3RhdGVUcmFuc2l0aW9uRXJyb3IoZiJLaMO0bmcgdGjhu4MgQ2FwdHVyZSDEkcahbiBow6BuZyBraGkgY2jGsGEgxJHGsOG7o2MgQXV0aG9yaXplIChUcuG6oW5nIHRow6FpOiB7c2VsZi5jdXJyZW50X3N0YXRlLnZhbHVlfSkhIikNCiAgICAgICAgDQogICAgICAgIHNlbGYuY3VycmVudF9zdGF0ZSA9IE9yZGVyU3RhdGUuQ0FQVFVSRUQNCiAgICAgICAgcHJpbnQoZiIgIFtTVEFURSBDSEFOR0VdIE9yZGVyIHtzZWxmLm9yZGVyX2lkfTogQVVUSE9SSVpFRCAtPiBDQVBUVVJFRCAoVGnhu4FuIMSRw6MgdsOgbyB0w6BpIGtob+G6o24gY+G7rWEgaMOgbmcpIikNCg0KICAgIGRlZiBjYW5jZWwoc2VsZik6DQogICAgICAgICMgQkREIFJ1bGU6IEtow7RuZyB0aOG7gyBDYW5jZWwgbeG7mXQgxJHGoW4gaMOgbmcgxJHDoyBDYXB0dXJlIHRp4buBbg0KICAgICAgICBpZiBzZWxmLmN1cnJlbnRfc3RhdGUgaW4gW09yZGVyU3RhdGUuQ0FQVFVSRUQsIE9yZGVyU3RhdGUuUkVGVU5ERURdOg0KICAgICAgICAgICAgcmFpc2UgSW52YWxpZFN0YXRlVHJhbnNpdGlvbkVycm9yKGYixJDGoW4gaMOgbmcgxJHDoyB0aGFuaCB0b8OhbiB4b25nICh7c2VsZi5jdXJyZW50X3N0YXRlLnZhbHVlfSksIGLhuq90IGJ14buZYyBwaOG6o2kgcXVhIHF1eSB0csOsbmggUkVGVU5EISIpDQogICAgICAgIA0KICAgICAgICBzZWxmLmN1cnJlbnRfc3RhdGUgPSBPcmRlclN0YXRlLkNBTkNFTExFRA0KICAgICAgICBwcmludChmIiAgW1NUQVRFIENIQU5HRV0gT3JkZXIge3NlbGYub3JkZXJfaWR9OiAtPiBDQU5DRUxMRUQgKMSQw6MgaOG7p3kgxJHGoW4gaMOgbmcpIikNCg0KZGVmIHJ1bl9iZGRfYWNjZXB0YW5jZV90ZXN0cygpOg0KICAgIHByaW50KCI9IiAqIDgwKQ0KICAgIHByaW50KCIgICAgICBLSeG7gk0gVEjhu6wgQ0jhuqRQIE5I4bqsTiBCREQ6IFFVWSBDSFXhuqhOIE3DgVkgVFLhuqBORyBUSMOBSSDEkMagTiBIw4BORyAgICAgICAiKQ0KICAgIHByaW50KCI9IiAqIDgwKQ0KDQogICAgIyBL4buLY2ggYuG6o24gMTogSGFwcHkgUGF0aA0KICAgIHByaW50KCJcbltL4buKQ0ggQuG6ok4gMTogR2lhbyBk4buLY2ggdGjDoG5oIGPDtG5nIHRy4buNbiB24bq5biAoSGFwcHkgUGF0aCldIikNCiAgICBvcmRlcjEgPSBPcmRlclN0YXRlTWFjaGluZSgiT1JELTAwMSIsIDEwMC4wKQ0KICAgIG9yZGVyMS5hdXRob3JpemVfcGF5bWVudCgxMDAuMCkNCiAgICBvcmRlcjEuY2FwdHVyZSgpDQogICAgYXNzZXJ0IG9yZGVyMS5jdXJyZW50X3N0YXRlID09IE9yZGVyU3RhdGUuQ0FQVFVSRUQNCiAgICBwcmludCgiPj4+IEvhu4pDSCBC4bqiTiAxOiDEkOG6oFQgQ0hV4bqoTiAoUEFTU0VEKSIpDQoNCiAgICAjIEvhu4tjaCBi4bqjbiAyOiBWaSBwaOG6oW0gU3RhdGUgVHJhbnNpdGlvbiAoQ+G7kSB0w6xuaCBo4buneSDEkcahbiBow6BuZyDEkcOjIENhcHR1cmUpDQogICAgcHJpbnQoIlxuW0vhu4pDSCBC4bqiTiAyOiBUaOG7rSBuZ2hp4buHbSB2aSBwaOG6oW0gbG9naWMgY2h1eeG7g24gZOG7i2NoIHRy4bqhbmcgdGjDoWldIikNCiAgICBvcmRlcjIgPSBPcmRlclN0YXRlTWFjaGluZSgiT1JELTAwMiIsIDIwMC4wKQ0KICAgIG9yZGVyMi5hdXRob3JpemVfcGF5bWVudCgyMDAuMCkNCiAgICBvcmRlcjIuY2FwdHVyZSgpDQoNCiAgICB0cnk6DQogICAgICAgIHByaW50KCIgIFRo4buxYyBoaeG7h24gdGhhbyB0w6FjIGLhuqV0IGjhu6NwIHBow6FwOiBD4buRIHTDrG5oIENhbmNlbCDEkcahbiBow6BuZyDEkcOjIENhcHR1cmUuLi4iKQ0KICAgICAgICBvcmRlcjIuY2FuY2VsKCkNCiAgICBleGNlcHQgSW52YWxpZFN0YXRlVHJhbnNpdGlvbkVycm9yIGFzIGV4Og0KICAgICAgICBwcmludChmIiAgLT4gW0Lhuq5UIE5HT+G6oEkgTOG7hiBI4buiUCBM4buGXToge2V4fSIpDQogICAgICAgIHByaW50KCI+Pj4gS+G7ikNIIELhuqJOIDI6IELhuqJPIFbhu4YgVFLhuqBORyBUSMOBSSBBTiBUT8OATiAxMDAlIChQQVNTRUQpIikNCg0KICAgIHByaW50KCJcbiIgKyAiPSIgKiA4MCkNCg0KaWYgX19uYW1lX18gPT0gIl9fbWFpbl9fIjoNCiAgICBydW5fYmRkX2FjY2VwdGFuY2VfdGVzdHMoKQ0KYGBgDQoNCiMjIyMgVGVybWluYWwgT3V0cHV0IE3huqt1Og0KYGBgdGV4dA0KPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0NCiAgICAgIEtJ4buCTSBUSOG7rCBDSOG6pFAgTkjhuqxOIEJERDogUVVZIENIVeG6qE4gTcOBWSBUUuG6oE5HIFRIw4FJIMSQxqBOIEjDgE5HICAgICAgIA0KPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0NCg0KW0vhu4pDSCBC4bqiTiAxOiBHaWFvIGThu4tjaCB0aMOgbmggY8O0bmcgdHLhu41uIHbhurluIChIYXBweSBQYXRoKV0NCiAgW1NUQVRFIENIQU5HRV0gT3JkZXIgT1JELTAwMTogUEVORElOR19QQVlNRU5UIC0+IEFVVEhPUklaRUQgKEhvbGQgJDEwMC4wKQ0KICBbU1RBVEUgQ0hBTkdFXSBPcmRlciBPUkQtMDAxOiBBVVRIT1JJWkVEIC0+IENBUFRVUkVEIChUaeG7gW4gxJHDoyB2w6BvIHTDoGkga2hv4bqjbiBj4butYSBow6BuZykNCj4+PiBL4buKQ0ggQuG6ok4gMTogxJDhuqBUIENIVeG6qE4gKFBBU1NFRCkNCg0KW0vhu4pDSCBC4bqiTiAyOiBUaOG7rSBuZ2hp4buHbSB2aSBwaOG6oW0gbG9naWMgY2h1eeG7g24gZOG7i2NoIHRy4bqhbmcgdGjDoWldDQogIFtTVEFURSBDSEFOR0VdIE9yZGVyIE9SRC0wMDI6IFBFTkRJTkdfUEFZTUVOVCAtPiBBVVRIT1JJWkVEIChIb2xkICQyMDAuMCkNCiAgW1NUQVRFIENIQU5HRV0gT3JkZXIgT1JELTAwMjogQVVUSE9SSVpFRCAtPiBDQVBUVVJFRCAoVGnhu4FuIMSRw6MgdsOgbyB0w6BpIGtob+G6o24gY+G7rWEgaMOgbmcpDQogIFRo4buxYyBoaeG7h24gdGhhbyB0w6FjIGLhuqV0IGjhu6NwIHBow6FwOiBD4buRIHTDrG5oIENhbmNlbCDEkcahbiBow6BuZyDEkcOjIENhcHR1cmUuLi4NCiAgLT4gW0Lhuq5UIE5HT+G6oEkgTOG7hiBI4buiUCBM4buGXTogxJDGoW4gaMOgbmcgxJHDoyB0aGFuaCB0b8OhbiB4b25nIChDQVBUVVJFRCksIGLhuq90IGJ14buZYyBwaOG6o2kgcXVhIHF1eSB0csOsbmggUkVGVU5EIQ0KPj4+IEvhu4pDSCBC4bqiTiAyOiBC4bqiTyBW4buGIFRS4bqgTkcgVEjDgUkgQU4gVE/DgE4gMTAwJSAoUEFTU0VEKQ0KDQo9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KYGBgDQoNCi0tLQ0KDQojIyA0LiBTeXN0ZW1zIEVuZ2luZWVyaW5nICYgUHJvZHVjdGlvbiBQaXRmYWxscw0KDQojIyMgNC4xLiBD4bqhbSBC4bqreSBUaOG7sWMgQ2hp4bq/biBUaMaw4budbmcgR+G6t3AgKFByb2R1Y3Rpb24gUGl0ZmFsbHMpDQoNCiMjIyMgMS4gU+G7sSBD4buRICJNaXNzaW5nIEVkZ2UgQ2FzZSBFeHBsb3Npb24iIERvIFZp4bq/dCBgaWYtZWxzZWAgVOG7sSBQaMOhdA0KLSAqKkhp4buHbiB0xrDhu6NuZyoqOiBN4buZdCB0w61uaCBuxINuZyB0w61uaCBwaMOtIGLhuqNvIGhp4buDbSBjw7MgNCDEkWnhu4F1IGtp4buHbiDEkeG6p3UgdsOgby4gTOG6rXAgdHLDrG5oIHZpw6puIHZp4bq/dCBjw6FjIGto4buRaSBgaWZgIGzhu5NuZyBuaGF1IHbDoCBjaOG7iSBiYW8gcXXDoXQgNSB0csaw4budbmcgaOG7o3AuDQotICoqSOG6rXUgcXXhuqMqKjogS2hpIG3hu5l0IGtow6FjaCBow6BuZyBjw7MgdOG7lSBo4bujcCDEkWnhu4F1IGtp4buHbiB0aOG7qSA2IHh14bqldCBoaeG7h24gdHLDqm4gUHJvZHVjdGlvbiwgaOG7hyB0aOG7kW5nIHLGoWkgdsOgbyBuaMOhbmggYGVsc2VgIG3hurdjIMSR4buLbmggdsOgIHTDrW5oIGdpw6EgYuG6o28gaGnhu4NtIGLhurFuZyBcJDAsIGfDonkgdGjhuqV0IHRob8OhdCBow6BuZyB0csSDbSBuZ2jDrG4gVVNEIQ0KLSAqKkdp4bqjaSBwaMOhcCoqOiBC4bqvdCBideG7mWMgduG6vSAqKkRlY2lzaW9uIFRhYmxlKiogdHLGsOG7m2Mga2hpIGfDtSBjb2RlLiBC4bqjbmcgcXV54bq/dCDEkeG7i25oIGLhuq90IGJ14buZYyBs4bqtcCB0csOsbmggdmnDqm4gcGjhuqNpIMSR4buLbmggbmdoxKlhIGjDoG5oIHZpIGNobyDEkeG6p3kgxJHhu6cgJDJeNCA9IDE2JCB0csaw4budbmcgaOG7o3AuDQoNCiMjIyMgMi4gVGjhuqNtIEjhu41hICJTdGF0ZSBNYWNoaW5lIFJhY2UgQ29uZGl0aW9ucyIgVHJvbmcgSOG7hyBUaOG7kW5nIFBow6JuIFTDoW4NCi0gKipIaeG7h24gdMaw4bujbmcqKjogSGFpIFdlYmhvb2sgdOG7qyBj4buVbmcgdGhhbmggdG/DoW4gZ+G7rWkgduG7gSBn4bqnbiBuaMawIGPDuW5nIG3hu5l0IHTDrWNoIHThuq9jOiBXZWJob29rIDEgYsOhbyBgUGF5bWVudFN1Y2NlZWRlZGAsIFdlYmhvb2sgMiBiw6FvIGBQYXltZW50Q2FuY2VsbGVkYCBkbyBuZ8aw4budaSBkw7luZyB0aGFvIHTDoWMgbmhhbmguDQotICoqSOG6rXUgcXXhuqMqKjogTuG6v3Uga2jDtG5nIGPDsyBjxqEgY2jhur8ga2jDs2EgbOG6oWMgcXVhbiAoT3B0aW1pc3RpYyBMb2NraW5nIHZpYSBWZXJzaW9uKSBob+G6t2MgU3RhdGUgTWFjaGluZSBi4bqjbyB24buHLCB0cuG6oW5nIHRow6FpIGPhu6dhIMSRxqFuIGjDoG5nIGPDsyB0aOG7gyBi4buLIG5o4bqjeSBsw7lpIHThu6sgYENPTVBMRVRFRGAgduG7gSBgQ0FOQ0VMTEVEYC4NCi0gKipHaeG6o2kgcGjDoXAqKjogVGhp4bq/dCBr4bq/IGLhuqNuZyBEYXRhYmFzZSB24bubaSByw6BuZyBideG7mWMgdHLhuqFuZyB0aMOhaSBob+G6t2Mga2nhu4NtIHRyYSB2ZXJzaW9uOg0KICBgYGBzcWwNCiAgVVBEQVRFIG9yZGVycyBTRVQgc3RhdHVzID0gJ0NBUFRVUkVEJywgdmVyc2lvbiA9IHZlcnNpb24gKyAxIA0KICBXSEVSRSBpZCA9IDEwMSBBTkQgc3RhdHVzID0gJ0FVVEhPUklaRUQnIEFORCB2ZXJzaW9uID0gMjsNCiAgYGBgDQoNCiMjIyMgMy4gQuG6q3kgQmnhur9uIFNlcXVlbmNlIERpYWdyYW0gVGjDoG5oICJWxINuIELhuqNuIELhuqV0IERpIELhuqV0IEThu4tjaCINCi0gKipIaeG7h24gdMaw4bujbmcqKjogxJDhu5lpIG5nxakgduG6vSBt4buZdCBTZXF1ZW5jZSBEaWFncmFtIGNoaSB0aeG6v3QgxJHhur9uIHThu6tuZyB0w6puIGjDoG0gcmnDqm5nIHTGsCAoUHJpdmF0ZSBtZXRob2RzKSB2w6AgdOG7q25nIGJp4bq/biBu4buZaSB04bqhaS4NCi0gKipI4bqtdSBxdeG6oyoqOiBN4buXaSBraGkgbOG6rXAgdHLDrG5oIHZpw6puIMSR4buVaSB0w6puIG3hu5l0IGjDoG0gY29uLCB0w6BpIGxp4buHdSBraeG6v24gdHLDumMgbOG6rXAgdOG7qWMgYuG7iyBs4buXaSB0aOG7nWkgKE91dGRhdGVkKS4NCi0gKipHaeG6o2kgcGjDoXAqKjogU2VxdWVuY2UgRGlhZ3JhbSBjaOG7iSBuw6puIG3DtCBow6xuaCBow7NhIHTGsMahbmcgdMOhYyBnaeG7r2EgY8OhYyByYW5oIGdp4bubaSBs4bubbiAoKipNaWNyb3NlcnZpY2VzLCBBUEkgRW5kcG9pbnRzLCBEYXRhYmFzZSoqKSwga2jDtG5nIHbhur0gY2hpIHRp4bq/dCBtw6Mgbmd14buTbiBu4buZaSBi4buZIGLDqm4gdHJvbmcgbeG7mXQgY2xhc3MuDQoNCi0tLQ0KDQojIyMgNC4yLiBDTEkgRGlhZ25vc3RpY3MgJiBDw7RuZyBD4bulIEto4bqjbyBTw6F0IE3DtCBIw6xuaCBIw7NhDQoNCmBgYGJhc2gNCiMgMS4gQ2jhuqF5IGLDoGkga2nhu4NtIHRo4butIGNo4bqlcCBuaOG6rW4gQkREIHThu7EgxJHhu5luZyBi4bqxbmcgQmVoYXZlIENMSQ0KYmVoYXZlIGZlYXR1cmVzL29yZGVyX2xpZmVjeWNsZS5mZWF0dXJlDQoNCiMgMi4gU2luaCBiaeG7g3UgxJHhu5MgU3RhdGUgTWFjaGluZSB0cuG7sWMgdGnhur9wIHThu6sgbcOjIG5ndeG7k24gUGxhbnRVTUwNCnBsYW50dW1sIC10cG5nIG9yZGVyX3N0YXRlX21hY2hpbmUucHVtbA0KDQojIDMuIFF1w6l0IGtp4buDbSB0cmEgxJHhu5kgcGjhu6ljIHThuqFwIHBow6JuIG5ow6FuaCBDeWNsb21hdGljIENvbXBsZXhpdHkgY+G7p2EgY8OhYyBow6BtIGlmLWVsc2UNCmxpemFyZCBzcmMvIC1DIDEwDQpgYGANCg0KLS0tDQoNCiMjIDUuIELhuqNuZyBTbyBzw6FuaCAmIERlY2lzaW9uIE1hdHJpeA0KDQp8IEvhu7kgVGh14bqtdCBNw7QgSMOsbmggSMOzYSB8IENoaeG7gXUgS2jDtG5nIEdpYW4gxJDhuqFpIERp4buHbiB8IMSQ4buZIENow61uaCBYw6FjIEvhu7kgVGh14bqtdCB8IFBow7kgSOG7o3AgQ2hvIMSQ4buRaSBUxrDhu6NuZyB8IEtoaSBOw6BvIELhuq90IEJ14buZYyBEw7luZyB8DQp8IDotLS0gfCA6LS0tIHwgOi0tLSB8IDotLS0gfCA6LS0tIHwNCnwgKipVc2VyIFN0b3JpZXMgJiBHaGVya2luKiogfCBUxrDGoW5nIHTDoWMgJiBDaOG6pXAgbmjhuq1uIChCREQpIHwgVHJ1bmcgYsOsbmggLSBDYW8gfCBM4bqtcCB0csOsbmggdmnDqm4sIFRlc3RlciwgUE8gfCBM4bqtcCBr4bq/IGhv4bqhY2ggU3ByaW50LCBWaeG6v3QgVGVzdCB04buxIMSR4buZbmcgfA0KfCAqKlVzZSBDYXNlIERpYWdyYW0qKiB8IFJhbmggZ2nhu5tpICYgTeG7pWMgdGnDqnUgdOG7lW5nIHRo4buDIHwgVHJ1bmcgYsOsbmggfCBLaMOhY2ggaMOgbmcsIEJhbiBxdeG6o24gbMO9IHwgQsOhbyBjw6FvIHBo4bqhbSB2aSBk4buxIMOhbiB0cm9uZyBo4bujcCDEkeG7k25nIHwNCnwgKipTdGF0ZSBNYWNoaW5lIERpYWdyYW0qKiB8IFbDsm5nIMSR4budaSAmIFRy4bqhbmcgdGjDoWkgdGjhu7FjIHRo4buDfCAqKlLhuqV0IGNhbyAoTmdoacOqbSBuZ+G6t3QpKiogfCBL4bu5IHPGsCBCYWNrZW5kLCBLaeG6v24gdHLDumMgc8awIHwgUXXhuqNuIGzDvSDEkMahbiBow6BuZywgR2lhbyBk4buLY2ggdMOgaSBjaMOtbmgsIEdhbWV8DQp8ICoqU2VxdWVuY2UgRGlhZ3JhbSoqIHwgR2lhbyB0aeG6v3AgbeG6oW5nIHRoZW8gdGjhu51pIGdpYW4gfCBDYW8gfCBL4bu5IHPGsCBwaMOibiB0w6FuLCBBUEkgRGVzaWduZXIgfCBUaGnhur90IGvhur8gdMawxqFuZyB0w6FjIGxpw6puIGThu4tjaCB24bulIGdSUEMvUkVTVHwNCnwgKipEZWNpc2lvbiBUYWJsZXMgTWF0cml4KiogfCBMb2dpYyBwaMOibiBuaMOhbmggxJFp4buBdSBraeG7h24gfCAqKlR1eeG7h3QgxJHhu5FpICgkMTAwXCUkIHbDqXQgY+G6oW4pKip8IEzhuq1wIHRyw6xuaCB2acOqbiB0aHXhuq10IHRvw6FuLCBCQSB8IFTDrW5oIHRodeG6vywgRHV54buHdCBo4buTIHPGoSB2YXksIENo4bqlbSDEkWnhu4NtIHTDrW4gZOG7pW5nfA0K