Chế độ giao diện
4.1. Nền Tảng Kiến Trúc Phần Mềm (Software Architecture Fundamentals)
IMPORTANT
Nếu bạn chỉ được nhớ một điều duy nhất: Kiến trúc phần mềm không phải là việc lựa chọn framework thời thượng, mà là tập hợp các quyết định cấu trúc quan trọng nhất, khó đảo ngược nhất và tốn kém nhất nếu làm sai; một kiến trúc thành công là kiến trúc cân bằng tối ưu giữa các thuộc tính chất lượng (Trade-offs) và có khả năng tiến hóa liên tục thông qua các hàm thích ứng tự động (Automated Fitness Functions).
1. Kiến trúc Tổng quan & Mô hình Tư duy (Mental Model)
Ẩn dụ Đời sống: Kết Cấu Chịu Lực Tòa Nhà vs Trang Trí Nội Thất
Hãy so sánh việc xây dựng một hệ thống phần mềm với một tòa tháp chọc trời
- Chi tiết Triển khai (Code Implementation / Interior Decor): Màu sơn tường, rèm cửa, bố trí bàn ghế. Bạn có thể thay đổi màu sơn hoặc đổi vị trí sofa trong một buổi chiều với chi phí rất nhỏ. Đây là các dòng code cụ thể, thuật toán hay thư viện tiện ích.
- Kiến trúc Phần mềm (Software Architecture / Structural Engineering): Vị trí móng cọc khoan nhồi sâu 80m vào tầng địa chất, lõi bê tông cốt thép chịu động đất cấp 8, và hệ thống ống dẫn kỹ thuật chạy ngầm xuyên suốt tòa nhà. Nếu đã xây xong tầng 50 mà bạn nhận ra móng cọc chịu lực kém hoặc muốn chuyển toàn bộ lõi thang máy sang góc khác, chi phí đập đi xây lại tương đương với phá sản.
- Architectural Drivers (Yếu tố Thúc đẩy): Địa chấn khu vực, sức gió bão 150 km/h, tải trọng 10.000 cư dân, và ngân sách dự án.
- Fitness Functions (Cảm biến Kết cấu): Các cảm biến đo độ nghiêng và độ rung lắc gắn trên đỉnh tháp. Nếu tòa nhà dao động vượt quá biên độ an toàn, còi báo động lập tức kích hoạt (CI/CD Pipeline báo đỏ).
flowchart TD
subgraph Drivers["Architectural Drivers (Đầu Vào)"]
FR["Yêu Cầu Chức Năng (Core FR)"]
NFR["Thuộc Tính Chất Lượng (QAS: Latency, Availability, Scalability)"]
CON["Ràng Buộc Kỹ Thuật & Ngân Sách (Constraints)"]
end
subgraph ArchitectureProcess["Quy Trình Kiến Trúc & Đánh Đổi"]
DR["Drivers"] --> ATAM["Phân Tích Đánh Đổi ATAM<br/>(Trade-off & Sensitivity Analysis)"]
ATAM --> ADR["Architectural Decision Records (ADR)<br/>Văn bản hóa các quyết định"]
ATAM --> Style["Lựa Chọn Kiến Trúc<br/>(Styles & Patterns)"]
end
subgraph Implementation["Hiện Thực Hóa & Thẩm Định"]
Style --> Spike["Architectural Spike<br/>(Thử nghiệm công nghệ 2-3 ngày)"]
Spike --> WS["Walking Skeleton<br/>(Bộ xương chạy E2E mỏng nhất)"]
WS --> Code["Hệ Thống Triển Khai Thực Tế"]
end
subgraph Evolution["Tiến Hóa & Quản Trị (Governance)"]
Code --> FF["Automated Fitness Functions<br/>(Kiểm tra vi phạm ranh giới trong CI)"]
FF -- "Phát hiện Architectural Drift" --> REFACTOR["Refactor & Điều chỉnh Kiến Trúc"]
FF -- "Hợp chuẩn" --> PROD["Production Deployment"]
end
2. Chi tiết từng Keyword (Under-the-Hood Deep Dive)
2.1. Software Architecture, Architecture Styles, Patterns và Architectural Drivers
1. Software Architecture (Kiến trúc Phần mềm)
Theo định nghĩa chuẩn mực IEEE 1471 / ISO 42010 và các chuyên gia Ralph Johnson, Martin Fowler:
- Kiến trúc phần mềm là cấu trúc cơ bản của một hệ thống, bao gồm các thành phần phần mềm (Components), các mối quan hệ tương tác (Connectors), và các nguyên lý chỉ đạo việc thiết kế và tiến hóa của chúng.
- Kiến trúc tập trung vào "những quyết định tốn kém nhất nếu phải làm lại".
2. Architecture Styles vs Architecture Patterns
- Architecture Style (Phong cách kiến trúc): Một họ các cấu trúc hệ thống ở mức vĩ mô định hình cách tổ chức toàn cục (ví dụ: Monolithic, Microservices, Event-Driven, Layered, Pipe and Filter, Space-Based). Style trả lời câu hỏi: Hình thái tổng thể của hệ thống trông như thế nào?
- Architecture Pattern (Mẫu kiến trúc): Một giải pháp cấu trúc đã được chuẩn hóa để giải quyết một bài toán lặp đi lặp lại trong một bối cảnh cụ thể ở quy mô nhỏ hơn Style (ví dụ: CQRS, Saga Pattern, Circuit Breaker, Outbox Pattern, BFF - Backend for Frontend).
3. Architectural Drivers (Yếu Tố Thúc Đẩy Kiến Trúc)
Không có kiến trúc nào sinh ra trong chân không. Mọi quyết định kiến trúc đều chịu sự thúc đẩy của 4 trụ cột:
- Functional Requirements (FR): Nghiệp vụ cốt lõi mà hệ thống phải thực hiện.
- Quality Attributes (Non-Functional Requirements - NFR): Tốc độ, độ tin cậy, khả năng chịu lỗi, tính co giãn, bảo mật.
- Business Constraints (Ràng buộc Kinh doanh): Thời gian ra mắt (Time-to-Market), ngân sách hạ tầng máy chủ ($5,000/tháng), trình độ hiện tại của đội ngũ kỹ sư.
- Technical Constraints (Ràng buộc Kỹ thuật): Bắt buộc phải tích hợp hệ thống Core Banking qua chuẩn ISO 8583, hệ sinh thái đám mây chỉ định (AWS/GCP), cơ chế xác thực OAuth2.
2.2. Quality Attribute Scenario (QAS) và Đo lường Phi Chức năng
Các yêu cầu phi chức năng mơ hồ như "Hệ thống phải nhanh", "Hệ thống phải có tính sẵn sàng cao" là nguồn gốc của mọi thảm họa phần mềm. Để biến chúng thành tiêu chí kỹ thuật có thể kiểm chứng toán học, Viện Kỹ nghệ Phần mềm SEI (Carnegie Mellon University) đề xuất cấu trúc Quality Attribute Scenario (QAS) gồm 6 thành phần bắt buộc:
flowchart LR
S["1. Source of Stimulus<br/>(Nguồn kích thích: Khách hàng)"] --> ST["2. Stimulus<br/>(Kích thích: 50.000 RPS)"]
ST --> A["3. Artifact<br/>(Thành phần: Checkout API)"]
ENV["4. Environment<br/>(Môi trường: Flash Sale)"] -.-> A
A --> R["5. Response<br/>(Phản hồi: Xử lý đơn hàng)"]
R --> RM["6. Response Measure<br/>(Thước đo: p99 < 50ms, Error < 0.01%)"]
| Thành phần QAS | Ý Nghĩa Kỹ Thuật | Ví Dụ Cụ Thể |
|---|---|---|
| 1. Source of Stimulus | Thực thể kích hoạt sự kiện (Người dùng, Hacker, Cron, Sensor) | |
| 2. Stimulus | Tác nhân hoặc điều kiện cần xử lý | Gửi yêu cầu thanh toán giỏ hàng trong giờ Flash Sale |
| 3. Artifact | Bộ phận hoặc phân hệ phần mềm chịu tác động | Service Thanh toán (Payment Gateway & Ledger DB) |
| 4. Environment | Trạng thái của hệ thống khi kích thích xảy ra | Hệ thống đang chịu tải đỉnh (Peak Load), một cụm DB bị lag |
| 5. Response | Hành vi mà hệ thống phải thực hiện khi bị kích thích | Tiếp nhận yêu cầu, bảo lưu thứ tự hàng đợi, ghi nhận giao dịch |
| 6. Response Measure | Thước đo định lượng để xác định Pass/Fail | Độ trễ |
2.3. Phương pháp Đánh giá Đánh đổi Kiến trúc (ATAM)
Architecture Trade-off Analysis Method (ATAM) là quy trình khoa học được phát triển bởi SEI nhằm phân tích rủi ro và đánh giá các phương án kiến trúc trước khi đầu tư nhân lực lập trình.
Cốt lõi của ATAM là xác định:
- Sensitivity Points (Điểm nhạy cảm): Một quyết định kiến trúc tác động mạnh mẽ đến một thuộc tính chất lượng duy nhất. (Ví dụ: Thêm thuật toán mã hóa AES-256 tăng mạnh tính Bảo mật).
- Trade-off Points (Điểm đánh đổi): Một quyết định kiến trúc làm tăng thuộc tính chất lượng
nhưng lại trực tiếp làm suy giảm thuộc tính chất lượng . (Ví dụ: Mã hóa AES-256 tăng Bảo mật nhưng làm suy giảm Throughput và tăng CPU Latency). - Risks (Rủi ro): Các quyết định kiến trúc chưa rõ ràng hoặc có xác suất cao không thỏa mãn QAS.
- Non-Risks (Phi rủi ro): Các quyết định thiết kế an toàn, có tiền lệ kiểm chứng tốt.
2.4. Evolutionary Architecture, Architectural Spikes & Walking Skeleton
1. Evolutionary Architecture (Kiến trúc Tiến hóa)
Được Neal Ford, Rebecca Parsons và Patrick Kua định nghĩa: "Kiến trúc tiến hóa là kiến trúc hỗ trợ sự thay đổi có định hướng và liên tục qua nhiều chiều (multiple dimensions) mà không làm suy thoái các thuộc tính chất lượng cốt lõi". Thay vì cố gắng dự đoán toàn bộ tương lai (Big Design Up Front - BDUF), kiến trúc sư tạo ra một hệ thống có khả năng thích nghi khi nghiệp vụ và công nghệ thay đổi.
2. Architectural Spikes (Đợt Thử Nghiệm Kiến Trúc)
- Thuật ngữ bắt nguồn từ eXtreme Programming (XP).
- Là một thử nghiệm lập trình có giới hạn thời gian (Time-boxed, thường từ 1 đến 3 ngày) nhằm trả lời một câu hỏi kỹ thuật cụ thể hoặc loại bỏ rủi ro lớn nhất (ví dụ: Kafka có thể xử lý
messages/s trên cụm 3 node t3.medium không?). - Code của Spike thường bị vứt bỏ (Throwaway code) sau khi đã thu thập đủ dữ liệu đo lường.
3. Walking Skeleton (Bộ Xương Chuyển Động)
- Do Alistair Cockburn khởi xướng.
- Là một hiện thực hóa nhỏ nhất từ đầu đến cuối (End-to-End) của toàn bộ kiến trúc hệ thống: Client
API Gateway Business Service Database Monitoring CI/CD Pipeline. - Dù chức năng nghiệp vụ chỉ là một hàm rỗng (
return "Hello World"), Walking Skeleton chứng minh rằng toàn bộ các đường ống kết nối kỹ thuật, cấu hình mạng và tự động hóa triển khai đã hoạt động trơn tru ngay từ Sprint 1.
2.5. Architectural Fitness Functions và Ngăn Chặn Architectural Drift
1. Architectural Drift (Sự Suy Thoái Kiến Trúc)
Là hiện tượng kiến trúc thực tế được hiện thực hóa trong code dần dần bị xói mòn, biến dạng và rời xa bản thiết kế ban đầu. Nguyên nhân do áp lực tiến độ (Deadlines), sự thiếu hiểu biết của các lập trình viên mới, dẫn đến các vi phạm nghiêm trọng: Controller gọi thẳng vào Database, Service tầng dưới gọi ngược lên tầng trên, sinh ra Circular Dependencies.
graph LR
subgraph DesignedArch["Kiến Trúc Thiết Kế Ban Đầu"]
D1[UI / Controller] --> D2[Domain Service]
D2 --> D3[Repository / DB]
end
subgraph DriftedArch["Kiến Trúc Bị Suy Thoái (Architectural Drift)"]
A1[UI / Controller] --> A2[Domain Service]
A2 --> A3[Repository / DB]
A1 -. "Vi phạm: Chọc tắt!" .-> A3
A3 -. "Vi phạm: Circular Ref!" .-> A1
end
2. Architectural Fitness Functions (Hàm Thích Ứng Kiến Trúc)
Là bất kỳ cơ chế kiểm tra tự động nào (Unit Test, ArchUnit, AST Linter, Benchmark) dùng để đo lường tính toàn vẹn của kiến trúc trong chu trình CI/CD:
- Kiểm tra Ranh giới Tầng (Layer Integrity): Domain model không bao giờ được phép import bất kỳ package nào từ Infrastructure hoặc Framework.
- Kiểm tra Phụ thuộc Vòng (Circular Dependency): Cấm tiệt Package
. - Kiểm tra Thuộc tính Hiệu năng: Thời gian response
không được vượt quá trong đợt chạy performance regression test.
2.6. Architecture Governance và Architectural Decision Records (ADR)
Để ngăn ngừa kiến trúc trở thành "truyền thuyết miệng", mọi quyết định quan trọng phải được văn bản hóa dưới dạng ADR (Architectural Decision Record):
markdown
# ADR-007: Sử Dụng PostgreSQL Cho Bảng Kế Toán Thay Vì MongoDB
## Bối cảnh (Context)
Hệ thống cần lưu trữ giao dịch tiền tệ với yêu cầu bảo toàn tuyệt đối tính nhất quán (ACID), ngăn chặn chi tiêu kép (Double Spending). Đội ngũ đang cân nhắc giữa PostgreSQL và MongoDB.
## Quyết định (Decision)
Chúng tôi quyết định chọn **PostgreSQL** làm cơ sở dữ liệu chính cho Ledger Service, sử dụng mức cô lập giao dịch Serializable Isolation.
## Trạng thái (Status)
Đã duyệt (Accepted).
## Hệ quả & Đánh đổi (Consequences)
- Tích cực: Đảm bảo ACID tuyệt đối ở tầng cơ sở dữ liệu, hỗ trợ SQL quan hệ chuẩn mực.
- Tiêu cực: Khả năng mở rộng ghi ngang (Sharding) khó khăn hơn MongoDB; đội ngũ cần thiết lập giải pháp Read-Replica để chia tải truy vấn.1
2
3
4
5
6
7
8
9
10
11
12
13
14
2
3
4
5
6
7
8
9
10
11
12
13
14
3. Thực thi Mã nguồn & Mô phỏng Chuyên sâu (Dual-Engine Implementation)
3.1. C++20 Implementation: Compile-Time Architecture Layer Constraint Verifier
Chương trình C++20 dưới đây sử dụng C++20 Concepts và Type Traits để hiện thực hóa một Architectural Fitness Function hoạt động ngay trong quá trình biên dịch (Compile-time), ngăn chặn việc các tầng nghiệp vụ bị ô nhiễm bởi các kiểu dữ liệu từ tầng hạ tầng (Infrastructure).
cpp
#include <iostream>
#include <type_traits>
#include <concepts>
#include <string>
// ============================================================================
// ĐỊNH NGHĨA CÁC TAG PHÂN TẦNG KIẾN TRÚC (ARCHITECTURAL LAYER TAGS)
// ============================================================================
struct DomainLayerTag {};
struct InfrastructureLayerTag {};
struct PresentationLayerTag {};
// C++20 Concept: Bắt buộc thực thể phải thuộc Domain Layer
template <typename T>
concept IsDomainEntity = std::is_base_of_v<DomainLayerTag, T>;
// C++20 Concept: Bắt buộc thực thể thuộc Infrastructure
template <typename T>
concept IsInfrastructureService = std::is_base_of_v<InfrastructureLayerTag, T>;
// ============================================================================
// DOMAIN LAYER (CẤM PHỤ THUỘC VÀO INFRASTRUCTURE)
// ============================================================================
class OrderAggregate : public DomainLayerTag {
private:
uint64_t orderId_;
int64_t amountCents_;
public:
OrderAggregate(uint64_t id, int64_t amount) : orderId_(id), amountCents_(amount) {}
[[nodiscard]] uint64_t id() const noexcept { return orderId_; }
[[nodiscard]] int64_t amount() const noexcept { return amountCents_; }
};
// Interface Repository nằm trong Domain Layer (Dependency Inversion Principle)
class IOrderRepository : public DomainLayerTag {
public:
virtual ~IOrderRepository() = default;
virtual void save(const OrderAggregate& order) = 0;
};
// ============================================================================
// INFRASTRUCTURE LAYER (PHỤ THUỘC VÀO DOMAIN)
// ============================================================================
class PostgresOrderRepository : public InfrastructureLayerTag, public IOrderRepository {
public:
void save(const OrderAggregate& order) override {
std::cout << "[Postgres Infra] Executing SQL: INSERT INTO orders VALUES ("
<< order.id() << ", " << order.amount() << ");\n";
}
};
// ============================================================================
// ARCHITECTURAL FITNESS FUNCTION ENGINE (COMPILE-TIME RULE CHECK)
// ============================================================================
template <typename ServiceT, typename RepoT>
class DomainServiceHost {
// FITNESS FUNCTION ASSERTION: RepoT bắt buộc phải cài đặt Interface từ Domain Layer,
// chứ DomainService không được phép ghép nối trực tiếp với Concrete Infra!
static_assert(std::is_base_of_v<IOrderRepository, RepoT>,
"VIOLATION: DomainService must depend on IOrderRepository Interface!");
public:
static void executeOrderFlow(OrderAggregate order, RepoT& repo) {
std::cout << "[Domain Service] Processing business rules for Order " << order.id() << "...\n";
repo.save(order);
}
};
int main() {
std::cout << "=== C++20 Compile-Time Architectural Fitness Rule Engine ===\n";
OrderAggregate validOrder(101, 75000);
PostgresOrderRepository postgresRepo;
// Khởi chạy Domain Service tuân thủ nghiêm ngặt ranh giới kiến trúc
DomainServiceHost<void, IOrderRepository>::executeOrderFlow(validOrder, postgresRepo);
std::cout << "[Fitness Function Check] All Layer Invariants Validated at Compile-Time!\n";
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
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
Terminal Output Mẫu (C++20):
text
=== C++20 Compile-Time Architectural Fitness Rule Engine ===
[Domain Service] Processing business rules for Order 101...
[Postgres Infra] Executing SQL: INSERT INTO orders VALUES (101, 75000);
[Fitness Function Check] All Layer Invariants Validated at Compile-Time!1
2
3
4
2
3
4
3.2. Python 3.11+ Implementation: AST Architectural Fitness Linter & QAS Evaluator
Script Python 3.11+ dưới đây thực hiện hai chức năng:
- Phân tích AST để tự động quét toàn bộ mã nguồn của tầng
domainvà phát hiện nếu có bất kỳ dòng nàoimporttrái phép từinfrastructure(Automated Fitness Function). - Hệ thống kiểm định kịch bản thuộc tính chất lượng (QAS Evaluator).
python
from __future__ import annotations
import ast
import time
from typing import NamedTuple
# ============================================================================
# 1. ARCHITECTURAL FITNESS FUNCTION: AST LAYER BOUNDARY SCANNER
# ============================================================================
class ArchitecturalDriftError(Exception):
"""Bắn ra khi phát hiện vi phạm ranh giới kiến trúc trong CI/CD."""
pass
class LayerDependencyLinter(ast.NodeVisitor):
def __init__(self, current_module: str):
self.current_module = current_module
self.violations: list[str] = []
def visit_Import(self, node: ast.Import):
for alias in node.names:
self._check_violation(alias.name, node.lineno)
self.generic_visit(node)
def visit_ImportFrom(self, node: ast.ImportFrom):
if node.module:
self._check_violation(node.module, node.lineno)
self.generic_visit(node)
def _check_violation(self, imported_module: str, lineno: int):
# QUY TẮC CỐT LÕI: Tầng domain CẤM import từ infrastructure hoặc controllers
if "domain" in self.current_module:
if "infrastructure" in imported_module or "controllers" in imported_module:
self.violations.append(
f"Line {lineno}: Architectural Drift! '{self.current_module}' imports forbidden '{imported_module}'"
)
def verify_code_architecture(module_name: str, source_code: str):
tree = ast.parse(source_code)
linter = LayerDependencyLinter(current_module=module_name)
linter.visit(tree)
if linter.violations:
raise ArchitecturalDriftError("\n".join(linter.violations))
# ============================================================================
# 2. QUALITY ATTRIBUTE SCENARIO (QAS) VERIFIER
# ============================================================================
class QAScenario(NamedTuple):
name: str
target_latency_p99_ms: float
max_error_rate_pct: float
def execute_qas_benchmark(scenario: QAScenario, samples: list[float], errors: int) -> bool:
print(f"\n[Evaluating QAS: {scenario.name}]")
sorted_samples = sorted(samples)
p99_idx = int(len(sorted_samples) * 0.99)
p99_latency = sorted_samples[p99_idx]
error_rate = (errors / len(samples)) * 100.0
print(f" -> Measured p99 Latency : {p99_latency:.2f} ms (Target: < {scenario.target_latency_p99_ms} ms)")
print(f" -> Measured Error Rate : {error_rate:.4f} % (Target: < {scenario.max_error_rate_pct} %)")
passed = (p99_latency <= scenario.target_latency_p99_ms) and (error_rate <= scenario.max_error_rate_pct)
if passed:
print(" ✅ QAS Verification: PASSED")
else:
print(" ❌ QAS Verification: FAILED (Quality Attribute Breach)")
return passed
if __name__ == "__main__":
print("=== Python 3.11+ Architectural Governance & Fitness Engine ===")
# Test 1: Mã nguồn Domain hợp lệ
clean_domain_code = """
class OrderService:
def __init__(self, order_repo_interface):
self.repo = order_repo_interface
def calculate_total(self, items):
return sum(item.price for item in items)
"""
verify_code_architecture("app.domain.order_service", clean_domain_code)
print("\n[Fitness Test 1] Clean Domain Code passed architectural validation!")
# Test 2: Mã nguồn Domain bị ô nhiễm bởi Infrastructure (Architectural Drift)
corrupted_domain_code = """
import app.infrastructure.database.mysql_driver as db_driver
class OrderService:
def save_order(self, order):
db_driver.raw_execute(f"INSERT INTO orders VALUES ({order.id})")
"""
try:
verify_code_architecture("app.domain.order_service", corrupted_domain_code)
except ArchitecturalDriftError as ex:
print(f"\n[Fitness Test 2] Intercepted Architecture Violation Successfully:\n -> {ex}")
# Test 3: Đánh giá Quality Attribute Scenario
flash_sale_qas = QAScenario(
name="Flash Sale Checkout Latency",
target_latency_p99_ms=50.0,
max_error_rate_pct=0.01
)
# Giả lập 1000 mẫu độ trễ (ms)
mock_latencies = [15.0 + (i % 30) for i in range(1000)]
mock_latencies[-1] = 48.5 # Max p99
execute_qas_benchmark(flash_sale_qas, mock_latencies, errors=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
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
Terminal Output Mẫu (Python 3.11+):
text
=== Python 3.11+ Architectural Governance & Fitness Engine ===
[Fitness Test 1] Clean Domain Code passed architectural validation!
[Fitness Test 2] Intercepted Architecture Violation Successfully:
-> Line 2: Architectural Drift! 'app.domain.order_service' imports forbidden 'app.infrastructure.database.mysql_driver'
[Evaluating QAS: Flash Sale Checkout Latency]
-> Measured p99 Latency : 44.00 ms (Target: < 50.0 ms)
-> Measured Error Rate : 0.0000 % (Target: < 0.01 %)
✅ QAS Verification: PASSED1
2
3
4
5
6
7
8
9
10
11
2
3
4
5
6
7
8
9
10
11
4. Systems Engineering & Production Pitfalls
Các Cạm Bẫy Thực Chiến (Gotchas & Production Antipatterns)
Hội Chứng Phi Hành Gia Kiến Trúc (Architecture Astronaut Syndrome):
- Bản chất: Kiến trúc sư thiết kế các hệ thống trừu tượng quá mức (Over-engineering), áp dụng Microservices, Kubernetes, Event Sourcing, gRPC cho một ứng dụng CRUD nội bộ công ty chỉ có 50 người dùng. Chi phí bảo trì hạ tầng nuốt chửng toàn bộ ngân sách dự án.
- Khắc phục: Bắt đầu với Modular Monolith hoặc Walking Skeleton đơn giản nhất; chỉ phân rã kiến trúc khi xuất hiện áp lực đo lường được từ các Architectural Drivers.
Bỏ Qua Điểm Đánh Đổi (Ignored Trade-offs in ATAM):
- Bản chất: Đội ngũ chọn Microservices vì muốn "Scalability", nhưng bỏ qua hoàn toàn chi phí phát sinh: Network Latency tăng gấp 5 lần, mất tính toàn vẹn giao dịch ACID, và bài toán Distributed Tracing cực kỳ phức tạp.
- Khắc phục: Mọi quyết định kiến trúc phải ghi rõ trong ADR: "Chúng ta chọn giải pháp này thì chúng ta chấp nhận đánh mất điều gì?".
Lỗ Hổng N+1 Truy Vấn Đội Lốt Kiến Trúc Đẹp:
- Bản chất: Áp dụng phân tầng nghiêm ngặt (Repository
Service Controller), nhưng do đóng gói quá kỹ, Service gọirepository.findById(id)trong một vòng lặpfor1000 lần thay vì viết một truy vấnbatch. Kiến trúc hoàn toàn sạch trên giấy nhưng sập database trên Production. - Khắc phục: Bổ sung Fitness Function kiểm tra số lượng truy vấn SQL sinh ra trên mỗi HTTP Request (Query Budget per Request).
- Bản chất: Áp dụng phân tầng nghiêm ngặt (Repository
Kỹ Thuật Chẩn Đoán & Giám Sát Kiến Trúc Bằng CLI:
bash# 1. Phát hiện Circular Dependencies trong mã nguồn Go/TypeScript/C++ madge --circular src/ # 2. Phân tích đồ thị phụ thuộc giữa các package bằng Graphviz go mod graph | modgraphviz | dot -Tpng -o dependencies.png # 3. Chạy ArchUnit kiểm định quy tắc kiến trúc Java/Kotlin trên CI ./gradlew test --tests "*ArchitectureFitnessTest*"1
2
3
4
5
6
7
8
5. Bảng So sánh & Decision Matrix
5.1. So Sánh Các Phương Pháp Đánh Giá Kiến Trúc (Architecture Evaluation Frameworks)
| Phương Pháp | Xuất Xứ / Tổ Chức | Mục Tiêu Trọng Tâm | Thời Điểm Thực Hiện | Chi Phí Nhân Lực |
|---|---|---|---|---|
| ATAM | SEI (Carnegie Mellon) | Đánh giá Trade-offs giữa các thuộc tính chất lượng (NFR) | Trước khi code chính thức | Trung bình (1-2 tuần workshop) |
| SAAM | SEI (Software Architecture Analysis) | Đánh giá khả năng sửa đổi (Modifiability) và chức năng | Giai đoạn thiết kế sơ bộ | Thấp (Vài ngày) |
| CBAM | SEI (Cost-Benefit Analysis) | Tối ưu hóa lợi ích kinh tế (ROI) theo chi phí kiến trúc | Khi quyết định nâng cấp hệ thống | Cao (Cần dữ liệu tài chính) |
| Fitness Functions | ThoughtWorks / Neal Ford | Đo lường liên tục, ngăn ngừa Architectural Drift trong CI | Liên tục 24/7 sau mỗi Git Commit | Rất thấp (Tự động hóa hoàn toàn) |
5.2. Ma Trận Chiến Lược Thiết Kế: BDUF vs Evolutionary Architecture
| Tiêu Chí | Big Design Up Front (BDUF) | Evolutionary Architecture (Tiến Hóa) |
|---|---|---|
| Giả định Cốt lõi | Mọi yêu cầu có thể dự đoán chính xác ngay từ đầu | Yêu cầu và công nghệ liên tục thay đổi theo thời gian |
| Tốc độ Ra Mắt (Time-to-Market) | Rất chậm (Tốn hàng tháng viết tài liệu thiết kế) | Rất nhanh (Dựa trên Walking Skeleton và Spikes) |
| Khả năng Phản hồi Thay đổi | Rất kém; chi phí sửa đổi bản vẽ cực cao | Cực cao; được bảo vệ bởi Automated Fitness Functions |
| Bảo vệ Tính Toàn Vẹn | Dựa vào kỷ luật cá nhân của kỹ sư (Dễ bị Drift) | Dựa vào kiểm thử tự động trong CI/CD Pipelines |
| Môi trường Áp dụng | Phần mềm điều khiển phi thuyền, thiết bị y tế hạt nhân | 99% các hệ thống Web, Cloud, SaaS, FinTech hiện đại |
IyA0LjEuIE7hu4FuIFThuqNuZyBLaeG6v24gVHLDumMgUGjhuqduIE3hu4FtIChTb2Z0d2FyZSBBcmNoaXRlY3R1cmUgRnVuZGFtZW50YWxzKQ0KDQo+IFshSU1QT1JUQU5UXQ0KPiAqKk7hur91IGLhuqFuIGNo4buJIMSRxrDhu6NjIG5o4bubIG3hu5l0IMSRaeG7gXUgZHV5IG5o4bqldDoqKiBLaeG6v24gdHLDumMgcGjhuqduIG3hu4FtIGtow7RuZyBwaOG6o2kgbMOgIHZp4buHYyBs4buxYSBjaOG7jW4gZnJhbWV3b3JrIHRo4budaSB0aMaw4bujbmcsIG3DoCBsw6AgdOG6rXAgaOG7o3AgY8OhYyBxdXnhur90IMSR4buLbmggY+G6pXUgdHLDumMgcXVhbiB0cuG7jW5nIG5o4bqldCwga2jDsyDEkeG6o28gbmfGsOG7o2MgbmjhuqV0IHbDoCB04buRbiBrw6ltIG5o4bqldCBu4bq/dSBsw6BtIHNhaTsgbeG7mXQga2nhur9uIHRyw7pjIHRow6BuaCBjw7RuZyBsw6Aga2nhur9uIHRyw7pjIGPDom4gYuG6sW5nIHThu5FpIMawdSBnaeG7r2EgY8OhYyB0aHXhu5ljIHTDrW5oIGNo4bqldCBsxrDhu6NuZyAoVHJhZGUtb2ZmcykgdsOgIGPDsyBraOG6oyBuxINuZyB0aeG6v24gaMOzYSBsacOqbiB04bulYyB0aMO0bmcgcXVhIGPDoWMgaMOgbSB0aMOtY2gg4bupbmcgdOG7sSDEkeG7mW5nIChBdXRvbWF0ZWQgRml0bmVzcyBGdW5jdGlvbnMpLg0KDQotLS0NCg0KIyMgMS4gS2nhur9uIHRyw7pjIFThu5VuZyBxdWFuICYgTcO0IGjDrG5oIFTGsCBkdXkgKE1lbnRhbCBNb2RlbCkNCg0KIyMjIOG6qG4gZOG7pSDEkOG7nWkgc+G7kW5nOiBL4bq/dCBD4bqldSBDaOG7i3UgTOG7sWMgVMOyYSBOaMOgIHZzIFRyYW5nIFRyw60gTuG7mWkgVGjhuqV0DQpIw6N5IHNvIHPDoW5oIHZp4buHYyB4w6J5IGThu7FuZyBt4buZdCBo4buHIHRo4buRbmcgcGjhuqduIG3hu4FtIHbhu5tpIG3hu5l0IHTDsmEgdGjDoXAgY2jhu41jIHRy4budaSAkODEkIHThuqduZzoNCi0gKipDaGkgdGnhur90IFRyaeG7g24ga2hhaSAoQ29kZSBJbXBsZW1lbnRhdGlvbiAvIEludGVyaW9yIERlY29yKSoqOiBNw6B1IHPGoW4gdMaw4budbmcsIHLDqG0gY+G7rWEsIGLhu5EgdHLDrSBiw6BuIGdo4bq/LiBC4bqhbiBjw7MgdGjhu4MgdGhheSDEkeG7lWkgbcOgdSBzxqFuIGhv4bq3YyDEkeG7lWkgduG7iyB0csOtIHNvZmEgdHJvbmcgbeG7mXQgYnXhu5VpIGNoaeG7gXUgduG7m2kgY2hpIHBow60gcuG6pXQgbmjhu48uIMSQw6J5IGzDoCBjw6FjIGTDsm5nIGNvZGUgY+G7pSB0aOG7gywgdGh14bqtdCB0b8OhbiBoYXkgdGjGsCB2aeG7h24gdGnhu4duIMOtY2guDQotICoqS2nhur9uIHRyw7pjIFBo4bqnbiBt4buBbSAoU29mdHdhcmUgQXJjaGl0ZWN0dXJlIC8gU3RydWN0dXJhbCBFbmdpbmVlcmluZykqKjogVuG7iyB0csOtIG3Ds25nIGPhu41jIGtob2FuIG5o4buTaSBzw6J1IDgwbSB2w6BvIHThuqduZyDEkeG7i2EgY2jhuqV0LCBsw7VpIGLDqiB0w7RuZyBj4buRdCB0aMOpcCBjaOG7i3UgxJHhu5luZyDEkeG6pXQgY+G6pXAgOCwgdsOgIGjhu4cgdGjhu5FuZyDhu5FuZyBk4bqrbiBr4bu5IHRodeG6rXQgY2jhuqF5IG5n4bqnbSB4dXnDqm4gc3Xhu5F0IHTDsmEgbmjDoC4gTuG6v3UgxJHDoyB4w6J5IHhvbmcgdOG6p25nIDUwIG3DoCBi4bqhbiBuaOG6rW4gcmEgbcOzbmcgY+G7jWMgY2jhu4t1IGzhu7FjIGvDqW0gaG/hurdjIG114buRbiBjaHV54buDbiB0b8OgbiBi4buZIGzDtWkgdGhhbmcgbcOheSBzYW5nIGfDs2Mga2jDoWMsIGNoaSBwaMOtIMSR4bqtcCDEkWkgeMOieSBs4bqhaSB0xrDGoW5nIMSRxrDGoW5nIHbhu5tpIHBow6Egc+G6o24uDQotICoqQXJjaGl0ZWN0dXJhbCBEcml2ZXJzIChZ4bq/dSB04buRIFRow7pjIMSR4bqpeSkqKjogxJDhu4thIGNo4bqlbiBraHUgduG7sWMsIHPhu6ljIGdpw7MgYsOjbyAxNTAga20vaCwgdOG6o2kgdHLhu41uZyAxMC4wMDAgY8awIGTDom4sIHbDoCBuZ8OibiBzw6FjaCBk4buxIMOhbi4NCi0gKipGaXRuZXNzIEZ1bmN0aW9ucyAoQ+G6o20gYmnhur9uIEvhur90IGPhuqV1KSoqOiBDw6FjIGPhuqNtIGJp4bq/biDEkW8gxJHhu5kgbmdoacOqbmcgdsOgIMSR4buZIHJ1bmcgbOG6r2MgZ+G6r24gdHLDqm4gxJHhu4luaCB0aMOhcC4gTuG6v3UgdMOyYSBuaMOgIGRhbyDEkeG7mW5nIHbGsOG7o3QgcXXDoSBiacOqbiDEkeG7mSBhbiB0b8OgbiwgY8OyaSBiw6FvIMSR4buZbmcgbOG6rXAgdOG7qWMga8OtY2ggaG/huqF0IChDSS9DRCBQaXBlbGluZSBiw6FvIMSR4buPKS4NCg0KYGBgbWVybWFpZA0KZmxvd2NoYXJ0IFREDQogICAgc3ViZ3JhcGggRHJpdmVyc1siQXJjaGl0ZWN0dXJhbCBEcml2ZXJzICjEkOG6p3UgVsOgbykiXQ0KICAgICAgICBGUlsiWcOqdSBD4bqndSBDaOG7qWMgTsSDbmcgKENvcmUgRlIpIl0NCiAgICAgICAgTkZSWyJUaHXhu5ljIFTDrW5oIENo4bqldCBMxrDhu6NuZyAoUUFTOiBMYXRlbmN5LCBBdmFpbGFiaWxpdHksIFNjYWxhYmlsaXR5KSJdDQogICAgICAgIENPTlsiUsOgbmcgQnXhu5ljIEvhu7kgVGh14bqtdCAmIE5nw6JuIFPDoWNoIChDb25zdHJhaW50cykiXQ0KICAgIGVuZA0KDQogICAgc3ViZ3JhcGggQXJjaGl0ZWN0dXJlUHJvY2Vzc1siUXV5IFRyw6xuaCBLaeG6v24gVHLDumMgJiDEkMOhbmggxJDhu5VpIl0NCiAgICAgICAgRFJbIkRyaXZlcnMiXSAtLT4gQVRBTVsiUGjDom4gVMOtY2ggxJDDoW5oIMSQ4buVaSBBVEFNPGJyLz4oVHJhZGUtb2ZmICYgU2Vuc2l0aXZpdHkgQW5hbHlzaXMpIl0NCiAgICAgICAgQVRBTSAtLT4gQURSWyJBcmNoaXRlY3R1cmFsIERlY2lzaW9uIFJlY29yZHMgKEFEUik8YnIvPlbEg24gYuG6o24gaMOzYSBjw6FjIHF1eeG6v3QgxJHhu4tuaCJdDQogICAgICAgIEFUQU0gLS0+IFN0eWxlWyJM4buxYSBDaOG7jW4gS2nhur9uIFRyw7pjPGJyLz4oU3R5bGVzICYgUGF0dGVybnMpIl0NCiAgICBlbmQNCg0KICAgIHN1YmdyYXBoIEltcGxlbWVudGF0aW9uWyJIaeG7h24gVGjhu7FjIEjDs2EgJiBUaOG6qW0gxJDhu4tuaCJdDQogICAgICAgIFN0eWxlIC0tPiBTcGlrZVsiQXJjaGl0ZWN0dXJhbCBTcGlrZTxici8+KFRo4butIG5naGnhu4dtIGPDtG5nIG5naOG7hyAyLTMgbmfDoHkpIl0NCiAgICAgICAgU3Bpa2UgLS0+IFdTWyJXYWxraW5nIFNrZWxldG9uPGJyLz4oQuG7mSB4xrDGoW5nIGNo4bqheSBFMkUgbeG7j25nIG5o4bqldCkiXQ0KICAgICAgICBXUyAtLT4gQ29kZVsiSOG7hyBUaOG7kW5nIFRyaeG7g24gS2hhaSBUaOG7sWMgVOG6vyJdDQogICAgZW5kDQoNCiAgICBzdWJncmFwaCBFdm9sdXRpb25bIlRp4bq/biBIw7NhICYgUXXhuqNuIFRy4buLIChHb3Zlcm5hbmNlKSJdDQogICAgICAgIENvZGUgLS0+IEZGWyJBdXRvbWF0ZWQgRml0bmVzcyBGdW5jdGlvbnM8YnIvPihLaeG7g20gdHJhIHZpIHBo4bqhbSByYW5oIGdp4bubaSB0cm9uZyBDSSkiXQ0KICAgICAgICBGRiAtLSAiUGjDoXQgaGnhu4duIEFyY2hpdGVjdHVyYWwgRHJpZnQiIC0tPiBSRUZBQ1RPUlsiUmVmYWN0b3IgJiDEkGnhu4F1IGNo4buJbmggS2nhur9uIFRyw7pjIl0NCiAgICAgICAgRkYgLS0gIkjhu6NwIGNodeG6qW4iIC0tPiBQUk9EWyJQcm9kdWN0aW9uIERlcGxveW1lbnQiXQ0KICAgIGVuZA0KYGBgDQoNCi0tLQ0KDQojIyAyLiBDaGkgdGnhur90IHThu6tuZyBLZXl3b3JkIChVbmRlci10aGUtSG9vZCBEZWVwIERpdmUpDQoNCiMjIyAyLjEuIFNvZnR3YXJlIEFyY2hpdGVjdHVyZSwgQXJjaGl0ZWN0dXJlIFN0eWxlcywgUGF0dGVybnMgdsOgIEFyY2hpdGVjdHVyYWwgRHJpdmVycw0KDQojIyMjIDEuIFNvZnR3YXJlIEFyY2hpdGVjdHVyZSAoS2nhur9uIHRyw7pjIFBo4bqnbiBt4buBbSkNClRoZW8gxJHhu4tuaCBuZ2jEqWEgY2h14bqpbiBt4buxYyBJRUVFIDE0NzEgLyBJU08gNDIwMTAgdsOgIGPDoWMgY2h1ecOqbiBnaWEgUmFscGggSm9obnNvbiwgTWFydGluIEZvd2xlcjoNCi0gS2nhur9uIHRyw7pjIHBo4bqnbiBt4buBbSBsw6AgY+G6pXUgdHLDumMgY8ahIGLhuqNuIGPhu6dhIG3hu5l0IGjhu4cgdGjhu5FuZywgYmFvIGfhu5NtIGPDoWMgKip0aMOgbmggcGjhuqduIHBo4bqnbiBt4buBbSAoQ29tcG9uZW50cykqKiwgY8OhYyAqKm3hu5FpIHF1YW4gaOG7hyB0xrDGoW5nIHTDoWMgKENvbm5lY3RvcnMpKiosIHbDoCBjw6FjIG5ndXnDqm4gbMO9IGNo4buJIMSR4bqhbyB2aeG7h2MgdGhp4bq/dCBr4bq/IHbDoCB0aeG6v24gaMOzYSBj4bunYSBjaMO6bmcuDQotIEtp4bq/biB0csO6YyB04bqtcCB0cnVuZyB2w6BvICoibmjhu69uZyBxdXnhur90IMSR4buLbmggdOG7kW4ga8OpbSBuaOG6pXQgbuG6v3UgcGjhuqNpIGzDoG0gbOG6oWkiKi4NCg0KIyMjIyAyLiBBcmNoaXRlY3R1cmUgU3R5bGVzIHZzIEFyY2hpdGVjdHVyZSBQYXR0ZXJucw0KLSAqKkFyY2hpdGVjdHVyZSBTdHlsZSAoUGhvbmcgY8OhY2gga2nhur9uIHRyw7pjKSoqOiBN4buZdCBo4buNIGPDoWMgY+G6pXUgdHLDumMgaOG7hyB0aOG7kW5nIOG7nyBt4bupYyB2xKkgbcO0IMSR4buLbmggaMOsbmggY8OhY2ggdOG7lSBjaOG7qWMgdG/DoG4gY+G7pWMgKHbDrSBk4bulOiBNb25vbGl0aGljLCBNaWNyb3NlcnZpY2VzLCBFdmVudC1Ecml2ZW4sIExheWVyZWQsIFBpcGUgYW5kIEZpbHRlciwgU3BhY2UtQmFzZWQpLiBTdHlsZSB0cuG6oyBs4budaSBjw6J1IGjhu49pOiAqSMOsbmggdGjDoWkgdOG7lW5nIHRo4buDIGPhu6dhIGjhu4cgdGjhu5FuZyB0csO0bmcgbmjGsCB0aOG6vyBuw6BvPyoNCi0gKipBcmNoaXRlY3R1cmUgUGF0dGVybiAoTeG6q3Uga2nhur9uIHRyw7pjKSoqOiBN4buZdCBnaeG6o2kgcGjDoXAgY+G6pXUgdHLDumMgxJHDoyDEkcaw4bujYyBjaHXhuqluIGjDs2EgxJHhu4MgZ2nhuqNpIHF1eeG6v3QgbeG7mXQgYsOgaSB0b8OhbiBs4bq3cCDEkWkgbOG6t3AgbOG6oWkgdHJvbmcgbeG7mXQgYuG7kWkgY+G6o25oIGPhu6UgdGjhu4Mg4bufIHF1eSBtw7Qgbmjhu48gaMahbiBTdHlsZSAodsOtIGThu6U6IENRUlMsIFNhZ2EgUGF0dGVybiwgQ2lyY3VpdCBCcmVha2VyLCBPdXRib3ggUGF0dGVybiwgQkZGIC0gQmFja2VuZCBmb3IgRnJvbnRlbmQpLg0KDQojIyMjIDMuIEFyY2hpdGVjdHVyYWwgRHJpdmVycyAoWeG6v3UgVOG7kSBUaMO6YyDEkOG6qXkgS2nhur9uIFRyw7pjKQ0KS2jDtG5nIGPDsyBraeG6v24gdHLDumMgbsOgbyBzaW5oIHJhIHRyb25nIGNow6JuIGtow7RuZy4gTeG7jWkgcXV54bq/dCDEkeG7i25oIGtp4bq/biB0csO6YyDEkeG7gXUgY2jhu4t1IHPhu7EgdGjDumMgxJHhuql5IGPhu6dhIDQgdHLhu6UgY+G7mXQ6DQoxLiAqKkZ1bmN0aW9uYWwgUmVxdWlyZW1lbnRzIChGUikqKjogTmdoaeG7h3AgduG7pSBj4buRdCBsw7VpIG3DoCBo4buHIHRo4buRbmcgcGjhuqNpIHRo4buxYyBoaeG7h24uDQoyLiAqKlF1YWxpdHkgQXR0cmlidXRlcyAoTm9uLUZ1bmN0aW9uYWwgUmVxdWlyZW1lbnRzIC0gTkZSKSoqOiBU4buRYyDEkeG7mSwgxJHhu5kgdGluIGPhuq15LCBraOG6oyBuxINuZyBjaOG7i3UgbOG7l2ksIHTDrW5oIGNvIGdpw6NuLCBi4bqjbyBt4bqtdC4NCjMuICoqQnVzaW5lc3MgQ29uc3RyYWludHMgKFLDoG5nIGJ14buZYyBLaW5oIGRvYW5oKSoqOiBUaOG7nWkgZ2lhbiByYSBt4bqvdCAoVGltZS10by1NYXJrZXQpLCBuZ8OibiBzw6FjaCBo4bqhIHThuqduZyBtw6F5IGNo4bunIChcJDUsMDAwL3Row6FuZyksIHRyw6xuaCDEkeG7mSBoaeG7h24gdOG6oWkgY+G7p2EgxJHhu5lpIG5nxakga+G7uSBzxrAuDQo0LiAqKlRlY2huaWNhbCBDb25zdHJhaW50cyAoUsOgbmcgYnXhu5ljIEvhu7kgdGh14bqtdCkqKjogQuG6r3QgYnXhu5ljIHBo4bqjaSB0w61jaCBo4bujcCBo4buHIHRo4buRbmcgQ29yZSBCYW5raW5nIHF1YSBjaHXhuqluIElTTyA4NTgzLCBo4buHIHNpbmggdGjDoWkgxJHDoW0gbcOieSBjaOG7iSDEkeG7i25oIChBV1MvR0NQKSwgY8ahIGNo4bq/IHjDoWMgdGjhu7FjIE9BdXRoMi4NCg0KLS0tDQoNCiMjIyAyLjIuIFF1YWxpdHkgQXR0cmlidXRlIFNjZW5hcmlvIChRQVMpIHbDoCDEkG8gbMaw4budbmcgUGhpIENo4bupYyBuxINuZw0KQ8OhYyB5w6p1IGPhuqd1IHBoaSBjaOG7qWMgbsSDbmcgbcahIGjhu5MgbmjGsCAqIkjhu4cgdGjhu5FuZyBwaOG6o2kgbmhhbmgiKiwgKiJI4buHIHRo4buRbmcgcGjhuqNpIGPDsyB0w61uaCBz4bq1biBzw6BuZyBjYW8iKiBsw6Agbmd14buTbiBn4buRYyBj4bunYSBt4buNaSB0aOG6o20gaOG7jWEgcGjhuqduIG3hu4FtLiDEkOG7gyBiaeG6v24gY2jDum5nIHRow6BuaCB0acOqdSBjaMOtIGvhu7kgdGh14bqtdCBjw7MgdGjhu4Mga2nhu4NtIGNo4bupbmcgdG/DoW4gaOG7jWMsIFZp4buHbiBL4bu5IG5naOG7hyBQaOG6p24gbeG7gW0gU0VJIChDYXJuZWdpZSBNZWxsb24gVW5pdmVyc2l0eSkgxJHhu4EgeHXhuqV0IGPhuqV1IHRyw7pjICoqUXVhbGl0eSBBdHRyaWJ1dGUgU2NlbmFyaW8gKFFBUykqKiBn4buTbSA2IHRow6BuaCBwaOG6p24gYuG6r3QgYnXhu5ljOg0KDQpgYGBtZXJtYWlkDQpmbG93Y2hhcnQgTFINCiAgICBTWyIxLiBTb3VyY2Ugb2YgU3RpbXVsdXM8YnIvPihOZ3Xhu5NuIGvDrWNoIHRow61jaDogS2jDoWNoIGjDoG5nKSJdIC0tPiBTVFsiMi4gU3RpbXVsdXM8YnIvPihLw61jaCB0aMOtY2g6IDUwLjAwMCBSUFMpIl0NCiAgICBTVCAtLT4gQVsiMy4gQXJ0aWZhY3Q8YnIvPihUaMOgbmggcGjhuqduOiBDaGVja291dCBBUEkpIl0NCiAgICBFTlZbIjQuIEVudmlyb25tZW50PGJyLz4oTcO0aSB0csaw4budbmc6IEZsYXNoIFNhbGUpIl0gLS4tPiBBDQogICAgQSAtLT4gUlsiNS4gUmVzcG9uc2U8YnIvPihQaOG6o24gaOG7k2k6IFjhu60gbMO9IMSRxqFuIGjDoG5nKSJdDQogICAgUiAtLT4gUk1bIjYuIFJlc3BvbnNlIE1lYXN1cmU8YnIvPihUaMaw4bubYyDEkW86IHA5OSA8IDUwbXMsIEVycm9yIDwgMC4wMSUpIl0NCmBgYA0KDQp8IFRow6BuaCBwaOG6p24gUUFTIHwgw50gTmdoxKlhIEvhu7kgVGh14bqtdCB8IFbDrSBE4bulIEPhu6UgVGjhu4MgfA0KfCA6LS0tIHwgOi0tLSB8IDotLS0gfA0KfCAqKjEuIFNvdXJjZSBvZiBTdGltdWx1cyoqIHwgVGjhu7FjIHRo4buDIGvDrWNoIGhv4bqhdCBz4buxIGtp4buHbiAoTmfGsOG7nWkgZMO5bmcsIEhhY2tlciwgQ3JvbiwgU2Vuc29yKSB8ICQxMDAuMDAwJCBuZ8aw4budaSBkw7luZyDEkeG7k25nIHRo4budaSB0csOqbiBNb2JpbGUgQXBwIHwNCnwgKioyLiBTdGltdWx1cyoqIHwgVMOhYyBuaMOibiBob+G6t2MgxJFp4buBdSBraeG7h24gY+G6p24geOG7rSBsw70gfCBH4butaSB5w6p1IGPhuqd1IHRoYW5oIHRvw6FuIGdp4buPIGjDoG5nIHRyb25nIGdp4budIEZsYXNoIFNhbGUgfA0KfCAqKjMuIEFydGlmYWN0KiogfCBC4buZIHBo4bqtbiBob+G6t2MgcGjDom4gaOG7hyBwaOG6p24gbeG7gW0gY2jhu4t1IHTDoWMgxJHhu5luZyB8IFNlcnZpY2UgVGhhbmggdG/DoW4gKFBheW1lbnQgR2F0ZXdheSAmIExlZGdlciBEQikgfA0KfCAqKjQuIEVudmlyb25tZW50KiogfCBUcuG6oW5nIHRow6FpIGPhu6dhIGjhu4cgdGjhu5FuZyBraGkga8OtY2ggdGjDrWNoIHjhuqN5IHJhIHwgSOG7hyB0aOG7kW5nIMSRYW5nIGNo4buLdSB04bqjaSDEkeG7iW5oIChQZWFrIExvYWQpLCBt4buZdCBj4bulbSBEQiBi4buLIGxhZyB8DQp8ICoqNS4gUmVzcG9uc2UqKiB8IEjDoG5oIHZpIG3DoCBo4buHIHRo4buRbmcgcGjhuqNpIHRo4buxYyBoaeG7h24ga2hpIGLhu4sga8OtY2ggdGjDrWNoIHwgVGnhur9wIG5o4bqtbiB5w6p1IGPhuqd1LCBi4bqjbyBsxrB1IHRo4bupIHThu7EgaMOgbmcgxJHhu6NpLCBnaGkgbmjhuq1uIGdpYW8gZOG7i2NoIHwNCnwgKio2LiBSZXNwb25zZSBNZWFzdXJlKiogfCBUaMaw4bubYyDEkW8gxJHhu4tuaCBsxrDhu6NuZyDEkeG7gyB4w6FjIMSR4buLbmggUGFzcy9GYWlsIHwgxJDhu5kgdHLhu4UgJHA5OSBcbGUgMTIwXCxcdGV4dHttc30kLCB04bu3IGzhu4cgdGjhuqV0IGLhuqFpICQ1XHRleHR7eHh9IFxsZSAwLjAwMVwlJCB8DQoNCi0tLQ0KDQojIyMgMi4zLiBQaMawxqFuZyBwaMOhcCDEkMOhbmggZ2nDoSDEkMOhbmggxJHhu5VpIEtp4bq/biB0csO6YyAoQVRBTSkNCioqQXJjaGl0ZWN0dXJlIFRyYWRlLW9mZiBBbmFseXNpcyBNZXRob2QgKEFUQU0pKiogbMOgIHF1eSB0csOsbmgga2hvYSBo4buNYyDEkcaw4bujYyBwaMOhdCB0cmnhu4NuIGLhu59pIFNFSSBuaOG6sW0gcGjDom4gdMOtY2ggcuG7p2kgcm8gdsOgIMSRw6FuaCBnacOhIGPDoWMgcGjGsMahbmcgw6FuIGtp4bq/biB0csO6YyB0csaw4bubYyBraGkgxJHhuqd1IHTGsCBuaMOibiBs4buxYyBs4bqtcCB0csOsbmguDQoNCkPhu5F0IGzDtWkgY+G7p2EgQVRBTSBsw6AgeMOhYyDEkeG7i25oOg0KLSAqKlNlbnNpdGl2aXR5IFBvaW50cyAoxJBp4buDbSBuaOG6oXkgY+G6o20pKio6IE3hu5l0IHF1eeG6v3QgxJHhu4tuaCBraeG6v24gdHLDumMgdMOhYyDEkeG7mW5nIG3huqFuaCBt4bq9IMSR4bq/biBt4buZdCB0aHXhu5ljIHTDrW5oIGNo4bqldCBsxrDhu6NuZyBkdXkgbmjhuqV0LiAoVsOtIGThu6U6IFRow6ptIHRodeG6rXQgdG/DoW4gbcOjIGjDs2EgQUVTLTI1NiB0xINuZyBt4bqhbmggdMOtbmggQuG6o28gbeG6rXQpLg0KLSAqKlRyYWRlLW9mZiBQb2ludHMgKMSQaeG7g20gxJHDoW5oIMSR4buVaSkqKjogTeG7mXQgcXV54bq/dCDEkeG7i25oIGtp4bq/biB0csO6YyBsw6BtIHTEg25nIHRodeG7mWMgdMOtbmggY2jhuqV0IGzGsOG7o25nICRBJCBuaMawbmcgbOG6oWkgdHLhu7FjIHRp4bq/cCBsw6BtIHN1eSBnaeG6o20gdGh14buZYyB0w61uaCBjaOG6pXQgbMaw4bujbmcgJEIkLiAoVsOtIGThu6U6IE3DoyBow7NhIEFFUy0yNTYgdMSDbmcgQuG6o28gbeG6rXQgbmjGsG5nIGzDoG0gc3V5IGdp4bqjbSBUaHJvdWdocHV0IHbDoCB0xINuZyBDUFUgTGF0ZW5jeSkuDQotICoqUmlza3MgKFLhu6dpIHJvKSoqOiBDw6FjIHF1eeG6v3QgxJHhu4tuaCBraeG6v24gdHLDumMgY2jGsGEgcsO1IHLDoG5nIGhv4bq3YyBjw7MgeMOhYyBzdeG6pXQgY2FvIGtow7RuZyB0aOG7j2EgbcOjbiBRQVMuDQotICoqTm9uLVJpc2tzIChQaGkgcuG7p2kgcm8pKio6IEPDoWMgcXV54bq/dCDEkeG7i25oIHRoaeG6v3Qga+G6vyBhbiB0b8OgbiwgY8OzIHRp4buBbiBs4buHIGtp4buDbSBjaOG7qW5nIHThu5F0Lg0KDQotLS0NCg0KIyMjIDIuNC4gRXZvbHV0aW9uYXJ5IEFyY2hpdGVjdHVyZSwgQXJjaGl0ZWN0dXJhbCBTcGlrZXMgJiBXYWxraW5nIFNrZWxldG9uDQoNCiMjIyMgMS4gRXZvbHV0aW9uYXJ5IEFyY2hpdGVjdHVyZSAoS2nhur9uIHRyw7pjIFRp4bq/biBow7NhKQ0KxJDGsOG7o2MgTmVhbCBGb3JkLCBSZWJlY2NhIFBhcnNvbnMgdsOgIFBhdHJpY2sgS3VhIMSR4buLbmggbmdoxKlhOiAqIktp4bq/biB0csO6YyB0aeG6v24gaMOzYSBsw6Aga2nhur9uIHRyw7pjIGjhu5cgdHLhu6Mgc+G7sSB0aGF5IMSR4buVaSBjw7MgxJHhu4tuaCBoxrDhu5tuZyB2w6AgbGnDqm4gdOG7pWMgcXVhIG5oaeG7gXUgY2hp4buBdSAobXVsdGlwbGUgZGltZW5zaW9ucykgbcOgIGtow7RuZyBsw6BtIHN1eSB0aG/DoWkgY8OhYyB0aHXhu5ljIHTDrW5oIGNo4bqldCBsxrDhu6NuZyBj4buRdCBsw7VpIiouIFRoYXkgdsOsIGPhu5EgZ+G6r25nIGThu7EgxJFvw6FuIHRvw6BuIGLhu5kgdMawxqFuZyBsYWkgKEJpZyBEZXNpZ24gVXAgRnJvbnQgLSBCRFVGKSwga2nhur9uIHRyw7pjIHPGsCB04bqhbyByYSBt4buZdCBo4buHIHRo4buRbmcgY8OzIGto4bqjIG7Eg25nIHRow61jaCBuZ2hpIGtoaSBuZ2hp4buHcCB24bulIHbDoCBjw7RuZyBuZ2jhu4cgdGhheSDEkeG7lWkuDQoNCiMjIyMgMi4gQXJjaGl0ZWN0dXJhbCBTcGlrZXMgKMSQ4bujdCBUaOG7rSBOZ2hp4buHbSBLaeG6v24gVHLDumMpDQotIFRodeG6rXQgbmfhu68gYuG6r3Qgbmd14buTbiB04burIGVYdHJlbWUgUHJvZ3JhbW1pbmcgKFhQKS4NCi0gTMOgIG3hu5l0IHRo4butIG5naGnhu4dtIGzhuq1wIHRyw6xuaCBjw7MgZ2nhu5tpIGjhuqFuIHRo4budaSBnaWFuIChUaW1lLWJveGVkLCB0aMaw4budbmcgdOG7qyAxIMSR4bq/biAzIG5nw6B5KSBuaOG6sW0gdHLhuqMgbOG7nWkgbeG7mXQgY8OidSBo4buPaSBr4bu5IHRodeG6rXQgY+G7pSB0aOG7gyBob+G6t2MgbG/huqFpIGLhu48gcuG7p2kgcm8gbOG7m24gbmjhuqV0ICh2w60gZOG7pTogKkthZmthIGPDsyB0aOG7gyB44butIGzDvSAkNTAwLjAwMCQgbWVzc2FnZXMvcyB0csOqbiBj4bulbSAzIG5vZGUgdDMubWVkaXVtIGtow7RuZz8qKS4NCi0gQ29kZSBj4bunYSBTcGlrZSB0aMaw4budbmcgYuG7iyB24bupdCBi4buPIChUaHJvd2F3YXkgY29kZSkgc2F1IGtoaSDEkcOjIHRodSB0aOG6rXAgxJHhu6cgZOG7ryBsaeG7h3UgxJFvIGzGsOG7nW5nLg0KDQojIyMjIDMuIFdhbGtpbmcgU2tlbGV0b24gKELhu5kgWMawxqFuZyBDaHV54buDbiDEkOG7mW5nKQ0KLSBEbyBBbGlzdGFpciBDb2NrYnVybiBraOG7n2kgeMaw4bubbmcuDQotIEzDoCBt4buZdCBoaeG7h24gdGjhu7FjIGjDs2Egbmjhu48gbmjhuqV0IHThu6sgxJHhuqd1IMSR4bq/biBjdeG7kWkgKEVuZC10by1FbmQpIGPhu6dhIHRvw6BuIGLhu5kga2nhur9uIHRyw7pjIGjhu4cgdGjhu5FuZzogQ2xpZW50ICRcdG8kIEFQSSBHYXRld2F5ICRcdG8kIEJ1c2luZXNzIFNlcnZpY2UgJFx0byQgRGF0YWJhc2UgJFx0byQgTW9uaXRvcmluZyAkXHRvJCBDSS9DRCBQaXBlbGluZS4NCi0gRMO5IGNo4bupYyBuxINuZyBuZ2hp4buHcCB24bulIGNo4buJIGzDoCBt4buZdCBow6BtIHLhu5duZyAoYHJldHVybiAiSGVsbG8gV29ybGQiYCksIFdhbGtpbmcgU2tlbGV0b24gY2jhu6luZyBtaW5oIHLhurFuZyB0b8OgbiBi4buZIGPDoWMgxJHGsOG7nW5nIOG7kW5nIGvhur90IG7hu5FpIGvhu7kgdGh14bqtdCwgY+G6pXUgaMOsbmggbeG6oW5nIHbDoCB04buxIMSR4buZbmcgaMOzYSB0cmnhu4NuIGtoYWkgxJHDoyBob+G6oXQgxJHhu5luZyB0csahbiB0cnUgbmdheSB04burIFNwcmludCAxLg0KDQotLS0NCg0KIyMjIDIuNS4gQXJjaGl0ZWN0dXJhbCBGaXRuZXNzIEZ1bmN0aW9ucyB2w6AgTmfEg24gQ2jhurduIEFyY2hpdGVjdHVyYWwgRHJpZnQNCg0KIyMjIyAxLiBBcmNoaXRlY3R1cmFsIERyaWZ0IChT4buxIFN1eSBUaG/DoWkgS2nhur9uIFRyw7pjKQ0KTMOgIGhp4buHbiB0xrDhu6NuZyBraeG6v24gdHLDumMgdGjhu7FjIHThur8gxJHGsOG7o2MgaGnhu4duIHRo4buxYyBow7NhIHRyb25nIGNvZGUgZOG6p24gZOG6p24gYuG7iyB4w7NpIG3Dsm4sIGJp4bq/biBk4bqhbmcgdsOgIHLhu51pIHhhIGLhuqNuIHRoaeG6v3Qga+G6vyBiYW4gxJHhuqd1LiBOZ3V5w6puIG5ow6JuIGRvIMOhcCBs4buxYyB0aeG6v24gxJHhu5kgKERlYWRsaW5lcyksIHPhu7EgdGhp4bq/dSBoaeG7g3UgYmnhur90IGPhu6dhIGPDoWMgbOG6rXAgdHLDrG5oIHZpw6puIG3hu5tpLCBk4bqrbiDEkeG6v24gY8OhYyB2aSBwaOG6oW0gbmdoacOqbSB0cuG7jW5nOiBDb250cm9sbGVyIGfhu41pIHRo4bqzbmcgdsOgbyBEYXRhYmFzZSwgU2VydmljZSB04bqnbmcgZMaw4bubaSBn4buNaSBuZ8aw4bujYyBsw6puIHThuqduZyB0csOqbiwgc2luaCByYSBDaXJjdWxhciBEZXBlbmRlbmNpZXMuDQoNCmBgYG1lcm1haWQNCmdyYXBoIExSDQogICAgc3ViZ3JhcGggRGVzaWduZWRBcmNoWyJLaeG6v24gVHLDumMgVGhp4bq/dCBL4bq/IEJhbiDEkOG6p3UiXQ0KICAgICAgICBEMVtVSSAvIENvbnRyb2xsZXJdIC0tPiBEMltEb21haW4gU2VydmljZV0NCiAgICAgICAgRDIgLS0+IEQzW1JlcG9zaXRvcnkgLyBEQl0NCiAgICBlbmQNCg0KICAgIHN1YmdyYXBoIERyaWZ0ZWRBcmNoWyJLaeG6v24gVHLDumMgQuG7iyBTdXkgVGhvw6FpIChBcmNoaXRlY3R1cmFsIERyaWZ0KSJdDQogICAgICAgIEExW1VJIC8gQ29udHJvbGxlcl0gLS0+IEEyW0RvbWFpbiBTZXJ2aWNlXQ0KICAgICAgICBBMiAtLT4gQTNbUmVwb3NpdG9yeSAvIERCXQ0KICAgICAgICBBMSAtLiAiVmkgcGjhuqFtOiBDaOG7jWMgdOG6r3QhIiAuLT4gQTMNCiAgICAgICAgQTMgLS4gIlZpIHBo4bqhbTogQ2lyY3VsYXIgUmVmISIgLi0+IEExDQogICAgZW5kDQpgYGANCg0KIyMjIyAyLiBBcmNoaXRlY3R1cmFsIEZpdG5lc3MgRnVuY3Rpb25zIChIw6BtIFRow61jaCDhu6huZyBLaeG6v24gVHLDumMpDQpMw6AgYuG6pXQga+G7syBjxqEgY2jhur8ga2nhu4NtIHRyYSB04buxIMSR4buZbmcgbsOgbyAoVW5pdCBUZXN0LCBBcmNoVW5pdCwgQVNUIExpbnRlciwgQmVuY2htYXJrKSBkw7luZyDEkeG7gyDEkW8gbMaw4budbmcgdMOtbmggdG/DoG4gduG6uW4gY+G7p2Ega2nhur9uIHRyw7pjIHRyb25nIGNodSB0csOsbmggQ0kvQ0Q6DQotICoqS2nhu4NtIHRyYSBSYW5oIGdp4bubaSBU4bqnbmcgKExheWVyIEludGVncml0eSkqKjogRG9tYWluIG1vZGVsIGtow7RuZyBiYW8gZ2nhu50gxJHGsOG7o2MgcGjDqXAgaW1wb3J0IGLhuqV0IGvhu7MgcGFja2FnZSBuw6BvIHThu6sgSW5mcmFzdHJ1Y3R1cmUgaG/hurdjIEZyYW1ld29yay4NCi0gKipLaeG7g20gdHJhIFBo4bulIHRodeG7mWMgVsOybmcgKENpcmN1bGFyIERlcGVuZGVuY3kpKio6IEPhuqVtIHRp4buHdCBQYWNrYWdlICRBIFx0byBCIFx0byBBJC4NCi0gKipLaeG7g20gdHJhIFRodeG7mWMgdMOtbmggSGnhu4d1IG7Eg25nKio6IFRo4budaSBnaWFuIHJlc3BvbnNlICRwOTUkIGtow7RuZyDEkcaw4bujYyB2xrDhu6N0IHF1w6EgJDIwMFwsXHRleHR7bXN9JCB0cm9uZyDEkeG7o3QgY2jhuqF5IHBlcmZvcm1hbmNlIHJlZ3Jlc3Npb24gdGVzdC4NCg0KLS0tDQoNCiMjIyAyLjYuIEFyY2hpdGVjdHVyZSBHb3Zlcm5hbmNlIHbDoCBBcmNoaXRlY3R1cmFsIERlY2lzaW9uIFJlY29yZHMgKEFEUikNCsSQ4buDIG5nxINuIG5n4burYSBraeG6v24gdHLDumMgdHLhu58gdGjDoG5oICJ0cnV54buBbiB0aHV54bq/dCBtaeG7h25nIiwgbeG7jWkgcXV54bq/dCDEkeG7i25oIHF1YW4gdHLhu41uZyBwaOG6o2kgxJHGsOG7o2MgdsSDbiBi4bqjbiBow7NhIGTGsOG7m2kgZOG6oW5nICoqQURSIChBcmNoaXRlY3R1cmFsIERlY2lzaW9uIFJlY29yZCkqKjoNCg0KYGBgbWFya2Rvd24NCiMgQURSLTAwNzogU+G7rSBE4bulbmcgUG9zdGdyZVNRTCBDaG8gQuG6o25nIEvhur8gVG/DoW4gVGhheSBWw6wgTW9uZ29EQg0KDQojIyBC4buRaSBj4bqjbmggKENvbnRleHQpDQpI4buHIHRo4buRbmcgY+G6p24gbMawdSB0cuG7ryBnaWFvIGThu4tjaCB0aeG7gW4gdOG7hyB24bubaSB5w6p1IGPhuqd1IGLhuqNvIHRvw6BuIHR1eeG7h3QgxJHhu5FpIHTDrW5oIG5o4bqldCBxdcOhbiAoQUNJRCksIG5nxINuIGNo4bq3biBjaGkgdGnDqnUga8OpcCAoRG91YmxlIFNwZW5kaW5nKS4gxJDhu5lpIG5nxakgxJFhbmcgY8OibiBuaOG6r2MgZ2nhu69hIFBvc3RncmVTUUwgdsOgIE1vbmdvREIuDQoNCiMjIFF1eeG6v3QgxJHhu4tuaCAoRGVjaXNpb24pDQpDaMO6bmcgdMO0aSBxdXnhur90IMSR4buLbmggY2jhu41uICoqUG9zdGdyZVNRTCoqIGzDoG0gY8ahIHPhu58gZOG7ryBsaeG7h3UgY2jDrW5oIGNobyBMZWRnZXIgU2VydmljZSwgc+G7rSBk4bulbmcgbeG7qWMgY8O0IGzhuq1wIGdpYW8gZOG7i2NoIFNlcmlhbGl6YWJsZSBJc29sYXRpb24uDQoNCiMjIFRy4bqhbmcgdGjDoWkgKFN0YXR1cykNCsSQw6MgZHV54buHdCAoQWNjZXB0ZWQpLg0KDQojIyBI4buHIHF14bqjICYgxJDDoW5oIMSR4buVaSAoQ29uc2VxdWVuY2VzKQ0KLSBUw61jaCBj4buxYzogxJDhuqNtIGLhuqNvIEFDSUQgdHV54buHdCDEkeG7kWkg4bufIHThuqduZyBjxqEgc+G7nyBk4buvIGxp4buHdSwgaOG7lyB0cuG7oyBTUUwgcXVhbiBo4buHIGNodeG6qW4gbeG7sWMuDQotIFRpw6p1IGPhu7FjOiBLaOG6oyBuxINuZyBt4bufIHLhu5luZyBnaGkgbmdhbmcgKFNoYXJkaW5nKSBraMOzIGtoxINuIGjGoW4gTW9uZ29EQjsgxJHhu5lpIG5nxakgY+G6p24gdGhp4bq/dCBs4bqtcCBnaeG6o2kgcGjDoXAgUmVhZC1SZXBsaWNhIMSR4buDIGNoaWEgdOG6o2kgdHJ1eSB24bqlbi4NCmBgYA0KDQotLS0NCg0KIyMgMy4gVGjhu7FjIHRoaSBNw6Mgbmd14buTbiAmIE3DtCBwaOG7j25nIENodXnDqm4gc8OidSAoRHVhbC1FbmdpbmUgSW1wbGVtZW50YXRpb24pDQoNCiMjIyAzLjEuIEMrKzIwIEltcGxlbWVudGF0aW9uOiBDb21waWxlLVRpbWUgQXJjaGl0ZWN0dXJlIExheWVyIENvbnN0cmFpbnQgVmVyaWZpZXINCkNoxrDGoW5nIHRyw6xuaCBDKysyMCBkxrDhu5tpIMSRw6J5IHPhu60gZOG7pW5nIEMrKzIwIENvbmNlcHRzIHbDoCBUeXBlIFRyYWl0cyDEkeG7gyBoaeG7h24gdGjhu7FjIGjDs2EgbeG7mXQgKipBcmNoaXRlY3R1cmFsIEZpdG5lc3MgRnVuY3Rpb24qKiBob+G6oXQgxJHhu5luZyBuZ2F5IHRyb25nIHF1w6EgdHLDrG5oIGJpw6puIGThu4tjaCAoQ29tcGlsZS10aW1lKSwgbmfEg24gY2jhurduIHZp4buHYyBjw6FjIHThuqduZyBuZ2hp4buHcCB24bulIGLhu4sgw7Qgbmhp4buFbSBi4bufaSBjw6FjIGtp4buDdSBk4buvIGxp4buHdSB04burIHThuqduZyBo4bqhIHThuqduZyAoSW5mcmFzdHJ1Y3R1cmUpLg0KDQpgYGBjcHANCiNpbmNsdWRlIDxpb3N0cmVhbT4NCiNpbmNsdWRlIDx0eXBlX3RyYWl0cz4NCiNpbmNsdWRlIDxjb25jZXB0cz4NCiNpbmNsdWRlIDxzdHJpbmc+DQoNCi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0NCi8vIMSQ4buKTkggTkdIxKhBIEPDgUMgVEFHIFBIw4JOIFThuqZORyBLSeG6vk4gVFLDmkMgKEFSQ0hJVEVDVFVSQUwgTEFZRVIgVEFHUykNCi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0NCnN0cnVjdCBEb21haW5MYXllclRhZyB7fTsNCnN0cnVjdCBJbmZyYXN0cnVjdHVyZUxheWVyVGFnIHt9Ow0Kc3RydWN0IFByZXNlbnRhdGlvbkxheWVyVGFnIHt9Ow0KDQovLyBDKysyMCBDb25jZXB0OiBC4bqvdCBideG7mWMgdGjhu7FjIHRo4buDIHBo4bqjaSB0aHXhu5ljIERvbWFpbiBMYXllcg0KdGVtcGxhdGUgPHR5cGVuYW1lIFQ+DQpjb25jZXB0IElzRG9tYWluRW50aXR5ID0gc3RkOjppc19iYXNlX29mX3Y8RG9tYWluTGF5ZXJUYWcsIFQ+Ow0KDQovLyBDKysyMCBDb25jZXB0OiBC4bqvdCBideG7mWMgdGjhu7FjIHRo4buDIHRodeG7mWMgSW5mcmFzdHJ1Y3R1cmUNCnRlbXBsYXRlIDx0eXBlbmFtZSBUPg0KY29uY2VwdCBJc0luZnJhc3RydWN0dXJlU2VydmljZSA9IHN0ZDo6aXNfYmFzZV9vZl92PEluZnJhc3RydWN0dXJlTGF5ZXJUYWcsIFQ+Ow0KDQovLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQovLyBET01BSU4gTEFZRVIgKEPhuqRNIFBI4bukIFRIVeG7mEMgVsOATyBJTkZSQVNUUlVDVFVSRSkNCi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0NCmNsYXNzIE9yZGVyQWdncmVnYXRlIDogcHVibGljIERvbWFpbkxheWVyVGFnIHsNCnByaXZhdGU6DQogICAgdWludDY0X3Qgb3JkZXJJZF87DQogICAgaW50NjRfdCBhbW91bnRDZW50c187DQpwdWJsaWM6DQogICAgT3JkZXJBZ2dyZWdhdGUodWludDY0X3QgaWQsIGludDY0X3QgYW1vdW50KSA6IG9yZGVySWRfKGlkKSwgYW1vdW50Q2VudHNfKGFtb3VudCkge30NCiAgICBbW25vZGlzY2FyZF1dIHVpbnQ2NF90IGlkKCkgY29uc3Qgbm9leGNlcHQgeyByZXR1cm4gb3JkZXJJZF87IH0NCiAgICBbW25vZGlzY2FyZF1dIGludDY0X3QgYW1vdW50KCkgY29uc3Qgbm9leGNlcHQgeyByZXR1cm4gYW1vdW50Q2VudHNfOyB9DQp9Ow0KDQovLyBJbnRlcmZhY2UgUmVwb3NpdG9yeSBu4bqxbSB0cm9uZyBEb21haW4gTGF5ZXIgKERlcGVuZGVuY3kgSW52ZXJzaW9uIFByaW5jaXBsZSkNCmNsYXNzIElPcmRlclJlcG9zaXRvcnkgOiBwdWJsaWMgRG9tYWluTGF5ZXJUYWcgew0KcHVibGljOg0KICAgIHZpcnR1YWwgfklPcmRlclJlcG9zaXRvcnkoKSA9IGRlZmF1bHQ7DQogICAgdmlydHVhbCB2b2lkIHNhdmUoY29uc3QgT3JkZXJBZ2dyZWdhdGUmIG9yZGVyKSA9IDA7DQp9Ow0KDQovLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQovLyBJTkZSQVNUUlVDVFVSRSBMQVlFUiAoUEjhu6QgVEhV4buYQyBWw4BPIERPTUFJTikNCi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0NCmNsYXNzIFBvc3RncmVzT3JkZXJSZXBvc2l0b3J5IDogcHVibGljIEluZnJhc3RydWN0dXJlTGF5ZXJUYWcsIHB1YmxpYyBJT3JkZXJSZXBvc2l0b3J5IHsNCnB1YmxpYzoNCiAgICB2b2lkIHNhdmUoY29uc3QgT3JkZXJBZ2dyZWdhdGUmIG9yZGVyKSBvdmVycmlkZSB7DQogICAgICAgIHN0ZDo6Y291dCA8PCAiW1Bvc3RncmVzIEluZnJhXSBFeGVjdXRpbmcgU1FMOiBJTlNFUlQgSU5UTyBvcmRlcnMgVkFMVUVTICgiIA0KICAgICAgICAgICAgICAgICAgPDwgb3JkZXIuaWQoKSA8PCAiLCAiIDw8IG9yZGVyLmFtb3VudCgpIDw8ICIpO1xuIjsNCiAgICB9DQp9Ow0KDQovLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQovLyBBUkNISVRFQ1RVUkFMIEZJVE5FU1MgRlVOQ1RJT04gRU5HSU5FIChDT01QSUxFLVRJTUUgUlVMRSBDSEVDSykNCi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0NCnRlbXBsYXRlIDx0eXBlbmFtZSBTZXJ2aWNlVCwgdHlwZW5hbWUgUmVwb1Q+DQpjbGFzcyBEb21haW5TZXJ2aWNlSG9zdCB7DQogICAgLy8gRklUTkVTUyBGVU5DVElPTiBBU1NFUlRJT046IFJlcG9UIGLhuq90IGJ14buZYyBwaOG6o2kgY8OgaSDEkeG6t3QgSW50ZXJmYWNlIHThu6sgRG9tYWluIExheWVyLA0KICAgIC8vIGNo4bupIERvbWFpblNlcnZpY2Uga2jDtG5nIMSRxrDhu6NjIHBow6lwIGdow6lwIG7hu5FpIHRy4buxYyB0aeG6v3AgduG7m2kgQ29uY3JldGUgSW5mcmEhDQogICAgc3RhdGljX2Fzc2VydChzdGQ6OmlzX2Jhc2Vfb2ZfdjxJT3JkZXJSZXBvc2l0b3J5LCBSZXBvVD4sIA0KICAgICAgICAgICAgICAgICAgIlZJT0xBVElPTjogRG9tYWluU2VydmljZSBtdXN0IGRlcGVuZCBvbiBJT3JkZXJSZXBvc2l0b3J5IEludGVyZmFjZSEiKTsNCnB1YmxpYzoNCiAgICBzdGF0aWMgdm9pZCBleGVjdXRlT3JkZXJGbG93KE9yZGVyQWdncmVnYXRlIG9yZGVyLCBSZXBvVCYgcmVwbykgew0KICAgICAgICBzdGQ6OmNvdXQgPDwgIltEb21haW4gU2VydmljZV0gUHJvY2Vzc2luZyBidXNpbmVzcyBydWxlcyBmb3IgT3JkZXIgIiA8PCBvcmRlci5pZCgpIDw8ICIuLi5cbiI7DQogICAgICAgIHJlcG8uc2F2ZShvcmRlcik7DQogICAgfQ0KfTsNCg0KaW50IG1haW4oKSB7DQogICAgc3RkOjpjb3V0IDw8ICI9PT0gQysrMjAgQ29tcGlsZS1UaW1lIEFyY2hpdGVjdHVyYWwgRml0bmVzcyBSdWxlIEVuZ2luZSA9PT1cbiI7DQoNCiAgICBPcmRlckFnZ3JlZ2F0ZSB2YWxpZE9yZGVyKDEwMSwgNzUwMDApOw0KICAgIFBvc3RncmVzT3JkZXJSZXBvc2l0b3J5IHBvc3RncmVzUmVwbzsNCg0KICAgIC8vIEto4bufaSBjaOG6oXkgRG9tYWluIFNlcnZpY2UgdHXDom4gdGjhu6cgbmdoacOqbSBuZ+G6t3QgcmFuaCBnaeG7m2kga2nhur9uIHRyw7pjDQogICAgRG9tYWluU2VydmljZUhvc3Q8dm9pZCwgSU9yZGVyUmVwb3NpdG9yeT46OmV4ZWN1dGVPcmRlckZsb3codmFsaWRPcmRlciwgcG9zdGdyZXNSZXBvKTsNCg0KICAgIHN0ZDo6Y291dCA8PCAiW0ZpdG5lc3MgRnVuY3Rpb24gQ2hlY2tdIEFsbCBMYXllciBJbnZhcmlhbnRzIFZhbGlkYXRlZCBhdCBDb21waWxlLVRpbWUhXG4iOw0KICAgIHJldHVybiAwOw0KfQ0KYGBgDQoNCiMjIyMgVGVybWluYWwgT3V0cHV0IE3huqt1IChDKysyMCk6DQpgYGB0ZXh0DQo9PT0gQysrMjAgQ29tcGlsZS1UaW1lIEFyY2hpdGVjdHVyYWwgRml0bmVzcyBSdWxlIEVuZ2luZSA9PT0NCltEb21haW4gU2VydmljZV0gUHJvY2Vzc2luZyBidXNpbmVzcyBydWxlcyBmb3IgT3JkZXIgMTAxLi4uDQpbUG9zdGdyZXMgSW5mcmFdIEV4ZWN1dGluZyBTUUw6IElOU0VSVCBJTlRPIG9yZGVycyBWQUxVRVMgKDEwMSwgNzUwMDApOw0KW0ZpdG5lc3MgRnVuY3Rpb24gQ2hlY2tdIEFsbCBMYXllciBJbnZhcmlhbnRzIFZhbGlkYXRlZCBhdCBDb21waWxlLVRpbWUhDQpgYGANCg0KLS0tDQoNCiMjIyAzLjIuIFB5dGhvbiAzLjExKyBJbXBsZW1lbnRhdGlvbjogQVNUIEFyY2hpdGVjdHVyYWwgRml0bmVzcyBMaW50ZXIgJiBRQVMgRXZhbHVhdG9yDQpTY3JpcHQgUHl0aG9uIDMuMTErIGTGsOG7m2kgxJHDonkgdGjhu7FjIGhp4buHbiBoYWkgY2jhu6ljIG7Eg25nOg0KMS4gUGjDom4gdMOtY2ggQVNUIMSR4buDIHThu7EgxJHhu5luZyBxdcOpdCB0b8OgbiBi4buZIG3DoyBuZ3Xhu5NuIGPhu6dhIHThuqduZyBgZG9tYWluYCB2w6AgcGjDoXQgaGnhu4duIG7hur91IGPDsyBi4bqldCBr4buzIGTDsm5nIG7DoG8gYGltcG9ydGAgdHLDoWkgcGjDqXAgdOG7qyBgaW5mcmFzdHJ1Y3R1cmVgIChBdXRvbWF0ZWQgRml0bmVzcyBGdW5jdGlvbikuDQoyLiBI4buHIHRo4buRbmcga2nhu4NtIMSR4buLbmgga+G7i2NoIGLhuqNuIHRodeG7mWMgdMOtbmggY2jhuqV0IGzGsOG7o25nIChRQVMgRXZhbHVhdG9yKS4NCg0KYGBgcHl0aG9uDQpmcm9tIF9fZnV0dXJlX18gaW1wb3J0IGFubm90YXRpb25zDQppbXBvcnQgYXN0DQppbXBvcnQgdGltZQ0KZnJvbSB0eXBpbmcgaW1wb3J0IE5hbWVkVHVwbGUNCg0KIyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQojIDEuIEFSQ0hJVEVDVFVSQUwgRklUTkVTUyBGVU5DVElPTjogQVNUIExBWUVSIEJPVU5EQVJZIFNDQU5ORVINCiMgPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KY2xhc3MgQXJjaGl0ZWN0dXJhbERyaWZ0RXJyb3IoRXhjZXB0aW9uKToNCiAgICAiIiJC4bqvbiByYSBraGkgcGjDoXQgaGnhu4duIHZpIHBo4bqhbSByYW5oIGdp4bubaSBraeG6v24gdHLDumMgdHJvbmcgQ0kvQ0QuIiIiDQogICAgcGFzcw0KDQpjbGFzcyBMYXllckRlcGVuZGVuY3lMaW50ZXIoYXN0Lk5vZGVWaXNpdG9yKToNCiAgICBkZWYgX19pbml0X18oc2VsZiwgY3VycmVudF9tb2R1bGU6IHN0cik6DQogICAgICAgIHNlbGYuY3VycmVudF9tb2R1bGUgPSBjdXJyZW50X21vZHVsZQ0KICAgICAgICBzZWxmLnZpb2xhdGlvbnM6IGxpc3Rbc3RyXSA9IFtdDQoNCiAgICBkZWYgdmlzaXRfSW1wb3J0KHNlbGYsIG5vZGU6IGFzdC5JbXBvcnQpOg0KICAgICAgICBmb3IgYWxpYXMgaW4gbm9kZS5uYW1lczoNCiAgICAgICAgICAgIHNlbGYuX2NoZWNrX3Zpb2xhdGlvbihhbGlhcy5uYW1lLCBub2RlLmxpbmVubykNCiAgICAgICAgc2VsZi5nZW5lcmljX3Zpc2l0KG5vZGUpDQoNCiAgICBkZWYgdmlzaXRfSW1wb3J0RnJvbShzZWxmLCBub2RlOiBhc3QuSW1wb3J0RnJvbSk6DQogICAgICAgIGlmIG5vZGUubW9kdWxlOg0KICAgICAgICAgICAgc2VsZi5fY2hlY2tfdmlvbGF0aW9uKG5vZGUubW9kdWxlLCBub2RlLmxpbmVubykNCiAgICAgICAgc2VsZi5nZW5lcmljX3Zpc2l0KG5vZGUpDQoNCiAgICBkZWYgX2NoZWNrX3Zpb2xhdGlvbihzZWxmLCBpbXBvcnRlZF9tb2R1bGU6IHN0ciwgbGluZW5vOiBpbnQpOg0KICAgICAgICAjIFFVWSBU4bquQyBD4buQVCBMw5VJOiBU4bqnbmcgZG9tYWluIEPhuqRNIGltcG9ydCB04burIGluZnJhc3RydWN0dXJlIGhv4bq3YyBjb250cm9sbGVycw0KICAgICAgICBpZiAiZG9tYWluIiBpbiBzZWxmLmN1cnJlbnRfbW9kdWxlOg0KICAgICAgICAgICAgaWYgImluZnJhc3RydWN0dXJlIiBpbiBpbXBvcnRlZF9tb2R1bGUgb3IgImNvbnRyb2xsZXJzIiBpbiBpbXBvcnRlZF9tb2R1bGU6DQogICAgICAgICAgICAgICAgc2VsZi52aW9sYXRpb25zLmFwcGVuZCgNCiAgICAgICAgICAgICAgICAgICAgZiJMaW5lIHtsaW5lbm99OiBBcmNoaXRlY3R1cmFsIERyaWZ0ISAne3NlbGYuY3VycmVudF9tb2R1bGV9JyBpbXBvcnRzIGZvcmJpZGRlbiAne2ltcG9ydGVkX21vZHVsZX0nIg0KICAgICAgICAgICAgICAgICkNCg0KZGVmIHZlcmlmeV9jb2RlX2FyY2hpdGVjdHVyZShtb2R1bGVfbmFtZTogc3RyLCBzb3VyY2VfY29kZTogc3RyKToNCiAgICB0cmVlID0gYXN0LnBhcnNlKHNvdXJjZV9jb2RlKQ0KICAgIGxpbnRlciA9IExheWVyRGVwZW5kZW5jeUxpbnRlcihjdXJyZW50X21vZHVsZT1tb2R1bGVfbmFtZSkNCiAgICBsaW50ZXIudmlzaXQodHJlZSkNCiAgICBpZiBsaW50ZXIudmlvbGF0aW9uczoNCiAgICAgICAgcmFpc2UgQXJjaGl0ZWN0dXJhbERyaWZ0RXJyb3IoIlxuIi5qb2luKGxpbnRlci52aW9sYXRpb25zKSkNCg0KDQojID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0NCiMgMi4gUVVBTElUWSBBVFRSSUJVVEUgU0NFTkFSSU8gKFFBUykgVkVSSUZJRVINCiMgPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KY2xhc3MgUUFTY2VuYXJpbyhOYW1lZFR1cGxlKToNCiAgICBuYW1lOiBzdHINCiAgICB0YXJnZXRfbGF0ZW5jeV9wOTlfbXM6IGZsb2F0DQogICAgbWF4X2Vycm9yX3JhdGVfcGN0OiBmbG9hdA0KDQpkZWYgZXhlY3V0ZV9xYXNfYmVuY2htYXJrKHNjZW5hcmlvOiBRQVNjZW5hcmlvLCBzYW1wbGVzOiBsaXN0W2Zsb2F0XSwgZXJyb3JzOiBpbnQpIC0+IGJvb2w6DQogICAgcHJpbnQoZiJcbltFdmFsdWF0aW5nIFFBUzoge3NjZW5hcmlvLm5hbWV9XSIpDQogICAgc29ydGVkX3NhbXBsZXMgPSBzb3J0ZWQoc2FtcGxlcykNCiAgICBwOTlfaWR4ID0gaW50KGxlbihzb3J0ZWRfc2FtcGxlcykgKiAwLjk5KQ0KICAgIHA5OV9sYXRlbmN5ID0gc29ydGVkX3NhbXBsZXNbcDk5X2lkeF0NCiAgICBlcnJvcl9yYXRlID0gKGVycm9ycyAvIGxlbihzYW1wbGVzKSkgKiAxMDAuMA0KDQogICAgcHJpbnQoZiIgIC0+IE1lYXN1cmVkIHA5OSBMYXRlbmN5IDoge3A5OV9sYXRlbmN5Oi4yZn0gbXMgKFRhcmdldDogPCB7c2NlbmFyaW8udGFyZ2V0X2xhdGVuY3lfcDk5X21zfSBtcykiKQ0KICAgIHByaW50KGYiICAtPiBNZWFzdXJlZCBFcnJvciBSYXRlICA6IHtlcnJvcl9yYXRlOi40Zn0gJSAoVGFyZ2V0OiA8IHtzY2VuYXJpby5tYXhfZXJyb3JfcmF0ZV9wY3R9ICUpIikNCg0KICAgIHBhc3NlZCA9IChwOTlfbGF0ZW5jeSA8PSBzY2VuYXJpby50YXJnZXRfbGF0ZW5jeV9wOTlfbXMpIGFuZCAoZXJyb3JfcmF0ZSA8PSBzY2VuYXJpby5tYXhfZXJyb3JfcmF0ZV9wY3QpDQogICAgaWYgcGFzc2VkOg0KICAgICAgICBwcmludCgiICDinIUgUUFTIFZlcmlmaWNhdGlvbjogUEFTU0VEIikNCiAgICBlbHNlOg0KICAgICAgICBwcmludCgiICDinYwgUUFTIFZlcmlmaWNhdGlvbjogRkFJTEVEIChRdWFsaXR5IEF0dHJpYnV0ZSBCcmVhY2gpIikNCiAgICByZXR1cm4gcGFzc2VkDQoNCg0KaWYgX19uYW1lX18gPT0gIl9fbWFpbl9fIjoNCiAgICBwcmludCgiPT09IFB5dGhvbiAzLjExKyBBcmNoaXRlY3R1cmFsIEdvdmVybmFuY2UgJiBGaXRuZXNzIEVuZ2luZSA9PT0iKQ0KDQogICAgIyBUZXN0IDE6IE3DoyBuZ3Xhu5NuIERvbWFpbiBo4bujcCBs4buHDQogICAgY2xlYW5fZG9tYWluX2NvZGUgPSAiIiINCmNsYXNzIE9yZGVyU2VydmljZToNCiAgICBkZWYgX19pbml0X18oc2VsZiwgb3JkZXJfcmVwb19pbnRlcmZhY2UpOg0KICAgICAgICBzZWxmLnJlcG8gPSBvcmRlcl9yZXBvX2ludGVyZmFjZQ0KICAgIGRlZiBjYWxjdWxhdGVfdG90YWwoc2VsZiwgaXRlbXMpOg0KICAgICAgICByZXR1cm4gc3VtKGl0ZW0ucHJpY2UgZm9yIGl0ZW0gaW4gaXRlbXMpDQoiIiINCiAgICB2ZXJpZnlfY29kZV9hcmNoaXRlY3R1cmUoImFwcC5kb21haW4ub3JkZXJfc2VydmljZSIsIGNsZWFuX2RvbWFpbl9jb2RlKQ0KICAgIHByaW50KCJcbltGaXRuZXNzIFRlc3QgMV0gQ2xlYW4gRG9tYWluIENvZGUgcGFzc2VkIGFyY2hpdGVjdHVyYWwgdmFsaWRhdGlvbiEiKQ0KDQogICAgIyBUZXN0IDI6IE3DoyBuZ3Xhu5NuIERvbWFpbiBi4buLIMO0IG5oaeG7hW0gYuG7n2kgSW5mcmFzdHJ1Y3R1cmUgKEFyY2hpdGVjdHVyYWwgRHJpZnQpDQogICAgY29ycnVwdGVkX2RvbWFpbl9jb2RlID0gIiIiDQppbXBvcnQgYXBwLmluZnJhc3RydWN0dXJlLmRhdGFiYXNlLm15c3FsX2RyaXZlciBhcyBkYl9kcml2ZXINCg0KY2xhc3MgT3JkZXJTZXJ2aWNlOg0KICAgIGRlZiBzYXZlX29yZGVyKHNlbGYsIG9yZGVyKToNCiAgICAgICAgZGJfZHJpdmVyLnJhd19leGVjdXRlKGYiSU5TRVJUIElOVE8gb3JkZXJzIFZBTFVFUyAoe29yZGVyLmlkfSkiKQ0KIiIiDQogICAgdHJ5Og0KICAgICAgICB2ZXJpZnlfY29kZV9hcmNoaXRlY3R1cmUoImFwcC5kb21haW4ub3JkZXJfc2VydmljZSIsIGNvcnJ1cHRlZF9kb21haW5fY29kZSkNCiAgICBleGNlcHQgQXJjaGl0ZWN0dXJhbERyaWZ0RXJyb3IgYXMgZXg6DQogICAgICAgIHByaW50KGYiXG5bRml0bmVzcyBUZXN0IDJdIEludGVyY2VwdGVkIEFyY2hpdGVjdHVyZSBWaW9sYXRpb24gU3VjY2Vzc2Z1bGx5OlxuICAtPiB7ZXh9IikNCg0KICAgICMgVGVzdCAzOiDEkMOhbmggZ2nDoSBRdWFsaXR5IEF0dHJpYnV0ZSBTY2VuYXJpbw0KICAgIGZsYXNoX3NhbGVfcWFzID0gUUFTY2VuYXJpbygNCiAgICAgICAgbmFtZT0iRmxhc2ggU2FsZSBDaGVja291dCBMYXRlbmN5IiwNCiAgICAgICAgdGFyZ2V0X2xhdGVuY3lfcDk5X21zPTUwLjAsDQogICAgICAgIG1heF9lcnJvcl9yYXRlX3BjdD0wLjAxDQogICAgKQ0KICAgICMgR2nhuqMgbOG6rXAgMTAwMCBt4bqrdSDEkeG7mSB0cuG7hSAobXMpDQogICAgbW9ja19sYXRlbmNpZXMgPSBbMTUuMCArIChpICUgMzApIGZvciBpIGluIHJhbmdlKDEwMDApXQ0KICAgIG1vY2tfbGF0ZW5jaWVzWy0xXSA9IDQ4LjUgIyBNYXggcDk5DQogICAgZXhlY3V0ZV9xYXNfYmVuY2htYXJrKGZsYXNoX3NhbGVfcWFzLCBtb2NrX2xhdGVuY2llcywgZXJyb3JzPTApDQpgYGANCg0KIyMjIyBUZXJtaW5hbCBPdXRwdXQgTeG6q3UgKFB5dGhvbiAzLjExKyk6DQpgYGB0ZXh0DQo9PT0gUHl0aG9uIDMuMTErIEFyY2hpdGVjdHVyYWwgR292ZXJuYW5jZSAmIEZpdG5lc3MgRW5naW5lID09PQ0KDQpbRml0bmVzcyBUZXN0IDFdIENsZWFuIERvbWFpbiBDb2RlIHBhc3NlZCBhcmNoaXRlY3R1cmFsIHZhbGlkYXRpb24hDQoNCltGaXRuZXNzIFRlc3QgMl0gSW50ZXJjZXB0ZWQgQXJjaGl0ZWN0dXJlIFZpb2xhdGlvbiBTdWNjZXNzZnVsbHk6DQogIC0+IExpbmUgMjogQXJjaGl0ZWN0dXJhbCBEcmlmdCEgJ2FwcC5kb21haW4ub3JkZXJfc2VydmljZScgaW1wb3J0cyBmb3JiaWRkZW4gJ2FwcC5pbmZyYXN0cnVjdHVyZS5kYXRhYmFzZS5teXNxbF9kcml2ZXInDQoNCltFdmFsdWF0aW5nIFFBUzogRmxhc2ggU2FsZSBDaGVja291dCBMYXRlbmN5XQ0KICAtPiBNZWFzdXJlZCBwOTkgTGF0ZW5jeSA6IDQ0LjAwIG1zIChUYXJnZXQ6IDwgNTAuMCBtcykNCiAgLT4gTWVhc3VyZWQgRXJyb3IgUmF0ZSAgOiAwLjAwMDAgJSAoVGFyZ2V0OiA8IDAuMDEgJSkNCiAg4pyFIFFBUyBWZXJpZmljYXRpb246IFBBU1NFRA0KYGBgDQoNCi0tLQ0KDQojIyA0LiBTeXN0ZW1zIEVuZ2luZWVyaW5nICYgUHJvZHVjdGlvbiBQaXRmYWxscw0KDQojIyMgQ8OhYyBD4bqhbSBC4bqreSBUaOG7sWMgQ2hp4bq/biAoR290Y2hhcyAmIFByb2R1Y3Rpb24gQW50aXBhdHRlcm5zKQ0KDQoxLiAqKkjhu5lpIENo4bupbmcgUGhpIEjDoG5oIEdpYSBLaeG6v24gVHLDumMgKEFyY2hpdGVjdHVyZSBBc3Ryb25hdXQgU3luZHJvbWUpKio6DQogICAtICpC4bqjbiBjaOG6pXQqOiBLaeG6v24gdHLDumMgc8awIHRoaeG6v3Qga+G6vyBjw6FjIGjhu4cgdGjhu5FuZyB0cuG7q3UgdMaw4bujbmcgcXXDoSBt4bupYyAoT3Zlci1lbmdpbmVlcmluZyksIMOhcCBk4bulbmcgTWljcm9zZXJ2aWNlcywgS3ViZXJuZXRlcywgRXZlbnQgU291cmNpbmcsIGdSUEMgY2hvIG3hu5l0IOG7qW5nIGThu6VuZyBDUlVEIG7hu5lpIGLhu5kgY8O0bmcgdHkgY2jhu4kgY8OzIDUwIG5nxrDhu51pIGTDuW5nLiBDaGkgcGjDrSBi4bqjbyB0csOsIGjhuqEgdOG6p25nIG514buRdCBjaOG7rW5nIHRvw6BuIGLhu5kgbmfDom4gc8OhY2ggZOG7sSDDoW4uDQogICAtICpLaOG6r2MgcGjhu6VjKjogQuG6r3QgxJHhuqd1IHbhu5tpICoqTW9kdWxhciBNb25vbGl0aCoqIGhv4bq3YyBXYWxraW5nIFNrZWxldG9uIMSRxqFuIGdp4bqjbiBuaOG6pXQ7IGNo4buJIHBow6JuIHLDoyBraeG6v24gdHLDumMga2hpIHh14bqldCBoaeG7h24gw6FwIGzhu7FjIMSRbyBsxrDhu51uZyDEkcaw4bujYyB04burIGPDoWMgQXJjaGl0ZWN0dXJhbCBEcml2ZXJzLg0KDQoyLiAqKkLhu48gUXVhIMSQaeG7g20gxJDDoW5oIMSQ4buVaSAoSWdub3JlZCBUcmFkZS1vZmZzIGluIEFUQU0pKio6DQogICAtICpC4bqjbiBjaOG6pXQqOiDEkOG7mWkgbmfFqSBjaOG7jW4gTWljcm9zZXJ2aWNlcyB2w6wgbXXhu5FuICJTY2FsYWJpbGl0eSIsIG5oxrBuZyBi4buPIHF1YSBob8OgbiB0b8OgbiBjaGkgcGjDrSBwaMOhdCBzaW5oOiBOZXR3b3JrIExhdGVuY3kgdMSDbmcgZ+G6pXAgNSBs4bqnbiwgbeG6pXQgdMOtbmggdG/DoG4gduG6uW4gZ2lhbyBk4buLY2ggQUNJRCwgdsOgIGLDoGkgdG/DoW4gRGlzdHJpYnV0ZWQgVHJhY2luZyBj4buxYyBr4buzIHBo4bupYyB04bqhcC4NCiAgIC0gKkto4bqvYyBwaOG7pWMqOiBN4buNaSBxdXnhur90IMSR4buLbmgga2nhur9uIHRyw7pjIHBo4bqjaSBnaGkgcsO1IHRyb25nIEFEUjogIkNow7puZyB0YSBjaOG7jW4gZ2nhuqNpIHBow6FwIG7DoHkgdGjDrCBjaMO6bmcgdGEgY2jhuqVwIG5o4bqtbiDEkcOhbmggbeG6pXQgxJFp4buBdSBnw6w/Ii4NCg0KMy4gKipM4buXIEjhu5VuZyBOKzEgVHJ1eSBW4bqlbiDEkOG7mWkgTOG7kXQgS2nhur9uIFRyw7pjIMSQ4bq5cCoqOg0KICAgLSAqQuG6o24gY2jhuqV0Kjogw4FwIGThu6VuZyBwaMOibiB04bqnbmcgbmdoacOqbSBuZ+G6t3QgKFJlcG9zaXRvcnkgJFx0byQgU2VydmljZSAkXHRvJCBDb250cm9sbGVyKSwgbmjGsG5nIGRvIMSRw7NuZyBnw7NpIHF1w6Ega+G7uSwgU2VydmljZSBn4buNaSBgcmVwb3NpdG9yeS5maW5kQnlJZChpZClgIHRyb25nIG3hu5l0IHbDsm5nIGzhurdwIGBmb3JgIDEwMDAgbOG6p24gdGhheSB2w6wgdmnhur90IG3hu5l0IHRydXkgduG6pW4gYGJhdGNoYC4gS2nhur9uIHRyw7pjIGhvw6BuIHRvw6BuIHPhuqFjaCB0csOqbiBnaeG6pXkgbmjGsG5nIHPhuq1wIGRhdGFiYXNlIHRyw6puIFByb2R1Y3Rpb24uDQogICAtICpLaOG6r2MgcGjhu6VjKjogQuG7lSBzdW5nIEZpdG5lc3MgRnVuY3Rpb24ga2nhu4NtIHRyYSBz4buRIGzGsOG7o25nIHRydXkgduG6pW4gU1FMIHNpbmggcmEgdHLDqm4gbeG7l2kgSFRUUCBSZXF1ZXN0IChRdWVyeSBCdWRnZXQgcGVyIFJlcXVlc3QpLg0KDQo0LiAqKkvhu7kgVGh14bqtdCBDaOG6qW4gxJBvw6FuICYgR2nDoW0gU8OhdCBLaeG6v24gVHLDumMgQuG6sW5nIENMSSoqOg0KICAgYGBgYmFzaA0KICAgIyAxLiBQaMOhdCBoaeG7h24gQ2lyY3VsYXIgRGVwZW5kZW5jaWVzIHRyb25nIG3DoyBuZ3Xhu5NuIEdvL1R5cGVTY3JpcHQvQysrDQogICBtYWRnZSAtLWNpcmN1bGFyIHNyYy8NCg0KICAgIyAyLiBQaMOibiB0w61jaCDEkeG7kyB0aOG7iyBwaOG7pSB0aHXhu5ljIGdp4buvYSBjw6FjIHBhY2thZ2UgYuG6sW5nIEdyYXBodml6DQogICBnbyBtb2QgZ3JhcGggfCBtb2RncmFwaHZpeiB8IGRvdCAtVHBuZyAtbyBkZXBlbmRlbmNpZXMucG5nDQoNCiAgICMgMy4gQ2jhuqF5IEFyY2hVbml0IGtp4buDbSDEkeG7i25oIHF1eSB04bqvYyBraeG6v24gdHLDumMgSmF2YS9Lb3RsaW4gdHLDqm4gQ0kNCiAgIC4vZ3JhZGxldyB0ZXN0IC0tdGVzdHMgIipBcmNoaXRlY3R1cmVGaXRuZXNzVGVzdCoiDQogICBgYGANCg0KLS0tDQoNCiMjIDUuIELhuqNuZyBTbyBzw6FuaCAmIERlY2lzaW9uIE1hdHJpeA0KDQojIyMgNS4xLiBTbyBTw6FuaCBDw6FjIFBoxrDGoW5nIFBow6FwIMSQw6FuaCBHacOhIEtp4bq/biBUcsO6YyAoQXJjaGl0ZWN0dXJlIEV2YWx1YXRpb24gRnJhbWV3b3JrcykNCg0KfCBQaMawxqFuZyBQaMOhcCB8IFh14bqldCBY4bupIC8gVOG7lSBDaOG7qWMgfCBN4bulYyBUacOqdSBUcuG7jW5nIFTDom0gfCBUaOG7nWkgxJBp4buDbSBUaOG7sWMgSGnhu4duIHwgQ2hpIFBow60gTmjDom4gTOG7sWMgfA0KfCA6LS0tIHwgOi0tLSB8IDotLS0gfCA6LS0tIHwgOi0tLSB8DQp8ICoqQVRBTSoqIHwgU0VJIChDYXJuZWdpZSBNZWxsb24pIHwgxJDDoW5oIGdpw6EgVHJhZGUtb2ZmcyBnaeG7r2EgY8OhYyB0aHXhu5ljIHTDrW5oIGNo4bqldCBsxrDhu6NuZyAoTkZSKSB8IFRyxrDhu5tjIGtoaSBjb2RlIGNow61uaCB0aOG7qWMgfCBUcnVuZyBiw6xuaCAoMS0yIHR14bqnbiB3b3Jrc2hvcCkgfA0KfCAqKlNBQU0qKiB8IFNFSSAoU29mdHdhcmUgQXJjaGl0ZWN0dXJlIEFuYWx5c2lzKSB8IMSQw6FuaCBnacOhIGto4bqjIG7Eg25nIHPhu61hIMSR4buVaSAoTW9kaWZpYWJpbGl0eSkgdsOgIGNo4bupYyBuxINuZyB8IEdpYWkgxJFv4bqhbiB0aGnhur90IGvhur8gc8ahIGLhu5kgfCBUaOG6pXAgKFbDoGkgbmfDoHkpIHwNCnwgKipDQkFNKiogfCBTRUkgKENvc3QtQmVuZWZpdCBBbmFseXNpcykgfCBU4buRaSDGsHUgaMOzYSBs4bujaSDDrWNoIGtpbmggdOG6vyAoUk9JKSB0aGVvIGNoaSBwaMOtIGtp4bq/biB0csO6YyB8IEtoaSBxdXnhur90IMSR4buLbmggbsOibmcgY+G6pXAgaOG7hyB0aOG7kW5nIHwgQ2FvIChD4bqnbiBk4buvIGxp4buHdSB0w6BpIGNow61uaCkgfA0KfCAqKkZpdG5lc3MgRnVuY3Rpb25zKiogfCBUaG91Z2h0V29ya3MgLyBOZWFsIEZvcmQgfCDEkG8gbMaw4budbmcgbGnDqm4gdOG7pWMsIG5nxINuIG5n4burYSBBcmNoaXRlY3R1cmFsIERyaWZ0IHRyb25nIENJIHwgTGnDqm4gdOG7pWMgMjQvNyBzYXUgbeG7l2kgR2l0IENvbW1pdCB8IFLhuqV0IHRo4bqlcCAoVOG7sSDEkeG7mW5nIGjDs2EgaG/DoG4gdG/DoG4pIHwNCg0KIyMjIDUuMi4gTWEgVHLhuq1uIENoaeG6v24gTMaw4bujYyBUaGnhur90IEvhur86IEJEVUYgdnMgRXZvbHV0aW9uYXJ5IEFyY2hpdGVjdHVyZQ0KDQp8IFRpw6p1IENow60gfCBCaWcgRGVzaWduIFVwIEZyb250IChCRFVGKSB8IEV2b2x1dGlvbmFyeSBBcmNoaXRlY3R1cmUgKFRp4bq/biBIw7NhKSB8DQp8IDotLS0gfCA6LS0tIHwgOi0tLSB8DQp8ICoqR2nhuqMgxJHhu4tuaCBD4buRdCBsw7VpKiogfCBN4buNaSB5w6p1IGPhuqd1IGPDsyB0aOG7gyBk4buxIMSRb8OhbiBjaMOtbmggeMOhYyBuZ2F5IHThu6sgxJHhuqd1IHwgWcOqdSBj4bqndSB2w6AgY8O0bmcgbmdo4buHIGxpw6puIHThu6VjIHRoYXkgxJHhu5VpIHRoZW8gdGjhu51pIGdpYW4gfA0KfCAqKlThu5FjIMSR4buZIFJhIE3huq90IChUaW1lLXRvLU1hcmtldCkqKiB8IFLhuqV0IGNo4bqtbSAoVOG7kW4gaMOgbmcgdGjDoW5nIHZp4bq/dCB0w6BpIGxp4buHdSB0aGnhur90IGvhur8pIHwgUuG6pXQgbmhhbmggKEThu7FhIHRyw6puIFdhbGtpbmcgU2tlbGV0b24gdsOgIFNwaWtlcykgfA0KfCAqKkto4bqjIG7Eg25nIFBo4bqjbiBo4buTaSBUaGF5IMSR4buVaSoqIHwgUuG6pXQga8OpbTsgY2hpIHBow60gc+G7rWEgxJHhu5VpIGLhuqNuIHbhur0gY+G7sWMgY2FvIHwgQ+G7sWMgY2FvOyDEkcaw4bujYyBi4bqjbyB24buHIGLhu59pIEF1dG9tYXRlZCBGaXRuZXNzIEZ1bmN0aW9ucyB8DQp8ICoqQuG6o28gduG7hyBUw61uaCBUb8OgbiBW4bq5bioqIHwgROG7sWEgdsOgbyBr4bu3IGx14bqtdCBjw6EgbmjDom4gY+G7p2Ega+G7uSBzxrAgKEThu4UgYuG7iyBEcmlmdCkgfCBE4buxYSB2w6BvIGtp4buDbSB0aOG7rSB04buxIMSR4buZbmcgdHJvbmcgQ0kvQ0QgUGlwZWxpbmVzIHwNCnwgKipNw7RpIHRyxrDhu51uZyDDgXAgZOG7pW5nKiogfCBQaOG6p24gbeG7gW0gxJFp4buBdSBraGnhu4NuIHBoaSB0aHV54buBbiwgdGhp4bq/dCBi4buLIHkgdOG6vyBo4bqhdCBuaMOibiB8IDk5JSBjw6FjIGjhu4cgdGjhu5FuZyBXZWIsIENsb3VkLCBTYWFTLCBGaW5UZWNoIGhp4buHbiDEkeG6oWkgfA0K