Chế độ giao diện
4.8. Tài Liệu Hóa và Thẩm Định Kiến Trúc (Architecture Documentation & Review)
IMPORTANT
Nếu bạn chỉ được nhớ một điều duy nhất: Bản vẽ kiến trúc chỉ có giá trị khi nó phản ánh sự thật đang chạy trên Production; tài liệu kiến trúc hiện đại tuân theo triết lý Docs-as-Code và C4 Model để có thể kiểm thử tự động, lưu trữ cùng mã nguồn trong Git và bảo vệ các quyết định kỹ thuật thông qua Architecture Decision Records (ADR).
1. Kiến trúc Tổng quan & Mô hình Tư duy (Mental Model)
Ẩn dụ Đời sống: Google Maps Đa Tầng và Nhật Ký Công Trình Của Kỹ Sư Trưởng
Hãy hình dung việc lập tài liệu kiến trúc tương tự như cách chúng ta quan sát thế giới qua ứng dụng Google Maps:
- C4 Level 1: System Context (Bản đồ Trái Đất / Vệ tinh): Nhìn từ quỹ đạo vũ trụ, bạn chỉ thấy biên giới các lục địa, đại dương và vị trí các quốc gia (Hệ thống của bạn tương tác với Ngân hàng, Khách hàng, Cổng SMS). Bạn không nhìn thấy ô tô hay nhà cửa.
- C4 Level 2: Container Diagram (Bản đồ Thành phố / Giao thông): Phóng to vào một thành phố, bạn thấy các khu đô thị, sân bay, bến xe, đường cao tốc nối các quận (Web SPA, API Gateway, Microservices, PostgreSQL, Kafka và giao thức kết nối HTTP/gRPC).
- C4 Level 3: Component Diagram (Bản vẽ Mặt bằng Khu nhà): Phóng to vào một tòa chung cư, bạn thấy các phòng chức năng, cầu thang, hành lang (Controllers, Use Cases, Repositories bên trong một Microservice).
- C4 Level 4: Code Diagram (Bản vẽ Mạch điện / Ống nước chi tiết): Phóng to vào chân ổ cắm điện hoặc chi tiết cấu trúc ren của van nước (UML Class Diagram của một thuật toán phức tạp).
- Architecture Decision Record - ADR (Nhật ký Công trình): Khi kỹ sư trưởng quyết định dùng móng cọc bê tông dự ứng lực thay vì móng băng vì địa chất có túi bùn, quyết định này được ký tên và đóng dấu vào sổ nhật ký công trình. Mười năm sau, dù kỹ sư trưởng đã nghỉ hưu, người tiếp quản vẫn biết chính xác lý do tại sao không được phép đào sâu thêm mà không cần đoán mò.
flowchart TD
subgraph C4Hierarchy["C4 Model: Khung Trực Quan Hóa Đa Tầng (Simon Brown)"]
L1["Level 1: System Context Diagram<br/>(Ai dùng hệ thống? Tích hợp bên ngoài nào?)"]
L2["Level 2: Container Diagram<br/>(Ứng dụng, Database, Broker, Giao thức kết nối)"]
L3["Level 3: Component Diagram<br/>(Controllers, Services, Repositories trong 1 Container)"]
L4["Level 4: Code Diagram<br/>(UML Class Diagrams, Entities - Thường tự sinh)"]
L1 -->|Zoom In| L2
L2 -->|Zoom In| L3
L3 -->|Zoom In| L4
end
subgraph GovernanceDocs["Quản Trị & Hồ Sơ Quyết Định (Docs-as-Code)"]
ADR["Architecture Decision Records (ADR)<br/>Context • Decision • Consequences (Trade-offs)"]
QAW["Quality Attribute Workshop (QAW)<br/>Thẩm định kịch bản NFR trước khi thiết kế"]
FF["Automated Fitness Functions<br/>ArchUnit / Linter ngăn chặn Architectural Drift"]
end
C4Hierarchy <-->|Đồng bộ & Bổ trợ| GovernanceDocs
2. Chi tiết từng Keyword (Under-the-Hood Deep Dive)
2.1. Mô Hình C4 Trực Quan Hóa Kiến Trúc Phần Mềm (Simon Brown: 4 Cấp Độ)
Được phát minh bởi Simon Brown, C4 Model giải quyết căn bệnh muôn thuở của sơ đồ kiến trúc: Các hình hộp và mũi tên vô nghĩa không có ngữ cảnh rõ ràng. C4 phân cấp thành 4 mức trừu tượng:
flowchart LR
subgraph Level1["1. System Context (Macro View)"]
User([Customer / User]) -->|HTTPS| Sys[Core Banking Platform System]
Sys -->|ISO 8583| Visa[External: Visa Payment Network]
end
subgraph Level2["2. Containers (Deployable Units)"]
SPA[React Web SPA] -->|HTTPS/JSON| GW[Envoy API Gateway]
GW -->|gRPC| CoreSvc[Account Core Service: Go / C++]
CoreSvc --> DB[(PostgreSQL Database)]
end
- Level 1: System Context Diagram (Bối cảnh Hệ thống):
- Dành cho: Ban giám đốc, Product Managers, và mọi đối tượng kỹ thuật lẫn phi kỹ thuật.
- Thể hiện: Hệ thống phần mềm của bạn nằm ở đâu trong bức tranh toàn cảnh; ai là người dùng tương tác trực tiếp; hệ thống phụ thuộc vào những đối tác bên ngoài nào.
- Nguyên tắc: Không hiển thị bất kỳ chi tiết công nghệ, framework, hay cơ sở dữ liệu nào.
- Level 2: Container Diagram (Các Khối Triển Khai):
- Dành cho: Kỹ sư phần mềm, Kiến trúc sư, DevOps/SRE.
- Định nghĩa "Container": Bất kỳ đơn vị phần mềm nào có thể chạy và triển khai độc lập (Web SPA, Mobile App, Microservice, Database, Message Queue, Cron Job).
- Thể hiện: Trách nhiệm của từng Container, công nghệ sử dụng (Go, React, PostgreSQL) và giao thức mạng truyền thông (gRPC over HTTP/2, TLS 1.3).
- Level 3: Component Diagram (Các Thành Phần Bên Trong Container):
- Dành cho: Các kỹ sư trực tiếp lập trình trên Container đó.
- Thể hiện: Cấu trúc bên trong của một Container được chia thành các Components nào (theo Clean Architecture: Controllers, Use Cases, Repositories) và cách chúng liên kết qua Interfaces.
- Level 4: Code Diagram (Mức Mã Nguồn):
- Dành cho: Lập trình viên chuyên sâu.
- Thể hiện: Các sơ đồ lớp (UML Class Diagrams), State Machines hoặc Entity Relationship. Thường chỉ nên vẽ cho các thuật toán rất phức tạp; không nên vẽ cho toàn bộ code vì sẽ nhanh chóng bị lỗi thời.
2.2. Mô Hình Góc Nhìn 4+1 (Philippe Kruchten Architectural View Model)
Được chuẩn hóa trong tài liệu IEEE 1471, mô hình 4+1 của Philippe Kruchten cung cấp 5 góc nhìn đa chiều để thỏa mãn nhu cầu thông tin của các nhóm bên liên quan khác nhau:
flowchart TD
subgraph Kruchten["Mô Hình 4+1 Kiến Trúc (Philippe Kruchten)"]
Scenarios["+1: Use Case / Scenarios View<br/>(Tâm điểm kiểm chứng kịch bản người dùng)"]
Logical["1. Logical View<br/>(Classes, Objects, Domain Models)"]
Dev["2. Development View<br/>(Packages, Modules, Repositories)"]
Process["3. Process View<br/>(Threads, Concurrency, Latency, Scale)"]
Physical["4. Physical / Deployment View<br/>(Hardware, VMs, K8s Pods, Networks)"]
Scenarios -.->|Kiểm chứng & Liên kết| Logical
Scenarios -.->|Kiểm chứng & Liên kết| Dev
Scenarios -.->|Kiểm chứng & Liên kết| Process
Scenarios -.->|Kiểm chứng & Liên kết| Physical
end
- Logical View (Góc Nhìn Logic): Phục vụ End-Users và Architects. Mô tả cấu trúc các khái niệm nghiệp vụ, thực thể Domain, và các mối quan hệ trừu tượng.
- Development View (Góc Nhìn Phát Triển): Phục vụ Lập trình viên và Quản lý Cấu hình. Mô tả cấu trúc phân chia mã nguồn trong Git, quản lý thư viện phụ thuộc (Maven, Cargo, Go Modules) và quy trình biên dịch.
- Process View (Góc Nhìn Tiến Trình): Phục vụ Tích hợp Hệ thống. Mô tả các luồng thực thi (Threads), tiến trình (Processes), đồng bộ hóa, độ trễ mạng và hiệu năng khi hệ thống chạy ở runtime.
- Physical / Deployment View (Góc Nhìn Vật Lý): Phục vụ DevOps và SRE. Mô tả cách phần mềm được ánh xạ lên máy chủ vật lý, máy ảo, container Kubernetes, cấu hình tường lửa và cân bằng tải.
- +1: Use Case / Scenarios View (Góc Nhìn Kịch Bản Cốt Lõi): Tâm điểm liên kết toàn bộ 4 góc nhìn trên. Mỗi kịch bản nghiệp vụ đóng vai trò sợi chỉ đỏ xuyên suốt để kiểm chứng xem 4 góc nhìn kia có phối hợp nhịp nhàng với nhau không.
2.3. Architecture Decision Records (ADR) và Triết Lý Docs-as-Code
1. Triết Lý Docs-as-Code
- Tài liệu kiến trúc được đối xử bình đẳng như mã nguồn:
- Viết bằng văn bản thuần túy (Markdown / AsciiDoc) thay vì Word hay PDF.
- Lưu trữ trực tiếp trong cùng Git Repository của dự án (
docs/adr/). - Được review thông qua Pull Request (PR) có sự phê duyệt của Tech Leads.
- Được kiểm thử cú pháp và liên kết tự động bằng CI/CD Pipelines.
2. Cấu Trúc Chuẩn Của Một Bản ADR (Michael Nygard Standard)
Một tài liệu ADR hoàn chỉnh bắt buộc phải có 5 phần ngắn gọn:
- Title: Số thứ tự và quyết định (ví dụ:
ADR-012: Sử dụng gRPC thay thế REST cho giao tiếp nội bộ). - Status: Trạng thái hiện tại:
PROPOSED(Đang đề xuất),ACCEPTED(Đã duyệt),REJECTED(Bị bác bỏ), hoặcSUPERSEDED(Bị thay thế bởi ADR mới hơn). - Context (Bối cảnh): Trình bày bài toán kỹ thuật, các ràng buộc và lý do tại sao quyết định này cần được đưa ra.
- Decision (Quyết định): Giải pháp kỹ thuật được chọn lựa để áp dụng.
- Consequences (Hệ quả & Đánh đổi): Phân tích khách quan: Quyết định này mang lại lợi ích gì (Pros) và chúng ta chấp nhận đánh mất điều gì (Cons / Trade-offs).
2.4. Quality Attribute Workshop (QAW) và Đánh Giá Kiến Trúc Định Kỳ
- QAW (SEI): Một buổi hội thảo tạo điều kiện (Facilitated Workshop) diễn ra trong 1 ngày giữa các Kiến trúc sư, Lập trình viên, Product Owners và các bên liên quan để tìm ra các kịch bản thuộc tính chất lượng (QAS) quan trọng nhất trước khi bắt đầu thiết kế.
- Architecture Review Meetings:
- Diễn ra định kỳ (hàng tuần hoặc trước mỗi quý).
- Mục tiêu: Rà soát các ADR mới được đề xuất, kiểm tra xem có service nào bị "suy thoái kiến trúc" không, và đưa ra quyết định nâng cấp hạ tầng.
2.5. Automated Fitness Functions: Biến Tài Liệu Thành Mã Kiểm Thử Sống
- Vấn đề lớn nhất của tài liệu bằng lời nói là: Tài liệu nói một đằng, code chạy một nẻo.
- Giải pháp: Hiện thực hóa các quy tắc kiến trúc thành các bài kiểm thử tự động (Automated Fitness Functions) chạy trực tiếp trong CI/CD bằng các công cụ như ArchUnit, Deptrac hoặc Custom Linters:
- "Tầng Domain không được phép import bất kỳ package nào từ Infrastructure".
- "Không có circular dependency giữa các modules".
- "Thời gian đáp ứng của API thanh toán phải dưới 50ms".
2.6. Quản Trị Kiến Trúc Doanh Nghiệp (Architecture Governance & Anti-Erosion)
- Architectural Erosion / Drift: Hiện tượng mã nguồn theo thời gian bị xói mòn do áp lực tiến độ (Deadlines), các kỹ sư mới tạo đường tắt (Shortcuts) phá vỡ ranh giới kiến trúc.
- Biện pháp ngăn chặn:
- Thiết lập Quality Gates tự động từ chối merge PR nếu vi phạm ranh giới.
- Bổ nhiệm Architecture Champions trong từng đội nhóm để giám sát và hướng dẫn.
- Dành riêng
ngân sách kỹ thuật trong mỗi Sprint để trả nợ kỹ thuật kiến trúc.
3. Thực thi Mã nguồn & Mô phỏng Chuyên sâu (Dual-Engine Implementation)
3.1. C++20 Implementation: Automated Architecture Compliance & Fitness Checker
Chương trình C++20 dưới đây mô phỏng một công cụ kiểm định quy tắc kiến trúc (Architecture Compliance Checker) chạy trong chu trình kiểm thử tự động, quét ma trận phụ thuộc giữa các module và cảnh báo nếu có vi phạm Architectural Drift.
cpp
#include <iostream>
#include <vector>
#include <string>
#include <unordered_map>
#include <unordered_set>
#include <stdexcept>
#include <iomanip>
// ============================================================================
// ARCHITECTURAL LAYER DEFINITIONS & RULES ENGINE
// ============================================================================
enum class Layer { PRESENTATION, APPLICATION, DOMAIN, INFRASTRUCTURE };
std::string layerToString(Layer l) {
switch (l) {
case Layer::PRESENTATION: return "Presentation";
case Layer::APPLICATION: return "Application";
case Layer::DOMAIN: return "Domain";
case Layer::INFRASTRUCTURE: return "Infrastructure";
}
return "Unknown";
}
struct DependencyRule {
Layer source;
Layer target;
bool isAllowed;
std::string ruleDescription;
};
class ArchitectureFitnessEngine {
private:
std::vector<DependencyRule> rules_;
std::unordered_map<std::string, Layer> moduleLayerRegistry_;
std::vector<std::pair<std::string, std::string>> declaredDependencies_;
public:
void registerModule(const std::string& moduleName, Layer layer) {
moduleLayerRegistry_[moduleName] = layer;
}
void addRule(Layer src, Layer dst, bool allowed, const std::string& desc) {
rules_.push_back({src, dst, allowed, desc});
}
void recordDependency(const std::string& fromModule, const std::string& toModule) {
declaredDependencies_.emplace_back(fromModule, toModule);
}
bool evaluateCompliance() {
std::cout << "[Architecture Fitness Evaluation Started]\n";
bool allPassed = true;
for (const auto& [from, to] : declaredDependencies_) {
Layer srcLayer = moduleLayerRegistry_.at(from);
Layer dstLayer = moduleLayerRegistry_.at(to);
// Kiểm tra các quy tắc bị cấm
for (const auto& rule : rules_) {
if (rule.source == srcLayer && rule.target == dstLayer && !rule.isAllowed) {
std::cout << " ❌ ARCHITECTURAL DRIFT DETECTED: "
<< "Module '" << from << "' (" << layerToString(srcLayer) << ") "
<< "depends on '" << to << "' (" << layerToString(dstLayer) << ")!\n"
<< " Rule Violated: " << rule.ruleDescription << "\n";
allPassed = false;
}
}
}
if (allPassed) {
std::cout << " ✅ ALL ARCHITECTURAL FITNESS FUNCTIONS PASSED! Zero drift detected.\n";
}
return allPassed;
}
};
int main() {
std::cout << "=== C++20 Automated Architecture Fitness Rule Verifier ===\n";
ArchitectureFitnessEngine engine;
// 1. Đăng ký các modules vào từng tầng kiến trúc Clean Architecture
engine.registerModule("OrderController", Layer::PRESENTATION);
engine.registerModule("CreateOrderUseCase", Layer::APPLICATION);
engine.registerModule("OrderAggregate", Layer::DOMAIN);
engine.registerModule("PostgresOrderRepository", Layer::INFRASTRUCTURE);
// 2. Thiết lập các quy tắc bất biến của kiến trúc
// Quy tắc: Domain Layer CẤM tiệt phụ thuộc vào Infrastructure hoặc Presentation
engine.addRule(Layer::DOMAIN, Layer::INFRASTRUCTURE, false, "Domain must not depend on Infrastructure (DIP)");
engine.addRule(Layer::DOMAIN, Layer::PRESENTATION, false, "Domain must not know about Presentation");
// Quy tắc: Presentation CẤM gọi thẳng vào Infrastructure (Closed Layering)
engine.addRule(Layer::PRESENTATION, Layer::INFRASTRUCTURE, false, "Presentation must not bypass Application layer");
// 3. Ghi nhận các quan hệ phụ thuộc thực tế trong mã nguồn
engine.recordDependency("OrderController", "CreateOrderUseCase"); // Hợp lệ
engine.recordDependency("CreateOrderUseCase", "OrderAggregate"); // Hợp lệ
engine.recordDependency("PostgresOrderRepository", "OrderAggregate"); // Hợp lệ (DIP)
// Cố tình ghi nhận 1 vi phạm kiến trúc: Domain gọi thẳng Database!
std::cout << "\n--- Scenario 1: Clean Architecture Verification ---\n";
engine.evaluateCompliance();
std::cout << "\n--- Scenario 2: Injecting Malicious Architectural Drift ---\n";
engine.recordDependency("OrderAggregate", "PostgresOrderRepository"); // VI PHẠM!
bool result = engine.evaluateCompliance();
if (!result) {
std::cout << "\n[CI/CD Quality Gate Result]: ❌ BUILD FAILED! Blocking Pull Request.\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
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
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
Terminal Output Mẫu (C++20):
text
=== C++20 Automated Architecture Fitness Rule Verifier ===
--- Scenario 1: Clean Architecture Verification ---
[Architecture Fitness Evaluation Started]
✅ ALL ARCHITECTURAL FITNESS FUNCTIONS PASSED! Zero drift detected.
--- Scenario 2: Injecting Malicious Architectural Drift ---
[Architecture Fitness Evaluation Started]
❌ ARCHITECTURAL DRIFT DETECTED: Module 'OrderAggregate' (Domain) depends on 'PostgresOrderRepository' (Infrastructure)!
Rule Violated: Domain must not depend on Infrastructure (DIP)
[CI/CD Quality Gate Result]: ❌ BUILD FAILED! Blocking Pull Request.1
2
3
4
5
6
7
8
9
10
11
12
2
3
4
5
6
7
8
9
10
11
12
3.2. Python 3.11+ Implementation: Git CI ADR Validator & Markdown Compliance Checker
Script Python 3.11+ dưới đây đóng vai trò một Git Pre-commit Hook hoặc CI/CD Action để tự động thẩm định tính hợp lệ của các file Architecture Decision Record (ADR), đảm bảo các trường bắt buộc (Status, Context, Decision, Consequences) không bị bỏ trống.
python
from __future__ import annotations
import re
from pathlib import Path
from dataclasses import dataclass
@dataclass
class ADRValidationResult:
is_valid: bool
errors: list[str]
status: str = ""
class ADRValidator:
REQUIRED_SECTIONS = ["bối cảnh", "quyết định", "hệ quả"]
VALID_STATUSES = {"PROPOSED", "ACCEPTED", "REJECTED", "SUPERSEDED"}
@classmethod
def validate_content(cls, content: str) -> ADRValidationResult:
errors = []
lower_content = content.lower()
# 1. Kiểm tra Tiêu đề H1
title_match = re.search(r"^#\s+ADR-\d+:\s+(.+)$", content, re.MULTILINE)
if not title_match:
errors.append("Missing or malformed H1 title. Required format: '# ADR-XXX: Title'")
# 2. Kiểm tra Trạng thái (Status)
status_match = re.search(r"\*\s+Trạng thái\s*\*:\s*([A-Z]+)", content, re.IGNORECASE)
status = ""
if status_match:
status = status_match.group(1).upper()
if status not in cls.VALID_STATUSES:
errors.append(f"Invalid status '{status}'. Must be one of: {cls.VALID_STATUSES}")
else:
errors.append("Missing Status metadata line: '* Trạng thái*: ACCEPTED'")
# 3. Kiểm tra các Section bắt buộc
for sec in cls.REQUIRED_SECTIONS:
if f"## {sec}" not in lower_content:
errors.append(f"Missing mandatory section header: '## {sec.capitalize()}'")
# 4. Kiểm tra độ dài nội dung (Tránh việc viết stub rỗng)
if len(content.strip().splitlines()) < 15:
errors.append("ADR content is too brief (< 15 lines). Please provide detailed trade-off analysis.")
return ADRValidationResult(is_valid=(len(errors) == 0), errors=errors, status=status)
if __name__ == "__main__":
print("=== Python 3.11+ CI/CD Architecture Decision Record (ADR) Linter ===")
# Test 1: Tài liệu ADR chuẩn mực
valid_adr_markdown = """
# ADR-015: Sử dụng PostgreSQL thay cho MongoDB cho Sổ Cái Kế Toán
* **Trạng thái**: ACCEPTED
* **Người đề xuất**: Staff Software Engineer
* **Ngày duyệt**: 2026-11-15
## Bối cảnh (Context)
Hệ thống kế toán yêu cầu tính toàn vẹn giao dịch ACID tuyệt đối. Đội ngũ đang gặp vấn đề mất tính nhất quán khi lưu trữ dữ liệu tài chính trên MongoDB.
## Quyết định (Decision)
Chúng tôi quyết định di chuyển toàn bộ dữ liệu sổ cái sang PostgreSQL, áp dụng mức cô lập giao dịch Serializable Isolation.
## Hệ quả (Consequences)
- **Tích cực**: Bảo toàn tính đúng đắn của tiền tệ, ngăn ngừa chi tiêu kép.
- **Tiêu cực**: Việc mở rộng ghi ngang (Sharding) sẽ phức tạp hơn MongoDB; cần cấu trúc lại bảng dữ liệu.
"""
res1 = ADRValidator.validate_content(valid_adr_markdown)
print(f"\n[Evaluating Valid ADR-015]: Status='{res1.status}'")
if res1.is_valid:
print(" ✅ ADR Validation: PASSED! High quality architectural document.")
# Test 2: Tài liệu ADR cẩu thả, thiếu các phần cốt lõi
corrupt_adr_markdown = """
# Bad ADR: Change some DB
Just decided to use Redis because it is very fast.
"""
res2 = ADRValidator.validate_content(corrupt_adr_markdown)
print(f"\n[Evaluating Malformed ADR]:")
print(" ❌ ADR Validation: FAILED with following violations:")
for err in res2.errors:
print(f" - {err}")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
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
Terminal Output Mẫu (Python 3.11+):
text
=== Python 3.11+ CI/CD Architecture Decision Record (ADR) Linter ===
[Evaluating Valid ADR-015]: Status='ACCEPTED'
✅ ADR Validation: PASSED! High quality architectural document.
[Evaluating Malformed ADR]:
❌ ADR Validation: FAILED with following violations:
- Missing or malformed H1 title. Required format: '# ADR-XXX: Title'
- Missing Status metadata line: '* Trạng thái*: ACCEPTED'
- Missing mandatory section header: '## Bối cảnh'
- Missing mandatory section header: '## Quyết định'
- Missing mandatory section header: '## Hệ quả'
- ADR content is too brief (< 15 lines). Please provide detailed trade-off analysis.1
2
3
4
5
6
7
8
9
10
11
12
13
2
3
4
5
6
7
8
9
10
11
12
13
4. Systems Engineering & Production Pitfalls
Các Cạm Bẫy Thực Chiến (Gotchas & Production Antipatterns)
Căn Bệnh Tài Liệu Viết Xong Rồi Quên (Write-and-Forget Stale Docs):
- Bản chất: Trong tuần đầu tiên thành lập dự án, các kỹ sư vẽ nên những sơ đồ hoành tráng trên Confluence hoặc Miro. Sáu tháng sau, mã nguồn đã thay đổi hoàn toàn nhưng tài liệu không được cập nhật, biến tài liệu thành cái bẫy nguy hiểm cho các lập trình viên mới gia nhập.
- Khắc phục: Triệt để tuân theo Docs-as-Code. Tài liệu phải nằm cùng Git repo với code; một PR thay đổi kiến trúc mà không cập nhật ADR/C4 Diagram sẽ bị chặn merge!
Cạm Bẫy C4 Level 4 Gây Phình To Tài Liệu (Level 4 Diagram Bloat):
- Bản chất: Lập trình viên cố gắng vẽ chi tiết sơ đồ lớp (Class Diagrams) cho từng component trong hệ thống. Chỉ sau 1 lần refactor, hàng trăm sơ đồ này lập tức bị sai lệch.
- Khắc phục: Dừng lại ở Level 2 (Containers) và Level 3 (Components). Đối với Level 4, chỉ sử dụng các công cụ tự động sinh từ code (như
javadoc,doxygen,mermaid-js AST generators) khi thực sự cần.
Hội Chứng Tê Liệt Vì Quyết Định (ADR Paralysis):
- Bản chất: Đội ngũ đòi hỏi phải viết ADR cho cả những việc nhỏ nhặt (như đổi tên một biến, chọn thư viện format ngày tháng). Việc này làm chậm tốc độ phát triển và biến quy trình kỹ thuật thành thủ tục hành chính quan liêu.
- Khắc phục: Chỉ viết ADR cho những quyết định thực sự "quan trọng, khó đảo ngược và tốn kém" (ví dụ: Thay đổi Database, giao thức truyền thông, hoặc cơ chế xác thực người dùng).
Kỹ Thuật Chẩn Đoán & Giám Sát Tài Liệu Bằng CLI:
bash# 1. Tự động sinh sơ đồ C4 Model sang file ảnh PNG từ mã nguồn Structurizr DSL structurizr-cli export -w workspace.dsl -f mermaid # 2. Quét kiểm tra các liên kết hỏng (Broken Links) trong thư mục tài liệu Docs-as-Code markdown-link-check docs/**/*.md # 3. Tạo báo cáo danh mục các ADR hiện có trong dự án bằng công cụ adr-tools adr generate toc > docs/adr/README.md1
2
3
4
5
6
7
8
5. Bảng So sánh & Decision Matrix
5.1. So Sánh Các Khung Tài Liệu Hóa Kiến Trúc (Architecture Frameworks)
| Tiêu Chí | C4 Model (Simon Brown) | 4+1 View Model (Kruchten) | UML Chuẩn Cổ Điển |
|---|---|---|---|
| Độ Phức Tạp Học Tập | Cực thấp (Chỉ cần 30 phút) | Trung bình | Rất cao (Hàng trăm ký hiệu khắt khe) |
| Tính Trực Quan | Rất cao (Tương tự Google Maps) | Rất cao (Theo góc nhìn đối tượng) | Thấp đối với người phi kỹ thuật |
| Hỗ Trợ Docs-as-Code | Hoàn hảo (Mermaid, Structurizr) | Tốt (Markdown, PlantUML) | Kém (Cần công cụ vẽ chuyên biệt nặng nề) |
| Trọng Tâm | Cấu trúc phân cấp thành phần | Đa chiều (Logic, Tiến trình, Vật lý) | Chi tiết cú pháp hướng đối tượng |
| Khuyến Nghị Áp Dụng | Tiêu chuẩn số 1 cho 95% dự án hiện đại | Dự án Enterprise quy mô lớn, phức tạp | Các thuật toán khoa học máy tính đặc thù |
5.2. Ma Trận Phân Định Các Loại Tài Liệu Kỹ Thuật
| Loại Tài Liệu | Mục Đích Trọng Tâm | Vòng Đời & Tính Ổn Định | Đối Tượng Đọc Chính |
|---|---|---|---|
| RFC (Request for Comments) | Đề xuất giải pháp và thu thập phản biện | Tạm thời (Bị đóng sau khi thống nhất) | Toàn bộ kỹ sư trong team |
| Design Doc (Bản Thiết Kế) | Đặc tả chi tiết tính năng trước khi code | Trung hạn (Theo chu kỳ của Feature) | Developers trực tiếp phát triển |
| ADR (Architecture Decision Record) | Văn bản hóa lý do chọn giải pháp & Trade-offs | Bất biến vĩnh viễn (Lịch sử dự án) | Tất cả kỹ sư hiện tại và tương lai |
IyA0LjguIFTDoGkgTGnhu4d1IEjDs2EgdsOgIFRo4bqpbSDEkOG7i25oIEtp4bq/biBUcsO6YyAoQXJjaGl0ZWN0dXJlIERvY3VtZW50YXRpb24gJiBSZXZpZXcpDQoNCj4gWyFJTVBPUlRBTlRdDQo+ICoqTuG6v3UgYuG6oW4gY2jhu4kgxJHGsOG7o2Mgbmjhu5sgbeG7mXQgxJFp4buBdSBkdXkgbmjhuqV0OioqIELhuqNuIHbhur0ga2nhur9uIHRyw7pjIGNo4buJIGPDsyBnacOhIHRy4buLIGtoaSBuw7MgcGjhuqNuIMOhbmggc+G7sSB0aOG6rXQgxJFhbmcgY2jhuqF5IHRyw6puIFByb2R1Y3Rpb247IHTDoGkgbGnhu4d1IGtp4bq/biB0csO6YyBoaeG7h24gxJHhuqFpIHR1w6JuIHRoZW8gdHJp4bq/dCBsw70gRG9jcy1hcy1Db2RlIHbDoCBDNCBNb2RlbCDEkeG7gyBjw7MgdGjhu4Mga2nhu4NtIHRo4butIHThu7EgxJHhu5luZywgbMawdSB0cuG7ryBjw7luZyBtw6Mgbmd14buTbiB0cm9uZyBHaXQgdsOgIGLhuqNvIHbhu4cgY8OhYyBxdXnhur90IMSR4buLbmgga+G7uSB0aHXhuq10IHRow7RuZyBxdWEgQXJjaGl0ZWN0dXJlIERlY2lzaW9uIFJlY29yZHMgKEFEUikuDQoNCi0tLQ0KDQojIyAxLiBLaeG6v24gdHLDumMgVOG7lW5nIHF1YW4gJiBNw7QgaMOsbmggVMawIGR1eSAoTWVudGFsIE1vZGVsKQ0KDQojIyMg4bqobiBk4bulIMSQ4budaSBz4buRbmc6IEdvb2dsZSBNYXBzIMSQYSBU4bqnbmcgdsOgIE5o4bqtdCBLw70gQ8O0bmcgVHLDrG5oIEPhu6dhIEvhu7kgU8awIFRyxrDhu59uZw0KSMOjeSBow6xuaCBkdW5nIHZp4buHYyBs4bqtcCB0w6BpIGxp4buHdSBraeG6v24gdHLDumMgdMawxqFuZyB04buxIG5oxrAgY8OhY2ggY2jDum5nIHRhIHF1YW4gc8OhdCB0aOG6vyBnaeG7m2kgcXVhIOG7qW5nIGThu6VuZyBHb29nbGUgTWFwczoNCi0gKipDNCBMZXZlbCAxOiBTeXN0ZW0gQ29udGV4dCAoQuG6o24gxJHhu5MgVHLDoWkgxJDhuqV0IC8gVuG7hyB0aW5oKSoqOiBOaMOsbiB04burIHF14bu5IMSR4bqhbyB2xakgdHLhu6UsIGLhuqFuIGNo4buJIHRo4bqleSBiacOqbiBnaeG7m2kgY8OhYyBs4bulYyDEkeG7i2EsIMSR4bqhaSBkxrDGoW5nIHbDoCB24buLIHRyw60gY8OhYyBxdeG7kWMgZ2lhIChI4buHIHRo4buRbmcgY+G7p2EgYuG6oW4gdMawxqFuZyB0w6FjIHbhu5tpIE5nw6JuIGjDoG5nLCBLaMOhY2ggaMOgbmcsIEPhu5VuZyBTTVMpLiBC4bqhbiBraMO0bmcgbmjDrG4gdGjhuqV5IMO0IHTDtCBoYXkgbmjDoCBj4butYS4NCi0gKipDNCBMZXZlbCAyOiBDb250YWluZXIgRGlhZ3JhbSAoQuG6o24gxJHhu5MgVGjDoG5oIHBo4buRIC8gR2lhbyB0aMO0bmcpKio6IFBow7NuZyB0byB2w6BvIG3hu5l0IHRow6BuaCBwaOG7kSwgYuG6oW4gdGjhuqV5IGPDoWMga2h1IMSRw7QgdGjhu4ssIHPDom4gYmF5LCBi4bq/biB4ZSwgxJHGsOG7nW5nIGNhbyB04buRYyBu4buRaSBjw6FjIHF14bqtbiAoV2ViIFNQQSwgQVBJIEdhdGV3YXksIE1pY3Jvc2VydmljZXMsIFBvc3RncmVTUUwsIEthZmthIHbDoCBnaWFvIHRo4bupYyBr4bq/dCBu4buRaSBIVFRQL2dSUEMpLg0KLSAqKkM0IExldmVsIDM6IENvbXBvbmVudCBEaWFncmFtIChC4bqjbiB24bq9IE3hurd0IGLhurFuZyBLaHUgbmjDoCkqKjogUGjDs25nIHRvIHbDoG8gbeG7mXQgdMOyYSBjaHVuZyBjxrAsIGLhuqFuIHRo4bqleSBjw6FjIHBow7JuZyBjaOG7qWMgbsSDbmcsIGPhuqd1IHRoYW5nLCBow6BuaCBsYW5nIChDb250cm9sbGVycywgVXNlIENhc2VzLCBSZXBvc2l0b3JpZXMgYsOqbiB0cm9uZyBt4buZdCBNaWNyb3NlcnZpY2UpLg0KLSAqKkM0IExldmVsIDQ6IENvZGUgRGlhZ3JhbSAoQuG6o24gduG6vSBN4bqhY2ggxJFp4buHbiAvIOG7kG5nIG7GsOG7m2MgY2hpIHRp4bq/dCkqKjogUGjDs25nIHRvIHbDoG8gY2jDom4g4buVIGPhuq9tIMSRaeG7h24gaG/hurdjIGNoaSB0aeG6v3QgY+G6pXUgdHLDumMgcmVuIGPhu6dhIHZhbiBuxrDhu5tjIChVTUwgQ2xhc3MgRGlhZ3JhbSBj4bunYSBt4buZdCB0aHXhuq10IHRvw6FuIHBo4bupYyB04bqhcCkuDQotICoqQXJjaGl0ZWN0dXJlIERlY2lzaW9uIFJlY29yZCAtIEFEUiAoTmjhuq10IGvDvSBDw7RuZyB0csOsbmgpKio6IEtoaSBr4bu5IHPGsCB0csaw4bufbmcgcXV54bq/dCDEkeG7i25oIGTDuW5nIG3Ds25nIGPhu41jIGLDqiB0w7RuZyBk4buxIOG7qW5nIGzhu7FjIHRoYXkgdsOsIG3Ds25nIGLEg25nIHbDrCDEkeG7i2EgY2jhuqV0IGPDsyB0w7ppIGLDuW4sIHF1eeG6v3QgxJHhu4tuaCBuw6B5IMSRxrDhu6NjIGvDvSB0w6puIHbDoCDEkcOzbmcgZOG6pXUgdsOgbyBz4buVIG5o4bqtdCBrw70gY8O0bmcgdHLDrG5oLiBNxrDhu51pIG7Eg20gc2F1LCBkw7kga+G7uSBzxrAgdHLGsOG7n25nIMSRw6Mgbmdo4buJIGjGsHUsIG5nxrDhu51pIHRp4bq/cCBxdeG6o24gduG6q24gYmnhur90IGNow61uaCB4w6FjIGzDvSBkbyB04bqhaSBzYW8ga2jDtG5nIMSRxrDhu6NjIHBow6lwIMSRw6BvIHPDonUgdGjDqm0gbcOgIGtow7RuZyBj4bqnbiDEkW/DoW4gbcOyLg0KDQpgYGBtZXJtYWlkDQpmbG93Y2hhcnQgVEQNCiAgICBzdWJncmFwaCBDNEhpZXJhcmNoeVsiQzQgTW9kZWw6IEtodW5nIFRy4buxYyBRdWFuIEjDs2EgxJBhIFThuqduZyAoU2ltb24gQnJvd24pIl0NCiAgICAgICAgTDFbIkxldmVsIDE6IFN5c3RlbSBDb250ZXh0IERpYWdyYW08YnIvPihBaSBkw7luZyBo4buHIHRo4buRbmc/IFTDrWNoIGjhu6NwIGLDqm4gbmdvw6BpIG7DoG8/KSJdDQogICAgICAgIEwyWyJMZXZlbCAyOiBDb250YWluZXIgRGlhZ3JhbTxici8+KOG7qG5nIGThu6VuZywgRGF0YWJhc2UsIEJyb2tlciwgR2lhbyB0aOG7qWMga+G6v3QgbuG7kWkpIl0NCiAgICAgICAgTDNbIkxldmVsIDM6IENvbXBvbmVudCBEaWFncmFtPGJyLz4oQ29udHJvbGxlcnMsIFNlcnZpY2VzLCBSZXBvc2l0b3JpZXMgdHJvbmcgMSBDb250YWluZXIpIl0NCiAgICAgICAgTDRbIkxldmVsIDQ6IENvZGUgRGlhZ3JhbTxici8+KFVNTCBDbGFzcyBEaWFncmFtcywgRW50aXRpZXMgLSBUaMaw4budbmcgdOG7sSBzaW5oKSJdDQogICAgICAgIA0KICAgICAgICBMMSAtLT58Wm9vbSBJbnwgTDINCiAgICAgICAgTDIgLS0+fFpvb20gSW58IEwzDQogICAgICAgIEwzIC0tPnxab29tIElufCBMNA0KICAgIGVuZA0KDQogICAgc3ViZ3JhcGggR292ZXJuYW5jZURvY3NbIlF14bqjbiBUcuG7iyAmIEjhu5MgU8ahIFF1eeG6v3QgxJDhu4tuaCAoRG9jcy1hcy1Db2RlKSJdDQogICAgICAgIEFEUlsiQXJjaGl0ZWN0dXJlIERlY2lzaW9uIFJlY29yZHMgKEFEUik8YnIvPkNvbnRleHQg4oCiIERlY2lzaW9uIOKAoiBDb25zZXF1ZW5jZXMgKFRyYWRlLW9mZnMpIl0NCiAgICAgICAgUUFXWyJRdWFsaXR5IEF0dHJpYnV0ZSBXb3Jrc2hvcCAoUUFXKTxici8+VGjhuqltIMSR4buLbmgga+G7i2NoIGLhuqNuIE5GUiB0csaw4bubYyBraGkgdGhp4bq/dCBr4bq/Il0NCiAgICAgICAgRkZbIkF1dG9tYXRlZCBGaXRuZXNzIEZ1bmN0aW9uczxici8+QXJjaFVuaXQgLyBMaW50ZXIgbmfEg24gY2jhurduIEFyY2hpdGVjdHVyYWwgRHJpZnQiXQ0KICAgIGVuZA0KDQogICAgQzRIaWVyYXJjaHkgPC0tPnzEkOG7k25nIGLhu5kgJiBC4buVIHRy4bujfCBHb3Zlcm5hbmNlRG9jcw0KYGBgDQoNCi0tLQ0KDQojIyAyLiBDaGkgdGnhur90IHThu6tuZyBLZXl3b3JkIChVbmRlci10aGUtSG9vZCBEZWVwIERpdmUpDQoNCiMjIyAyLjEuIE3DtCBIw6xuaCBDNCBUcuG7sWMgUXVhbiBIw7NhIEtp4bq/biBUcsO6YyBQaOG6p24gTeG7gW0gKFNpbW9uIEJyb3duOiA0IEPhuqVwIMSQ4buZKQ0KxJDGsOG7o2MgcGjDoXQgbWluaCBi4bufaSBTaW1vbiBCcm93biwgQzQgTW9kZWwgZ2nhuqNpIHF1eeG6v3QgY8SDbiBi4buHbmggbXXDtG4gdGh14bufIGPhu6dhIHPGoSDEkeG7kyBraeG6v24gdHLDumM6ICoqQ8OhYyBow6xuaCBo4buZcCB2w6AgbcWpaSB0w6puIHbDtCBuZ2jEqWEga2jDtG5nIGPDsyBuZ+G7ryBj4bqjbmggcsO1IHLDoG5nKiouIEM0IHBow6JuIGPhuqVwIHRow6BuaCA0IG3hu6ljIHRy4burdSB0xrDhu6NuZzoNCg0KYGBgbWVybWFpZA0KZmxvd2NoYXJ0IExSDQogICAgc3ViZ3JhcGggTGV2ZWwxWyIxLiBTeXN0ZW0gQ29udGV4dCAoTWFjcm8gVmlldykiXQ0KICAgICAgICBVc2VyKFtDdXN0b21lciAvIFVzZXJdKSAtLT58SFRUUFN8IFN5c1tDb3JlIEJhbmtpbmcgUGxhdGZvcm0gU3lzdGVtXQ0KICAgICAgICBTeXMgLS0+fElTTyA4NTgzfCBWaXNhW0V4dGVybmFsOiBWaXNhIFBheW1lbnQgTmV0d29ya10NCiAgICBlbmQNCg0KICAgIHN1YmdyYXBoIExldmVsMlsiMi4gQ29udGFpbmVycyAoRGVwbG95YWJsZSBVbml0cykiXQ0KICAgICAgICBTUEFbUmVhY3QgV2ViIFNQQV0gLS0+fEhUVFBTL0pTT058IEdXW0Vudm95IEFQSSBHYXRld2F5XQ0KICAgICAgICBHVyAtLT58Z1JQQ3wgQ29yZVN2Y1tBY2NvdW50IENvcmUgU2VydmljZTogR28gLyBDKytdDQogICAgICAgIENvcmVTdmMgLS0+IERCWyhQb3N0Z3JlU1FMIERhdGFiYXNlKV0NCiAgICBlbmQNCmBgYA0KDQoxLiAqKkxldmVsIDE6IFN5c3RlbSBDb250ZXh0IERpYWdyYW0gKELhu5FpIGPhuqNuaCBI4buHIHRo4buRbmcpKio6DQogICAtIETDoG5oIGNobzogQmFuIGdpw6FtIMSR4buRYywgUHJvZHVjdCBNYW5hZ2VycywgdsOgIG3hu41pIMSR4buRaSB0xrDhu6NuZyBr4bu5IHRodeG6rXQgbOG6q24gcGhpIGvhu7kgdGh14bqtdC4NCiAgIC0gVGjhu4MgaGnhu4duOiBI4buHIHRo4buRbmcgcGjhuqduIG3hu4FtIGPhu6dhIGLhuqFuIG7hurFtIOG7nyDEkcOidSB0cm9uZyBi4bupYyB0cmFuaCB0b8OgbiBj4bqjbmg7IGFpIGzDoCBuZ8aw4budaSBkw7luZyB0xrDGoW5nIHTDoWMgdHLhu7FjIHRp4bq/cDsgaOG7hyB0aOG7kW5nIHBo4bulIHRodeG7mWMgdsOgbyBuaOG7r25nIMSR4buRaSB0w6FjIGLDqm4gbmdvw6BpIG7DoG8uDQogICAtICpOZ3V5w6puIHThuq9jKjogS2jDtG5nIGhp4buDbiB0aOG7iyBi4bqldCBr4buzIGNoaSB0aeG6v3QgY8O0bmcgbmdo4buHLCBmcmFtZXdvcmssIGhheSBjxqEgc+G7nyBk4buvIGxp4buHdSBuw6BvLg0KMi4gKipMZXZlbCAyOiBDb250YWluZXIgRGlhZ3JhbSAoQ8OhYyBLaOG7kWkgVHJp4buDbiBLaGFpKSoqOg0KICAgLSBEw6BuaCBjaG86IEvhu7kgc8awIHBo4bqnbiBt4buBbSwgS2nhur9uIHRyw7pjIHPGsCwgRGV2T3BzL1NSRS4NCiAgIC0gxJDhu4tuaCBuZ2jEqWEgKiJDb250YWluZXIiKjogQuG6pXQga+G7syDEkcahbiB24buLIHBo4bqnbiBt4buBbSBuw6BvIGPDsyB0aOG7gyBjaOG6oXkgdsOgIHRyaeG7g24ga2hhaSDEkeG7mWMgbOG6rXAgKFdlYiBTUEEsIE1vYmlsZSBBcHAsIE1pY3Jvc2VydmljZSwgRGF0YWJhc2UsIE1lc3NhZ2UgUXVldWUsIENyb24gSm9iKS4NCiAgIC0gVGjhu4MgaGnhu4duOiBUcsOhY2ggbmhp4buHbSBj4bunYSB04burbmcgQ29udGFpbmVyLCBjw7RuZyBuZ2jhu4cgc+G7rSBk4bulbmcgKEdvLCBSZWFjdCwgUG9zdGdyZVNRTCkgdsOgIGdpYW8gdGjhu6ljIG3huqFuZyB0cnV54buBbiB0aMO0bmcgKGdSUEMgb3ZlciBIVFRQLzIsIFRMUyAxLjMpLg0KMy4gKipMZXZlbCAzOiBDb21wb25lbnQgRGlhZ3JhbSAoQ8OhYyBUaMOgbmggUGjhuqduIELDqm4gVHJvbmcgQ29udGFpbmVyKSoqOg0KICAgLSBEw6BuaCBjaG86IEPDoWMga+G7uSBzxrAgdHLhu7FjIHRp4bq/cCBs4bqtcCB0csOsbmggdHLDqm4gQ29udGFpbmVyIMSRw7MuDQogICAtIFRo4buDIGhp4buHbjogQ+G6pXUgdHLDumMgYsOqbiB0cm9uZyBj4bunYSBt4buZdCBDb250YWluZXIgxJHGsOG7o2MgY2hpYSB0aMOgbmggY8OhYyBDb21wb25lbnRzIG7DoG8gKHRoZW8gQ2xlYW4gQXJjaGl0ZWN0dXJlOiBDb250cm9sbGVycywgVXNlIENhc2VzLCBSZXBvc2l0b3JpZXMpIHbDoCBjw6FjaCBjaMO6bmcgbGnDqm4ga+G6v3QgcXVhIEludGVyZmFjZXMuDQo0LiAqKkxldmVsIDQ6IENvZGUgRGlhZ3JhbSAoTeG7qWMgTcOjIE5ndeG7k24pKio6DQogICAtIETDoG5oIGNobzogTOG6rXAgdHLDrG5oIHZpw6puIGNodXnDqm4gc8OidS4NCiAgIC0gVGjhu4MgaGnhu4duOiBDw6FjIHPGoSDEkeG7kyBs4bubcCAoVU1MIENsYXNzIERpYWdyYW1zKSwgU3RhdGUgTWFjaGluZXMgaG/hurdjIEVudGl0eSBSZWxhdGlvbnNoaXAuIFRoxrDhu51uZyBjaOG7iSBuw6puIHbhur0gY2hvIGPDoWMgdGh14bqtdCB0b8OhbiBy4bqldCBwaOG7qWMgdOG6oXA7IGtow7RuZyBuw6puIHbhur0gY2hvIHRvw6BuIGLhu5kgY29kZSB2w6wgc+G6vSBuaGFuaCBjaMOzbmcgYuG7iyBs4buXaSB0aOG7nWkuDQoNCi0tLQ0KDQojIyMgMi4yLiBNw7QgSMOsbmggR8OzYyBOaMOsbiA0KzEgKFBoaWxpcHBlIEtydWNodGVuIEFyY2hpdGVjdHVyYWwgVmlldyBNb2RlbCkNCsSQxrDhu6NjIGNodeG6qW4gaMOzYSB0cm9uZyB0w6BpIGxp4buHdSBJRUVFIDE0NzEsIG3DtCBow6xuaCA0KzEgY+G7p2EgUGhpbGlwcGUgS3J1Y2h0ZW4gY3VuZyBj4bqlcCA1IGfDs2MgbmjDrG4gxJFhIGNoaeG7gXUgxJHhu4MgdGjhu49hIG3Do24gbmh1IGPhuqd1IHRow7RuZyB0aW4gY+G7p2EgY8OhYyBuaMOzbSBiw6puIGxpw6puIHF1YW4ga2jDoWMgbmhhdToNCg0KYGBgbWVybWFpZA0KZmxvd2NoYXJ0IFREDQogICAgc3ViZ3JhcGggS3J1Y2h0ZW5bIk3DtCBIw6xuaCA0KzEgS2nhur9uIFRyw7pjIChQaGlsaXBwZSBLcnVjaHRlbikiXQ0KICAgICAgICBTY2VuYXJpb3NbIisxOiBVc2UgQ2FzZSAvIFNjZW5hcmlvcyBWaWV3PGJyLz4oVMOibSDEkWnhu4NtIGtp4buDbSBjaOG7qW5nIGvhu4tjaCBi4bqjbiBuZ8aw4budaSBkw7luZykiXQ0KICAgICAgICANCiAgICAgICAgTG9naWNhbFsiMS4gTG9naWNhbCBWaWV3PGJyLz4oQ2xhc3NlcywgT2JqZWN0cywgRG9tYWluIE1vZGVscykiXQ0KICAgICAgICBEZXZbIjIuIERldmVsb3BtZW50IFZpZXc8YnIvPihQYWNrYWdlcywgTW9kdWxlcywgUmVwb3NpdG9yaWVzKSJdDQogICAgICAgIFByb2Nlc3NbIjMuIFByb2Nlc3MgVmlldzxici8+KFRocmVhZHMsIENvbmN1cnJlbmN5LCBMYXRlbmN5LCBTY2FsZSkiXQ0KICAgICAgICBQaHlzaWNhbFsiNC4gUGh5c2ljYWwgLyBEZXBsb3ltZW50IFZpZXc8YnIvPihIYXJkd2FyZSwgVk1zLCBLOHMgUG9kcywgTmV0d29ya3MpIl0NCiAgICAgICAgDQogICAgICAgIFNjZW5hcmlvcyAtLi0+fEtp4buDbSBjaOG7qW5nICYgTGnDqm4ga+G6v3R8IExvZ2ljYWwNCiAgICAgICAgU2NlbmFyaW9zIC0uLT58S2nhu4NtIGNo4bupbmcgJiBMacOqbiBr4bq/dHwgRGV2DQogICAgICAgIFNjZW5hcmlvcyAtLi0+fEtp4buDbSBjaOG7qW5nICYgTGnDqm4ga+G6v3R8IFByb2Nlc3MNCiAgICAgICAgU2NlbmFyaW9zIC0uLT58S2nhu4NtIGNo4bupbmcgJiBMacOqbiBr4bq/dHwgUGh5c2ljYWwNCiAgICBlbmQNCmBgYA0KDQoxLiAqKkxvZ2ljYWwgVmlldyAoR8OzYyBOaMOsbiBMb2dpYykqKjogUGjhu6VjIHbhu6UgRW5kLVVzZXJzIHbDoCBBcmNoaXRlY3RzLiBNw7QgdOG6oyBj4bqldSB0csO6YyBjw6FjIGtow6FpIG5p4buHbSBuZ2hp4buHcCB24bulLCB0aOG7sWMgdGjhu4MgRG9tYWluLCB2w6AgY8OhYyBt4buRaSBxdWFuIGjhu4cgdHLhu6t1IHTGsOG7o25nLg0KMi4gKipEZXZlbG9wbWVudCBWaWV3IChHw7NjIE5ow6xuIFBow6F0IFRyaeG7g24pKio6IFBo4bulYyB24bulIEzhuq1wIHRyw6xuaCB2acOqbiB2w6AgUXXhuqNuIGzDvSBD4bqldSBow6xuaC4gTcO0IHThuqMgY+G6pXUgdHLDumMgcGjDom4gY2hpYSBtw6Mgbmd14buTbiB0cm9uZyBHaXQsIHF14bqjbiBsw70gdGjGsCB2aeG7h24gcGjhu6UgdGh14buZYyAoTWF2ZW4sIENhcmdvLCBHbyBNb2R1bGVzKSB2w6AgcXV5IHRyw6xuaCBiacOqbiBk4buLY2guDQozLiAqKlByb2Nlc3MgVmlldyAoR8OzYyBOaMOsbiBUaeG6v24gVHLDrG5oKSoqOiBQaOG7pWMgduG7pSBUw61jaCBo4bujcCBI4buHIHRo4buRbmcuIE3DtCB04bqjIGPDoWMgbHXhu5NuZyB0aOG7sWMgdGhpIChUaHJlYWRzKSwgdGnhur9uIHRyw6xuaCAoUHJvY2Vzc2VzKSwgxJHhu5NuZyBi4buZIGjDs2EsIMSR4buZIHRy4buFIG3huqFuZyB2w6AgaGnhu4d1IG7Eg25nIGtoaSBo4buHIHRo4buRbmcgY2jhuqF5IOG7nyBydW50aW1lLg0KNC4gKipQaHlzaWNhbCAvIERlcGxveW1lbnQgVmlldyAoR8OzYyBOaMOsbiBW4bqtdCBMw70pKio6IFBo4bulYyB24bulIERldk9wcyB2w6AgU1JFLiBNw7QgdOG6oyBjw6FjaCBwaOG6p24gbeG7gW0gxJHGsOG7o2Mgw6FuaCB44bqhIGzDqm4gbcOheSBjaOG7pyB24bqtdCBsw70sIG3DoXkg4bqjbywgY29udGFpbmVyIEt1YmVybmV0ZXMsIGPhuqV1IGjDrG5oIHTGsOG7nW5nIGzhu61hIHbDoCBjw6JuIGLhurFuZyB04bqjaS4NCjUuICoqKzE6IFVzZSBDYXNlIC8gU2NlbmFyaW9zIFZpZXcgKEfDs2MgTmjDrG4gS+G7i2NoIELhuqNuIEPhu5F0IEzDtWkpKio6IFTDom0gxJFp4buDbSBsacOqbiBr4bq/dCB0b8OgbiBi4buZIDQgZ8OzYyBuaMOsbiB0csOqbi4gTeG7l2kga+G7i2NoIGLhuqNuIG5naGnhu4dwIHbhu6UgxJHDs25nIHZhaSB0csOyIHPhu6NpIGNo4buJIMSR4buPIHh1ecOqbiBzdeG7kXQgxJHhu4Mga2nhu4NtIGNo4bupbmcgeGVtIDQgZ8OzYyBuaMOsbiBraWEgY8OzIHBo4buRaSBo4bujcCBuaOG7i3AgbmjDoG5nIHbhu5tpIG5oYXUga2jDtG5nLg0KDQotLS0NCg0KIyMjIDIuMy4gQXJjaGl0ZWN0dXJlIERlY2lzaW9uIFJlY29yZHMgKEFEUikgdsOgIFRyaeG6v3QgTMO9IERvY3MtYXMtQ29kZQ0KDQojIyMjIDEuIFRyaeG6v3QgTMO9IERvY3MtYXMtQ29kZQ0KLSBUw6BpIGxp4buHdSBraeG6v24gdHLDumMgxJHGsOG7o2MgxJHhu5FpIHjhu60gYsOsbmggxJHhurNuZyBuaMawIG3DoyBuZ3Xhu5NuOg0KICAtIFZp4bq/dCBi4bqxbmcgdsSDbiBi4bqjbiB0aHXhuqduIHTDunkgKE1hcmtkb3duIC8gQXNjaWlEb2MpIHRoYXkgdsOsIFdvcmQgaGF5IFBERi4NCiAgLSBMxrB1IHRy4buvIHRy4buxYyB0aeG6v3AgdHJvbmcgY8O5bmcgR2l0IFJlcG9zaXRvcnkgY+G7p2EgZOG7sSDDoW4gKGBkb2NzL2Fkci9gKS4NCiAgLSDEkMaw4bujYyByZXZpZXcgdGjDtG5nIHF1YSBQdWxsIFJlcXVlc3QgKFBSKSBjw7Mgc+G7sSBwaMOqIGR1eeG7h3QgY+G7p2EgVGVjaCBMZWFkcy4NCiAgLSDEkMaw4bujYyBraeG7g20gdGjhu60gY8O6IHBow6FwIHbDoCBsacOqbiBr4bq/dCB04buxIMSR4buZbmcgYuG6sW5nIENJL0NEIFBpcGVsaW5lcy4NCg0KIyMjIyAyLiBD4bqldSBUcsO6YyBDaHXhuqluIEPhu6dhIE3hu5l0IELhuqNuIEFEUiAoTWljaGFlbCBOeWdhcmQgU3RhbmRhcmQpDQpN4buZdCB0w6BpIGxp4buHdSBBRFIgaG/DoG4gY2jhu4luaCBi4bqvdCBideG7mWMgcGjhuqNpIGPDsyA1IHBo4bqnbiBuZ+G6r24gZ+G7jW46DQoxLiAqKlRpdGxlKio6IFPhu5EgdGjhu6kgdOG7sSB2w6AgcXV54bq/dCDEkeG7i25oICh2w60gZOG7pTogYEFEUi0wMTI6IFPhu60gZOG7pW5nIGdSUEMgdGhheSB0aOG6vyBSRVNUIGNobyBnaWFvIHRp4bq/cCBu4buZaSBi4buZYCkuDQoyLiAqKlN0YXR1cyoqOiBUcuG6oW5nIHRow6FpIGhp4buHbiB04bqhaTogYFBST1BPU0VEYCAoxJBhbmcgxJHhu4EgeHXhuqV0KSwgYEFDQ0VQVEVEYCAoxJDDoyBkdXnhu4d0KSwgYFJFSkVDVEVEYCAoQuG7iyBiw6FjIGLhu48pLCBob+G6t2MgYFNVUEVSU0VERURgIChC4buLIHRoYXkgdGjhur8gYuG7n2kgQURSIG3hu5tpIGjGoW4pLg0KMy4gKipDb250ZXh0IChC4buRaSBj4bqjbmgpKio6IFRyw6xuaCBiw6B5IGLDoGkgdG/DoW4ga+G7uSB0aHXhuq10LCBjw6FjIHLDoG5nIGJ14buZYyB2w6AgbMO9IGRvIHThuqFpIHNhbyBxdXnhur90IMSR4buLbmggbsOgeSBj4bqnbiDEkcaw4bujYyDEkcawYSByYS4NCjQuICoqRGVjaXNpb24gKFF1eeG6v3QgxJHhu4tuaCkqKjogR2nhuqNpIHBow6FwIGvhu7kgdGh14bqtdCDEkcaw4bujYyBjaOG7jW4gbOG7sWEgxJHhu4Mgw6FwIGThu6VuZy4NCjUuICoqQ29uc2VxdWVuY2VzIChI4buHIHF14bqjICYgxJDDoW5oIMSR4buVaSkqKjogUGjDom4gdMOtY2gga2jDoWNoIHF1YW46IFF1eeG6v3QgxJHhu4tuaCBuw6B5IG1hbmcgbOG6oWkgbOG7o2kgw61jaCBnw6wgKFByb3MpIHbDoCBjaMO6bmcgdGEgY2jhuqVwIG5o4bqtbiDEkcOhbmggbeG6pXQgxJFp4buBdSBnw6wgKENvbnMgLyBUcmFkZS1vZmZzKS4NCg0KLS0tDQoNCiMjIyAyLjQuIFF1YWxpdHkgQXR0cmlidXRlIFdvcmtzaG9wIChRQVcpIHbDoCDEkMOhbmggR2nDoSBLaeG6v24gVHLDumMgxJDhu4tuaCBL4buzDQotICoqUUFXIChTRUkpKio6IE3hu5l0IGJ14buVaSBo4buZaSB0aOG6o28gdOG6oW8gxJFp4buBdSBraeG7h24gKEZhY2lsaXRhdGVkIFdvcmtzaG9wKSBkaeG7hW4gcmEgdHJvbmcgMSBuZ8OgeSBnaeG7r2EgY8OhYyBLaeG6v24gdHLDumMgc8awLCBM4bqtcCB0csOsbmggdmnDqm4sIFByb2R1Y3QgT3duZXJzIHbDoCBjw6FjIGLDqm4gbGnDqm4gcXVhbiDEkeG7gyB0w6xtIHJhIGPDoWMga+G7i2NoIGLhuqNuIHRodeG7mWMgdMOtbmggY2jhuqV0IGzGsOG7o25nIChRQVMpIHF1YW4gdHLhu41uZyBuaOG6pXQgdHLGsOG7m2Mga2hpIGLhuq90IMSR4bqndSB0aGnhur90IGvhur8uDQotICoqQXJjaGl0ZWN0dXJlIFJldmlldyBNZWV0aW5ncyoqOg0KICAtIERp4buFbiByYSDEkeG7i25oIGvhu7MgKGjDoG5nIHR14bqnbiBob+G6t2MgdHLGsOG7m2MgbeG7l2kgcXXDvSkuDQogIC0gTeG7pWMgdGnDqnU6IFLDoCBzb8OhdCBjw6FjIEFEUiBt4bubaSDEkcaw4bujYyDEkeG7gSB4deG6pXQsIGtp4buDbSB0cmEgeGVtIGPDsyBzZXJ2aWNlIG7DoG8gYuG7iyAic3V5IHRob8OhaSBraeG6v24gdHLDumMiIGtow7RuZywgdsOgIMSRxrBhIHJhIHF1eeG6v3QgxJHhu4tuaCBuw6JuZyBj4bqlcCBo4bqhIHThuqduZy4NCg0KLS0tDQoNCiMjIyAyLjUuIEF1dG9tYXRlZCBGaXRuZXNzIEZ1bmN0aW9uczogQmnhur9uIFTDoGkgTGnhu4d1IFRow6BuaCBNw6MgS2nhu4NtIFRo4butIFPhu5FuZw0KLSBW4bqlbiDEkeG7gSBs4bubbiBuaOG6pXQgY+G7p2EgdMOgaSBsaeG7h3UgYuG6sW5nIGzhu51pIG7Ds2kgbMOgOiAqKlTDoGkgbGnhu4d1IG7Ds2kgbeG7mXQgxJHhurFuZywgY29kZSBjaOG6oXkgbeG7mXQgbuG6u28qKi4NCi0gKipHaeG6o2kgcGjDoXAqKjogSGnhu4duIHRo4buxYyBow7NhIGPDoWMgcXV5IHThuq9jIGtp4bq/biB0csO6YyB0aMOgbmggY8OhYyBiw6BpIGtp4buDbSB0aOG7rSB04buxIMSR4buZbmcgKEF1dG9tYXRlZCBGaXRuZXNzIEZ1bmN0aW9ucykgY2jhuqF5IHRy4buxYyB0aeG6v3AgdHJvbmcgQ0kvQ0QgYuG6sW5nIGPDoWMgY8O0bmcgY+G7pSBuaMawIEFyY2hVbml0LCBEZXB0cmFjIGhv4bq3YyBDdXN0b20gTGludGVyczoNCiAgLSAqIlThuqduZyBEb21haW4ga2jDtG5nIMSRxrDhu6NjIHBow6lwIGltcG9ydCBi4bqldCBr4buzIHBhY2thZ2UgbsOgbyB04burIEluZnJhc3RydWN0dXJlIiouDQogIC0gKiJLaMO0bmcgY8OzIGNpcmN1bGFyIGRlcGVuZGVuY3kgZ2nhu69hIGPDoWMgbW9kdWxlcyIqLg0KICAtICoiVGjhu51pIGdpYW4gxJHDoXAg4bupbmcgY+G7p2EgQVBJIHRoYW5oIHRvw6FuIHBo4bqjaSBkxrDhu5tpIDUwbXMiKi4NCg0KLS0tDQoNCiMjIyAyLjYuIFF14bqjbiBUcuG7iyBLaeG6v24gVHLDumMgRG9hbmggTmdoaeG7h3AgKEFyY2hpdGVjdHVyZSBHb3Zlcm5hbmNlICYgQW50aS1Fcm9zaW9uKQ0KLSAqKkFyY2hpdGVjdHVyYWwgRXJvc2lvbiAvIERyaWZ0Kio6IEhp4buHbiB0xrDhu6NuZyBtw6Mgbmd14buTbiB0aGVvIHRo4budaSBnaWFuIGLhu4sgeMOzaSBtw7JuIGRvIMOhcCBs4buxYyB0aeG6v24gxJHhu5kgKERlYWRsaW5lcyksIGPDoWMga+G7uSBzxrAgbeG7m2kgdOG6oW8gxJHGsOG7nW5nIHThuq90IChTaG9ydGN1dHMpIHBow6EgduG7oSByYW5oIGdp4bubaSBraeG6v24gdHLDumMuDQotICoqQmnhu4duIHBow6FwIG5nxINuIGNo4bq3bioqOg0KICAxLiBUaGnhur90IGzhuq1wICoqUXVhbGl0eSBHYXRlcyoqIHThu7EgxJHhu5luZyB04burIGNo4buRaSBtZXJnZSBQUiBu4bq/dSB2aSBwaOG6oW0gcmFuaCBnaeG7m2kuDQogIDIuIELhu5Ugbmhp4buHbSAqKkFyY2hpdGVjdHVyZSBDaGFtcGlvbnMqKiB0cm9uZyB04burbmcgxJHhu5lpIG5ow7NtIMSR4buDIGdpw6FtIHPDoXQgdsOgIGjGsOG7m25nIGThuqtuLg0KICAzLiBEw6BuaCByacOqbmcgJDIwXCUkIG5nw6JuIHPDoWNoIGvhu7kgdGh14bqtdCB0cm9uZyBt4buXaSBTcHJpbnQgxJHhu4MgdHLhuqMgbuG7oyBr4bu5IHRodeG6rXQga2nhur9uIHRyw7pjLg0KDQotLS0NCg0KIyMgMy4gVGjhu7FjIHRoaSBNw6Mgbmd14buTbiAmIE3DtCBwaOG7j25nIENodXnDqm4gc8OidSAoRHVhbC1FbmdpbmUgSW1wbGVtZW50YXRpb24pDQoNCiMjIyAzLjEuIEMrKzIwIEltcGxlbWVudGF0aW9uOiBBdXRvbWF0ZWQgQXJjaGl0ZWN0dXJlIENvbXBsaWFuY2UgJiBGaXRuZXNzIENoZWNrZXINCkNoxrDGoW5nIHRyw6xuaCBDKysyMCBkxrDhu5tpIMSRw6J5IG3DtCBwaOG7j25nIG3hu5l0IGPDtG5nIGPhu6Uga2nhu4NtIMSR4buLbmggcXV5IHThuq9jIGtp4bq/biB0csO6YyAoQXJjaGl0ZWN0dXJlIENvbXBsaWFuY2UgQ2hlY2tlcikgY2jhuqF5IHRyb25nIGNodSB0csOsbmgga2nhu4NtIHRo4butIHThu7EgxJHhu5luZywgcXXDqXQgbWEgdHLhuq1uIHBo4bulIHRodeG7mWMgZ2nhu69hIGPDoWMgbW9kdWxlIHbDoCBj4bqjbmggYsOhbyBu4bq/dSBjw7MgdmkgcGjhuqFtIEFyY2hpdGVjdHVyYWwgRHJpZnQuDQoNCmBgYGNwcA0KI2luY2x1ZGUgPGlvc3RyZWFtPg0KI2luY2x1ZGUgPHZlY3Rvcj4NCiNpbmNsdWRlIDxzdHJpbmc+DQojaW5jbHVkZSA8dW5vcmRlcmVkX21hcD4NCiNpbmNsdWRlIDx1bm9yZGVyZWRfc2V0Pg0KI2luY2x1ZGUgPHN0ZGV4Y2VwdD4NCiNpbmNsdWRlIDxpb21hbmlwPg0KDQovLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQovLyBBUkNISVRFQ1RVUkFMIExBWUVSIERFRklOSVRJT05TICYgUlVMRVMgRU5HSU5FDQovLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQplbnVtIGNsYXNzIExheWVyIHsgUFJFU0VOVEFUSU9OLCBBUFBMSUNBVElPTiwgRE9NQUlOLCBJTkZSQVNUUlVDVFVSRSB9Ow0KDQpzdGQ6OnN0cmluZyBsYXllclRvU3RyaW5nKExheWVyIGwpIHsNCiAgICBzd2l0Y2ggKGwpIHsNCiAgICAgICAgY2FzZSBMYXllcjo6UFJFU0VOVEFUSU9OOiAgIHJldHVybiAiUHJlc2VudGF0aW9uIjsNCiAgICAgICAgY2FzZSBMYXllcjo6QVBQTElDQVRJT046ICAgIHJldHVybiAiQXBwbGljYXRpb24iOw0KICAgICAgICBjYXNlIExheWVyOjpET01BSU46ICAgICAgICAgcmV0dXJuICJEb21haW4iOw0KICAgICAgICBjYXNlIExheWVyOjpJTkZSQVNUUlVDVFVSRTogcmV0dXJuICJJbmZyYXN0cnVjdHVyZSI7DQogICAgfQ0KICAgIHJldHVybiAiVW5rbm93biI7DQp9DQoNCnN0cnVjdCBEZXBlbmRlbmN5UnVsZSB7DQogICAgTGF5ZXIgc291cmNlOw0KICAgIExheWVyIHRhcmdldDsNCiAgICBib29sIGlzQWxsb3dlZDsNCiAgICBzdGQ6OnN0cmluZyBydWxlRGVzY3JpcHRpb247DQp9Ow0KDQpjbGFzcyBBcmNoaXRlY3R1cmVGaXRuZXNzRW5naW5lIHsNCnByaXZhdGU6DQogICAgc3RkOjp2ZWN0b3I8RGVwZW5kZW5jeVJ1bGU+IHJ1bGVzXzsNCiAgICBzdGQ6OnVub3JkZXJlZF9tYXA8c3RkOjpzdHJpbmcsIExheWVyPiBtb2R1bGVMYXllclJlZ2lzdHJ5XzsNCiAgICBzdGQ6OnZlY3RvcjxzdGQ6OnBhaXI8c3RkOjpzdHJpbmcsIHN0ZDo6c3RyaW5nPj4gZGVjbGFyZWREZXBlbmRlbmNpZXNfOw0KDQpwdWJsaWM6DQogICAgdm9pZCByZWdpc3Rlck1vZHVsZShjb25zdCBzdGQ6OnN0cmluZyYgbW9kdWxlTmFtZSwgTGF5ZXIgbGF5ZXIpIHsNCiAgICAgICAgbW9kdWxlTGF5ZXJSZWdpc3RyeV9bbW9kdWxlTmFtZV0gPSBsYXllcjsNCiAgICB9DQoNCiAgICB2b2lkIGFkZFJ1bGUoTGF5ZXIgc3JjLCBMYXllciBkc3QsIGJvb2wgYWxsb3dlZCwgY29uc3Qgc3RkOjpzdHJpbmcmIGRlc2MpIHsNCiAgICAgICAgcnVsZXNfLnB1c2hfYmFjayh7c3JjLCBkc3QsIGFsbG93ZWQsIGRlc2N9KTsNCiAgICB9DQoNCiAgICB2b2lkIHJlY29yZERlcGVuZGVuY3koY29uc3Qgc3RkOjpzdHJpbmcmIGZyb21Nb2R1bGUsIGNvbnN0IHN0ZDo6c3RyaW5nJiB0b01vZHVsZSkgew0KICAgICAgICBkZWNsYXJlZERlcGVuZGVuY2llc18uZW1wbGFjZV9iYWNrKGZyb21Nb2R1bGUsIHRvTW9kdWxlKTsNCiAgICB9DQoNCiAgICBib29sIGV2YWx1YXRlQ29tcGxpYW5jZSgpIHsNCiAgICAgICAgc3RkOjpjb3V0IDw8ICJbQXJjaGl0ZWN0dXJlIEZpdG5lc3MgRXZhbHVhdGlvbiBTdGFydGVkXVxuIjsNCiAgICAgICAgYm9vbCBhbGxQYXNzZWQgPSB0cnVlOw0KDQogICAgICAgIGZvciAoY29uc3QgYXV0byYgW2Zyb20sIHRvXSA6IGRlY2xhcmVkRGVwZW5kZW5jaWVzXykgew0KICAgICAgICAgICAgTGF5ZXIgc3JjTGF5ZXIgPSBtb2R1bGVMYXllclJlZ2lzdHJ5Xy5hdChmcm9tKTsNCiAgICAgICAgICAgIExheWVyIGRzdExheWVyID0gbW9kdWxlTGF5ZXJSZWdpc3RyeV8uYXQodG8pOw0KDQogICAgICAgICAgICAvLyBLaeG7g20gdHJhIGPDoWMgcXV5IHThuq9jIGLhu4sgY+G6pW0NCiAgICAgICAgICAgIGZvciAoY29uc3QgYXV0byYgcnVsZSA6IHJ1bGVzXykgew0KICAgICAgICAgICAgICAgIGlmIChydWxlLnNvdXJjZSA9PSBzcmNMYXllciAmJiBydWxlLnRhcmdldCA9PSBkc3RMYXllciAmJiAhcnVsZS5pc0FsbG93ZWQpIHsNCiAgICAgICAgICAgICAgICAgICAgc3RkOjpjb3V0IDw8ICIgIOKdjCBBUkNISVRFQ1RVUkFMIERSSUZUIERFVEVDVEVEOiAiDQogICAgICAgICAgICAgICAgICAgICAgICAgICAgICA8PCAiTW9kdWxlICciIDw8IGZyb20gPDwgIicgKCIgPDwgbGF5ZXJUb1N0cmluZyhzcmNMYXllcikgPDwgIikgIg0KICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgPDwgImRlcGVuZHMgb24gJyIgPDwgdG8gPDwgIicgKCIgPDwgbGF5ZXJUb1N0cmluZyhkc3RMYXllcikgPDwgIikhXG4iDQogICAgICAgICAgICAgICAgICAgICAgICAgICAgICA8PCAiICAgICBSdWxlIFZpb2xhdGVkOiAiIDw8IHJ1bGUucnVsZURlc2NyaXB0aW9uIDw8ICJcbiI7DQogICAgICAgICAgICAgICAgICAgIGFsbFBhc3NlZCA9IGZhbHNlOw0KICAgICAgICAgICAgICAgIH0NCiAgICAgICAgICAgIH0NCiAgICAgICAgfQ0KDQogICAgICAgIGlmIChhbGxQYXNzZWQpIHsNCiAgICAgICAgICAgIHN0ZDo6Y291dCA8PCAiICDinIUgQUxMIEFSQ0hJVEVDVFVSQUwgRklUTkVTUyBGVU5DVElPTlMgUEFTU0VEISBaZXJvIGRyaWZ0IGRldGVjdGVkLlxuIjsNCiAgICAgICAgfQ0KICAgICAgICByZXR1cm4gYWxsUGFzc2VkOw0KICAgIH0NCn07DQoNCmludCBtYWluKCkgew0KICAgIHN0ZDo6Y291dCA8PCAiPT09IEMrKzIwIEF1dG9tYXRlZCBBcmNoaXRlY3R1cmUgRml0bmVzcyBSdWxlIFZlcmlmaWVyID09PVxuIjsNCiAgICBBcmNoaXRlY3R1cmVGaXRuZXNzRW5naW5lIGVuZ2luZTsNCg0KICAgIC8vIDEuIMSQxINuZyBrw70gY8OhYyBtb2R1bGVzIHbDoG8gdOG7q25nIHThuqduZyBraeG6v24gdHLDumMgQ2xlYW4gQXJjaGl0ZWN0dXJlDQogICAgZW5naW5lLnJlZ2lzdGVyTW9kdWxlKCJPcmRlckNvbnRyb2xsZXIiLCBMYXllcjo6UFJFU0VOVEFUSU9OKTsNCiAgICBlbmdpbmUucmVnaXN0ZXJNb2R1bGUoIkNyZWF0ZU9yZGVyVXNlQ2FzZSIsIExheWVyOjpBUFBMSUNBVElPTik7DQogICAgZW5naW5lLnJlZ2lzdGVyTW9kdWxlKCJPcmRlckFnZ3JlZ2F0ZSIsIExheWVyOjpET01BSU4pOw0KICAgIGVuZ2luZS5yZWdpc3Rlck1vZHVsZSgiUG9zdGdyZXNPcmRlclJlcG9zaXRvcnkiLCBMYXllcjo6SU5GUkFTVFJVQ1RVUkUpOw0KDQogICAgLy8gMi4gVGhp4bq/dCBs4bqtcCBjw6FjIHF1eSB04bqvYyBi4bqldCBiaeG6v24gY+G7p2Ega2nhur9uIHRyw7pjDQogICAgLy8gUXV5IHThuq9jOiBEb21haW4gTGF5ZXIgQ+G6pE0gdGnhu4d0IHBo4bulIHRodeG7mWMgdsOgbyBJbmZyYXN0cnVjdHVyZSBob+G6t2MgUHJlc2VudGF0aW9uDQogICAgZW5naW5lLmFkZFJ1bGUoTGF5ZXI6OkRPTUFJTiwgTGF5ZXI6OklORlJBU1RSVUNUVVJFLCBmYWxzZSwgIkRvbWFpbiBtdXN0IG5vdCBkZXBlbmQgb24gSW5mcmFzdHJ1Y3R1cmUgKERJUCkiKTsNCiAgICBlbmdpbmUuYWRkUnVsZShMYXllcjo6RE9NQUlOLCBMYXllcjo6UFJFU0VOVEFUSU9OLCBmYWxzZSwgIkRvbWFpbiBtdXN0IG5vdCBrbm93IGFib3V0IFByZXNlbnRhdGlvbiIpOw0KICAgIC8vIFF1eSB04bqvYzogUHJlc2VudGF0aW9uIEPhuqRNIGfhu41pIHRo4bqzbmcgdsOgbyBJbmZyYXN0cnVjdHVyZSAoQ2xvc2VkIExheWVyaW5nKQ0KICAgIGVuZ2luZS5hZGRSdWxlKExheWVyOjpQUkVTRU5UQVRJT04sIExheWVyOjpJTkZSQVNUUlVDVFVSRSwgZmFsc2UsICJQcmVzZW50YXRpb24gbXVzdCBub3QgYnlwYXNzIEFwcGxpY2F0aW9uIGxheWVyIik7DQoNCiAgICAvLyAzLiBHaGkgbmjhuq1uIGPDoWMgcXVhbiBo4buHIHBo4bulIHRodeG7mWMgdGjhu7FjIHThur8gdHJvbmcgbcOjIG5ndeG7k24NCiAgICBlbmdpbmUucmVjb3JkRGVwZW5kZW5jeSgiT3JkZXJDb250cm9sbGVyIiwgIkNyZWF0ZU9yZGVyVXNlQ2FzZSIpOyAgICAgICAvLyBI4bujcCBs4buHDQogICAgZW5naW5lLnJlY29yZERlcGVuZGVuY3koIkNyZWF0ZU9yZGVyVXNlQ2FzZSIsICJPcmRlckFnZ3JlZ2F0ZSIpOyAgICAgICAgLy8gSOG7o3AgbOG7hw0KICAgIGVuZ2luZS5yZWNvcmREZXBlbmRlbmN5KCJQb3N0Z3Jlc09yZGVyUmVwb3NpdG9yeSIsICJPcmRlckFnZ3JlZ2F0ZSIpOyAgIC8vIEjhu6NwIGzhu4cgKERJUCkNCg0KICAgIC8vIEPhu5EgdMOsbmggZ2hpIG5o4bqtbiAxIHZpIHBo4bqhbSBraeG6v24gdHLDumM6IERvbWFpbiBn4buNaSB0aOG6s25nIERhdGFiYXNlIQ0KICAgIHN0ZDo6Y291dCA8PCAiXG4tLS0gU2NlbmFyaW8gMTogQ2xlYW4gQXJjaGl0ZWN0dXJlIFZlcmlmaWNhdGlvbiAtLS1cbiI7DQogICAgZW5naW5lLmV2YWx1YXRlQ29tcGxpYW5jZSgpOw0KDQogICAgc3RkOjpjb3V0IDw8ICJcbi0tLSBTY2VuYXJpbyAyOiBJbmplY3RpbmcgTWFsaWNpb3VzIEFyY2hpdGVjdHVyYWwgRHJpZnQgLS0tXG4iOw0KICAgIGVuZ2luZS5yZWNvcmREZXBlbmRlbmN5KCJPcmRlckFnZ3JlZ2F0ZSIsICJQb3N0Z3Jlc09yZGVyUmVwb3NpdG9yeSIpOyAgIC8vIFZJIFBI4bqgTSENCiAgICBib29sIHJlc3VsdCA9IGVuZ2luZS5ldmFsdWF0ZUNvbXBsaWFuY2UoKTsNCg0KICAgIGlmICghcmVzdWx0KSB7DQogICAgICAgIHN0ZDo6Y291dCA8PCAiXG5bQ0kvQ0QgUXVhbGl0eSBHYXRlIFJlc3VsdF06IOKdjCBCVUlMRCBGQUlMRUQhIEJsb2NraW5nIFB1bGwgUmVxdWVzdC5cbiI7DQogICAgfQ0KDQogICAgcmV0dXJuIDA7DQp9DQpgYGANCg0KIyMjIyBUZXJtaW5hbCBPdXRwdXQgTeG6q3UgKEMrKzIwKToNCmBgYHRleHQNCj09PSBDKysyMCBBdXRvbWF0ZWQgQXJjaGl0ZWN0dXJlIEZpdG5lc3MgUnVsZSBWZXJpZmllciA9PT0NCg0KLS0tIFNjZW5hcmlvIDE6IENsZWFuIEFyY2hpdGVjdHVyZSBWZXJpZmljYXRpb24gLS0tDQpbQXJjaGl0ZWN0dXJlIEZpdG5lc3MgRXZhbHVhdGlvbiBTdGFydGVkXQ0KICDinIUgQUxMIEFSQ0hJVEVDVFVSQUwgRklUTkVTUyBGVU5DVElPTlMgUEFTU0VEISBaZXJvIGRyaWZ0IGRldGVjdGVkLg0KDQotLS0gU2NlbmFyaW8gMjogSW5qZWN0aW5nIE1hbGljaW91cyBBcmNoaXRlY3R1cmFsIERyaWZ0IC0tLQ0KW0FyY2hpdGVjdHVyZSBGaXRuZXNzIEV2YWx1YXRpb24gU3RhcnRlZF0NCiAg4p2MIEFSQ0hJVEVDVFVSQUwgRFJJRlQgREVURUNURUQ6IE1vZHVsZSAnT3JkZXJBZ2dyZWdhdGUnIChEb21haW4pIGRlcGVuZHMgb24gJ1Bvc3RncmVzT3JkZXJSZXBvc2l0b3J5JyAoSW5mcmFzdHJ1Y3R1cmUpIQ0KICAgICBSdWxlIFZpb2xhdGVkOiBEb21haW4gbXVzdCBub3QgZGVwZW5kIG9uIEluZnJhc3RydWN0dXJlIChESVApDQoNCltDSS9DRCBRdWFsaXR5IEdhdGUgUmVzdWx0XTog4p2MIEJVSUxEIEZBSUxFRCEgQmxvY2tpbmcgUHVsbCBSZXF1ZXN0Lg0KYGBgDQoNCi0tLQ0KDQojIyMgMy4yLiBQeXRob24gMy4xMSsgSW1wbGVtZW50YXRpb246IEdpdCBDSSBBRFIgVmFsaWRhdG9yICYgTWFya2Rvd24gQ29tcGxpYW5jZSBDaGVja2VyDQpTY3JpcHQgUHl0aG9uIDMuMTErIGTGsOG7m2kgxJHDonkgxJHDs25nIHZhaSB0csOyIG3hu5l0IEdpdCBQcmUtY29tbWl0IEhvb2sgaG/hurdjIENJL0NEIEFjdGlvbiDEkeG7gyB04buxIMSR4buZbmcgdGjhuqltIMSR4buLbmggdMOtbmggaOG7o3AgbOG7hyBj4bunYSBjw6FjIGZpbGUgQXJjaGl0ZWN0dXJlIERlY2lzaW9uIFJlY29yZCAoQURSKSwgxJHhuqNtIGLhuqNvIGPDoWMgdHLGsOG7nW5nIGLhuq90IGJ14buZYyAoU3RhdHVzLCBDb250ZXh0LCBEZWNpc2lvbiwgQ29uc2VxdWVuY2VzKSBraMO0bmcgYuG7iyBi4buPIHRy4buRbmcuDQoNCmBgYHB5dGhvbg0KZnJvbSBfX2Z1dHVyZV9fIGltcG9ydCBhbm5vdGF0aW9ucw0KaW1wb3J0IHJlDQpmcm9tIHBhdGhsaWIgaW1wb3J0IFBhdGgNCmZyb20gZGF0YWNsYXNzZXMgaW1wb3J0IGRhdGFjbGFzcw0KDQpAZGF0YWNsYXNzDQpjbGFzcyBBRFJWYWxpZGF0aW9uUmVzdWx0Og0KICAgIGlzX3ZhbGlkOiBib29sDQogICAgZXJyb3JzOiBsaXN0W3N0cl0NCiAgICBzdGF0dXM6IHN0ciA9ICIiDQoNCmNsYXNzIEFEUlZhbGlkYXRvcjoNCiAgICBSRVFVSVJFRF9TRUNUSU9OUyA9IFsiYuG7kWkgY+G6o25oIiwgInF1eeG6v3QgxJHhu4tuaCIsICJo4buHIHF14bqjIl0NCiAgICBWQUxJRF9TVEFUVVNFUyA9IHsiUFJPUE9TRUQiLCAiQUNDRVBURUQiLCAiUkVKRUNURUQiLCAiU1VQRVJTRURFRCJ9DQoNCiAgICBAY2xhc3NtZXRob2QNCiAgICBkZWYgdmFsaWRhdGVfY29udGVudChjbHMsIGNvbnRlbnQ6IHN0cikgLT4gQURSVmFsaWRhdGlvblJlc3VsdDoNCiAgICAgICAgZXJyb3JzID0gW10NCiAgICAgICAgbG93ZXJfY29udGVudCA9IGNvbnRlbnQubG93ZXIoKQ0KDQogICAgICAgICMgMS4gS2nhu4NtIHRyYSBUacOqdSDEkeG7gSBIMQ0KICAgICAgICB0aXRsZV9tYXRjaCA9IHJlLnNlYXJjaChyIl4jXHMrQURSLVxkKzpccysoLispJCIsIGNvbnRlbnQsIHJlLk1VTFRJTElORSkNCiAgICAgICAgaWYgbm90IHRpdGxlX21hdGNoOg0KICAgICAgICAgICAgZXJyb3JzLmFwcGVuZCgiTWlzc2luZyBvciBtYWxmb3JtZWQgSDEgdGl0bGUuIFJlcXVpcmVkIGZvcm1hdDogJyMgQURSLVhYWDogVGl0bGUnIikNCg0KICAgICAgICAjIDIuIEtp4buDbSB0cmEgVHLhuqFuZyB0aMOhaSAoU3RhdHVzKQ0KICAgICAgICBzdGF0dXNfbWF0Y2ggPSByZS5zZWFyY2gociJcKlxzK1Ry4bqhbmcgdGjDoWlccypcKjpccyooW0EtWl0rKSIsIGNvbnRlbnQsIHJlLklHTk9SRUNBU0UpDQogICAgICAgIHN0YXR1cyA9ICIiDQogICAgICAgIGlmIHN0YXR1c19tYXRjaDoNCiAgICAgICAgICAgIHN0YXR1cyA9IHN0YXR1c19tYXRjaC5ncm91cCgxKS51cHBlcigpDQogICAgICAgICAgICBpZiBzdGF0dXMgbm90IGluIGNscy5WQUxJRF9TVEFUVVNFUzoNCiAgICAgICAgICAgICAgICBlcnJvcnMuYXBwZW5kKGYiSW52YWxpZCBzdGF0dXMgJ3tzdGF0dXN9Jy4gTXVzdCBiZSBvbmUgb2Y6IHtjbHMuVkFMSURfU1RBVFVTRVN9IikNCiAgICAgICAgZWxzZToNCiAgICAgICAgICAgIGVycm9ycy5hcHBlbmQoIk1pc3NpbmcgU3RhdHVzIG1ldGFkYXRhIGxpbmU6ICcqIFRy4bqhbmcgdGjDoWkqOiBBQ0NFUFRFRCciKQ0KDQogICAgICAgICMgMy4gS2nhu4NtIHRyYSBjw6FjIFNlY3Rpb24gYuG6r3QgYnXhu5ljDQogICAgICAgIGZvciBzZWMgaW4gY2xzLlJFUVVJUkVEX1NFQ1RJT05TOg0KICAgICAgICAgICAgaWYgZiIjIyB7c2VjfSIgbm90IGluIGxvd2VyX2NvbnRlbnQ6DQogICAgICAgICAgICAgICAgZXJyb3JzLmFwcGVuZChmIk1pc3NpbmcgbWFuZGF0b3J5IHNlY3Rpb24gaGVhZGVyOiAnIyMge3NlYy5jYXBpdGFsaXplKCl9JyIpDQoNCiAgICAgICAgIyA0LiBLaeG7g20gdHJhIMSR4buZIGTDoGkgbuG7mWkgZHVuZyAoVHLDoW5oIHZp4buHYyB2aeG6v3Qgc3R1YiBy4buXbmcpDQogICAgICAgIGlmIGxlbihjb250ZW50LnN0cmlwKCkuc3BsaXRsaW5lcygpKSA8IDE1Og0KICAgICAgICAgICAgZXJyb3JzLmFwcGVuZCgiQURSIGNvbnRlbnQgaXMgdG9vIGJyaWVmICg8IDE1IGxpbmVzKS4gUGxlYXNlIHByb3ZpZGUgZGV0YWlsZWQgdHJhZGUtb2ZmIGFuYWx5c2lzLiIpDQoNCiAgICAgICAgcmV0dXJuIEFEUlZhbGlkYXRpb25SZXN1bHQoaXNfdmFsaWQ9KGxlbihlcnJvcnMpID09IDApLCBlcnJvcnM9ZXJyb3JzLCBzdGF0dXM9c3RhdHVzKQ0KDQoNCmlmIF9fbmFtZV9fID09ICJfX21haW5fXyI6DQogICAgcHJpbnQoIj09PSBQeXRob24gMy4xMSsgQ0kvQ0QgQXJjaGl0ZWN0dXJlIERlY2lzaW9uIFJlY29yZCAoQURSKSBMaW50ZXIgPT09IikNCg0KICAgICMgVGVzdCAxOiBUw6BpIGxp4buHdSBBRFIgY2h14bqpbiBt4buxYw0KICAgIHZhbGlkX2Fkcl9tYXJrZG93biA9ICIiIg0KIyBBRFItMDE1OiBT4butIGThu6VuZyBQb3N0Z3JlU1FMIHRoYXkgY2hvIE1vbmdvREIgY2hvIFPhu5UgQ8OhaSBL4bq/IFRvw6FuDQoNCiogKipUcuG6oW5nIHRow6FpKio6IEFDQ0VQVEVEDQoqICoqTmfGsOG7nWkgxJHhu4EgeHXhuqV0Kio6IFN0YWZmIFNvZnR3YXJlIEVuZ2luZWVyDQoqICoqTmfDoHkgZHV54buHdCoqOiAyMDI2LTExLTE1DQoNCiMjIELhu5FpIGPhuqNuaCAoQ29udGV4dCkNCkjhu4cgdGjhu5FuZyBr4bq/IHRvw6FuIHnDqnUgY+G6p3UgdMOtbmggdG/DoG4gduG6uW4gZ2lhbyBk4buLY2ggQUNJRCB0dXnhu4d0IMSR4buRaS4gxJDhu5lpIG5nxakgxJFhbmcgZ+G6t3AgduG6pW4gxJHhu4EgbeG6pXQgdMOtbmggbmjhuqV0IHF1w6FuIGtoaSBsxrB1IHRy4buvIGThu68gbGnhu4d1IHTDoGkgY2jDrW5oIHRyw6puIE1vbmdvREIuDQoNCiMjIFF1eeG6v3QgxJHhu4tuaCAoRGVjaXNpb24pDQpDaMO6bmcgdMO0aSBxdXnhur90IMSR4buLbmggZGkgY2h1eeG7g24gdG/DoG4gYuG7mSBk4buvIGxp4buHdSBz4buVIGPDoWkgc2FuZyBQb3N0Z3JlU1FMLCDDoXAgZOG7pW5nIG3hu6ljIGPDtCBs4bqtcCBnaWFvIGThu4tjaCBTZXJpYWxpemFibGUgSXNvbGF0aW9uLg0KDQojIyBI4buHIHF14bqjIChDb25zZXF1ZW5jZXMpDQotICoqVMOtY2ggY+G7sWMqKjogQuG6o28gdG/DoG4gdMOtbmggxJHDum5nIMSR4bqvbiBj4bunYSB0aeG7gW4gdOG7hywgbmfEg24gbmfhu6thIGNoaSB0acOqdSBrw6lwLg0KLSAqKlRpw6p1IGPhu7FjKio6IFZp4buHYyBt4bufIHLhu5luZyBnaGkgbmdhbmcgKFNoYXJkaW5nKSBz4bq9IHBo4bupYyB04bqhcCBoxqFuIE1vbmdvREI7IGPhuqduIGPhuqV1IHRyw7pjIGzhuqFpIGLhuqNuZyBk4buvIGxp4buHdS4NCiIiIg0KDQogICAgcmVzMSA9IEFEUlZhbGlkYXRvci52YWxpZGF0ZV9jb250ZW50KHZhbGlkX2Fkcl9tYXJrZG93bikNCiAgICBwcmludChmIlxuW0V2YWx1YXRpbmcgVmFsaWQgQURSLTAxNV06IFN0YXR1cz0ne3JlczEuc3RhdHVzfSciKQ0KICAgIGlmIHJlczEuaXNfdmFsaWQ6DQogICAgICAgIHByaW50KCIgIOKchSBBRFIgVmFsaWRhdGlvbjogUEFTU0VEISBIaWdoIHF1YWxpdHkgYXJjaGl0ZWN0dXJhbCBkb2N1bWVudC4iKQ0KDQogICAgIyBUZXN0IDI6IFTDoGkgbGnhu4d1IEFEUiBj4bqpdSB0aOG6oywgdGhp4bq/dSBjw6FjIHBo4bqnbiBj4buRdCBsw7VpDQogICAgY29ycnVwdF9hZHJfbWFya2Rvd24gPSAiIiINCiMgQmFkIEFEUjogQ2hhbmdlIHNvbWUgREINCkp1c3QgZGVjaWRlZCB0byB1c2UgUmVkaXMgYmVjYXVzZSBpdCBpcyB2ZXJ5IGZhc3QuDQoiIiINCiAgICByZXMyID0gQURSVmFsaWRhdG9yLnZhbGlkYXRlX2NvbnRlbnQoY29ycnVwdF9hZHJfbWFya2Rvd24pDQogICAgcHJpbnQoZiJcbltFdmFsdWF0aW5nIE1hbGZvcm1lZCBBRFJdOiIpDQogICAgcHJpbnQoIiAg4p2MIEFEUiBWYWxpZGF0aW9uOiBGQUlMRUQgd2l0aCBmb2xsb3dpbmcgdmlvbGF0aW9uczoiKQ0KICAgIGZvciBlcnIgaW4gcmVzMi5lcnJvcnM6DQogICAgICAgIHByaW50KGYiICAgICAtIHtlcnJ9IikNCmBgYA0KDQojIyMjIFRlcm1pbmFsIE91dHB1dCBN4bqrdSAoUHl0aG9uIDMuMTErKToNCmBgYHRleHQNCj09PSBQeXRob24gMy4xMSsgQ0kvQ0QgQXJjaGl0ZWN0dXJlIERlY2lzaW9uIFJlY29yZCAoQURSKSBMaW50ZXIgPT09DQoNCltFdmFsdWF0aW5nIFZhbGlkIEFEUi0wMTVdOiBTdGF0dXM9J0FDQ0VQVEVEJw0KICDinIUgQURSIFZhbGlkYXRpb246IFBBU1NFRCEgSGlnaCBxdWFsaXR5IGFyY2hpdGVjdHVyYWwgZG9jdW1lbnQuDQoNCltFdmFsdWF0aW5nIE1hbGZvcm1lZCBBRFJdOg0KICDinYwgQURSIFZhbGlkYXRpb246IEZBSUxFRCB3aXRoIGZvbGxvd2luZyB2aW9sYXRpb25zOg0KICAgICAtIE1pc3Npbmcgb3IgbWFsZm9ybWVkIEgxIHRpdGxlLiBSZXF1aXJlZCBmb3JtYXQ6ICcjIEFEUi1YWFg6IFRpdGxlJw0KICAgICAtIE1pc3NpbmcgU3RhdHVzIG1ldGFkYXRhIGxpbmU6ICcqIFRy4bqhbmcgdGjDoWkqOiBBQ0NFUFRFRCcNCiAgICAgLSBNaXNzaW5nIG1hbmRhdG9yeSBzZWN0aW9uIGhlYWRlcjogJyMjIELhu5FpIGPhuqNuaCcNCiAgICAgLSBNaXNzaW5nIG1hbmRhdG9yeSBzZWN0aW9uIGhlYWRlcjogJyMjIFF1eeG6v3QgxJHhu4tuaCcNCiAgICAgLSBNaXNzaW5nIG1hbmRhdG9yeSBzZWN0aW9uIGhlYWRlcjogJyMjIEjhu4cgcXXhuqMnDQogICAgIC0gQURSIGNvbnRlbnQgaXMgdG9vIGJyaWVmICg8IDE1IGxpbmVzKS4gUGxlYXNlIHByb3ZpZGUgZGV0YWlsZWQgdHJhZGUtb2ZmIGFuYWx5c2lzLg0KYGBgDQoNCi0tLQ0KDQojIyA0LiBTeXN0ZW1zIEVuZ2luZWVyaW5nICYgUHJvZHVjdGlvbiBQaXRmYWxscw0KDQojIyMgQ8OhYyBD4bqhbSBC4bqreSBUaOG7sWMgQ2hp4bq/biAoR290Y2hhcyAmIFByb2R1Y3Rpb24gQW50aXBhdHRlcm5zKQ0KDQoxLiAqKkPEg24gQuG7h25oIFTDoGkgTGnhu4d1IFZp4bq/dCBYb25nIFLhu5NpIFF1w6puIChXcml0ZS1hbmQtRm9yZ2V0IFN0YWxlIERvY3MpKio6DQogICAtICpC4bqjbiBjaOG6pXQqOiBUcm9uZyB0deG6p24gxJHhuqd1IHRpw6puIHRow6BuaCBs4bqtcCBk4buxIMOhbiwgY8OhYyBr4bu5IHPGsCB24bq9IG7Dqm4gbmjhu69uZyBzxqEgxJHhu5MgaG/DoG5oIHRyw6FuZyB0csOqbiBDb25mbHVlbmNlIGhv4bq3YyBNaXJvLiBTw6F1IHRow6FuZyBzYXUsIG3DoyBuZ3Xhu5NuIMSRw6MgdGhheSDEkeG7lWkgaG/DoG4gdG/DoG4gbmjGsG5nIHTDoGkgbGnhu4d1IGtow7RuZyDEkcaw4bujYyBj4bqtcCBuaOG6rXQsIGJp4bq/biB0w6BpIGxp4buHdSB0aMOgbmggY8OhaSBi4bqreSBuZ3V5IGhp4buDbSBjaG8gY8OhYyBs4bqtcCB0csOsbmggdmnDqm4gbeG7m2kgZ2lhIG5o4bqtcC4NCiAgIC0gKkto4bqvYyBwaOG7pWMqOiBUcmnhu4d0IMSR4buDIHR1w6JuIHRoZW8gKipEb2NzLWFzLUNvZGUqKi4gVMOgaSBsaeG7h3UgcGjhuqNpIG7hurFtIGPDuW5nIEdpdCByZXBvIHbhu5tpIGNvZGU7IG3hu5l0IFBSIHRoYXkgxJHhu5VpIGtp4bq/biB0csO6YyBtw6Aga2jDtG5nIGPhuq1wIG5o4bqtdCBBRFIvQzQgRGlhZ3JhbSBz4bq9IGLhu4sgY2jhurduIG1lcmdlIQ0KDQoyLiAqKkPhuqFtIELhuqt5IEM0IExldmVsIDQgR8OieSBQaMOsbmggVG8gVMOgaSBMaeG7h3UgKExldmVsIDQgRGlhZ3JhbSBCbG9hdCkqKjoNCiAgIC0gKkLhuqNuIGNo4bqldCo6IEzhuq1wIHRyw6xuaCB2acOqbiBj4buRIGfhuq9uZyB24bq9IGNoaSB0aeG6v3Qgc8ahIMSR4buTIGzhu5twIChDbGFzcyBEaWFncmFtcykgY2hvIHThu6tuZyBjb21wb25lbnQgdHJvbmcgaOG7hyB0aOG7kW5nLiBDaOG7iSBzYXUgMSBs4bqnbiByZWZhY3RvciwgaMOgbmcgdHLEg20gc8ahIMSR4buTIG7DoHkgbOG6rXAgdOG7qWMgYuG7iyBzYWkgbOG7h2NoLg0KICAgLSAqS2jhuq9jIHBo4bulYyo6IEThu6tuZyBs4bqhaSDhu58gKipMZXZlbCAyIChDb250YWluZXJzKSoqIHbDoCAqKkxldmVsIDMgKENvbXBvbmVudHMpKiouIMSQ4buRaSB24bubaSBMZXZlbCA0LCBjaOG7iSBz4butIGThu6VuZyBjw6FjIGPDtG5nIGPhu6UgdOG7sSDEkeG7mW5nIHNpbmggdOG7qyBjb2RlIChuaMawIGBqYXZhZG9jYCwgYGRveHlnZW5gLCBgbWVybWFpZC1qcyBBU1QgZ2VuZXJhdG9yc2ApIGtoaSB0aOG7sWMgc+G7sSBj4bqnbi4NCg0KMy4gKipI4buZaSBDaOG7qW5nIFTDqiBMaeG7h3QgVsOsIFF1eeG6v3QgxJDhu4tuaCAoQURSIFBhcmFseXNpcykqKjoNCiAgIC0gKkLhuqNuIGNo4bqldCo6IMSQ4buZaSBuZ8WpIMSRw7JpIGjhu49pIHBo4bqjaSB2aeG6v3QgQURSIGNobyBj4bqjIG5o4buvbmcgdmnhu4djIG5o4buPIG5o4bq3dCAobmjGsCDEkeG7lWkgdMOqbiBt4buZdCBiaeG6v24sIGNo4buNbiB0aMawIHZp4buHbiBmb3JtYXQgbmfDoHkgdGjDoW5nKS4gVmnhu4djIG7DoHkgbMOgbSBjaOG6rW0gdOG7kWMgxJHhu5kgcGjDoXQgdHJp4buDbiB2w6AgYmnhur9uIHF1eSB0csOsbmgga+G7uSB0aHXhuq10IHRow6BuaCB0aOG7pyB04bulYyBow6BuaCBjaMOtbmggcXVhbiBsacOqdS4NCiAgIC0gKkto4bqvYyBwaOG7pWMqOiBDaOG7iSB2aeG6v3QgQURSIGNobyBuaOG7r25nIHF1eeG6v3QgxJHhu4tuaCB0aOG7sWMgc+G7sSAqKiJxdWFuIHRy4buNbmcsIGtow7MgxJHhuqNvIG5nxrDhu6NjIHbDoCB04buRbiBrw6ltIioqICh2w60gZOG7pTogVGhheSDEkeG7lWkgRGF0YWJhc2UsIGdpYW8gdGjhu6ljIHRydXnhu4FuIHRow7RuZywgaG/hurdjIGPGoSBjaOG6vyB4w6FjIHRo4buxYyBuZ8aw4budaSBkw7luZykuDQoNCjQuICoqS+G7uSBUaHXhuq10IENo4bqpbiDEkG/DoW4gJiBHacOhbSBTw6F0IFTDoGkgTGnhu4d1IELhurFuZyBDTEkqKjoNCiAgIGBgYGJhc2gNCiAgICMgMS4gVOG7sSDEkeG7mW5nIHNpbmggc8ahIMSR4buTIEM0IE1vZGVsIHNhbmcgZmlsZSDhuqNuaCBQTkcgdOG7qyBtw6Mgbmd14buTbiBTdHJ1Y3R1cml6ciBEU0wNCiAgIHN0cnVjdHVyaXpyLWNsaSBleHBvcnQgLXcgd29ya3NwYWNlLmRzbCAtZiBtZXJtYWlkDQoNCiAgICMgMi4gUXXDqXQga2nhu4NtIHRyYSBjw6FjIGxpw6puIGvhur90IGjhu49uZyAoQnJva2VuIExpbmtzKSB0cm9uZyB0aMawIG3hu6VjIHTDoGkgbGnhu4d1IERvY3MtYXMtQ29kZQ0KICAgbWFya2Rvd24tbGluay1jaGVjayBkb2NzLyoqLyoubWQNCg0KICAgIyAzLiBU4bqhbyBiw6FvIGPDoW8gZGFuaCBt4bulYyBjw6FjIEFEUiBoaeG7h24gY8OzIHRyb25nIGThu7Egw6FuIGLhurFuZyBjw7RuZyBj4bulIGFkci10b29scw0KICAgYWRyIGdlbmVyYXRlIHRvYyA+IGRvY3MvYWRyL1JFQURNRS5tZA0KICAgYGBgDQoNCi0tLQ0KDQojIyA1LiBC4bqjbmcgU28gc8OhbmggJiBEZWNpc2lvbiBNYXRyaXgNCg0KIyMjIDUuMS4gU28gU8OhbmggQ8OhYyBLaHVuZyBUw6BpIExp4buHdSBIw7NhIEtp4bq/biBUcsO6YyAoQXJjaGl0ZWN0dXJlIEZyYW1ld29ya3MpDQoNCnwgVGnDqnUgQ2jDrSB8IEM0IE1vZGVsIChTaW1vbiBCcm93bikgfCA0KzEgVmlldyBNb2RlbCAoS3J1Y2h0ZW4pIHwgVU1MIENodeG6qW4gQ+G7lSDEkGnhu4NuIHwNCnwgOi0tLSB8IDotLS0gfCA6LS0tIHwgOi0tLSB8DQp8ICoqxJDhu5kgUGjhu6ljIFThuqFwIEjhu41jIFThuq1wKip8IEPhu7FjIHRo4bqlcCAoQ2jhu4kgY+G6p24gMzAgcGjDunQpIHwgVHJ1bmcgYsOsbmggfCBS4bqldCBjYW8gKEjDoG5nIHRyxINtIGvDvSBoaeG7h3Uga2jhuq90IGtoZSkgfA0KfCAqKlTDrW5oIFRy4buxYyBRdWFuKiogfCBS4bqldCBjYW8gKFTGsMahbmcgdOG7sSBHb29nbGUgTWFwcykgfCBS4bqldCBjYW8gKFRoZW8gZ8OzYyBuaMOsbiDEkeG7kWkgdMaw4bujbmcpIHwgVGjhuqVwIMSR4buRaSB24bubaSBuZ8aw4budaSBwaGkga+G7uSB0aHXhuq10IHwNCnwgKipI4buXIFRy4bujIERvY3MtYXMtQ29kZSoqIHwgSG/DoG4gaOG6o28gKE1lcm1haWQsIFN0cnVjdHVyaXpyKSB8IFThu5F0IChNYXJrZG93biwgUGxhbnRVTUwpIHwgS8OpbSAoQ+G6p24gY8O0bmcgY+G7pSB24bq9IGNodXnDqm4gYmnhu4d0IG7hurduZyBu4buBKSB8DQp8ICoqVHLhu41uZyBUw6JtKiogfCBD4bqldSB0csO6YyBwaMOibiBj4bqlcCB0aMOgbmggcGjhuqduIHwgxJBhIGNoaeG7gXUgKExvZ2ljLCBUaeG6v24gdHLDrG5oLCBW4bqtdCBsw70pIHwgQ2hpIHRp4bq/dCBjw7ogcGjDoXAgaMaw4bubbmcgxJHhu5FpIHTGsOG7o25nIHwNCnwgKipLaHV54bq/biBOZ2jhu4sgw4FwIEThu6VuZyoqIHwgKipUacOqdSBjaHXhuqluIHPhu5EgMSBjaG8gOTUlIGThu7Egw6FuIGhp4buHbiDEkeG6oWkqKnwgROG7sSDDoW4gRW50ZXJwcmlzZSBxdXkgbcO0IGzhu5tuLCBwaOG7qWMgdOG6oXAgfCBDw6FjIHRodeG6rXQgdG/DoW4ga2hvYSBo4buNYyBtw6F5IHTDrW5oIMSR4bq3YyB0aMO5IHwNCg0KIyMjIDUuMi4gTWEgVHLhuq1uIFBow6JuIMSQ4buLbmggQ8OhYyBMb+G6oWkgVMOgaSBMaeG7h3UgS+G7uSBUaHXhuq10DQoNCnwgTG/huqFpIFTDoGkgTGnhu4d1IHwgTeG7pWMgxJDDrWNoIFRy4buNbmcgVMOibSB8IFbDsm5nIMSQ4budaSAmIFTDrW5oIOG7lG4gxJDhu4tuaCB8IMSQ4buRaSBUxrDhu6NuZyDEkOG7jWMgQ2jDrW5oIHwNCnwgOi0tLSB8IDotLS0gfCA6LS0tIHwgOi0tLSB8DQp8ICoqUkZDIChSZXF1ZXN0IGZvciBDb21tZW50cykqKiB8IMSQ4buBIHh14bqldCBnaeG6o2kgcGjDoXAgdsOgIHRodSB0aOG6rXAgcGjhuqNuIGJp4buHbiB8IFThuqFtIHRo4budaSAoQuG7iyDEkcOzbmcgc2F1IGtoaSB0aOG7kW5nIG5o4bqldCkgfCBUb8OgbiBi4buZIGvhu7kgc8awIHRyb25nIHRlYW0gfA0KfCAqKkRlc2lnbiBEb2MgKELhuqNuIFRoaeG6v3QgS+G6vykqKiB8IMSQ4bq3YyB04bqjIGNoaSB0aeG6v3QgdMOtbmggbsSDbmcgdHLGsOG7m2Mga2hpIGNvZGUgfCBUcnVuZyBo4bqhbiAoVGhlbyBjaHUga+G7syBj4bunYSBGZWF0dXJlKSB8IERldmVsb3BlcnMgdHLhu7FjIHRp4bq/cCBwaMOhdCB0cmnhu4NuIHwNCnwgKipBRFIgKEFyY2hpdGVjdHVyZSBEZWNpc2lvbiBSZWNvcmQpKip8ICoqVsSDbiBi4bqjbiBow7NhIGzDvSBkbyBjaOG7jW4gZ2nhuqNpIHBow6FwICYgVHJhZGUtb2ZmcyoqIHwgKipC4bqldCBiaeG6v24gdsSpbmggdmnhu4VuIChM4buLY2ggc+G7rSBk4buxIMOhbikqKiB8IFThuqV0IGPhuqMga+G7uSBzxrAgaGnhu4duIHThuqFpIHbDoCB0xrDGoW5nIGxhaSB8DQo=