Chế độ giao diện
4.3. Kiến Trúc Phân Tầng (Layered Architecture & N-Tier)
IMPORTANT
Nếu bạn chỉ được nhớ một điều duy nhất: Kiến trúc phân tầng tổ chức mã nguồn thành các lát cắt ngang độc lập theo mức độ trừu tượng hóa; sức mạnh của nó nằm ở tính cô lập (Isolation of Layers) và ranh giới giao dịch (Transaction Boundary) tường minh, nhưng phải cảnh giác cao độ trước Sinkhole Anti-Pattern và rò rỉ chi tiết hạ tầng (Layer Leaking) lên các tầng trên.
1. Kiến trúc Tổng quan & Mô hình Tư duy (Mental Model)
Ẩn dụ Đời sống: Chuỗi Vận Hành Nhà Hàng 5 Sao Cao Cấp
Hãy hình dung kiến trúc phân tầng hoạt động tương tự như một nhà hàng ẩm thực chuyên nghiệp:
- Presentation Layer (Nhân viên Bồi bàn & Lễ tân): Tiếp đón khách hàng, trao menu, ghi nhận order và kiểm tra xem khách có yêu cầu món hợp lệ không. Bồi bàn không bao giờ tự ý vào bếp nấu nướng, cũng không được tự chạy ra chợ mua thịt bò.
- Application Layer (Quản lý Nhà hàng / Bếp trưởng Điều phối): Nhận phiếu order từ bồi bàn, kiểm tra tiến độ, ra lệnh cho các bếp chuyên biệt chuẩn bị món ăn, điều phối thời gian và chịu trách nhiệm tính toán hóa đơn thanh toán (Transaction Boundary).
- Domain Layer (Nghệ nhân Nấu bếp / Công thức Ẩm thực Cốt lõi): Trái tim của nhà hàng. Nắm giữ công thức ướp thịt độc quyền, nhiệt độ nướng hoàn hảo và quy chuẩn an toàn vệ sinh thực phẩm (Business Invariants). Nghệ nhân tập trung 100% vào việc nấu món ngon, không cần biết khách ăn bằng đĩa sứ hay mang về bằng hộp giấy.
- Infrastructure Layer (Thủ kho, Nhà cung cấp Nông sản & Thiết bị Bếp): Hệ thống tủ đông công nghiệp, nguồn cung thịt bò Wagyu nhập khẩu, và cổng thanh toán POS cà thẻ tín dụng.
- Cross-Cutting Concerns (Hệ thống Điện, Nước & Camera Giám sát): Cung cấp năng lượng và bảo an cho toàn bộ nhà hàng mà không can thiệp vào công thức nấu ăn.
flowchart TD
subgraph ClientSpace["Thế Giới Bên Ngoài (External Clients)"]
Client["Web / Mobile / Third-party API"]
end
subgraph LayeredApp["Kiến Trúc Phân Tầng Chuẩn Doanh Nghiệp (Enterprise 4-Layers)"]
direction TB
PL["1. Presentation Layer (Tầng Trình Diễn)<br/>REST/GraphQL Controllers, DTOs, Input Validation"]
AL["2. Application Layer (Tầng Ứng Dụng)<br/>Use Cases, Orchestration, Transaction Boundary (BEGIN/COMMIT)"]
DL["3. Domain Layer (Tầng Nghiệp Vụ Cốt Lõi)<br/>Entities, Value Objects, Business Invariants, Domain Logic"]
IL["4. Infrastructure Layer (Tầng Hạ Tầng)<br/>Repositories, Database ORM, External APIs, File System"]
PL -->|Gọi trực tiếp| AL
AL -->|Gọi trực tiếp| DL
AL -->|Gọi Interface| IL
DL -. "Không phụ thuộc" .-> IL
end
subgraph CrossCutting["Cross-Cutting Concerns"]
CC["Logging • Telemetry • Security (AuthN/AuthZ) • Distributed Tracing • Caching"]
end
Client --> PL
CC -. "Cắt ngang qua tất cả các tầng" .-> PL
CC -.-> AL
CC -.-> DL
CC -.-> IL
2. Chi tiết từng Keyword (Under-the-Hood Deep Dive)
2.1. Phân Biệt Layered Architecture (Logical) vs N-Tier Architecture (Physical)
Một sự nhầm lẫn kinh điển trong ngành kỹ nghệ phần mềm là đồng nhất giữa Layers và Tiers:
| Tiêu Chí | Layered Architecture (Tầng Logic) | N-Tier Architecture (Tầng Vật Lý) |
|---|---|---|
| Bản chất | Phân chia về mặt tổ chức cấu trúc mã nguồn, packages, namespaces bên trong cùng một tiến trình. | Phân chia về mặt hạ tầng vật lý, máy chủ, máy ảo hoặc các tiến trình OS riêng biệt chạy trên mạng. |
| Chi phí Giao tiếp | Gọi hàm trong bộ nhớ (In-memory calls) ở tốc độ nano-giây ( | Gọi qua mạng (RPC, HTTP, TCP Socket) ở tốc độ mili-giây ( |
| Khả năng Lỗi | Không thể xảy ra lỗi đứt gãy cáp mạng nội bộ tiến trình. | Đối mặt với 8 định kiến sai lầm về mạng phân tán (Fallacies of Distributed Computing). |
| Ví dụ Kinh điển | Một file app.jar chứa các package: controller, service, domain, repository. | Hệ thống 3-Tier: Web Server (Nginx) |
2.2. Giải Phẫu Bốn Tầng Tiêu Chuẩn: Presentation, Application, Domain, Infrastructure
1. Presentation Layer (Tầng Trình Diễn)
- Trách nhiệm: Tiếp nhận luồng dữ liệu thô từ thế giới bên ngoài (HTTP Request, gRPC message, Kafka Event payload, CLI arguments).
- Thao tác hợp lệ: Xác thực cú pháp (Schema validation, JSON schema), phân giải mã định danh (Authentication token parsing), ánh xạ Request sang DTO (Data Transfer Object) nội bộ, và chuyển đổi kết quả trả về mã HTTP tương ứng (
200 OK,201 Created,400 Bad Request). - Điều cấm kỵ: Tuyệt đối không chứa logic nghiệp vụ tính toán (như tính lãi suất hay kiểm tra hạn mức tín dụng).
2. Application Layer (Tầng Ứng Dụng / Workflow Orchestration)
- Trách nhiệm: Đóng vai trò nhạc trưởng điều phối các Use Cases.
- Thao tác hợp lệ:
- Tiếp nhận DTO từ Presentation Layer.
- Khởi tạo Ranh giới Giao dịch (Transaction Boundary): Mở kết nối DB, kích hoạt
BEGIN TRANSACTION. - Triệu hồi các Entities từ Domain Layer để thực thi quy tắc kinh doanh.
- Gọi Infrastructure để lưu trữ trạng thái mới hoặc gửi thông báo (Emails, Push notifications).
- Kết thúc giao dịch:
COMMIT TRANSACTIONhoặcROLLBACKkhi có lỗi.
3. Domain Layer (Tầng Nghiệp Vụ Cốt Lõi)
- Trách nhiệm: Trái tim và tài sản trí tuệ lớn nhất của doanh nghiệp. Chứa các Entities, Value Objects, Domain Exceptions và Domain Services.
- Thao tác hợp lệ: Kiểm soát các điều kiện bất biến (Class Invariants), thực hiện các phép tính logic thuần túy (ví dụ: công thức khấu hao tài sản, luật chiết khấu đơn hàng).
- Điều cấm kỵ: Hoàn toàn độc lập với công nghệ bên ngoài. Cấm tiệt việc import thư viện SQL, ORM Annotations, HTTP Headers hay JSON Parser vào Domain Layer.
4. Infrastructure Layer / Data Access Layer (DAL)
- Trách nhiệm: Hiện thực hóa các giao tiếp vật lý với phần cứng và thế giới bên ngoài: Kết nối cơ sở dữ liệu quan hệ (PostgreSQL, Oracle) hoặc NoSQL (MongoDB), bộ nhớ đệm (Redis), Message Queue (RabbitMQ), bộ lưu trữ đối tượng (AWS S3) và các dịch vụ bên thứ ba (Stripe, Twilio).
2.3. Cross-Cutting Concerns và Cơ Chế Tách Rời (AOP & Middlewares)
Cross-Cutting Concerns (Mối quan tâm xuyên suốt) là các khía cạnh kỹ thuật không thuộc về nghiệp vụ chuyên biệt của bất kỳ tầng nào nhưng lại hiện diện ở khắp mọi nơi:
- Ghi nhật ký (Structured Logging với Correlation ID).
- Giám sát độ trễ và số liệu (Prometheus Metrics & Distributed Tracing).
- Xác thực và phân quyền người dùng (Security / JWT Authorization).
- Quản lý bộ nhớ đệm (Caching).
Giải pháp Kiến trúc: Không bao giờ viết code logging hay đo thời gian lặp đi lặp lại ở mọi phương thức. Sử dụng:
- Aspect-Oriented Programming (AOP) hoặc Decorators để chèn logic xuyên suốt vào thời điểm biên dịch hoặc runtime.
- Middlewares / Interceptors Pipeline ở ranh giới của Presentation Layer.
2.4. Closed Architecture vs Open Architecture và Vấn Đề Rò Rỉ Tầng (Layer Leaking)
flowchart LR
subgraph Closed["Closed Architecture (Khuyên dùng)"]
C1[Layer N] --> C2[Layer N-1]
C2 --> C3[Layer N-2]
end
subgraph Open["Open Architecture (Nguy hiểm)"]
O1[Layer N] --> O2[Layer N-1]
O2 --> O3[Layer N-2]
O1 -. "Nhảy cóc xuyên tầng!" .-> O3
end
- Closed Architecture (Kiến trúc đóng - Chuẩn mực bắt buộc):
- Một tầng chỉ được phép giao tiếp trực tiếp với tầng ngay bên dưới nó.
- Muốn Presentation lấy được dữ liệu từ Database, request bắt buộc phải đi tuần tự: Presentation
Application Domain Infrastructure. - Lợi ích: Bảo tồn tính cô lập tối đa; khi thay đổi tầng Infrastructure, chỉ tầng Application bị ảnh hưởng, tầng Presentation hoàn toàn miễn nhiễm.
- Open Architecture (Kiến trúc mở):
- Cho phép một tầng nhảy cóc bỏ qua tầng trung gian (ví dụ: Controller gọi thẳng vào Data Access Layer để thực hiện truy vấn đọc nhanh).
- Hậu quả: Tạo ra mạng lưới phụ thuộc chéo chằng chịt (Spaghetti Dependencies), làm mất khả năng kiểm soát logic nghiệp vụ và ranh giới giao dịch.
- Layer Leaking (Rò rỉ tầng):
- Hiện tượng chi tiết cài đặt của tầng dưới bị phơi bày lên tầng trên.
- Ví dụ kinh điển: Trả trực tiếp đối tượng ORM Entity (
@Entitycủa Hibernate/JPA) lên tầng Controller rồi tuần tự hóa thành JSON trả cho Client. Nếu database thêm một cột nhạy cảm (password_hash), dữ liệu bị lộ thẳng ra ngoài Internet!
2.5. Sinkhole Anti-Pattern và Kỹ Thuật Tinh Gọn Luồng Dữ Liệu
Sinkhole Anti-Pattern (Hiện tượng cống xả ngầm) xảy ra khi một yêu cầu xử lý từ Client đi xuyên qua tất cả các tầng của hệ thống mà không có bất kỳ tầng nào thực hiện một logic nghiệp vụ có giá trị:
- Controller nhận request
gọi ServicegetUser(id). - Service không làm gì ngoài việc gọi Repository
findUser(id). - Repository trả về kết quả
Service chuyển tiếp Controller trả về client.
Quy tắc Đánh giá 80-20 (Sinkhole Assessment Rule):
- Nếu khoảng
các luồng trong hệ thống là Sinkhole (chủ yếu là các truy vấn đọc đơn giản - CRUD), điều này hoàn toàn bình thường và chấp nhận được để bảo vệ tính nhất quán kiến trúc. - Nếu
các luồng là Sinkhole, kiến trúc của bạn đang bị Over-Engineered (Phân tầng thừa thãi). - Giải pháp: Áp dụng phong cách CQRS - Tách riêng đường dẫn đọc (Read Path) cho phép Controller truy vấn trực tiếp View Database chuyên dụng, trong khi vẫn giữ nguyên kiến trúc phân tầng khắt khe cho đường dẫn ghi (Write Path).
2.6. Ranh Giới Giao Dịch (Transaction Boundary) và Quản Trị Trạng Thái
Ranh giới giao dịch là nơi bắt đầu và kết thúc của một đơn vị công việc nguyên tử (Unit of Work).
- Vị trí chuẩn mực: Application Layer.
- Lý do: Domain Layer chỉ quan tâm đến các quy tắc thuần túy của từng thực thể độc lập, không nắm giữ kết nối cơ sở dữ liệu. Presentation Layer quá xa, không thể đảm bảo an toàn nếu mạng bị đứt gãy.
- Cơ chế vận hành:
- Khi một Use Case được gọi, một Transaction Handle được tạo ra.
- Toàn bộ các thao tác ghi dữ liệu từ các Repository khác nhau tham gia vào cùng một Transaction Context.
- Nếu tất cả các điều kiện bất biến (Invariants) của Domain đều hợp lệ, Transaction được
COMMIT. - Nếu có bất kỳ lỗi nào xảy ra (Domain Exception hoặc Database Deadlock), toàn bộ các thay đổi lập tức được
ROLLBACK.
3. Thực thi Mã nguồn & Mô phỏng Chuyên sâu (Dual-Engine Implementation)
3.1. C++20 Implementation: Strict Closed Layered Architecture with RAII Transaction Management
Đoạn mã C++20 dưới đây minh họa hệ thống ngân hàng phân tầng khắt khe (Closed Layered Architecture) với cơ chế quản lý Transaction Boundary tự động bằng RAII và ngăn ngừa Layer Leaking thông qua DTO Mappers.
cpp
#include <iostream>
#include <memory>
#include <string>
#include <stdexcept>
#include <vector>
#include <utility>
// ============================================================================
// 1. DOMAIN LAYER (Zero external dependencies - Purity)
// ============================================================================
class InsufficientFundsException : public std::runtime_error {
public:
explicit InsufficientFundsException(const std::string& msg) : std::runtime_error(msg) {}
};
class BankAccount {
private:
uint64_t id_;
int64_t balanceCents_;
public:
BankAccount(uint64_t id, int64_t initialCents) : id_(id), balanceCents_(initialCents) {
if (initialCents < 0) throw std::invalid_argument("Initial balance cannot be negative");
}
void debit(int64_t cents) {
if (cents <= 0) throw std::invalid_argument("Debit amount must be positive");
if (balanceCents_ < cents) {
throw InsufficientFundsException("Insufficient funds: current " +
std::to_string(balanceCents_) + ", requested " + std::to_string(cents));
}
balanceCents_ -= cents;
}
void credit(int64_t cents) {
if (cents <= 0) throw std::invalid_argument("Credit amount must be positive");
balanceCents_ += cents;
}
[[nodiscard]] uint64_t id() const noexcept { return id_; }
[[nodiscard]] int64_t balanceCents() const noexcept { return balanceCents_; }
};
// ============================================================================
// 2. INFRASTRUCTURE INTERFACES & IMPLEMENTATION
// ============================================================================
class ITransactionContext {
public:
virtual ~ITransactionContext() = default;
virtual void commit() = 0;
virtual void rollback() = 0;
};
class IAccountRepository {
public:
virtual ~IAccountRepository() = default;
virtual std::unique_ptr<BankAccount> findById(uint64_t id) = 0;
virtual void save(const BankAccount& account) = 0;
virtual std::unique_ptr<ITransactionContext> beginTransaction() = 0;
};
// Giả lập lưu trữ Database thực tế
class MockSqlAccountRepository : public IAccountRepository {
private:
class MockTx : public ITransactionContext {
public:
void commit() override { std::cout << " [DB Engine] >>> COMMIT TRANSACTION Executed Successfully.\n"; }
void rollback() override { std::cout << " [DB Engine] >>> ROLLBACK TRANSACTION Triggered!\n"; }
};
public:
std::unique_ptr<BankAccount> findById(uint64_t id) override {
std::cout << " [DB Engine] Query: SELECT * FROM accounts WHERE id = " << id << ";\n";
return std::make_unique<BankAccount>(id, 100'000); // Mock số dư $1,000.00
}
void save(const BankAccount& account) override {
std::cout << " [DB Engine] Query: UPDATE accounts SET balance = "
<< account.balanceCents() << " WHERE id = " << account.id() << ";\n";
}
std::unique_ptr<ITransactionContext> beginTransaction() override {
std::cout << " [DB Engine] >>> BEGIN TRANSACTION\n";
return std::make_unique<MockTx>();
}
};
// ============================================================================
// 3. APPLICATION LAYER (Transaction Boundary & DTO Definitions)
// ============================================================================
struct TransferRequestDto {
uint64_t fromAccountId;
uint64_t toAccountId;
int64_t amountCents;
};
struct TransferResponseDto {
bool success;
std::string message;
int64_t fromRemainingBalanceCents;
};
class TransferMoneyUseCase {
private:
std::shared_ptr<IAccountRepository> repo_;
public:
explicit TransferMoneyUseCase(std::shared_ptr<IAccountRepository> repo) : repo_(std::move(repo)) {}
TransferResponseDto execute(const TransferRequestDto& request) {
// Mở ranh giới giao dịch (Transaction Boundary)
auto tx = repo_->beginTransaction();
try {
auto fromAcc = repo_->findById(request.fromAccountId);
auto toAcc = repo_->findById(request.toAccountId);
if (!fromAcc || !toAcc) {
throw std::runtime_error("One or more accounts not found");
}
// Thực thi Domain Logic nguyên chất
fromAcc->debit(request.amountCents);
toAcc->credit(request.amountCents);
// Lưu trữ trạng thái mới
repo_->save(*fromAcc);
repo_->save(*toAcc);
// Xác nhận giao dịch
tx->commit();
return TransferResponseDto{
.success = true,
.message = "Funds transferred successfully",
.fromRemainingBalanceCents = fromAcc->balanceCents()
};
} catch (const std::exception& ex) {
tx->rollback();
throw; // Lan truyền tiếp để Presentation Layer chuyển đổi sang HTTP status code
}
}
};
// ============================================================================
// 4. PRESENTATION LAYER (REST Controller Simulation)
// ============================================================================
class PaymentHttpController {
private:
TransferMoneyUseCase useCase_;
public:
explicit PaymentHttpController(TransferMoneyUseCase useCase) : useCase_(std::move(useCase)) {}
void handlePostTransfer(uint64_t from, uint64_t to, int64_t cents) {
std::cout << "\n[HTTP Presentation Layer] Received POST /api/transfers payload...\n";
// 1. Validation cú pháp đầu vào
if (cents <= 0) {
std::cout << " -> HTTP 400 Bad Request: Amount must be greater than zero.\n";
return;
}
TransferRequestDto dto{from, to, cents};
// 2. Chuyển giao xuống Application Layer
try {
auto response = useCase_.execute(dto);
std::cout << " -> HTTP 200 OK: " << response.message
<< " | New Balance: " << response.fromRemainingBalanceCents << " cents\n";
} catch (const InsufficientFundsException& ex) {
std::cout << " -> HTTP 422 Unprocessable Entity (Domain Rule Violated): " << ex.what() << "\n";
} catch (const std::exception& ex) {
std::cout << " -> HTTP 500 Internal Server Error: " << ex.what() << "\n";
}
}
};
int main() {
std::cout << "=== C++20 Strict Closed Layered Architecture Demo ===\n";
auto repo = std::make_shared<MockSqlAccountRepository>();
TransferMoneyUseCase useCase(repo);
PaymentHttpController controller(useCase);
// Kịch bản 1: Giao dịch thành công
controller.handlePostTransfer(101, 102, 25'000); // Chuyển $250.00
// Kịch bản 2: Giao dịch vi phạm Domain Rule (Không đủ tiền)
controller.handlePostTransfer(101, 102, 500'000); // Chuyển $5,000.00 (Số dư chỉ có $1,000.00)
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
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
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
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
Terminal Output Mẫu (C++20):
text
=== C++20 Strict Closed Layered Architecture Demo ===
[HTTP Presentation Layer] Received POST /api/transfers payload...
[DB Engine] >>> BEGIN TRANSACTION
[DB Engine] Query: SELECT * FROM accounts WHERE id = 101;
[DB Engine] Query: SELECT * FROM accounts WHERE id = 102;
[DB Engine] Query: UPDATE accounts SET balance = 75000 WHERE id = 101;
[DB Engine] Query: UPDATE accounts SET balance = 125000 WHERE id = 102;
[DB Engine] >>> COMMIT TRANSACTION Executed Successfully.
-> HTTP 200 OK: Funds transferred successfully | New Balance: 75000 cents
[HTTP Presentation Layer] Received POST /api/transfers payload...
[DB Engine] >>> BEGIN TRANSACTION
[DB Engine] Query: SELECT * FROM accounts WHERE id = 101;
[DB Engine] Query: SELECT * FROM accounts WHERE id = 102;
[DB Engine] >>> ROLLBACK TRANSACTION Triggered!
-> HTTP 422 Unprocessable Entity (Domain Rule Violated): Insufficient funds: current 100000, requested 5000001
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
3.2. Python 3.11+ Implementation: Clean Layered Service with DTO Protection
Chương trình Python 3.11+ dưới đây minh họa việc thực thi phân tầng khắt khe, áp dụng Transaction Boundary qua Context Manager và DTO Mapper ngăn chặn triệt để Layer Leaking.
python
from __future__ import annotations
from dataclasses import dataclass
from typing import Protocol, Optional
import contextlib
# ============================================================================
# 1. DOMAIN LAYER
# ============================================================================
class BusinessRuleError(Exception):
pass
class ProductNotAvailableError(BusinessRuleError):
pass
@dataclass
class OrderLine:
product_id: str
quantity: int
unit_price: float
@property
def subtotal(self) -> float:
return self.quantity * self.unit_price
class Order:
def __init__(self, order_id: str, customer_id: str):
self.order_id = order_id
self.customer_id = customer_id
self.lines: list[OrderLine] = []
self.status: str = "DRAFT"
def add_item(self, product_id: str, quantity: int, unit_price: float) -> None:
if quantity <= 0:
raise BusinessRuleError("Quantity must be positive")
self.lines.append(OrderLine(product_id, quantity, unit_price))
def confirm(self) -> None:
if not self.lines:
raise BusinessRuleError("Cannot confirm an empty order")
self.status = "CONFIRMED"
@property
def total_amount(self) -> float:
return sum(line.subtotal for line in self.lines)
# ============================================================================
# 2. INFRASTRUCTURE INTERFACES & MOCK ADAPTER
# ============================================================================
class IOrderRepository(Protocol):
def save(self, order: Order) -> None: ...
def find_by_id(self, order_id: str) -> Optional[Order]: ...
@contextlib.contextmanager
def transaction(self): ...
class MockDatabaseRepository:
def __init__(self):
self._storage: dict[str, Order] = {}
def save(self, order: Order) -> None:
print(f" [DB Storage] Saving Order {order.order_id} (Status: {order.status}) to Database...")
self._storage[order.order_id] = order
def find_by_id(self, order_id: str) -> Optional[Order]:
return self._storage.get(order_id)
@contextlib.contextmanager
def transaction(self):
print(" [DB Engine] === BEGIN TRANSACTION ===")
try:
yield
print(" [DB Engine] === COMMIT TRANSACTION ===")
except Exception:
print(" [DB Engine] === ROLLBACK TRANSACTION DUE TO EXCEPTION ===")
raise
# ============================================================================
# 3. APPLICATION LAYER (USE CASE & DTOS)
# ============================================================================
@dataclass(frozen=True)
class CreateOrderInputDTO:
customer_id: str
product_id: str
quantity: int
unit_price: float
@dataclass(frozen=True)
class OrderResponseDTO:
order_id: str
total_amount: float
status: str
class CreateOrderUseCase:
def __init__(self, repo: IOrderRepository):
self._repo = repo
def execute(self, dto: CreateOrderInputDTO) -> OrderResponseDTO:
# Transaction Boundary nằm trọn vẹn trong Application Layer
with self._repo.transaction():
# Tạo Entity Domain
import uuid
order = Order(order_id=str(uuid.uuid4())[:8], customer_id=dto.customer_id)
order.add_item(dto.product_id, dto.quantity, dto.unit_price)
order.confirm()
# Lưu xuống hạ tầng
self._repo.save(order)
# MAPPER: Chuyển đổi sang Response DTO (Ngăn chặn Layer Leaking của Entity)
return OrderResponseDTO(
order_id=order.order_id,
total_amount=order.total_amount,
status=order.status
)
# ============================================================================
# 4. PRESENTATION LAYER (WEB CONTROLLER)
# ============================================================================
class WebOrderController:
def __init__(self, use_case: CreateOrderUseCase):
self._use_case = use_case
def handle_request(self, payload: dict) -> tuple[int, dict]:
print(f"\n[HTTP Controller] Handling Incoming Payload: {payload}")
try:
# 1. Input Validation
if "customer_id" not in payload or payload.get("quantity", 0) <= 0:
return 400, {"error": "Invalid request parameters"}
# 2. Ánh xạ sang Input DTO
dto = CreateOrderInputDTO(
customer_id=payload["customer_id"],
product_id=payload["product_id"],
quantity=payload["quantity"],
unit_price=payload["unit_price"]
)
# 3. Gọi Application Use Case
response = self._use_case.execute(dto)
return 201, {
"order_id": response.order_id,
"total": response.total_amount,
"status": response.status
}
except BusinessRuleError as bre:
return 422, {"business_error": str(bre)}
except Exception as e:
return 500, {"fatal_error": str(e)}
if __name__ == "__main__":
print("=== Python 3.11+ Closed Layered Architecture Demo ===")
repo = MockDatabaseRepository()
use_case = CreateOrderUseCase(repo)
controller = WebOrderController(use_case)
# Test Case 1: Tạo đơn hàng thành công
status_code, body = controller.handle_request({
"customer_id": "CUST-99",
"product_id": "MACBOOK-PRO-M3",
"quantity": 2,
"unit_price": 2499.00
})
print(f" -> Controller HTTP Status: {status_code} | Body: {body}")
# Test Case 2: Vi phạm kiểm tra đầu vào (HTTP 400)
status_code, body = controller.handle_request({
"customer_id": "CUST-99",
"product_id": "MACBOOK-PRO-M3",
"quantity": -5,
"unit_price": 2499.00
})
print(f" -> Controller HTTP Status: {status_code} | Body: {body}")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
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
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
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
Terminal Output Mẫu (Python 3.11+):
text
=== Python 3.11+ Closed Layered Architecture Demo ===
[HTTP Controller] Handling Incoming Payload: {'customer_id': 'CUST-99', 'product_id': 'MACBOOK-PRO-M3', 'quantity': 2, 'unit_price': 2499.0}
[DB Engine] === BEGIN TRANSACTION ===
[DB Storage] Saving Order 4d7a8b1c (Status: CONFIRMED) to Database...
[DB Engine] === COMMIT TRANSACTION ===
-> Controller HTTP Status: 201 | Body: {'order_id': '4d7a8b1c', 'total': 4998.0, 'status': 'CONFIRMED'}
[HTTP Controller] Handling Incoming Payload: {'customer_id': 'CUST-99', 'product_id': 'MACBOOK-PRO-M3', 'quantity': -5, 'unit_price': 2499.0}
-> Controller HTTP Status: 400 | Body: {'error': 'Invalid request parameters'}1
2
3
4
5
6
7
8
9
10
2
3
4
5
6
7
8
9
10
4. Systems Engineering & Production Pitfalls
Các Cạm Bẫy Thực Chiến (Gotchas & Production Antipatterns)
Rò Rỉ Đối Tượng ORM Gây Ra Detached Entity & LazyInitializationException:
- Bản chất: Lập trình viên bỏ qua việc tạo DTO mà truyền trực tiếp Entity của ORM (Hibernate, JPA, SQLAlchemy) lên Presentation Layer. Khi Controller cố gắng serialize đối tượng sang JSON, nó truy cập vào các trường quan hệ lười (Lazy Loaded Collections) khi Transaction của Application Layer đã bị đóng (
session closed), dẫn đến lỗi văng sập serverLazyInitializationExceptiontrên Production. - Khắc phục: Luôn sử dụng DTO Mapper tại ranh giới của Application Layer để sao chép dữ liệu trước khi trả về Presentation Layer.
- Bản chất: Lập trình viên bỏ qua việc tạo DTO mà truyền trực tiếp Entity của ORM (Hibernate, JPA, SQLAlchemy) lên Presentation Layer. Khi Controller cố gắng serialize đối tượng sang JSON, nó truy cập vào các trường quan hệ lười (Lazy Loaded Collections) khi Transaction của Application Layer đã bị đóng (
Ranh Giới Giao Dịch Kéo Dài Quá Lâu (Long-Running Transactions):
- Bản chất: Lập trình viên bao bọc toàn bộ phương thức Use Case trong một Transaction, bao gồm cả việc gọi HTTP API sang dịch vụ bên thứ ba (như gửi SMS hoặc gọi Visa Gateway). Nếu mạng bên thứ ba bị lag 10 giây, kết nối Database bị chiếm giữ trong 10 giây, khóa hàng loạt bảng (Row Locks), dẫn đến cạn kiệt Connection Pool của Database.
- Khắc phục: Tách rời: Chỉ mở Transaction Database cho các thao tác SQL thuần túy; các cuộc gọi I/O mạng bên ngoài phải được thực hiện trước hoặc sau khi đóng Transaction.
Hiện Tượng Phân Tầng Thái Quá (Architecture Bloat & Anemic Domain):
- Bản chất: Hệ thống có hàng chục tầng trung gian nhưng Domain Layer lại hoàn toàn rỗng không chứa logic (Anemic Domain Model - chỉ có getters và setters), biến toàn bộ hệ thống thành một chuỗi cống xả ngầm Sinkhole tốn CPU mà không đem lại giá trị bảo trì nào.
- Khắc phục: Nếu ứng dụng chỉ thuần túy làm CRUD, hãy loại bỏ các tầng phức tạp và sử dụng mô hình Active Record hoặc Transaction Script đơn giản.
Kỹ Thuật Chẩn Đoán & Giám Sát Phân Tầng Bằng CLI:
bash# 1. Phát hiện các tầng gọi nhảy cóc vi phạm Closed Architecture bằng JDepend CLI jdepend -file report.xml src/ # 2. Đo thời gian thực thi của từng tầng kiến trúc thông qua OpenTelemetry Spans otel-cli exec --service-name order-api --name "ApplicationLayer::TransferUseCase" ./run_usecase # 3. Giám sát số lượng Connection rò rỉ trong Connection Pool của PostgreSQL psql -c "SELECT count(*), state FROM pg_stat_activity GROUP BY state;"1
2
3
4
5
6
7
8
5. Bảng So sánh & Decision Matrix
5.1. So Sánh Closed Layered vs Open Layered Architecture
| Tiêu Chí | Closed Layered Architecture | Open Layered Architecture |
|---|---|---|
| Quy tắc Gọi | Chỉ được gọi tầng kế tiếp ( | Được phép nhảy cóc ( |
| Mức độ Tách rời (Decoupling) | Rất cao; thay đổi tầng hạ tầng không ảnh hưởng tầng trên | Rất thấp; các tầng bị dính chặt vào nhau |
| Khả năng Bảo trì (Maintainability) | Rất cao | Thấp; dễ biến thành Big Ball of Mud |
| Hiệu năng Thực thi | Tốn một phần chi phí chuyển tiếp DTO | Nhanh hơn một chút ở các truy vấn đọc nhanh |
| Rủi ro Rò rỉ Hạ tầng | Rất thấp | Cực kỳ cao |
| Khuyến nghị | Tiêu chuẩn mặc định cho 95% hệ thống | Chỉ dùng cho các báo cáo dữ liệu đặc thù |
5.2. Ma Trận Chuyển Đổi: Layered Architecture vs Clean / Hexagonal Architecture
| Đặc Tính | Traditional Layered Architecture | Clean / Hexagonal Architecture |
|---|---|---|
| Hướng Phụ thuộc | Hướng xuống Cơ sở dữ liệu ( | Hướng vào trong Nghiệp vụ ( |
| Trọng tâm Hệ thống | Database-Centric (Dữ liệu là trung tâm) | Domain-Centric (Quy tắc kinh doanh là trung tâm) |
| Khả năng Đổi Database | Rất khó; Domain thường bị dính ORM annotations | Cực kỳ dễ; Database chỉ là một Adapter cắm thêm |
| Khả năng Viết Unit Test | Thường cần Database ảo (H2, TestContainers) | Viết Unit Test |
| Độ Phức Tạp Ban Đầu | Thấp; trực quan, quen thuộc với mọi lập trình viên | Cao; cần hiểu sâu về DIP, Ports & Adapters |
| Giai đoạn Phù hợp | Khởi tạo dự án, ứng dụng doanh nghiệp vừa | Core Banking, FinTech, hệ thống có vòng đời > 10 năm |
IyA0LjMuIEtp4bq/biBUcsO6YyBQaMOibiBU4bqnbmcgKExheWVyZWQgQXJjaGl0ZWN0dXJlICYgTi1UaWVyKQ0KDQo+IFshSU1QT1JUQU5UXQ0KPiAqKk7hur91IGLhuqFuIGNo4buJIMSRxrDhu6NjIG5o4bubIG3hu5l0IMSRaeG7gXUgZHV5IG5o4bqldDoqKiBLaeG6v24gdHLDumMgcGjDom4gdOG6p25nIHThu5UgY2jhu6ljIG3DoyBuZ3Xhu5NuIHRow6BuaCBjw6FjIGzDoXQgY+G6r3QgbmdhbmcgxJHhu5ljIGzhuq1wIHRoZW8gbeG7qWMgxJHhu5kgdHLhu6t1IHTGsOG7o25nIGjDs2E7IHPhu6ljIG3huqFuaCBj4bunYSBuw7MgbuG6sW0g4bufIHTDrW5oIGPDtCBs4bqtcCAoSXNvbGF0aW9uIG9mIExheWVycykgdsOgIHJhbmggZ2nhu5tpIGdpYW8gZOG7i2NoIChUcmFuc2FjdGlvbiBCb3VuZGFyeSkgdMaw4budbmcgbWluaCwgbmjGsG5nIHBo4bqjaSBj4bqjbmggZ2nDoWMgY2FvIMSR4buZIHRyxrDhu5tjIFNpbmtob2xlIEFudGktUGF0dGVybiB2w6AgcsOyIHLhu4kgY2hpIHRp4bq/dCBo4bqhIHThuqduZyAoTGF5ZXIgTGVha2luZykgbMOqbiBjw6FjIHThuqduZyB0csOqbi4NCg0KLS0tDQoNCiMjIDEuIEtp4bq/biB0csO6YyBU4buVbmcgcXVhbiAmIE3DtCBow6xuaCBUxrAgZHV5IChNZW50YWwgTW9kZWwpDQoNCiMjIyDhuqhuIGThu6UgxJDhu51pIHPhu5FuZzogQ2h14buXaSBW4bqtbiBIw6BuaCBOaMOgIEjDoG5nIDUgU2FvIENhbyBD4bqlcA0KSMOjeSBow6xuaCBkdW5nIGtp4bq/biB0csO6YyBwaMOibiB04bqnbmcgaG/huqF0IMSR4buZbmcgdMawxqFuZyB04buxIG5oxrAgbeG7mXQgbmjDoCBow6BuZyDhuqltIHRo4buxYyBjaHV5w6puIG5naGnhu4dwOg0KLSAqKlByZXNlbnRhdGlvbiBMYXllciAoTmjDom4gdmnDqm4gQuG7k2kgYsOgbiAmIEzhu4UgdMOibikqKjogVGnhur9wIMSRw7NuIGtow6FjaCBow6BuZywgdHJhbyBtZW51LCBnaGkgbmjhuq1uIG9yZGVyIHbDoCBraeG7g20gdHJhIHhlbSBraMOhY2ggY8OzIHnDqnUgY+G6p3UgbcOzbiBo4bujcCBs4buHIGtow7RuZy4gQuG7k2kgYsOgbiBraMO0bmcgYmFvIGdp4budIHThu7Egw70gdsOgbyBi4bq/cCBu4bqldSBuxrDhu5tuZywgY8Wpbmcga2jDtG5nIMSRxrDhu6NjIHThu7EgY2jhuqF5IHJhIGNo4bujIG11YSB0aOG7i3QgYsOyLg0KLSAqKkFwcGxpY2F0aW9uIExheWVyIChRdeG6o24gbMO9IE5ow6AgaMOgbmcgLyBC4bq/cCB0csaw4bufbmcgxJBp4buBdSBwaOG7kWkpKio6IE5o4bqtbiBwaGnhur91IG9yZGVyIHThu6sgYuG7k2kgYsOgbiwga2nhu4NtIHRyYSB0aeG6v24gxJHhu5ksIHJhIGzhu4duaCBjaG8gY8OhYyBi4bq/cCBjaHV5w6puIGJp4buHdCBjaHXhuqluIGLhu4sgbcOzbiDEg24sIMSRaeG7gXUgcGjhu5FpIHRo4budaSBnaWFuIHbDoCBjaOG7i3UgdHLDoWNoIG5oaeG7h20gdMOtbmggdG/DoW4gaMOzYSDEkcahbiB0aGFuaCB0b8OhbiAoVHJhbnNhY3Rpb24gQm91bmRhcnkpLg0KLSAqKkRvbWFpbiBMYXllciAoTmdo4buHIG5ow6JuIE7huqV1IGLhur9wIC8gQ8O0bmcgdGjhu6ljIOG6qG0gdGjhu7FjIEPhu5F0IGzDtWkpKio6IFRyw6FpIHRpbSBj4bunYSBuaMOgIGjDoG5nLiBO4bqvbSBnaeG7ryBjw7RuZyB0aOG7qWMgxrDhu5twIHRo4buLdCDEkeG7mWMgcXV54buBbiwgbmhp4buHdCDEkeG7mSBuxrDhu5tuZyBob8OgbiBo4bqjbyB2w6AgcXV5IGNodeG6qW4gYW4gdG/DoG4gduG7hyBzaW5oIHRo4buxYyBwaOG6qW0gKEJ1c2luZXNzIEludmFyaWFudHMpLiBOZ2jhu4cgbmjDom4gdOG6rXAgdHJ1bmcgMTAwJSB2w6BvIHZp4buHYyBu4bqldSBtw7NuIG5nb24sIGtow7RuZyBj4bqnbiBiaeG6v3Qga2jDoWNoIMSDbiBi4bqxbmcgxJHEqWEgc+G7qSBoYXkgbWFuZyB24buBIGLhurFuZyBo4buZcCBnaeG6pXkuDQotICoqSW5mcmFzdHJ1Y3R1cmUgTGF5ZXIgKFRo4bunIGtobywgTmjDoCBjdW5nIGPhuqVwIE7DtG5nIHPhuqNuICYgVGhp4bq/dCBi4buLIELhur9wKSoqOiBI4buHIHRo4buRbmcgdOG7pyDEkcO0bmcgY8O0bmcgbmdoaeG7h3AsIG5ndeG7k24gY3VuZyB0aOG7i3QgYsOyIFdhZ3l1IG5o4bqtcCBraOG6qXUsIHbDoCBj4buVbmcgdGhhbmggdG/DoW4gUE9TIGPDoCB0aOG6uyB0w61uIGThu6VuZy4NCi0gKipDcm9zcy1DdXR0aW5nIENvbmNlcm5zIChI4buHIHRo4buRbmcgxJBp4buHbiwgTsaw4bubYyAmIENhbWVyYSBHacOhbSBzw6F0KSoqOiBDdW5nIGPhuqVwIG7Eg25nIGzGsOG7o25nIHbDoCBi4bqjbyBhbiBjaG8gdG/DoG4gYuG7mSBuaMOgIGjDoG5nIG3DoCBraMO0bmcgY2FuIHRoaeG7h3AgdsOgbyBjw7RuZyB0aOG7qWMgbuG6pXUgxINuLg0KDQpgYGBtZXJtYWlkDQpmbG93Y2hhcnQgVEQNCiAgICBzdWJncmFwaCBDbGllbnRTcGFjZVsiVGjhur8gR2nhu5tpIELDqm4gTmdvw6BpIChFeHRlcm5hbCBDbGllbnRzKSJdDQogICAgICAgIENsaWVudFsiV2ViIC8gTW9iaWxlIC8gVGhpcmQtcGFydHkgQVBJIl0NCiAgICBlbmQNCg0KICAgIHN1YmdyYXBoIExheWVyZWRBcHBbIktp4bq/biBUcsO6YyBQaMOibiBU4bqnbmcgQ2h14bqpbiBEb2FuaCBOZ2hp4buHcCAoRW50ZXJwcmlzZSA0LUxheWVycykiXQ0KICAgICAgICBkaXJlY3Rpb24gVEINCiAgICAgICAgUExbIjEuIFByZXNlbnRhdGlvbiBMYXllciAoVOG6p25nIFRyw6xuaCBEaeG7hW4pPGJyLz5SRVNUL0dyYXBoUUwgQ29udHJvbGxlcnMsIERUT3MsIElucHV0IFZhbGlkYXRpb24iXQ0KICAgICAgICBBTFsiMi4gQXBwbGljYXRpb24gTGF5ZXIgKFThuqduZyDhu6huZyBE4bulbmcpPGJyLz5Vc2UgQ2FzZXMsIE9yY2hlc3RyYXRpb24sIFRyYW5zYWN0aW9uIEJvdW5kYXJ5IChCRUdJTi9DT01NSVQpIl0NCiAgICAgICAgRExbIjMuIERvbWFpbiBMYXllciAoVOG6p25nIE5naGnhu4dwIFbhu6UgQ+G7kXQgTMO1aSk8YnIvPkVudGl0aWVzLCBWYWx1ZSBPYmplY3RzLCBCdXNpbmVzcyBJbnZhcmlhbnRzLCBEb21haW4gTG9naWMiXQ0KICAgICAgICBJTFsiNC4gSW5mcmFzdHJ1Y3R1cmUgTGF5ZXIgKFThuqduZyBI4bqhIFThuqduZyk8YnIvPlJlcG9zaXRvcmllcywgRGF0YWJhc2UgT1JNLCBFeHRlcm5hbCBBUElzLCBGaWxlIFN5c3RlbSJdDQogICAgICAgIA0KICAgICAgICBQTCAtLT58R+G7jWkgdHLhu7FjIHRp4bq/cHwgQUwNCiAgICAgICAgQUwgLS0+fEfhu41pIHRy4buxYyB0aeG6v3B8IERMDQogICAgICAgIEFMIC0tPnxH4buNaSBJbnRlcmZhY2V8IElMDQogICAgICAgIERMIC0uICJLaMO0bmcgcGjhu6UgdGh14buZYyIgLi0+IElMDQogICAgZW5kDQoNCiAgICBzdWJncmFwaCBDcm9zc0N1dHRpbmdbIkNyb3NzLUN1dHRpbmcgQ29uY2VybnMiXQ0KICAgICAgICBDQ1siTG9nZ2luZyDigKIgVGVsZW1ldHJ5IOKAoiBTZWN1cml0eSAoQXV0aE4vQXV0aFopIOKAoiBEaXN0cmlidXRlZCBUcmFjaW5nIOKAoiBDYWNoaW5nIl0NCiAgICBlbmQNCg0KICAgIENsaWVudCAtLT4gUEwNCiAgICBDQyAtLiAiQ+G6r3QgbmdhbmcgcXVhIHThuqV0IGPhuqMgY8OhYyB04bqnbmciIC4tPiBQTA0KICAgIENDIC0uLT4gQUwNCiAgICBDQyAtLi0+IERMDQogICAgQ0MgLS4tPiBJTA0KYGBgDQoNCi0tLQ0KDQojIyAyLiBDaGkgdGnhur90IHThu6tuZyBLZXl3b3JkIChVbmRlci10aGUtSG9vZCBEZWVwIERpdmUpDQoNCiMjIyAyLjEuIFBow6JuIEJp4buHdCBMYXllcmVkIEFyY2hpdGVjdHVyZSAoTG9naWNhbCkgdnMgTi1UaWVyIEFyY2hpdGVjdHVyZSAoUGh5c2ljYWwpDQpN4buZdCBz4buxIG5o4bqnbSBs4bqrbiBraW5oIMSRaeG7g24gdHJvbmcgbmfDoG5oIGvhu7kgbmdo4buHIHBo4bqnbiBt4buBbSBsw6AgxJHhu5NuZyBuaOG6pXQgZ2nhu69hICoqTGF5ZXJzKiogdsOgICoqVGllcnMqKjoNCg0KfCBUacOqdSBDaMOtIHwgTGF5ZXJlZCBBcmNoaXRlY3R1cmUgKFThuqduZyBMb2dpYykgfCBOLVRpZXIgQXJjaGl0ZWN0dXJlIChU4bqnbmcgVuG6rXQgTMO9KSB8DQp8IDotLS0gfCA6LS0tIHwgOi0tLSB8DQp8ICoqQuG6o24gY2jhuqV0KiogfCBQaMOibiBjaGlhIHbhu4EgbeG6t3QgdOG7lSBjaOG7qWMgY+G6pXUgdHLDumMgbcOjIG5ndeG7k24sIHBhY2thZ2VzLCBuYW1lc3BhY2VzIGLDqm4gdHJvbmcgY8O5bmcgbeG7mXQgdGnhur9uIHRyw6xuaC4gfCBQaMOibiBjaGlhIHbhu4EgbeG6t3QgaOG6oSB04bqnbmcgduG6rXQgbMO9LCBtw6F5IGNo4bunLCBtw6F5IOG6o28gaG/hurdjIGPDoWMgdGnhur9uIHRyw6xuaCBPUyByacOqbmcgYmnhu4d0IGNo4bqheSB0csOqbiBt4bqhbmcuIHwNCnwgKipDaGkgcGjDrSBHaWFvIHRp4bq/cCoqIHwgR+G7jWkgaMOgbSB0cm9uZyBi4buZIG5o4bubIChJbi1tZW1vcnkgY2FsbHMpIOG7nyB04buRYyDEkeG7mSBuYW5vLWdpw6J5ICgkXHRleHR7bnN9JCkuIEtow7RuZyBjw7MgY2hpIHBow60gc2VyaWFsaXplLiB8IEfhu41pIHF1YSBt4bqhbmcgKFJQQywgSFRUUCwgVENQIFNvY2tldCkg4bufIHThu5FjIMSR4buZIG1pbGktZ2nDonkgKCRcdGV4dHttc30kKSwgdOG7kW4gY2hpIHBow60gc2VyaWFsaXplL2Rlc2VyaWFsaXplIGThu68gbGnhu4d1LiB8DQp8ICoqS2jhuqMgbsSDbmcgTOG7l2kqKiB8IEtow7RuZyB0aOG7gyB44bqjeSByYSBs4buXaSDEkeG7qXQgZ8OjeSBjw6FwIG3huqFuZyBu4buZaSBi4buZIHRp4bq/biB0csOsbmguIHwgxJDhu5FpIG3hurd0IHbhu5tpIDggxJHhu4tuaCBraeG6v24gc2FpIGzhuqdtIHbhu4EgbeG6oW5nIHBow6JuIHTDoW4gKEZhbGxhY2llcyBvZiBEaXN0cmlidXRlZCBDb21wdXRpbmcpLiB8DQp8ICoqVsOtIGThu6UgS2luaCDEkWnhu4NuKiogfCBN4buZdCBmaWxlIGBhcHAuamFyYCBjaOG7qWEgY8OhYyBwYWNrYWdlOiBgY29udHJvbGxlcmAsIGBzZXJ2aWNlYCwgYGRvbWFpbmAsIGByZXBvc2l0b3J5YC4gfCBI4buHIHRo4buRbmcgMy1UaWVyOiBXZWIgU2VydmVyIChOZ2lueCkgJFx0byQgQXBwIFNlcnZlciAoU3ByaW5nIEJvb3QpICRcdG8kIERhdGFiYXNlIFNlcnZlciAoUG9zdGdyZVNRTCkgdHLDqm4gMyBzdWJuZXQga2jDoWMgbmhhdS4gfA0KDQotLS0NCg0KIyMjIDIuMi4gR2nhuqNpIFBo4bqrdSBC4buRbiBU4bqnbmcgVGnDqnUgQ2h14bqpbjogUHJlc2VudGF0aW9uLCBBcHBsaWNhdGlvbiwgRG9tYWluLCBJbmZyYXN0cnVjdHVyZQ0KDQojIyMjIDEuIFByZXNlbnRhdGlvbiBMYXllciAoVOG6p25nIFRyw6xuaCBEaeG7hW4pDQotICoqVHLDoWNoIG5oaeG7h20qKjogVGnhur9wIG5o4bqtbiBsdeG7k25nIGThu68gbGnhu4d1IHRow7QgdOG7qyB0aOG6vyBnaeG7m2kgYsOqbiBuZ2/DoGkgKEhUVFAgUmVxdWVzdCwgZ1JQQyBtZXNzYWdlLCBLYWZrYSBFdmVudCBwYXlsb2FkLCBDTEkgYXJndW1lbnRzKS4NCi0gKipUaGFvIHTDoWMgaOG7o3AgbOG7hyoqOiBYw6FjIHRo4buxYyBjw7ogcGjDoXAgKFNjaGVtYSB2YWxpZGF0aW9uLCBKU09OIHNjaGVtYSksIHBow6JuIGdp4bqjaSBtw6MgxJHhu4tuaCBkYW5oIChBdXRoZW50aWNhdGlvbiB0b2tlbiBwYXJzaW5nKSwgw6FuaCB44bqhIFJlcXVlc3Qgc2FuZyBEVE8gKERhdGEgVHJhbnNmZXIgT2JqZWN0KSBu4buZaSBi4buZLCB2w6AgY2h1eeG7g24gxJHhu5VpIGvhur90IHF14bqjIHRy4bqjIHbhu4EgbcOjIEhUVFAgdMawxqFuZyDhu6luZyAoYDIwMCBPS2AsIGAyMDEgQ3JlYXRlZGAsIGA0MDAgQmFkIFJlcXVlc3RgKS4NCi0gKirEkGnhu4F1IGPhuqVtIGvhu7UqKjogVHV54buHdCDEkeG7kWkga2jDtG5nIGNo4bupYSBsb2dpYyBuZ2hp4buHcCB24bulIHTDrW5oIHRvw6FuIChuaMawIHTDrW5oIGzDo2kgc3XhuqV0IGhheSBraeG7g20gdHJhIGjhuqFuIG3hu6ljIHTDrW4gZOG7pW5nKS4NCg0KIyMjIyAyLiBBcHBsaWNhdGlvbiBMYXllciAoVOG6p25nIOG7qG5nIEThu6VuZyAvIFdvcmtmbG93IE9yY2hlc3RyYXRpb24pDQotICoqVHLDoWNoIG5oaeG7h20qKjogxJDDs25nIHZhaSB0csOyIG5o4bqhYyB0csaw4bufbmcgxJFp4buBdSBwaOG7kWkgY8OhYyBVc2UgQ2FzZXMuDQotICoqVGhhbyB0w6FjIGjhu6NwIGzhu4cqKjoNCiAgLSBUaeG6v3Agbmjhuq1uIERUTyB04burIFByZXNlbnRhdGlvbiBMYXllci4NCiAgLSBLaOG7n2kgdOG6oW8gKipSYW5oIGdp4bubaSBHaWFvIGThu4tjaCAoVHJhbnNhY3Rpb24gQm91bmRhcnkpKio6IE3hu58ga+G6v3QgbuG7kWkgREIsIGvDrWNoIGhv4bqhdCBgQkVHSU4gVFJBTlNBQ1RJT05gLg0KICAtIFRyaeG7h3UgaOG7k2kgY8OhYyBFbnRpdGllcyB04burIERvbWFpbiBMYXllciDEkeG7gyB0aOG7sWMgdGhpIHF1eSB04bqvYyBraW5oIGRvYW5oLg0KICAtIEfhu41pIEluZnJhc3RydWN0dXJlIMSR4buDIGzGsHUgdHLhu68gdHLhuqFuZyB0aMOhaSBt4bubaSBob+G6t2MgZ+G7rWkgdGjDtG5nIGLDoW8gKEVtYWlscywgUHVzaCBub3RpZmljYXRpb25zKS4NCiAgLSBL4bq/dCB0aMO6YyBnaWFvIGThu4tjaDogYENPTU1JVCBUUkFOU0FDVElPTmAgaG/hurdjIGBST0xMQkFDS2Aga2hpIGPDsyBs4buXaS4NCg0KIyMjIyAzLiBEb21haW4gTGF5ZXIgKFThuqduZyBOZ2hp4buHcCBW4bulIEPhu5F0IEzDtWkpDQotICoqVHLDoWNoIG5oaeG7h20qKjogVHLDoWkgdGltIHbDoCB0w6BpIHPhuqNuIHRyw60gdHXhu4cgbOG7m24gbmjhuqV0IGPhu6dhIGRvYW5oIG5naGnhu4dwLiBDaOG7qWEgY8OhYyBFbnRpdGllcywgVmFsdWUgT2JqZWN0cywgRG9tYWluIEV4Y2VwdGlvbnMgdsOgIERvbWFpbiBTZXJ2aWNlcy4NCi0gKipUaGFvIHTDoWMgaOG7o3AgbOG7hyoqOiBLaeG7g20gc2/DoXQgY8OhYyDEkWnhu4F1IGtp4buHbiBi4bqldCBiaeG6v24gKENsYXNzIEludmFyaWFudHMpLCB0aOG7sWMgaGnhu4duIGPDoWMgcGjDqXAgdMOtbmggbG9naWMgdGh14bqnbiB0w7p5ICh2w60gZOG7pTogY8O0bmcgdGjhu6ljIGto4bqldSBoYW8gdMOgaSBz4bqjbiwgbHXhuq10IGNoaeG6v3Qga2jhuqV1IMSRxqFuIGjDoG5nKS4NCi0gKirEkGnhu4F1IGPhuqVtIGvhu7UqKjogSG/DoG4gdG/DoG4gxJHhu5ljIGzhuq1wIHbhu5tpIGPDtG5nIG5naOG7hyBiw6puIG5nb8OgaS4gQ+G6pW0gdGnhu4d0IHZp4buHYyBpbXBvcnQgdGjGsCB2aeG7h24gU1FMLCBPUk0gQW5ub3RhdGlvbnMsIEhUVFAgSGVhZGVycyBoYXkgSlNPTiBQYXJzZXIgdsOgbyBEb21haW4gTGF5ZXIuDQoNCiMjIyMgNC4gSW5mcmFzdHJ1Y3R1cmUgTGF5ZXIgLyBEYXRhIEFjY2VzcyBMYXllciAoREFMKQ0KLSAqKlRyw6FjaCBuaGnhu4dtKio6IEhp4buHbiB0aOG7sWMgaMOzYSBjw6FjIGdpYW8gdGnhur9wIHbhuq10IGzDvSB24bubaSBwaOG6p24gY+G7qW5nIHbDoCB0aOG6vyBnaeG7m2kgYsOqbiBuZ2/DoGk6IEvhur90IG7hu5FpIGPGoSBz4bufIGThu68gbGnhu4d1IHF1YW4gaOG7hyAoUG9zdGdyZVNRTCwgT3JhY2xlKSBob+G6t2MgTm9TUUwgKE1vbmdvREIpLCBi4buZIG5o4bubIMSR4buHbSAoUmVkaXMpLCBNZXNzYWdlIFF1ZXVlIChSYWJiaXRNUSksIGLhu5kgbMawdSB0cuG7ryDEkeG7kWkgdMaw4bujbmcgKEFXUyBTMykgdsOgIGPDoWMgZOG7i2NoIHbhu6UgYsOqbiB0aOG7qSBiYSAoU3RyaXBlLCBUd2lsaW8pLg0KDQotLS0NCg0KIyMjIDIuMy4gQ3Jvc3MtQ3V0dGluZyBDb25jZXJucyB2w6AgQ8ahIENo4bq/IFTDoWNoIFLhu51pIChBT1AgJiBNaWRkbGV3YXJlcykNCioqQ3Jvc3MtQ3V0dGluZyBDb25jZXJucyAoTeG7kWkgcXVhbiB0w6JtIHh1ecOqbiBzdeG7kXQpKiogbMOgIGPDoWMga2jDrWEgY+G6oW5oIGvhu7kgdGh14bqtdCBraMO0bmcgdGh14buZYyB24buBIG5naGnhu4dwIHbhu6UgY2h1ecOqbiBiaeG7h3QgY+G7p2EgYuG6pXQga+G7syB04bqnbmcgbsOgbyBuaMawbmcgbOG6oWkgaGnhu4duIGRp4buHbiDhu58ga2jhuq9wIG3hu41pIG7GoWk6DQotIEdoaSBuaOG6rXQga8O9IChTdHJ1Y3R1cmVkIExvZ2dpbmcgduG7m2kgQ29ycmVsYXRpb24gSUQpLg0KLSBHacOhbSBzw6F0IMSR4buZIHRy4buFIHbDoCBz4buRIGxp4buHdSAoUHJvbWV0aGV1cyBNZXRyaWNzICYgRGlzdHJpYnV0ZWQgVHJhY2luZykuDQotIFjDoWMgdGjhu7FjIHbDoCBwaMOibiBxdXnhu4FuIG5nxrDhu51pIGTDuW5nIChTZWN1cml0eSAvIEpXVCBBdXRob3JpemF0aW9uKS4NCi0gUXXhuqNuIGzDvSBi4buZIG5o4bubIMSR4buHbSAoQ2FjaGluZykuDQoNCioqR2nhuqNpIHBow6FwIEtp4bq/biB0csO6YyoqOiBLaMO0bmcgYmFvIGdp4budIHZp4bq/dCBjb2RlIGxvZ2dpbmcgaGF5IMSRbyB0aOG7nWkgZ2lhbiBs4bq3cCDEkWkgbOG6t3AgbOG6oWkg4bufIG3hu41pIHBoxrDGoW5nIHRo4bupYy4gU+G7rSBk4bulbmc6DQotICoqQXNwZWN0LU9yaWVudGVkIFByb2dyYW1taW5nIChBT1ApKiogaG/hurdjIERlY29yYXRvcnMgxJHhu4MgY2jDqG4gbG9naWMgeHV5w6puIHN14buRdCB2w6BvIHRo4budaSDEkWnhu4NtIGJpw6puIGThu4tjaCBob+G6t2MgcnVudGltZS4NCi0gKipNaWRkbGV3YXJlcyAvIEludGVyY2VwdG9ycyBQaXBlbGluZSoqIOG7nyByYW5oIGdp4bubaSBj4bunYSBQcmVzZW50YXRpb24gTGF5ZXIuDQoNCi0tLQ0KDQojIyMgMi40LiBDbG9zZWQgQXJjaGl0ZWN0dXJlIHZzIE9wZW4gQXJjaGl0ZWN0dXJlIHbDoCBW4bqlbiDEkOG7gSBSw7IgUuG7iSBU4bqnbmcgKExheWVyIExlYWtpbmcpDQoNCmBgYG1lcm1haWQNCmZsb3djaGFydCBMUg0KICAgIHN1YmdyYXBoIENsb3NlZFsiQ2xvc2VkIEFyY2hpdGVjdHVyZSAoS2h1ecOqbiBkw7luZykiXQ0KICAgICAgICBDMVtMYXllciBOXSAtLT4gQzJbTGF5ZXIgTi0xXQ0KICAgICAgICBDMiAtLT4gQzNbTGF5ZXIgTi0yXQ0KICAgIGVuZA0KDQogICAgc3ViZ3JhcGggT3BlblsiT3BlbiBBcmNoaXRlY3R1cmUgKE5ndXkgaGnhu4NtKSJdDQogICAgICAgIE8xW0xheWVyIE5dIC0tPiBPMltMYXllciBOLTFdDQogICAgICAgIE8yIC0tPiBPM1tMYXllciBOLTJdDQogICAgICAgIE8xIC0uICJOaOG6o3kgY8OzYyB4dXnDqm4gdOG6p25nISIgLi0+IE8zDQogICAgZW5kDQpgYGANCg0KLSAqKkNsb3NlZCBBcmNoaXRlY3R1cmUgKEtp4bq/biB0csO6YyDEkcOzbmcgLSBDaHXhuqluIG3hu7FjIGLhuq90IGJ14buZYykqKjoNCiAgLSBN4buZdCB04bqnbmcgY2jhu4kgxJHGsOG7o2MgcGjDqXAgZ2lhbyB0aeG6v3AgdHLhu7FjIHRp4bq/cCB24bubaSAqKnThuqduZyBuZ2F5IGLDqm4gZMaw4bubaSBuw7MqKi4NCiAgLSBNdeG7kW4gUHJlc2VudGF0aW9uIGzhuqV5IMSRxrDhu6NjIGThu68gbGnhu4d1IHThu6sgRGF0YWJhc2UsIHJlcXVlc3QgYuG6r3QgYnXhu5ljIHBo4bqjaSDEkWkgdHXhuqduIHThu7E6IFByZXNlbnRhdGlvbiAkXHRvJCBBcHBsaWNhdGlvbiAkXHRvJCBEb21haW4gJFx0byQgSW5mcmFzdHJ1Y3R1cmUuDQogIC0gKkzhu6NpIMOtY2gqOiBC4bqjbyB04buTbiB0w61uaCBjw7QgbOG6rXAgdOG7kWkgxJFhOyBraGkgdGhheSDEkeG7lWkgdOG6p25nIEluZnJhc3RydWN0dXJlLCBjaOG7iSB04bqnbmcgQXBwbGljYXRpb24gYuG7iyDhuqNuaCBoxrDhu59uZywgdOG6p25nIFByZXNlbnRhdGlvbiBob8OgbiB0b8OgbiBtaeG7hW4gbmhp4buFbS4NCi0gKipPcGVuIEFyY2hpdGVjdHVyZSAoS2nhur9uIHRyw7pjIG3hu58pKio6DQogIC0gQ2hvIHBow6lwIG3hu5l0IHThuqduZyBuaOG6o3kgY8OzYyBi4buPIHF1YSB04bqnbmcgdHJ1bmcgZ2lhbiAodsOtIGThu6U6IENvbnRyb2xsZXIgZ+G7jWkgdGjhurNuZyB2w6BvIERhdGEgQWNjZXNzIExheWVyIMSR4buDIHRo4buxYyBoaeG7h24gdHJ1eSB24bqlbiDEkeG7jWMgbmhhbmgpLg0KICAtICpI4bqtdSBxdeG6oyo6IFThuqFvIHJhIG3huqFuZyBsxrDhu5tpIHBo4bulIHRodeG7mWMgY2jDqW8gY2jhurFuZyBjaOG7i3QgKFNwYWdoZXR0aSBEZXBlbmRlbmNpZXMpLCBsw6BtIG3huqV0IGto4bqjIG7Eg25nIGtp4buDbSBzb8OhdCBsb2dpYyBuZ2hp4buHcCB24bulIHbDoCByYW5oIGdp4bubaSBnaWFvIGThu4tjaC4NCi0gKipMYXllciBMZWFraW5nIChSw7IgcuG7iSB04bqnbmcpKio6DQogIC0gSGnhu4duIHTGsOG7o25nIGNoaSB0aeG6v3QgY8OgaSDEkeG6t3QgY+G7p2EgdOG6p25nIGTGsOG7m2kgYuG7iyBwaMahaSBiw6B5IGzDqm4gdOG6p25nIHRyw6puLg0KICAtICpWw60gZOG7pSBraW5oIMSRaeG7g24qOiBUcuG6oyB0cuG7sWMgdGnhur9wIMSR4buRaSB0xrDhu6NuZyBPUk0gRW50aXR5IChgQEVudGl0eWAgY+G7p2EgSGliZXJuYXRlL0pQQSkgbMOqbiB04bqnbmcgQ29udHJvbGxlciBy4buTaSB0deG6p24gdOG7sSBow7NhIHRow6BuaCBKU09OIHRy4bqjIGNobyBDbGllbnQuIE7hur91IGRhdGFiYXNlIHRow6ptIG3hu5l0IGPhu5l0IG5o4bqheSBj4bqjbSAoYHBhc3N3b3JkX2hhc2hgKSwgZOG7ryBsaeG7h3UgYuG7iyBs4buZIHRo4bqzbmcgcmEgbmdvw6BpIEludGVybmV0IQ0KDQotLS0NCg0KIyMjIDIuNS4gU2lua2hvbGUgQW50aS1QYXR0ZXJuIHbDoCBL4bu5IFRodeG6rXQgVGluaCBH4buNbiBMdeG7k25nIEThu68gTGnhu4d1DQoqKlNpbmtob2xlIEFudGktUGF0dGVybiAoSGnhu4duIHTGsOG7o25nIGPhu5FuZyB44bqjIG5n4bqnbSkqKiB44bqjeSByYSBraGkgbeG7mXQgecOqdSBj4bqndSB44butIGzDvSB04burIENsaWVudCDEkWkgeHV5w6puIHF1YSB04bqldCBj4bqjIGPDoWMgdOG6p25nIGPhu6dhIGjhu4cgdGjhu5FuZyBtw6Aga2jDtG5nIGPDsyBi4bqldCBr4buzIHThuqduZyBuw6BvIHRo4buxYyBoaeG7h24gbeG7mXQgbG9naWMgbmdoaeG7h3AgduG7pSBjw7MgZ2nDoSB0cuG7izoNCi0gQ29udHJvbGxlciBuaOG6rW4gcmVxdWVzdCAkXHRvJCBn4buNaSBTZXJ2aWNlIGBnZXRVc2VyKGlkKWAuDQotIFNlcnZpY2Uga2jDtG5nIGzDoG0gZ8OsIG5nb8OgaSB2aeG7h2MgZ+G7jWkgUmVwb3NpdG9yeSBgZmluZFVzZXIoaWQpYC4NCi0gUmVwb3NpdG9yeSB0cuG6oyB24buBIGvhur90IHF14bqjICRcdG8kIFNlcnZpY2UgY2h1eeG7g24gdGnhur9wICRcdG8kIENvbnRyb2xsZXIgdHLhuqMgduG7gSBjbGllbnQuDQoNCioqUXV5IHThuq9jIMSQw6FuaCBnacOhIDgwLTIwIChTaW5raG9sZSBBc3Nlc3NtZW50IFJ1bGUpKio6DQotIE7hur91IGtob+G6o25nICQyMFwlJCBjw6FjIGx14buTbmcgdHJvbmcgaOG7hyB0aOG7kW5nIGzDoCBTaW5raG9sZSAoY2jhu6cgeeG6v3UgbMOgIGPDoWMgdHJ1eSB24bqlbiDEkeG7jWMgxJHGoW4gZ2nhuqNuIC0gQ1JVRCksIMSRaeG7gXUgbsOgeSBob8OgbiB0b8OgbiBiw6xuaCB0aMaw4budbmcgdsOgIGNo4bqlcCBuaOG6rW4gxJHGsOG7o2MgxJHhu4MgYuG6o28gduG7hyB0w61uaCBuaOG6pXQgcXXDoW4ga2nhur9uIHRyw7pjLg0KLSBO4bq/dSAkPiA1MC04MFwlJCBjw6FjIGx14buTbmcgbMOgIFNpbmtob2xlLCBraeG6v24gdHLDumMgY+G7p2EgYuG6oW4gxJFhbmcgYuG7iyAqKk92ZXItRW5naW5lZXJlZCAoUGjDom4gdOG6p25nIHRo4burYSB0aMOjaSkqKi4NCi0gKkdp4bqjaSBwaMOhcCo6IMOBcCBk4bulbmcgcGhvbmcgY8OhY2ggKipDUVJTKiogLSBUw6FjaCByacOqbmcgxJHGsOG7nW5nIGThuqtuIMSR4buNYyAoUmVhZCBQYXRoKSBjaG8gcGjDqXAgQ29udHJvbGxlciB0cnV5IHbhuqVuIHRy4buxYyB0aeG6v3AgVmlldyBEYXRhYmFzZSBjaHV5w6puIGThu6VuZywgdHJvbmcga2hpIHbhuqtuIGdp4buvIG5ndXnDqm4ga2nhur9uIHRyw7pjIHBow6JuIHThuqduZyBraOG6r3Qga2hlIGNobyDEkcaw4budbmcgZOG6q24gZ2hpIChXcml0ZSBQYXRoKS4NCg0KLS0tDQoNCiMjIyAyLjYuIFJhbmggR2nhu5tpIEdpYW8gROG7i2NoIChUcmFuc2FjdGlvbiBCb3VuZGFyeSkgdsOgIFF14bqjbiBUcuG7iyBUcuG6oW5nIFRow6FpDQpSYW5oIGdp4bubaSBnaWFvIGThu4tjaCBsw6AgbsahaSBi4bqvdCDEkeG6p3UgdsOgIGvhur90IHRow7pjIGPhu6dhIG3hu5l0IMSRxqFuIHbhu4sgY8O0bmcgdmnhu4djIG5ndXnDqm4gdOG7rSAoVW5pdCBvZiBXb3JrKS4NCi0gKipW4buLIHRyw60gY2h14bqpbiBt4buxYyoqOiAqKkFwcGxpY2F0aW9uIExheWVyKiouDQotICoqTMO9IGRvKio6IERvbWFpbiBMYXllciBjaOG7iSBxdWFuIHTDom0gxJHhur9uIGPDoWMgcXV5IHThuq9jIHRodeG6p24gdMO6eSBj4bunYSB04burbmcgdGjhu7FjIHRo4buDIMSR4buZYyBs4bqtcCwga2jDtG5nIG7huq9tIGdp4buvIGvhur90IG7hu5FpIGPGoSBz4bufIGThu68gbGnhu4d1LiBQcmVzZW50YXRpb24gTGF5ZXIgcXXDoSB4YSwga2jDtG5nIHRo4buDIMSR4bqjbSBi4bqjbyBhbiB0b8OgbiBu4bq/dSBt4bqhbmcgYuG7iyDEkeG7qXQgZ8OjeS4NCi0gKipDxqEgY2jhur8gduG6rW4gaMOgbmgqKjoNCiAgMS4gS2hpIG3hu5l0IFVzZSBDYXNlIMSRxrDhu6NjIGfhu41pLCBt4buZdCBUcmFuc2FjdGlvbiBIYW5kbGUgxJHGsOG7o2MgdOG6oW8gcmEuDQogIDIuIFRvw6BuIGLhu5kgY8OhYyB0aGFvIHTDoWMgZ2hpIGThu68gbGnhu4d1IHThu6sgY8OhYyBSZXBvc2l0b3J5IGtow6FjIG5oYXUgdGhhbSBnaWEgdsOgbyBjw7luZyBt4buZdCBUcmFuc2FjdGlvbiBDb250ZXh0Lg0KICAzLiBO4bq/dSB04bqldCBj4bqjIGPDoWMgxJFp4buBdSBraeG7h24gYuG6pXQgYmnhur9uIChJbnZhcmlhbnRzKSBj4bunYSBEb21haW4gxJHhu4F1IGjhu6NwIGzhu4csIFRyYW5zYWN0aW9uIMSRxrDhu6NjIGBDT01NSVRgLg0KICA0LiBO4bq/dSBjw7MgYuG6pXQga+G7syBs4buXaSBuw6BvIHjhuqN5IHJhIChEb21haW4gRXhjZXB0aW9uIGhv4bq3YyBEYXRhYmFzZSBEZWFkbG9jayksIHRvw6BuIGLhu5kgY8OhYyB0aGF5IMSR4buVaSBs4bqtcCB04bupYyDEkcaw4bujYyBgUk9MTEJBQ0tgLg0KDQotLS0NCg0KIyMgMy4gVGjhu7FjIHRoaSBNw6Mgbmd14buTbiAmIE3DtCBwaOG7j25nIENodXnDqm4gc8OidSAoRHVhbC1FbmdpbmUgSW1wbGVtZW50YXRpb24pDQoNCiMjIyAzLjEuIEMrKzIwIEltcGxlbWVudGF0aW9uOiBTdHJpY3QgQ2xvc2VkIExheWVyZWQgQXJjaGl0ZWN0dXJlIHdpdGggUkFJSSBUcmFuc2FjdGlvbiBNYW5hZ2VtZW50DQrEkG/huqFuIG3DoyBDKysyMCBkxrDhu5tpIMSRw6J5IG1pbmggaOG7jWEgaOG7hyB0aOG7kW5nIG5nw6JuIGjDoG5nIHBow6JuIHThuqduZyBraOG6r3Qga2hlIChDbG9zZWQgTGF5ZXJlZCBBcmNoaXRlY3R1cmUpIHbhu5tpIGPGoSBjaOG6vyBxdeG6o24gbMO9IFRyYW5zYWN0aW9uIEJvdW5kYXJ5IHThu7EgxJHhu5luZyBi4bqxbmcgUkFJSSB2w6AgbmfEg24gbmfhu6thIExheWVyIExlYWtpbmcgdGjDtG5nIHF1YSBEVE8gTWFwcGVycy4NCg0KYGBgY3BwDQojaW5jbHVkZSA8aW9zdHJlYW0+DQojaW5jbHVkZSA8bWVtb3J5Pg0KI2luY2x1ZGUgPHN0cmluZz4NCiNpbmNsdWRlIDxzdGRleGNlcHQ+DQojaW5jbHVkZSA8dmVjdG9yPg0KI2luY2x1ZGUgPHV0aWxpdHk+DQoNCi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0NCi8vIDEuIERPTUFJTiBMQVlFUiAoWmVybyBleHRlcm5hbCBkZXBlbmRlbmNpZXMgLSBQdXJpdHkpDQovLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQpjbGFzcyBJbnN1ZmZpY2llbnRGdW5kc0V4Y2VwdGlvbiA6IHB1YmxpYyBzdGQ6OnJ1bnRpbWVfZXJyb3Igew0KcHVibGljOg0KICAgIGV4cGxpY2l0IEluc3VmZmljaWVudEZ1bmRzRXhjZXB0aW9uKGNvbnN0IHN0ZDo6c3RyaW5nJiBtc2cpIDogc3RkOjpydW50aW1lX2Vycm9yKG1zZykge30NCn07DQoNCmNsYXNzIEJhbmtBY2NvdW50IHsNCnByaXZhdGU6DQogICAgdWludDY0X3QgaWRfOw0KICAgIGludDY0X3QgYmFsYW5jZUNlbnRzXzsNCg0KcHVibGljOg0KICAgIEJhbmtBY2NvdW50KHVpbnQ2NF90IGlkLCBpbnQ2NF90IGluaXRpYWxDZW50cykgOiBpZF8oaWQpLCBiYWxhbmNlQ2VudHNfKGluaXRpYWxDZW50cykgew0KICAgICAgICBpZiAoaW5pdGlhbENlbnRzIDwgMCkgdGhyb3cgc3RkOjppbnZhbGlkX2FyZ3VtZW50KCJJbml0aWFsIGJhbGFuY2UgY2Fubm90IGJlIG5lZ2F0aXZlIik7DQogICAgfQ0KDQogICAgdm9pZCBkZWJpdChpbnQ2NF90IGNlbnRzKSB7DQogICAgICAgIGlmIChjZW50cyA8PSAwKSB0aHJvdyBzdGQ6OmludmFsaWRfYXJndW1lbnQoIkRlYml0IGFtb3VudCBtdXN0IGJlIHBvc2l0aXZlIik7DQogICAgICAgIGlmIChiYWxhbmNlQ2VudHNfIDwgY2VudHMpIHsNCiAgICAgICAgICAgIHRocm93IEluc3VmZmljaWVudEZ1bmRzRXhjZXB0aW9uKCJJbnN1ZmZpY2llbnQgZnVuZHM6IGN1cnJlbnQgIiArIA0KICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgc3RkOjp0b19zdHJpbmcoYmFsYW5jZUNlbnRzXykgKyAiLCByZXF1ZXN0ZWQgIiArIHN0ZDo6dG9fc3RyaW5nKGNlbnRzKSk7DQogICAgICAgIH0NCiAgICAgICAgYmFsYW5jZUNlbnRzXyAtPSBjZW50czsNCiAgICB9DQoNCiAgICB2b2lkIGNyZWRpdChpbnQ2NF90IGNlbnRzKSB7DQogICAgICAgIGlmIChjZW50cyA8PSAwKSB0aHJvdyBzdGQ6OmludmFsaWRfYXJndW1lbnQoIkNyZWRpdCBhbW91bnQgbXVzdCBiZSBwb3NpdGl2ZSIpOw0KICAgICAgICBiYWxhbmNlQ2VudHNfICs9IGNlbnRzOw0KICAgIH0NCg0KICAgIFtbbm9kaXNjYXJkXV0gdWludDY0X3QgaWQoKSBjb25zdCBub2V4Y2VwdCB7IHJldHVybiBpZF87IH0NCiAgICBbW25vZGlzY2FyZF1dIGludDY0X3QgYmFsYW5jZUNlbnRzKCkgY29uc3Qgbm9leGNlcHQgeyByZXR1cm4gYmFsYW5jZUNlbnRzXzsgfQ0KfTsNCg0KLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KLy8gMi4gSU5GUkFTVFJVQ1RVUkUgSU5URVJGQUNFUyAmIElNUExFTUVOVEFUSU9ODQovLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQpjbGFzcyBJVHJhbnNhY3Rpb25Db250ZXh0IHsNCnB1YmxpYzoNCiAgICB2aXJ0dWFsIH5JVHJhbnNhY3Rpb25Db250ZXh0KCkgPSBkZWZhdWx0Ow0KICAgIHZpcnR1YWwgdm9pZCBjb21taXQoKSA9IDA7DQogICAgdmlydHVhbCB2b2lkIHJvbGxiYWNrKCkgPSAwOw0KfTsNCg0KY2xhc3MgSUFjY291bnRSZXBvc2l0b3J5IHsNCnB1YmxpYzoNCiAgICB2aXJ0dWFsIH5JQWNjb3VudFJlcG9zaXRvcnkoKSA9IGRlZmF1bHQ7DQogICAgdmlydHVhbCBzdGQ6OnVuaXF1ZV9wdHI8QmFua0FjY291bnQ+IGZpbmRCeUlkKHVpbnQ2NF90IGlkKSA9IDA7DQogICAgdmlydHVhbCB2b2lkIHNhdmUoY29uc3QgQmFua0FjY291bnQmIGFjY291bnQpID0gMDsNCiAgICB2aXJ0dWFsIHN0ZDo6dW5pcXVlX3B0cjxJVHJhbnNhY3Rpb25Db250ZXh0PiBiZWdpblRyYW5zYWN0aW9uKCkgPSAwOw0KfTsNCg0KLy8gR2nhuqMgbOG6rXAgbMawdSB0cuG7ryBEYXRhYmFzZSB0aOG7sWMgdOG6vw0KY2xhc3MgTW9ja1NxbEFjY291bnRSZXBvc2l0b3J5IDogcHVibGljIElBY2NvdW50UmVwb3NpdG9yeSB7DQpwcml2YXRlOg0KICAgIGNsYXNzIE1vY2tUeCA6IHB1YmxpYyBJVHJhbnNhY3Rpb25Db250ZXh0IHsNCiAgICBwdWJsaWM6DQogICAgICAgIHZvaWQgY29tbWl0KCkgb3ZlcnJpZGUgeyBzdGQ6OmNvdXQgPDwgIiAgW0RCIEVuZ2luZV0gPj4+IENPTU1JVCBUUkFOU0FDVElPTiBFeGVjdXRlZCBTdWNjZXNzZnVsbHkuXG4iOyB9DQogICAgICAgIHZvaWQgcm9sbGJhY2soKSBvdmVycmlkZSB7IHN0ZDo6Y291dCA8PCAiICBbREIgRW5naW5lXSA+Pj4gUk9MTEJBQ0sgVFJBTlNBQ1RJT04gVHJpZ2dlcmVkIVxuIjsgfQ0KICAgIH07DQpwdWJsaWM6DQogICAgc3RkOjp1bmlxdWVfcHRyPEJhbmtBY2NvdW50PiBmaW5kQnlJZCh1aW50NjRfdCBpZCkgb3ZlcnJpZGUgew0KICAgICAgICBzdGQ6OmNvdXQgPDwgIiAgW0RCIEVuZ2luZV0gUXVlcnk6IFNFTEVDVCAqIEZST00gYWNjb3VudHMgV0hFUkUgaWQgPSAiIDw8IGlkIDw8ICI7XG4iOw0KICAgICAgICByZXR1cm4gc3RkOjptYWtlX3VuaXF1ZTxCYW5rQWNjb3VudD4oaWQsIDEwMCcwMDApOyAvLyBNb2NrIHPhu5EgZMawICQxLDAwMC4wMA0KICAgIH0NCg0KICAgIHZvaWQgc2F2ZShjb25zdCBCYW5rQWNjb3VudCYgYWNjb3VudCkgb3ZlcnJpZGUgew0KICAgICAgICBzdGQ6OmNvdXQgPDwgIiAgW0RCIEVuZ2luZV0gUXVlcnk6IFVQREFURSBhY2NvdW50cyBTRVQgYmFsYW5jZSA9ICIgDQogICAgICAgICAgICAgICAgICA8PCBhY2NvdW50LmJhbGFuY2VDZW50cygpIDw8ICIgV0hFUkUgaWQgPSAiIDw8IGFjY291bnQuaWQoKSA8PCAiO1xuIjsNCiAgICB9DQoNCiAgICBzdGQ6OnVuaXF1ZV9wdHI8SVRyYW5zYWN0aW9uQ29udGV4dD4gYmVnaW5UcmFuc2FjdGlvbigpIG92ZXJyaWRlIHsNCiAgICAgICAgc3RkOjpjb3V0IDw8ICIgIFtEQiBFbmdpbmVdID4+PiBCRUdJTiBUUkFOU0FDVElPTlxuIjsNCiAgICAgICAgcmV0dXJuIHN0ZDo6bWFrZV91bmlxdWU8TW9ja1R4PigpOw0KICAgIH0NCn07DQoNCi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0NCi8vIDMuIEFQUExJQ0FUSU9OIExBWUVSIChUcmFuc2FjdGlvbiBCb3VuZGFyeSAmIERUTyBEZWZpbml0aW9ucykNCi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0NCnN0cnVjdCBUcmFuc2ZlclJlcXVlc3REdG8gew0KICAgIHVpbnQ2NF90IGZyb21BY2NvdW50SWQ7DQogICAgdWludDY0X3QgdG9BY2NvdW50SWQ7DQogICAgaW50NjRfdCBhbW91bnRDZW50czsNCn07DQoNCnN0cnVjdCBUcmFuc2ZlclJlc3BvbnNlRHRvIHsNCiAgICBib29sIHN1Y2Nlc3M7DQogICAgc3RkOjpzdHJpbmcgbWVzc2FnZTsNCiAgICBpbnQ2NF90IGZyb21SZW1haW5pbmdCYWxhbmNlQ2VudHM7DQp9Ow0KDQpjbGFzcyBUcmFuc2Zlck1vbmV5VXNlQ2FzZSB7DQpwcml2YXRlOg0KICAgIHN0ZDo6c2hhcmVkX3B0cjxJQWNjb3VudFJlcG9zaXRvcnk+IHJlcG9fOw0KDQpwdWJsaWM6DQogICAgZXhwbGljaXQgVHJhbnNmZXJNb25leVVzZUNhc2Uoc3RkOjpzaGFyZWRfcHRyPElBY2NvdW50UmVwb3NpdG9yeT4gcmVwbykgOiByZXBvXyhzdGQ6Om1vdmUocmVwbykpIHt9DQoNCiAgICBUcmFuc2ZlclJlc3BvbnNlRHRvIGV4ZWN1dGUoY29uc3QgVHJhbnNmZXJSZXF1ZXN0RHRvJiByZXF1ZXN0KSB7DQogICAgICAgIC8vIE3hu58gcmFuaCBnaeG7m2kgZ2lhbyBk4buLY2ggKFRyYW5zYWN0aW9uIEJvdW5kYXJ5KQ0KICAgICAgICBhdXRvIHR4ID0gcmVwb18tPmJlZ2luVHJhbnNhY3Rpb24oKTsNCiAgICAgICAgdHJ5IHsNCiAgICAgICAgICAgIGF1dG8gZnJvbUFjYyA9IHJlcG9fLT5maW5kQnlJZChyZXF1ZXN0LmZyb21BY2NvdW50SWQpOw0KICAgICAgICAgICAgYXV0byB0b0FjYyA9IHJlcG9fLT5maW5kQnlJZChyZXF1ZXN0LnRvQWNjb3VudElkKTsNCg0KICAgICAgICAgICAgaWYgKCFmcm9tQWNjIHx8ICF0b0FjYykgew0KICAgICAgICAgICAgICAgIHRocm93IHN0ZDo6cnVudGltZV9lcnJvcigiT25lIG9yIG1vcmUgYWNjb3VudHMgbm90IGZvdW5kIik7DQogICAgICAgICAgICB9DQoNCiAgICAgICAgICAgIC8vIFRo4buxYyB0aGkgRG9tYWluIExvZ2ljIG5ndXnDqm4gY2jhuqV0DQogICAgICAgICAgICBmcm9tQWNjLT5kZWJpdChyZXF1ZXN0LmFtb3VudENlbnRzKTsNCiAgICAgICAgICAgIHRvQWNjLT5jcmVkaXQocmVxdWVzdC5hbW91bnRDZW50cyk7DQoNCiAgICAgICAgICAgIC8vIEzGsHUgdHLhu68gdHLhuqFuZyB0aMOhaSBt4bubaQ0KICAgICAgICAgICAgcmVwb18tPnNhdmUoKmZyb21BY2MpOw0KICAgICAgICAgICAgcmVwb18tPnNhdmUoKnRvQWNjKTsNCg0KICAgICAgICAgICAgLy8gWMOhYyBuaOG6rW4gZ2lhbyBk4buLY2gNCiAgICAgICAgICAgIHR4LT5jb21taXQoKTsNCg0KICAgICAgICAgICAgcmV0dXJuIFRyYW5zZmVyUmVzcG9uc2VEdG97DQogICAgICAgICAgICAgICAgLnN1Y2Nlc3MgPSB0cnVlLA0KICAgICAgICAgICAgICAgIC5tZXNzYWdlID0gIkZ1bmRzIHRyYW5zZmVycmVkIHN1Y2Nlc3NmdWxseSIsDQogICAgICAgICAgICAgICAgLmZyb21SZW1haW5pbmdCYWxhbmNlQ2VudHMgPSBmcm9tQWNjLT5iYWxhbmNlQ2VudHMoKQ0KICAgICAgICAgICAgfTsNCiAgICAgICAgfSBjYXRjaCAoY29uc3Qgc3RkOjpleGNlcHRpb24mIGV4KSB7DQogICAgICAgICAgICB0eC0+cm9sbGJhY2soKTsNCiAgICAgICAgICAgIHRocm93OyAvLyBMYW4gdHJ1eeG7gW4gdGnhur9wIMSR4buDIFByZXNlbnRhdGlvbiBMYXllciBjaHV54buDbiDEkeG7lWkgc2FuZyBIVFRQIHN0YXR1cyBjb2RlDQogICAgICAgIH0NCiAgICB9DQp9Ow0KDQovLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQovLyA0LiBQUkVTRU5UQVRJT04gTEFZRVIgKFJFU1QgQ29udHJvbGxlciBTaW11bGF0aW9uKQ0KLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KY2xhc3MgUGF5bWVudEh0dHBDb250cm9sbGVyIHsNCnByaXZhdGU6DQogICAgVHJhbnNmZXJNb25leVVzZUNhc2UgdXNlQ2FzZV87DQoNCnB1YmxpYzoNCiAgICBleHBsaWNpdCBQYXltZW50SHR0cENvbnRyb2xsZXIoVHJhbnNmZXJNb25leVVzZUNhc2UgdXNlQ2FzZSkgOiB1c2VDYXNlXyhzdGQ6Om1vdmUodXNlQ2FzZSkpIHt9DQoNCiAgICB2b2lkIGhhbmRsZVBvc3RUcmFuc2Zlcih1aW50NjRfdCBmcm9tLCB1aW50NjRfdCB0bywgaW50NjRfdCBjZW50cykgew0KICAgICAgICBzdGQ6OmNvdXQgPDwgIlxuW0hUVFAgUHJlc2VudGF0aW9uIExheWVyXSBSZWNlaXZlZCBQT1NUIC9hcGkvdHJhbnNmZXJzIHBheWxvYWQuLi5cbiI7DQogICAgICAgIC8vIDEuIFZhbGlkYXRpb24gY8O6IHBow6FwIMSR4bqndSB2w6BvDQogICAgICAgIGlmIChjZW50cyA8PSAwKSB7DQogICAgICAgICAgICBzdGQ6OmNvdXQgPDwgIiAgLT4gSFRUUCA0MDAgQmFkIFJlcXVlc3Q6IEFtb3VudCBtdXN0IGJlIGdyZWF0ZXIgdGhhbiB6ZXJvLlxuIjsNCiAgICAgICAgICAgIHJldHVybjsNCiAgICAgICAgfQ0KDQogICAgICAgIFRyYW5zZmVyUmVxdWVzdER0byBkdG97ZnJvbSwgdG8sIGNlbnRzfTsNCg0KICAgICAgICAvLyAyLiBDaHV54buDbiBnaWFvIHh14buRbmcgQXBwbGljYXRpb24gTGF5ZXINCiAgICAgICAgdHJ5IHsNCiAgICAgICAgICAgIGF1dG8gcmVzcG9uc2UgPSB1c2VDYXNlXy5leGVjdXRlKGR0byk7DQogICAgICAgICAgICBzdGQ6OmNvdXQgPDwgIiAgLT4gSFRUUCAyMDAgT0s6ICIgPDwgcmVzcG9uc2UubWVzc2FnZSANCiAgICAgICAgICAgICAgICAgICAgICA8PCAiIHwgTmV3IEJhbGFuY2U6ICIgPDwgcmVzcG9uc2UuZnJvbVJlbWFpbmluZ0JhbGFuY2VDZW50cyA8PCAiIGNlbnRzXG4iOw0KICAgICAgICB9IGNhdGNoIChjb25zdCBJbnN1ZmZpY2llbnRGdW5kc0V4Y2VwdGlvbiYgZXgpIHsNCiAgICAgICAgICAgIHN0ZDo6Y291dCA8PCAiICAtPiBIVFRQIDQyMiBVbnByb2Nlc3NhYmxlIEVudGl0eSAoRG9tYWluIFJ1bGUgVmlvbGF0ZWQpOiAiIDw8IGV4LndoYXQoKSA8PCAiXG4iOw0KICAgICAgICB9IGNhdGNoIChjb25zdCBzdGQ6OmV4Y2VwdGlvbiYgZXgpIHsNCiAgICAgICAgICAgIHN0ZDo6Y291dCA8PCAiICAtPiBIVFRQIDUwMCBJbnRlcm5hbCBTZXJ2ZXIgRXJyb3I6ICIgPDwgZXgud2hhdCgpIDw8ICJcbiI7DQogICAgICAgIH0NCiAgICB9DQp9Ow0KDQppbnQgbWFpbigpIHsNCiAgICBzdGQ6OmNvdXQgPDwgIj09PSBDKysyMCBTdHJpY3QgQ2xvc2VkIExheWVyZWQgQXJjaGl0ZWN0dXJlIERlbW8gPT09XG4iOw0KDQogICAgYXV0byByZXBvID0gc3RkOjptYWtlX3NoYXJlZDxNb2NrU3FsQWNjb3VudFJlcG9zaXRvcnk+KCk7DQogICAgVHJhbnNmZXJNb25leVVzZUNhc2UgdXNlQ2FzZShyZXBvKTsNCiAgICBQYXltZW50SHR0cENvbnRyb2xsZXIgY29udHJvbGxlcih1c2VDYXNlKTsNCg0KICAgIC8vIEvhu4tjaCBi4bqjbiAxOiBHaWFvIGThu4tjaCB0aMOgbmggY8O0bmcNCiAgICBjb250cm9sbGVyLmhhbmRsZVBvc3RUcmFuc2ZlcigxMDEsIDEwMiwgMjUnMDAwKTsgLy8gQ2h1eeG7g24gJDI1MC4wMA0KDQogICAgLy8gS+G7i2NoIGLhuqNuIDI6IEdpYW8gZOG7i2NoIHZpIHBo4bqhbSBEb21haW4gUnVsZSAoS2jDtG5nIMSR4bunIHRp4buBbikNCiAgICBjb250cm9sbGVyLmhhbmRsZVBvc3RUcmFuc2ZlcigxMDEsIDEwMiwgNTAwJzAwMCk7IC8vIENodXnhu4NuICQ1LDAwMC4wMCAoU+G7kSBkxrAgY2jhu4kgY8OzICQxLDAwMC4wMCkNCg0KICAgIHJldHVybiAwOw0KfQ0KYGBgDQoNCiMjIyMgVGVybWluYWwgT3V0cHV0IE3huqt1IChDKysyMCk6DQpgYGB0ZXh0DQo9PT0gQysrMjAgU3RyaWN0IENsb3NlZCBMYXllcmVkIEFyY2hpdGVjdHVyZSBEZW1vID09PQ0KDQpbSFRUUCBQcmVzZW50YXRpb24gTGF5ZXJdIFJlY2VpdmVkIFBPU1QgL2FwaS90cmFuc2ZlcnMgcGF5bG9hZC4uLg0KICBbREIgRW5naW5lXSA+Pj4gQkVHSU4gVFJBTlNBQ1RJT04NCiAgW0RCIEVuZ2luZV0gUXVlcnk6IFNFTEVDVCAqIEZST00gYWNjb3VudHMgV0hFUkUgaWQgPSAxMDE7DQogIFtEQiBFbmdpbmVdIFF1ZXJ5OiBTRUxFQ1QgKiBGUk9NIGFjY291bnRzIFdIRVJFIGlkID0gMTAyOw0KICBbREIgRW5naW5lXSBRdWVyeTogVVBEQVRFIGFjY291bnRzIFNFVCBiYWxhbmNlID0gNzUwMDAgV0hFUkUgaWQgPSAxMDE7DQogIFtEQiBFbmdpbmVdIFF1ZXJ5OiBVUERBVEUgYWNjb3VudHMgU0VUIGJhbGFuY2UgPSAxMjUwMDAgV0hFUkUgaWQgPSAxMDI7DQogIFtEQiBFbmdpbmVdID4+PiBDT01NSVQgVFJBTlNBQ1RJT04gRXhlY3V0ZWQgU3VjY2Vzc2Z1bGx5Lg0KICAtPiBIVFRQIDIwMCBPSzogRnVuZHMgdHJhbnNmZXJyZWQgc3VjY2Vzc2Z1bGx5IHwgTmV3IEJhbGFuY2U6IDc1MDAwIGNlbnRzDQoNCltIVFRQIFByZXNlbnRhdGlvbiBMYXllcl0gUmVjZWl2ZWQgUE9TVCAvYXBpL3RyYW5zZmVycyBwYXlsb2FkLi4uDQogIFtEQiBFbmdpbmVdID4+PiBCRUdJTiBUUkFOU0FDVElPTg0KICBbREIgRW5naW5lXSBRdWVyeTogU0VMRUNUICogRlJPTSBhY2NvdW50cyBXSEVSRSBpZCA9IDEwMTsNCiAgW0RCIEVuZ2luZV0gUXVlcnk6IFNFTEVDVCAqIEZST00gYWNjb3VudHMgV0hFUkUgaWQgPSAxMDI7DQogIFtEQiBFbmdpbmVdID4+PiBST0xMQkFDSyBUUkFOU0FDVElPTiBUcmlnZ2VyZWQhDQogIC0+IEhUVFAgNDIyIFVucHJvY2Vzc2FibGUgRW50aXR5IChEb21haW4gUnVsZSBWaW9sYXRlZCk6IEluc3VmZmljaWVudCBmdW5kczogY3VycmVudCAxMDAwMDAsIHJlcXVlc3RlZCA1MDAwMDANCmBgYA0KDQotLS0NCg0KIyMjIDMuMi4gUHl0aG9uIDMuMTErIEltcGxlbWVudGF0aW9uOiBDbGVhbiBMYXllcmVkIFNlcnZpY2Ugd2l0aCBEVE8gUHJvdGVjdGlvbg0KQ2jGsMahbmcgdHLDrG5oIFB5dGhvbiAzLjExKyBkxrDhu5tpIMSRw6J5IG1pbmggaOG7jWEgdmnhu4djIHRo4buxYyB0aGkgcGjDom4gdOG6p25nIGto4bqvdCBraGUsIMOhcCBk4bulbmcgVHJhbnNhY3Rpb24gQm91bmRhcnkgcXVhIENvbnRleHQgTWFuYWdlciB2w6AgRFRPIE1hcHBlciBuZ8SDbiBjaOG6t24gdHJp4buHdCDEkeG7gyBMYXllciBMZWFraW5nLg0KDQpgYGBweXRob24NCmZyb20gX19mdXR1cmVfXyBpbXBvcnQgYW5ub3RhdGlvbnMNCmZyb20gZGF0YWNsYXNzZXMgaW1wb3J0IGRhdGFjbGFzcw0KZnJvbSB0eXBpbmcgaW1wb3J0IFByb3RvY29sLCBPcHRpb25hbA0KaW1wb3J0IGNvbnRleHRsaWINCg0KIyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQojIDEuIERPTUFJTiBMQVlFUg0KIyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQpjbGFzcyBCdXNpbmVzc1J1bGVFcnJvcihFeGNlcHRpb24pOg0KICAgIHBhc3MNCg0KY2xhc3MgUHJvZHVjdE5vdEF2YWlsYWJsZUVycm9yKEJ1c2luZXNzUnVsZUVycm9yKToNCiAgICBwYXNzDQoNCkBkYXRhY2xhc3MNCmNsYXNzIE9yZGVyTGluZToNCiAgICBwcm9kdWN0X2lkOiBzdHINCiAgICBxdWFudGl0eTogaW50DQogICAgdW5pdF9wcmljZTogZmxvYXQNCg0KICAgIEBwcm9wZXJ0eQ0KICAgIGRlZiBzdWJ0b3RhbChzZWxmKSAtPiBmbG9hdDoNCiAgICAgICAgcmV0dXJuIHNlbGYucXVhbnRpdHkgKiBzZWxmLnVuaXRfcHJpY2UNCg0KY2xhc3MgT3JkZXI6DQogICAgZGVmIF9faW5pdF9fKHNlbGYsIG9yZGVyX2lkOiBzdHIsIGN1c3RvbWVyX2lkOiBzdHIpOg0KICAgICAgICBzZWxmLm9yZGVyX2lkID0gb3JkZXJfaWQNCiAgICAgICAgc2VsZi5jdXN0b21lcl9pZCA9IGN1c3RvbWVyX2lkDQogICAgICAgIHNlbGYubGluZXM6IGxpc3RbT3JkZXJMaW5lXSA9IFtdDQogICAgICAgIHNlbGYuc3RhdHVzOiBzdHIgPSAiRFJBRlQiDQoNCiAgICBkZWYgYWRkX2l0ZW0oc2VsZiwgcHJvZHVjdF9pZDogc3RyLCBxdWFudGl0eTogaW50LCB1bml0X3ByaWNlOiBmbG9hdCkgLT4gTm9uZToNCiAgICAgICAgaWYgcXVhbnRpdHkgPD0gMDoNCiAgICAgICAgICAgIHJhaXNlIEJ1c2luZXNzUnVsZUVycm9yKCJRdWFudGl0eSBtdXN0IGJlIHBvc2l0aXZlIikNCiAgICAgICAgc2VsZi5saW5lcy5hcHBlbmQoT3JkZXJMaW5lKHByb2R1Y3RfaWQsIHF1YW50aXR5LCB1bml0X3ByaWNlKSkNCg0KICAgIGRlZiBjb25maXJtKHNlbGYpIC0+IE5vbmU6DQogICAgICAgIGlmIG5vdCBzZWxmLmxpbmVzOg0KICAgICAgICAgICAgcmFpc2UgQnVzaW5lc3NSdWxlRXJyb3IoIkNhbm5vdCBjb25maXJtIGFuIGVtcHR5IG9yZGVyIikNCiAgICAgICAgc2VsZi5zdGF0dXMgPSAiQ09ORklSTUVEIg0KDQogICAgQHByb3BlcnR5DQogICAgZGVmIHRvdGFsX2Ftb3VudChzZWxmKSAtPiBmbG9hdDoNCiAgICAgICAgcmV0dXJuIHN1bShsaW5lLnN1YnRvdGFsIGZvciBsaW5lIGluIHNlbGYubGluZXMpDQoNCiMgPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KIyAyLiBJTkZSQVNUUlVDVFVSRSBJTlRFUkZBQ0VTICYgTU9DSyBBREFQVEVSDQojID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0NCmNsYXNzIElPcmRlclJlcG9zaXRvcnkoUHJvdG9jb2wpOg0KICAgIGRlZiBzYXZlKHNlbGYsIG9yZGVyOiBPcmRlcikgLT4gTm9uZTogLi4uDQogICAgZGVmIGZpbmRfYnlfaWQoc2VsZiwgb3JkZXJfaWQ6IHN0cikgLT4gT3B0aW9uYWxbT3JkZXJdOiAuLi4NCiAgICBAY29udGV4dGxpYi5jb250ZXh0bWFuYWdlcg0KICAgIGRlZiB0cmFuc2FjdGlvbihzZWxmKTogLi4uDQoNCmNsYXNzIE1vY2tEYXRhYmFzZVJlcG9zaXRvcnk6DQogICAgZGVmIF9faW5pdF9fKHNlbGYpOg0KICAgICAgICBzZWxmLl9zdG9yYWdlOiBkaWN0W3N0ciwgT3JkZXJdID0ge30NCg0KICAgIGRlZiBzYXZlKHNlbGYsIG9yZGVyOiBPcmRlcikgLT4gTm9uZToNCiAgICAgICAgcHJpbnQoZiIgIFtEQiBTdG9yYWdlXSBTYXZpbmcgT3JkZXIge29yZGVyLm9yZGVyX2lkfSAoU3RhdHVzOiB7b3JkZXIuc3RhdHVzfSkgdG8gRGF0YWJhc2UuLi4iKQ0KICAgICAgICBzZWxmLl9zdG9yYWdlW29yZGVyLm9yZGVyX2lkXSA9IG9yZGVyDQoNCiAgICBkZWYgZmluZF9ieV9pZChzZWxmLCBvcmRlcl9pZDogc3RyKSAtPiBPcHRpb25hbFtPcmRlcl06DQogICAgICAgIHJldHVybiBzZWxmLl9zdG9yYWdlLmdldChvcmRlcl9pZCkNCg0KICAgIEBjb250ZXh0bGliLmNvbnRleHRtYW5hZ2VyDQogICAgZGVmIHRyYW5zYWN0aW9uKHNlbGYpOg0KICAgICAgICBwcmludCgiICBbREIgRW5naW5lXSA9PT0gQkVHSU4gVFJBTlNBQ1RJT04gPT09IikNCiAgICAgICAgdHJ5Og0KICAgICAgICAgICAgeWllbGQNCiAgICAgICAgICAgIHByaW50KCIgIFtEQiBFbmdpbmVdID09PSBDT01NSVQgVFJBTlNBQ1RJT04gPT09IikNCiAgICAgICAgZXhjZXB0IEV4Y2VwdGlvbjoNCiAgICAgICAgICAgIHByaW50KCIgIFtEQiBFbmdpbmVdID09PSBST0xMQkFDSyBUUkFOU0FDVElPTiBEVUUgVE8gRVhDRVBUSU9OID09PSIpDQogICAgICAgICAgICByYWlzZQ0KDQojID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0NCiMgMy4gQVBQTElDQVRJT04gTEFZRVIgKFVTRSBDQVNFICYgRFRPUykNCiMgPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KQGRhdGFjbGFzcyhmcm96ZW49VHJ1ZSkNCmNsYXNzIENyZWF0ZU9yZGVySW5wdXREVE86DQogICAgY3VzdG9tZXJfaWQ6IHN0cg0KICAgIHByb2R1Y3RfaWQ6IHN0cg0KICAgIHF1YW50aXR5OiBpbnQNCiAgICB1bml0X3ByaWNlOiBmbG9hdA0KDQpAZGF0YWNsYXNzKGZyb3plbj1UcnVlKQ0KY2xhc3MgT3JkZXJSZXNwb25zZURUTzoNCiAgICBvcmRlcl9pZDogc3RyDQogICAgdG90YWxfYW1vdW50OiBmbG9hdA0KICAgIHN0YXR1czogc3RyDQoNCmNsYXNzIENyZWF0ZU9yZGVyVXNlQ2FzZToNCiAgICBkZWYgX19pbml0X18oc2VsZiwgcmVwbzogSU9yZGVyUmVwb3NpdG9yeSk6DQogICAgICAgIHNlbGYuX3JlcG8gPSByZXBvDQoNCiAgICBkZWYgZXhlY3V0ZShzZWxmLCBkdG86IENyZWF0ZU9yZGVySW5wdXREVE8pIC0+IE9yZGVyUmVzcG9uc2VEVE86DQogICAgICAgICMgVHJhbnNhY3Rpb24gQm91bmRhcnkgbuG6sW0gdHLhu41uIHbhurluIHRyb25nIEFwcGxpY2F0aW9uIExheWVyDQogICAgICAgIHdpdGggc2VsZi5fcmVwby50cmFuc2FjdGlvbigpOg0KICAgICAgICAgICAgIyBU4bqhbyBFbnRpdHkgRG9tYWluDQogICAgICAgICAgICBpbXBvcnQgdXVpZA0KICAgICAgICAgICAgb3JkZXIgPSBPcmRlcihvcmRlcl9pZD1zdHIodXVpZC51dWlkNCgpKVs6OF0sIGN1c3RvbWVyX2lkPWR0by5jdXN0b21lcl9pZCkNCiAgICAgICAgICAgIG9yZGVyLmFkZF9pdGVtKGR0by5wcm9kdWN0X2lkLCBkdG8ucXVhbnRpdHksIGR0by51bml0X3ByaWNlKQ0KICAgICAgICAgICAgb3JkZXIuY29uZmlybSgpDQoNCiAgICAgICAgICAgICMgTMawdSB4deG7kW5nIGjhuqEgdOG6p25nDQogICAgICAgICAgICBzZWxmLl9yZXBvLnNhdmUob3JkZXIpDQoNCiAgICAgICAgICAgICMgTUFQUEVSOiBDaHV54buDbiDEkeG7lWkgc2FuZyBSZXNwb25zZSBEVE8gKE5nxINuIGNo4bq3biBMYXllciBMZWFraW5nIGPhu6dhIEVudGl0eSkNCiAgICAgICAgICAgIHJldHVybiBPcmRlclJlc3BvbnNlRFRPKA0KICAgICAgICAgICAgICAgIG9yZGVyX2lkPW9yZGVyLm9yZGVyX2lkLA0KICAgICAgICAgICAgICAgIHRvdGFsX2Ftb3VudD1vcmRlci50b3RhbF9hbW91bnQsDQogICAgICAgICAgICAgICAgc3RhdHVzPW9yZGVyLnN0YXR1cw0KICAgICAgICAgICAgKQ0KDQojID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0NCiMgNC4gUFJFU0VOVEFUSU9OIExBWUVSIChXRUIgQ09OVFJPTExFUikNCiMgPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KY2xhc3MgV2ViT3JkZXJDb250cm9sbGVyOg0KICAgIGRlZiBfX2luaXRfXyhzZWxmLCB1c2VfY2FzZTogQ3JlYXRlT3JkZXJVc2VDYXNlKToNCiAgICAgICAgc2VsZi5fdXNlX2Nhc2UgPSB1c2VfY2FzZQ0KDQogICAgZGVmIGhhbmRsZV9yZXF1ZXN0KHNlbGYsIHBheWxvYWQ6IGRpY3QpIC0+IHR1cGxlW2ludCwgZGljdF06DQogICAgICAgIHByaW50KGYiXG5bSFRUUCBDb250cm9sbGVyXSBIYW5kbGluZyBJbmNvbWluZyBQYXlsb2FkOiB7cGF5bG9hZH0iKQ0KICAgICAgICB0cnk6DQogICAgICAgICAgICAjIDEuIElucHV0IFZhbGlkYXRpb24NCiAgICAgICAgICAgIGlmICJjdXN0b21lcl9pZCIgbm90IGluIHBheWxvYWQgb3IgcGF5bG9hZC5nZXQoInF1YW50aXR5IiwgMCkgPD0gMDoNCiAgICAgICAgICAgICAgICByZXR1cm4gNDAwLCB7ImVycm9yIjogIkludmFsaWQgcmVxdWVzdCBwYXJhbWV0ZXJzIn0NCg0KICAgICAgICAgICAgIyAyLiDDgW5oIHjhuqEgc2FuZyBJbnB1dCBEVE8NCiAgICAgICAgICAgIGR0byA9IENyZWF0ZU9yZGVySW5wdXREVE8oDQogICAgICAgICAgICAgICAgY3VzdG9tZXJfaWQ9cGF5bG9hZFsiY3VzdG9tZXJfaWQiXSwNCiAgICAgICAgICAgICAgICBwcm9kdWN0X2lkPXBheWxvYWRbInByb2R1Y3RfaWQiXSwNCiAgICAgICAgICAgICAgICBxdWFudGl0eT1wYXlsb2FkWyJxdWFudGl0eSJdLA0KICAgICAgICAgICAgICAgIHVuaXRfcHJpY2U9cGF5bG9hZFsidW5pdF9wcmljZSJdDQogICAgICAgICAgICApDQoNCiAgICAgICAgICAgICMgMy4gR+G7jWkgQXBwbGljYXRpb24gVXNlIENhc2UNCiAgICAgICAgICAgIHJlc3BvbnNlID0gc2VsZi5fdXNlX2Nhc2UuZXhlY3V0ZShkdG8pDQogICAgICAgICAgICByZXR1cm4gMjAxLCB7DQogICAgICAgICAgICAgICAgIm9yZGVyX2lkIjogcmVzcG9uc2Uub3JkZXJfaWQsDQogICAgICAgICAgICAgICAgInRvdGFsIjogcmVzcG9uc2UudG90YWxfYW1vdW50LA0KICAgICAgICAgICAgICAgICJzdGF0dXMiOiByZXNwb25zZS5zdGF0dXMNCiAgICAgICAgICAgIH0NCiAgICAgICAgZXhjZXB0IEJ1c2luZXNzUnVsZUVycm9yIGFzIGJyZToNCiAgICAgICAgICAgIHJldHVybiA0MjIsIHsiYnVzaW5lc3NfZXJyb3IiOiBzdHIoYnJlKX0NCiAgICAgICAgZXhjZXB0IEV4Y2VwdGlvbiBhcyBlOg0KICAgICAgICAgICAgcmV0dXJuIDUwMCwgeyJmYXRhbF9lcnJvciI6IHN0cihlKX0NCg0KDQppZiBfX25hbWVfXyA9PSAiX19tYWluX18iOg0KICAgIHByaW50KCI9PT0gUHl0aG9uIDMuMTErIENsb3NlZCBMYXllcmVkIEFyY2hpdGVjdHVyZSBEZW1vID09PSIpDQogICAgcmVwbyA9IE1vY2tEYXRhYmFzZVJlcG9zaXRvcnkoKQ0KICAgIHVzZV9jYXNlID0gQ3JlYXRlT3JkZXJVc2VDYXNlKHJlcG8pDQogICAgY29udHJvbGxlciA9IFdlYk9yZGVyQ29udHJvbGxlcih1c2VfY2FzZSkNCg0KICAgICMgVGVzdCBDYXNlIDE6IFThuqFvIMSRxqFuIGjDoG5nIHRow6BuaCBjw7RuZw0KICAgIHN0YXR1c19jb2RlLCBib2R5ID0gY29udHJvbGxlci5oYW5kbGVfcmVxdWVzdCh7DQogICAgICAgICJjdXN0b21lcl9pZCI6ICJDVVNULTk5IiwNCiAgICAgICAgInByb2R1Y3RfaWQiOiAiTUFDQk9PSy1QUk8tTTMiLA0KICAgICAgICAicXVhbnRpdHkiOiAyLA0KICAgICAgICAidW5pdF9wcmljZSI6IDI0OTkuMDANCiAgICB9KQ0KICAgIHByaW50KGYiICAtPiBDb250cm9sbGVyIEhUVFAgU3RhdHVzOiB7c3RhdHVzX2NvZGV9IHwgQm9keToge2JvZHl9IikNCg0KICAgICMgVGVzdCBDYXNlIDI6IFZpIHBo4bqhbSBraeG7g20gdHJhIMSR4bqndSB2w6BvIChIVFRQIDQwMCkNCiAgICBzdGF0dXNfY29kZSwgYm9keSA9IGNvbnRyb2xsZXIuaGFuZGxlX3JlcXVlc3Qoew0KICAgICAgICAiY3VzdG9tZXJfaWQiOiAiQ1VTVC05OSIsDQogICAgICAgICJwcm9kdWN0X2lkIjogIk1BQ0JPT0stUFJPLU0zIiwNCiAgICAgICAgInF1YW50aXR5IjogLTUsDQogICAgICAgICJ1bml0X3ByaWNlIjogMjQ5OS4wMA0KICAgIH0pDQogICAgcHJpbnQoZiIgIC0+IENvbnRyb2xsZXIgSFRUUCBTdGF0dXM6IHtzdGF0dXNfY29kZX0gfCBCb2R5OiB7Ym9keX0iKQ0KYGBgDQoNCiMjIyMgVGVybWluYWwgT3V0cHV0IE3huqt1IChQeXRob24gMy4xMSspOg0KYGBgdGV4dA0KPT09IFB5dGhvbiAzLjExKyBDbG9zZWQgTGF5ZXJlZCBBcmNoaXRlY3R1cmUgRGVtbyA9PT0NCg0KW0hUVFAgQ29udHJvbGxlcl0gSGFuZGxpbmcgSW5jb21pbmcgUGF5bG9hZDogeydjdXN0b21lcl9pZCc6ICdDVVNULTk5JywgJ3Byb2R1Y3RfaWQnOiAnTUFDQk9PSy1QUk8tTTMnLCAncXVhbnRpdHknOiAyLCAndW5pdF9wcmljZSc6IDI0OTkuMH0NCiAgW0RCIEVuZ2luZV0gPT09IEJFR0lOIFRSQU5TQUNUSU9OID09PQ0KICBbREIgU3RvcmFnZV0gU2F2aW5nIE9yZGVyIDRkN2E4YjFjIChTdGF0dXM6IENPTkZJUk1FRCkgdG8gRGF0YWJhc2UuLi4NCiAgW0RCIEVuZ2luZV0gPT09IENPTU1JVCBUUkFOU0FDVElPTiA9PT0NCiAgLT4gQ29udHJvbGxlciBIVFRQIFN0YXR1czogMjAxIHwgQm9keTogeydvcmRlcl9pZCc6ICc0ZDdhOGIxYycsICd0b3RhbCc6IDQ5OTguMCwgJ3N0YXR1cyc6ICdDT05GSVJNRUQnfQ0KDQpbSFRUUCBDb250cm9sbGVyXSBIYW5kbGluZyBJbmNvbWluZyBQYXlsb2FkOiB7J2N1c3RvbWVyX2lkJzogJ0NVU1QtOTknLCAncHJvZHVjdF9pZCc6ICdNQUNCT09LLVBSTy1NMycsICdxdWFudGl0eSc6IC01LCAndW5pdF9wcmljZSc6IDI0OTkuMH0NCiAgLT4gQ29udHJvbGxlciBIVFRQIFN0YXR1czogNDAwIHwgQm9keTogeydlcnJvcic6ICdJbnZhbGlkIHJlcXVlc3QgcGFyYW1ldGVycyd9DQpgYGANCg0KLS0tDQoNCiMjIDQuIFN5c3RlbXMgRW5naW5lZXJpbmcgJiBQcm9kdWN0aW9uIFBpdGZhbGxzDQoNCiMjIyBDw6FjIEPhuqFtIELhuqt5IFRo4buxYyBDaGnhur9uIChHb3RjaGFzICYgUHJvZHVjdGlvbiBBbnRpcGF0dGVybnMpDQoNCjEuICoqUsOyIFLhu4kgxJDhu5FpIFTGsOG7o25nIE9STSBHw6J5IFJhIERldGFjaGVkIEVudGl0eSAmIExhenlJbml0aWFsaXphdGlvbkV4Y2VwdGlvbioqOg0KICAgLSAqQuG6o24gY2jhuqV0KjogTOG6rXAgdHLDrG5oIHZpw6puIGLhu48gcXVhIHZp4buHYyB04bqhbyBEVE8gbcOgIHRydXnhu4FuIHRy4buxYyB0aeG6v3AgRW50aXR5IGPhu6dhIE9STSAoSGliZXJuYXRlLCBKUEEsIFNRTEFsY2hlbXkpIGzDqm4gUHJlc2VudGF0aW9uIExheWVyLiBLaGkgQ29udHJvbGxlciBj4buRIGfhuq9uZyBzZXJpYWxpemUgxJHhu5FpIHTGsOG7o25nIHNhbmcgSlNPTiwgbsOzIHRydXkgY+G6rXAgdsOgbyBjw6FjIHRyxrDhu51uZyBxdWFuIGjhu4cgbMaw4budaSAoTGF6eSBMb2FkZWQgQ29sbGVjdGlvbnMpIGtoaSBUcmFuc2FjdGlvbiBj4bunYSBBcHBsaWNhdGlvbiBMYXllciDEkcOjIGLhu4sgxJHDs25nIChgc2Vzc2lvbiBjbG9zZWRgKSwgZOG6q24gxJHhur9uIGzhu5dpIHbEg25nIHPhuq1wIHNlcnZlciBgTGF6eUluaXRpYWxpemF0aW9uRXhjZXB0aW9uYCB0csOqbiBQcm9kdWN0aW9uLg0KICAgLSAqS2jhuq9jIHBo4bulYyo6IEx1w7RuIHPhu60gZOG7pW5nIERUTyBNYXBwZXIgdOG6oWkgcmFuaCBnaeG7m2kgY+G7p2EgQXBwbGljYXRpb24gTGF5ZXIgxJHhu4Mgc2FvIGNow6lwIGThu68gbGnhu4d1IHRyxrDhu5tjIGtoaSB0cuG6oyB24buBIFByZXNlbnRhdGlvbiBMYXllci4NCg0KMi4gKipSYW5oIEdp4bubaSBHaWFvIEThu4tjaCBLw6lvIETDoGkgUXXDoSBMw6J1IChMb25nLVJ1bm5pbmcgVHJhbnNhY3Rpb25zKSoqOg0KICAgLSAqQuG6o24gY2jhuqV0KjogTOG6rXAgdHLDrG5oIHZpw6puIGJhbyBi4buNYyB0b8OgbiBi4buZIHBoxrDGoW5nIHRo4bupYyBVc2UgQ2FzZSB0cm9uZyBt4buZdCBUcmFuc2FjdGlvbiwgYmFvIGfhu5NtIGPhuqMgdmnhu4djIGfhu41pIEhUVFAgQVBJIHNhbmcgZOG7i2NoIHbhu6UgYsOqbiB0aOG7qSBiYSAobmjGsCBn4butaSBTTVMgaG/hurdjIGfhu41pIFZpc2EgR2F0ZXdheSkuIE7hur91IG3huqFuZyBiw6puIHRo4bupIGJhIGLhu4sgbGFnIDEwIGdpw6J5LCBr4bq/dCBu4buRaSBEYXRhYmFzZSBi4buLIGNoaeG6v20gZ2nhu68gdHJvbmcgMTAgZ2nDonksIGtow7NhIGjDoG5nIGxv4bqhdCBi4bqjbmcgKFJvdyBMb2NrcyksIGThuqtuIMSR4bq/biBj4bqhbiBraeG7h3QgQ29ubmVjdGlvbiBQb29sIGPhu6dhIERhdGFiYXNlLg0KICAgLSAqS2jhuq9jIHBo4bulYyo6IFTDoWNoIHLhu51pOiBDaOG7iSBt4bufIFRyYW5zYWN0aW9uIERhdGFiYXNlIGNobyBjw6FjIHRoYW8gdMOhYyBTUUwgdGh14bqnbiB0w7p5OyBjw6FjIGN14buZYyBn4buNaSBJL08gbeG6oW5nIGLDqm4gbmdvw6BpIHBo4bqjaSDEkcaw4bujYyB0aOG7sWMgaGnhu4duIHRyxrDhu5tjIGhv4bq3YyBzYXUga2hpIMSRw7NuZyBUcmFuc2FjdGlvbi4NCg0KMy4gKipIaeG7h24gVMaw4bujbmcgUGjDom4gVOG6p25nIFRow6FpIFF1w6EgKEFyY2hpdGVjdHVyZSBCbG9hdCAmIEFuZW1pYyBEb21haW4pKio6DQogICAtICpC4bqjbiBjaOG6pXQqOiBI4buHIHRo4buRbmcgY8OzIGjDoG5nIGNo4bulYyB04bqnbmcgdHJ1bmcgZ2lhbiBuaMawbmcgRG9tYWluIExheWVyIGzhuqFpIGhvw6BuIHRvw6BuIHLhu5duZyBraMO0bmcgY2jhu6lhIGxvZ2ljIChBbmVtaWMgRG9tYWluIE1vZGVsIC0gY2jhu4kgY8OzIGdldHRlcnMgdsOgIHNldHRlcnMpLCBiaeG6v24gdG/DoG4gYuG7mSBo4buHIHRo4buRbmcgdGjDoG5oIG3hu5l0IGNodeG7l2kgY+G7kW5nIHjhuqMgbmfhuqdtIFNpbmtob2xlIHThu5FuIENQVSBtw6Aga2jDtG5nIMSRZW0gbOG6oWkgZ2nDoSB0cuG7iyBi4bqjbyB0csOsIG7DoG8uDQogICAtICpLaOG6r2MgcGjhu6VjKjogTuG6v3Ug4bupbmcgZOG7pW5nIGNo4buJIHRodeG6p24gdMO6eSBsw6BtIENSVUQsIGjDo3kgbG/huqFpIGLhu48gY8OhYyB04bqnbmcgcGjhu6ljIHThuqFwIHbDoCBz4butIGThu6VuZyBtw7QgaMOsbmggQWN0aXZlIFJlY29yZCBob+G6t2MgVHJhbnNhY3Rpb24gU2NyaXB0IMSRxqFuIGdp4bqjbi4NCg0KNC4gKipL4bu5IFRodeG6rXQgQ2jhuqluIMSQb8OhbiAmIEdpw6FtIFPDoXQgUGjDom4gVOG6p25nIELhurFuZyBDTEkqKjoNCiAgIGBgYGJhc2gNCiAgICMgMS4gUGjDoXQgaGnhu4duIGPDoWMgdOG6p25nIGfhu41pIG5o4bqjeSBjw7NjIHZpIHBo4bqhbSBDbG9zZWQgQXJjaGl0ZWN0dXJlIGLhurFuZyBKRGVwZW5kIENMSQ0KICAgamRlcGVuZCAtZmlsZSByZXBvcnQueG1sIHNyYy8NCg0KICAgIyAyLiDEkG8gdGjhu51pIGdpYW4gdGjhu7FjIHRoaSBj4bunYSB04burbmcgdOG6p25nIGtp4bq/biB0csO6YyB0aMO0bmcgcXVhIE9wZW5UZWxlbWV0cnkgU3BhbnMNCiAgIG90ZWwtY2xpIGV4ZWMgLS1zZXJ2aWNlLW5hbWUgb3JkZXItYXBpIC0tbmFtZSAiQXBwbGljYXRpb25MYXllcjo6VHJhbnNmZXJVc2VDYXNlIiAuL3J1bl91c2VjYXNlDQoNCiAgICMgMy4gR2nDoW0gc8OhdCBz4buRIGzGsOG7o25nIENvbm5lY3Rpb24gcsOyIHLhu4kgdHJvbmcgQ29ubmVjdGlvbiBQb29sIGPhu6dhIFBvc3RncmVTUUwNCiAgIHBzcWwgLWMgIlNFTEVDVCBjb3VudCgqKSwgc3RhdGUgRlJPTSBwZ19zdGF0X2FjdGl2aXR5IEdST1VQIEJZIHN0YXRlOyINCiAgIGBgYA0KDQotLS0NCg0KIyMgNS4gQuG6o25nIFNvIHPDoW5oICYgRGVjaXNpb24gTWF0cml4DQoNCiMjIyA1LjEuIFNvIFPDoW5oIENsb3NlZCBMYXllcmVkIHZzIE9wZW4gTGF5ZXJlZCBBcmNoaXRlY3R1cmUNCg0KfCBUacOqdSBDaMOtIHwgQ2xvc2VkIExheWVyZWQgQXJjaGl0ZWN0dXJlIHwgT3BlbiBMYXllcmVkIEFyY2hpdGVjdHVyZSB8DQp8IDotLS0gfCA6LS0tIHwgOi0tLSB8DQp8ICoqUXV5IHThuq9jIEfhu41pKiogfCBDaOG7iSDEkcaw4bujYyBn4buNaSB04bqnbmcga+G6vyB0aeG6v3AgKCROIFx0byBOLTEkKSB8IMSQxrDhu6NjIHBow6lwIG5o4bqjeSBjw7NjICgkTiBcdG8gTi0yJCkgfA0KfCAqKk3hu6ljIMSR4buZIFTDoWNoIHLhu51pIChEZWNvdXBsaW5nKSoqIHwgUuG6pXQgY2FvOyB0aGF5IMSR4buVaSB04bqnbmcgaOG6oSB04bqnbmcga2jDtG5nIOG6o25oIGjGsOG7n25nIHThuqduZyB0csOqbiB8IFLhuqV0IHRo4bqlcDsgY8OhYyB04bqnbmcgYuG7iyBkw61uaCBjaOG6t3QgdsOgbyBuaGF1IHwNCnwgKipLaOG6oyBuxINuZyBC4bqjbyB0csOsIChNYWludGFpbmFiaWxpdHkpKip8IFLhuqV0IGNhbyB8IFRo4bqlcDsgZOG7hSBiaeG6v24gdGjDoG5oIEJpZyBCYWxsIG9mIE11ZCB8DQp8ICoqSGnhu4d1IG7Eg25nIFRo4buxYyB0aGkqKiB8IFThu5FuIG3hu5l0IHBo4bqnbiBjaGkgcGjDrSBjaHV54buDbiB0aeG6v3AgRFRPIHwgTmhhbmggaMahbiBt4buZdCBjaMO6dCDhu58gY8OhYyB0cnV5IHbhuqVuIMSR4buNYyBuaGFuaCB8DQp8ICoqUuG7p2kgcm8gUsOyIHLhu4kgSOG6oSB04bqnbmcqKiB8IFLhuqV0IHRo4bqlcCB8IEPhu7FjIGvhu7MgY2FvIHwNCnwgKipLaHV54bq/biBuZ2jhu4sqKiB8ICoqVGnDqnUgY2h14bqpbiBt4bq3YyDEkeG7i25oIGNobyA5NSUgaOG7hyB0aOG7kW5nKiogfCBDaOG7iSBkw7luZyBjaG8gY8OhYyBiw6FvIGPDoW8gZOG7ryBsaeG7h3UgxJHhurdjIHRow7kgfA0KDQojIyMgNS4yLiBNYSBUcuG6rW4gQ2h1eeG7g24gxJDhu5VpOiBMYXllcmVkIEFyY2hpdGVjdHVyZSB2cyBDbGVhbiAvIEhleGFnb25hbCBBcmNoaXRlY3R1cmUNCg0KfCDEkOG6t2MgVMOtbmggfCBUcmFkaXRpb25hbCBMYXllcmVkIEFyY2hpdGVjdHVyZSB8IENsZWFuIC8gSGV4YWdvbmFsIEFyY2hpdGVjdHVyZSB8DQp8IDotLS0gfCA6LS0tIHwgOi0tLSB8DQp8ICoqSMaw4bubbmcgUGjhu6UgdGh14buZYyoqIHwgSMaw4bubbmcgeHXhu5FuZyBDxqEgc+G7nyBk4buvIGxp4buHdSAoJEEgXHRvIEIgXHRvIFx0ZXh0e0RCfSQpIHwgSMaw4bubbmcgdsOgbyB0cm9uZyBOZ2hp4buHcCB24bulICgkQSBcdG8gXHRleHR7Q29yZX0gXGxlZnRhcnJvdyBcdGV4dHtEQn0kKSB8DQp8ICoqVHLhu41uZyB0w6JtIEjhu4cgdGjhu5FuZyoqIHwgRGF0YWJhc2UtQ2VudHJpYyAoROG7ryBsaeG7h3UgbMOgIHRydW5nIHTDom0pIHwgRG9tYWluLUNlbnRyaWMgKFF1eSB04bqvYyBraW5oIGRvYW5oIGzDoCB0cnVuZyB0w6JtKSB8DQp8ICoqS2jhuqMgbsSDbmcgxJDhu5VpIERhdGFiYXNlKiogfCBS4bqldCBraMOzOyBEb21haW4gdGjGsOG7nW5nIGLhu4sgZMOtbmggT1JNIGFubm90YXRpb25zIHwgQ+G7sWMga+G7syBk4buFOyBEYXRhYmFzZSBjaOG7iSBsw6AgbeG7mXQgQWRhcHRlciBj4bqvbSB0aMOqbSB8DQp8ICoqS2jhuqMgbsSDbmcgVmnhur90IFVuaXQgVGVzdCoqIHwgVGjGsOG7nW5nIGPhuqduIERhdGFiYXNlIOG6o28gKEgyLCBUZXN0Q29udGFpbmVycykgfCBWaeG6v3QgVW5pdCBUZXN0ICQxMDBcJSQgdHJvbmcgUkFNIHbhu5tpIE1vY2sgUG9ydHMgfA0KfCAqKsSQ4buZIFBo4bupYyBU4bqhcCBCYW4gxJDhuqd1KiogfCBUaOG6pXA7IHRy4buxYyBxdWFuLCBxdWVuIHRodeG7mWMgduG7m2kgbeG7jWkgbOG6rXAgdHLDrG5oIHZpw6puIHwgQ2FvOyBj4bqnbiBoaeG7g3Ugc8OidSB24buBIERJUCwgUG9ydHMgJiBBZGFwdGVycyB8DQp8ICoqR2lhaSDEkW/huqFuIFBow7kgaOG7o3AqKiB8IEto4bufaSB04bqhbyBk4buxIMOhbiwg4bupbmcgZOG7pW5nIGRvYW5oIG5naGnhu4dwIHbhu6thIHwgQ29yZSBCYW5raW5nLCBGaW5UZWNoLCBo4buHIHRo4buRbmcgY8OzIHbDsm5nIMSR4budaSA+IDEwIG7Eg20gfA0K