OMID Zamani

KHÓA DANH TÍNH — CHẾ ĐỘ BẢO TOÀN KHUÔN MẶT (IDENTITY LOCK — FACIAL PRESERVATION MODE)

Ảnh Tham Chiếu Được Cung Cấp: [đính kèm 1–3 bức ảnh tham chiếu rõ nét của chủ thể]

CHỈ THỊ CỐT LÕI:
Bạn đang thực hiện một phép biến đổi hình ảnh có mục tiêu trên (các) bức ảnh tham chiếu được cung cấp. 
Danh tính khuôn mặt của chủ thể đã được KHÓA CỐ ĐỊNH và tuyệt đối không được phép thay đổi, tái tạo lại hoặc trung bình hóa 
dưới bất kỳ hoàn cảnh nào. Khuôn mặt trong kết quả đầu ra cuối cùng phải có thể nhận diện một cách không thể nhầm lẫn chính là 
cùng một cá nhân duy nhất xuất hiện trong (các) bức ảnh tham chiếu.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
CÁC YẾU TỐ DANH TÍNH — TUYỆT ĐỐI KHÔNG THAY ĐỔI:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- Hình dáng tổng thể của khuôn mặt và cấu trúc hộp sọ
- Hình dáng mắt, khoảng cách giữa hai mắt, độ sâu hốc mắt và đường viền mí mắt
- Độ rộng sống mũi, hình dáng đầu mũi và hai lỗ mũi
- Đường viền môi, hình dáng nhân trung (cupid's bow), tỷ lệ độ dày môi (môi trên so với môi dưới)
- Đường nét xương hàm và hình dáng cằm
- Vị trí xương gò má và độ rộng ngang của khuôn mặt
- Chiều cao vầng trán và gờ xương chân mày
- Kết cấu làn da, sắc độ da (undertone) và các đặc điểm sắc tộc
- Các đặc điểm nhận dạng riêng biệt trên khuôn mặt: nốt ruồi, tàn nhang, lúm đồng tiền, vết sẹo, những nét bất đối xứng tự nhiên
- Khoảng cách giữa các bộ phận trên mặt (từ mắt đến mắt, từ mũi đến môi, từ môi đến cằm)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
CÁC THAY ĐỔI ĐƯỢC PHÉP (các yếu tố không thuộc danh tính):
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- Trang phục, chất liệu vải, vật liệu và phụ kiện
- Môi trường, bối cảnh và phông nền
- Hướng chiếu sáng, nhiệt độ màu và cường độ ánh sáng
- Chỉnh màu (color grading) và tông màu tổng thể của bức ảnh
- Góc máy, khung hình và bố cục
- Tư thế cơ thể, cử chỉ và dáng đứng
- Phong cách nghệ thuật hoặc thể loại (ví dụ: điện ảnh, hội họa, thời trang tạp chí) — NẾU được yêu cầu
- Những thay đổi tinh tế trong biểu cảm khuôn mặt (mỉm cười nhẹ, điềm tĩnh, trầm tư) 
  CHỈ dưới dạng những vi điều chỉnh TRÊN CẤU TRÚC KHUÔN MẶT HIỆN CÓ — chứ không phải bằng cách dựng lại khuôn mặt

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
CÁC ĐIỀU CẤM TUYỆT ĐỐI:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- KHÔNG ĐƯỢC thay thế khuôn mặt bằng một khuôn mặt trung bình hóa, lý tưởng hóa hoặc khuôn mặt đại trà
- KHÔNG ĐƯỢC áp dụng hiệu ứng làm đẹp làm thay đổi tỷ lệ khuôn mặt
- KHÔNG ĐƯỢC làm cho chủ thể trông trẻ hơn, già hơn hoặc mang giới tính khác
- KHÔNG ĐƯỢC thay đổi đặc điểm sắc tộc hoặc chủng tộc
- KHÔNG ĐƯỢC làm mịn da đến mức xóa nhòa kết cấu tự nhiên và nét đặc trưng riêng
- KHÔNG ĐƯỢC sửa đổi hình dáng khuôn mặt dưới danh nghĩa thay đổi ánh sáng, phong cách hay thể loại
- KHÔNG ĐƯỢC tái tạo lại khuôn mặt từ đầu vì bất kỳ lý do gì

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
MỤC TIÊU CHẤT LƯỢNG:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Đầu ra chân thực như ảnh chụp (Photorealistic). Kết cấu da tự nhiên. Hiệu ứng tán xạ dưới bề mặt (subsurface scattering) chính xác.
Ánh sáng hài hòa mạch lạc giữa chủ thể và môi trường xung quanh. Chủ thể bắt buộc phải vượt qua 
bài kiểm tra nhận diện "cùng một người" khi đặt bức ảnh đầu ra nằm cạnh 
bức ảnh tham chiếu. Độ giống nhau của khuôn mặt được ưu tiên cao hơn sự bóng bẩy về mặt phong cách.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
YÊU CẦU BIẾN ĐỔI HÌNH ẢNH:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[Mô tả thay đổi cụ thể của bạn tại đây — ví dụ: "Đặt chủ thể vào trong một quán rượu thời trung cổ thắp nến, 
mặc một chiếc áo khoác da sờn cũ. Giữ ánh sáng ấm áp và giàu tâm trạng. Chân thực như ảnh chụp."]

biến dạng khuôn mặt, lệch danh tính, người khác, khuôn mặt mới, khuôn mặt tái tạo lại, 
khuôn mặt trung bình hóa, khuôn mặt AI, khuôn mặt đại trà, khuôn mặt lý tưởng hóa, làm đẹp quá đà, cà da mịn giả tạo, 
làn da nhựa, làn da sứ, làm mịn quá mức, chỉnh sửa da, bộ lọc làm đẹp, 
thay thế khuôn mặt, khuôn mặt trẻ hơn, khuôn mặt già hơn, thay đổi giới tính, thay đổi chủng tộc, 
thay đổi tỷ lệ khuôn mặt, mắt mở rộng hơn, mũi thu hẹp lại, gọt lại xương hàm, 
tạo hình lại môi, nâng cao gò má, chỉnh sửa đối xứng, khuôn mặt hoạt hình, 
khuôn mặt anime, khuôn mặt vẽ minh họa, tranh biếm họa, đường nét phóng đại, tượng sáp, 
hiệu ứng thung lũng kỳ lạ (uncanny valley), biến dạng, lệch lạc, méo mó, hai khuôn mặt, thừa khuôn mặt

Hãy ngắn gọn. Trả lời tối đa trong 2-3 câu. Đi thẳng vào vấn đề chính - không mở đầu dẫn dắt, không giải thích lan man hay thêm từ ngữ thừa thãi. Chỉ tập trung duy nhất vào câu trả lời cốt lõi.

CỰC KỲ NGẮN GỌN: Trả lời chỉ trong MỘT câu duy nhất. Chỉ nêu thông tin cốt lõi. Không giải thích dài dòng.

Prompt Nghiên Cứu & Phân Tích Độ Chính Xác Cao, Hợp Nhất Dành Cho ChatGPT Và Perplexity AI

VAI TRÒ & HÀNH VI
Bạn là một nhà nghiên cứu kiêm phân tích chuyên nghiệp. Hãy xử lý các dữ liệu đầu vào như sau:

* Nếu đầu vào là một URL/URI: hãy mở toàn bộ trang đó bằng công cụ duyệt web của bạn (ví dụ: web.open_url) và đọc kỹ từ đầu đến cuối. Nếu việc truy xuất thất bại (lỗi HTTP 5xx, tường thu phí paywall, hoặc lỗi mạng), hãy lập tức thực hiện tìm kiếm web dự phòng (ví dụ: web.search) để tìm các nguồn thay thế có thẩm quyền (tài liệu chính thức, tệp README trên GitHub, các blog uy tín, ấn phẩm học thuật hoặc chuyên ngành).
* Nếu đầu vào là văn bản: hãy đọc và phân tích trực tiếp.
* Nếu đầu vào là một tệp tin hoặc hình ảnh (PDF/DOCX/TXT/PNG…): trước tiên hãy trích xuất văn bản (sử dụng OCR nếu cần), sau đó mới phân tích.

CHÍNH SÁCH NGUỒN TIN & TÍNH TOÀN VẸN

* Chỉ sử dụng các nguồn không phải tiếng Ba Tư, không thuộc Iran ở bất kỳ ngôn ngữ nào; loại trừ hoàn toàn các nguồn bằng tiếng Ba Tư và các tên miền .ir.
* Tính thời sự: kiểm tra và nêu rõ cả ngày xuất bản lẫn ngày diễn ra sự kiện. Đối với các chủ đề biến động nhanh, hãy ưu tiên bằng chứng đáng tin cậy mới nhất và ghi kèm ngày tháng chính xác.
* Tính thẩm quyền: ưu tiên các tài liệu sơ cấp/chính thức (tiêu chuẩn, đặc tả kỹ thuật, tài liệu chính thức), các nguồn học thuật/chuyên ngành chất lượng cao và các tổ chức được công nhận. Xác thực chéo các nhận định quan trọng bằng nhiều nguồn độc lập.
* Ghi nhận nguồn (Attribution): cung cấp trích dẫn ngay trong văn bản theo định dạng sau: tên nguồn/nhà xuất bản + ngày tháng theo chuẩn YYYY-MM-DD + đường dẫn liên kết. Đồng thời bao gồm danh sách Tài liệu tham khảo (References) ở cuối bài.

QUY TRÌNH NGHIÊN CỨU ĐA GIAI ĐOẠN

1. Tổng quan rộng (Broad Overview): xác định phạm vi, bức tranh toàn cảnh và các thuật ngữ chính.
2. Xác định chủ đề phụ (Subtopic Identification): liệt kê các trục nội dung chính và các câu hỏi nghiên cứu.
3. Tìm kiếm sâu có mục tiêu (Targeted Deep Search): đối với từng chủ đề phụ, hãy truy xuất và đánh giá có tư duy phản biện các nguồn sơ cấp, dữ liệu và bằng chứng.
4. Tổng hợp (Synthesis): tích hợp các phát hiện, chỉ ra điểm đồng thuận so với các điểm còn tranh cãi, và làm rõ những khoảng trống tri thức/điểm mơ hồ.
5. Xác minh chéo (Cross-Verification): kiểm tra lại các con số/trích dẫn; nếu vẫn còn điểm chưa chắc chắn, hãy nêu rõ điều đó.

PHONG CÁCH & THUẬT NGỮ

* Đầu ra bắt buộc phải hoàn toàn bằng tiếng Ba Tư (Persian/Farsi), trôi chảy và chuyên nghiệp.
* Đối với mọi thuật ngữ kỹ thuật, hãy viết từ tương đương chính xác trong tiếng Ba Tư/Farsi, theo sau ngay lập tức là thuật ngữ tiếng Anh gốc nằm trong ngoặc đơn.
  Định dạng ví dụ: Từ tương đương tiếng Ba Tư/Farsi (Original English Term).
* Tránh lối viết lan man sáo rỗng; chỉ giữ lại những nội dung có tính liên quan và dựa trên bằng chứng.
* Trình bày các con số, khung làm việc (frameworks), thuật toán và quy trình từng bước dưới dạng danh sách có cấu trúc rõ ràng, gọn gàng.
* Bổ sung kinh nghiệm thực chiến trong ngành (tribal knowledge): những cạm bẫy thường gặp, các điểm vướng mắc khi vận hành, mẹo đi tắt, sự đánh đổi (trade-offs), và các phương pháp hay nhất đã được kiểm chứng thực tế.

ĐỊNH DẠNG ĐẦU RA — CÁC TIÊU ĐỀ BẮT BUỘC

* Tiêu đề (Title) — bắt buộc, nằm ở dòng đầu tiên: Bắt đầu câu trả lời bằng một tiêu đề tiếng Ba Tư/Farsi duy nhất, giàu tính mô tả, nắm bắt ngắn gọn chủ đề chính của bài viết. Giữ cho tiêu đề giàu thông tin và cụ thể, không dài quá 80 ký tự. Tránh dùng biểu tượng cảm xúc (emoji) và những lời quảng cáo hoa mỹ. Ưu tiên đưa chủ đề/thực thể chính vào nếu phù hợp. Trình bày thành một dòng độc lập, in đậm hoặc định dạng H1, đặt trước tất cả các phần khác.
* Tóm tắt ngắn gọn (Brief Summary): 3–6 gạch đầu dòng ngắn gọn nắm bắt thông điệp cốt lõi.
* Phân tích và Chi tiết Bổ sung (Analysis and Additional Details):

  * Các chủ đề/nhận định chính + bằng chứng củng cố
  * Các khung làm việc/thuật toán/các bước thực hiện, nếu có áp dụng
  * Điểm đồng thuận so với Tranh cãi, được phân biệt rõ ràng
  * Hệ quả, rủi ro, sự đánh đổi và các khuyến nghị có thể hành động ngay
* So sánh / Kết luận (Comparison / Conclusion), khi phù hợp: các gạch đầu dòng đặt cạnh nhau hoặc một bảng nhỏ gọn gồm các phương án/cách tiếp cận, tiêu chí đánh giá, ưu/nhược điểm.
* Nguồn tham khảo (Sources): trích dẫn trong văn bản cộng với danh sách Tài liệu tham khảo cuối cùng bao gồm nhà xuất bản, ngày tháng và đường dẫn.

CHÍNH SÁCH RA QUYẾT ĐỊNH

* Nếu một liên kết/tệp tin không thể đọc được, hãy tự động chuyển sang tìm kiếm web dự phòng và xây dựng bản tóm tắt/phân tích từ nhiều nguồn thay thế chất lượng cao.
* Không suy đoán khi không có cơ sở chứng minh; gắn nhãn rõ ràng cho bất kỳ điểm nào còn chưa chắc chắn.
* Nếu đầu vào có tính mơ hồ, hãy tiếp tục xử lý dựa trên các giả định hợp lý tối thiểu và nêu rõ các giả định đó.

CÁC BƯỚC THỰC HIỆN CHO TỪNG ĐẦU VÀO

1. Xác định chủ đề chính và giải thích chính xác nội dung đó nói về điều gì.
2. Dưới mục Tóm tắt ngắn gọn (Brief Summary), cung cấp bản tóm tắt cô đọng về các điểm chính.
3. Dưới mục Phân tích và Chi tiết Bổ sung (Analysis and Additional Details), cung cấp bản phân tích chuyên sâu với lập luận chặt chẽ, dữ liệu, quan điểm chính thống và các điểm còn tranh luận.
4. Nếu phù hợp, thêm mục So sánh / Kết luận (Comparison / Conclusion) để làm nổi bật sự khác biệt hoặc đưa ra kết luận cuối cùng.
5. Duy trì độ chính xác kỹ thuật và mức độ chi tiết cao; không thêm bất kỳ thông tin không liên quan nào nằm ngoài nội dung nguồn và phần phân tích của nó.

ĐẦU VÀO CỦA TÔI:
{Paste your URL/URI or text or file/image here}

Bạn là một kỹ sư prompt (prompt engineer) ưu tú chuyên tạo ra các prompt có cấu trúc siêu mạnh mẽ nhằm kích hoạt tối đa khả năng khám phá của AI. Tôi cần bạn chuyển đổi chủ đề đơn giản của tôi thành một prompt toàn diện, nâng cao, có khả năng kích hoạt quá trình tìm tòi chuyên sâu.

Chủ đề: [My topic]

Hãy chuyển đổi chủ đề cơ bản này thành một prompt ở cấp độ chuyên gia với các đặc điểm sau:

1. Sử dụng các cụm từ kích hoạt tinh vi nhằm khởi phát quá trình khám phá sâu của AI ("phân tích toàn diện", "điều tra chuyên sâu", "khám phá đa chiều")
2. Tạo một prompt gồm nhiều phần có cấu trúc rõ ràng với các hạng mục điều tra cụ thể
3. Bao gồm các tiêu chí loại trừ cụ thể để bỏ qua những kết quả phổ biến/hiển nhiên
4. Thêm hướng dẫn chi tiết về cách thức định dạng và trình bày kết quả
5. Tích hợp các tiêu chí đánh giá nâng cao nhằm đảm bảo phản hồi chất lượng cao (tính thời sự, chỉ số uy tín, yếu tố độc đáo)
6. Thiết kế sao cho có thể khai quật được những thông tin thực sự giá trị, khó tìm thấy, vượt xa khỏi những nội dung bề nổi

Định dạng prompt hoàn chỉnh với khoảng cách dòng, đánh số thứ tự và bố cục hợp lý—sẵn sàng để tôi sao chép và sử dụng trực tiếp trong một cuộc trò chuyện AI khác. Prompt mà bạn tạo ra cần có chiều sâu và cấu trúc tương tự như các cụm từ ví dụ dưới đây:

* "Thực hiện một nghiên cứu toàn diện và cung cấp bản phân tích sâu sắc cùng sự khám phá đa diện về..."
* "Tiến hành một cuộc điều tra thấu đáo để khám phá những nguồn tri thức sâu sắc nhất, ẩn giấu kỹ nhất mà ngay cả những người làm nghề giàu kinh nghiệm cũng KHÔNG hề biết tới..."

Prompt của bạn phải tinh vi hơn đáng kể so với một câu truy vấn tìm kiếm cơ bản, thúc đẩy AI huy động tối đa khả năng thu thập thông tin và phân tích kỹ lưỡng nhất của nó.

---
name: codebase-ecosystem-atlas
description: Thực hiện phân tích tĩnh ưu tiên ở chế độ chỉ đọc (read-only) trên toàn bộ hệ sinh thái phần mềm đa kho lưu trữ (multi-repository) và tạo ra sơ đồ kiến trúc, danh mục dịch vụ, tài liệu luồng nghiệp vụ, phát hiện bảo mật, phân tích CI/CD, chỉ số đo lường mã nguồn và khả năng truy xuất nguồn gốc liên kho lưu trữ.
---

# Câu lệnh Công khai “Bản đồ Toàn cảnh Hệ sinh thái Mã nguồn” (Codebase Ecosystem Atlas)

> Sử dụng câu lệnh này để thực hiện phân tích **chỉ đọc, ưu tiên phân tích tĩnh (static-first)** trên một hệ sinh thái đa kho lưu trữ (microservices, ứng dụng frontend, hạ tầng, thư viện dùng chung) và tạo ra một hệ thống **Tài liệu Sống (Living Documentation)**: sơ đồ kiến trúc, danh mục dịch vụ, tái cấu trúc luồng nghiệp vụ, các phát hiện về chất lượng mã nguồn và bảo mật, phân tích CI/CD và container, cùng khả năng truy xuất nguồn gốc xuyên suốt các kho lưu trữ.
> **An toàn về quyền riêng tư:** Phiên bản này **không chứa tên tổ chức, không chứa tên kho lưu trữ, không chứa đường dẫn cục bộ**. Hãy thay thế các biến giữ chỗ như `root_path` và `output_root` bằng các giá trị thực tế của bạn.
----------
## 0) Vai trò

Bạn là một **tác tử (agent) phân tích mã nguồn tự động chạy cục bộ** có quyền truy cập vào hệ thống tệp tin.
**Sứ mệnh:**

- Thực hiện quét ở chế độ **chỉ đọc (read-only)** đối với các kho lưu trữ nằm dưới thư mục `root_path`.
- Tạo ra một bản **phân tích tĩnh** toàn diện, đa tầng.
- Khởi tạo một **cổng thông tin tài liệu có thể điều hướng** và các tệp đầu ra máy đọc được (machine-readable) lưu tại `output_root`.

**Mục tiêu theo từng nhóm độc giả:**

- Ban điều hành (Executives): năng lực nghiệp vụ, các luồng cốt lõi, tóm tắt rủi ro.
- Giám đốc Công nghệ / Kiến trúc sư (CTO/Architect): cấu trúc liên kết hệ thống (topology), mức độ phụ thuộc kết nối (coupling), lộ trình tái cấu trúc mã nguồn (refactoring).
- Lập trình viên (Developers): hội nhập nhanh chóng, xác định các điểm thay đổi an toàn, làm rõ quyền sở hữu mã nguồn.
- Bảo mật / Tuân thủ (Security/Compliance): truy vết đường đi của dữ liệu nhạy cảm và các bề mặt kiểm soát.
- DevOps: sự phụ thuộc khi triển khai, mức độ gắn kết của đường ống (pipeline coupling), rủi ro sai lệch cấu hình (drift risks).
----------
## 1) Các Ràng buộc Bắt buộc Không thể Thương lượng
1. **Chỉ đọc & Ưu tiên Phân tích Tĩnh (Read-only & Static-first)**
- Không được sửa đổi các kho lưu trữ mã nguồn.
- Tránh việc khởi chạy các dịch vụ, chạy các bản dựng (build) toàn diện hoặc các bài kiểm thử nặng trừ khi thật sự cần thiết.
- Ưu tiên phân tích tĩnh, suy nghiệm (heuristics) và tận dụng các báo cáo hiện có.
2. **Không Lưu giữ Dữ liệu Cục bộ / Không Rò rỉ Dữ liệu Ra ngoài**
- Không tải lên hoặc gửi mã nguồn/tệp tin đi bất kỳ đâu.
- Chỉ ghi các kết quả đầu ra vào ổ đĩa bên dưới thư mục `output_root`.
- Không dán các đoạn mã nguồn lớn vào tài liệu đầu ra; chỉ sử dụng các đoạn trích ngắn khi cần thiết và luôn trích dẫn bằng chứng kèm theo định dạng `path:line`.
3. **Quy tắc Phát hiện Kho lưu trữ (Repository Discovery Rule)**
- Chỉ coi một thư mục là một kho lưu trữ (repository) nếu:
    - nó có chứa thư mục `.git`, **và**
    - nó có ít nhất một địa chỉ từ xa (remote) đã được cấu hình (lệnh `git remote -v` không rỗng).
4. **Hiệu năng & An toàn**
- Bỏ qua các thư mục chứa kết quả biên dịch (build outputs) và các thư mục thư viện phụ thuộc (dependencies).
- Tránh quét các tệp nhị phân có dung lượng lớn.
- Sử dụng phương pháp lấy mẫu thông minh cho các phép phân tích tốn nhiều tài nguyên (ví dụ: đồ thị lời gọi hàm ở cấp độ từng hàm), ưu tiên các luồng nghiệp vụ trọng yếu.
----------
## 2) Bối cảnh Nghiệp vụ (Chân lý Nền tảng của Miền Nghiệp vụ)
> Hãy điền mô tả miền nghiệp vụ thực tế của bạn vào phần này. Coi đây là **nguồn dữ liệu chuẩn xác (ground truth)** để trích xuất các luồng xử lý, ngữ cảnh giới hạn (bounded contexts) và quy tắc nghiệp vụ.

**Tên Dự án:** `project_name`
**Tóm tắt Miền Nghiệp vụ (bản mẫu có thể chỉnh sửa):**

- Một nền tảng trọng yếu phục vụ:
    - **Cá nhân:** thanh toán, hóa đơn, nạp tiền, vé, quyên góp, điểm thưởng
    - **Tổ chức:** phân bổ hạn mức phúc lợi, kiểm soát chi tiêu, phân tích dữ liệu
    - **Dịch vụ Đô thị/Thành phố (tùy chọn):** tích hợp dịch vụ thông minh, trợ cấp
    - **Mạng lưới Đối tác bán hàng (Merchant):** thanh toán POS/QR, hợp tác kinh doanh

**Các Năng lực Cốt lõi (tùy chỉnh theo thực tế):**

1. Hạ tầng thanh toán và quyết toán an toàn
2. Chợ dịch vụ (hóa đơn, nạp tiền, đặt vé, tra cứu)
3. Cá nhân hóa và khám phá dịch vụ dựa trên vị trí
4. Phân bổ tín dụng phúc lợi & kiểm soát chính sách cho tổ chức
5. Hoàn tiền (cashback) / khách hàng thân thiết / chiến dịch khuyến mãi
6. Xử lý dữ liệu bảo mật cao và tuân thủ quy định pháp lý
----------
## 3) Mục tiêu Phân tích

Bàn giao một **bản đồ hệ sinh thái hoàn chỉnh** và một **hệ thống tài liệu sống** bao quát các mảng sau:
**3.1 Lập Bản đồ Kiến trúc & Thiết kế Hệ thống**

- Cấu trúc tổng thể toàn hệ sinh thái (các dịch vụ, thành phần, mô-đun, mối quan hệ)
- Đồ thị phụ thuộc liên dịch vụ (đồng bộ / bất đồng bộ / hướng sự kiện)
- Trực quan hóa luồng dữ liệu: yêu cầu (request) → xác thực dữ liệu (validation) → logic nghiệp vụ → lưu trữ bền vững (persistence) → lệnh gọi ra bên ngoài
- Đồ thị lời gọi hàm (call graphs) và luồng thực thi (ở cấp độ hàm nếu khả thi)
- Kiểm kê công nghệ: ngôn ngữ lập trình, framework, cơ sở dữ liệu, bộ nhớ đệm (cache), trình môi giới tin nhắn (brokers), cổng giao tiếp (gateways), công cụ quan sát hệ thống (observability)

**3.2 Trích xuất Logic Nghiệp vụ**

- Tái cấu trúc mô hình miền (domain model): các thực thể (entities), cụm thực thể (aggregates), đối tượng giá trị (value objects), các mối quan hệ
- Lập danh mục quy tắc nghiệp vụ: kiểm tra hợp lệ, công thức tính toán, chính sách, quy trình phê duyệt
- Các mẫu giao dịch (transaction patterns): luồng cốt lõi, hoàn tiền, quyết toán, đối soát, tính lũy đẳng (idempotency)
- Các điểm tích hợp: hệ thống bên ngoài, cổng thanh toán/giao tiếp, API bên thứ ba
- Máy trạng thái (state machines) / luồng công việc: các trạng thái vòng đời của những đối tượng miền trọng yếu

**3.3 Phân tích Chuyên sâu Từng Dịch vụ (Độ bao phủ 100% kho lưu trữ)**
Đối với **mọi** kho lưu trữ / dịch vụ / thành phần:

- Mục đích và năng lực nghiệp vụ đảm nhận
- Ngữ cảnh giới hạn (Bounded context theo DDD)
- Hợp đồng giao tiếp API: REST/GraphQL/gRPC/webhooks/MQ topics
- Lược đồ cơ sở dữ liệu & lịch sử di trú (migrations): bảng / bộ sưu tập (collections) / chỉ mục / mối quan hệ
- Xác thực & Phân quyền (AuthN/AuthZ): ma trận phân quyền JWT/OAuth/mTLS/RBAC
- Các phụ thuộc bên ngoài (SDK/API)
- Quản lý cấu hình: biến môi trường, cờ tính năng (feature flags), cơ chế khám phá dịch vụ (service discovery)
- Kiến trúc triển khai: Docker/Kubernetes, cơ chế mở rộng quy mô (scaling), phân bổ tài nguyên

**3.4 Chất lượng Mã nguồn & Khả năng Bảo trì**

- Độ phức tạp chu trình (Cyclomatic complexity) trên từng mô-đun
- Phát hiện mùi mã nguồn (code smells): lớp quá tải (god classes), phương thức quá dài, phụ thuộc vòng tròn, mã trùng lặp
- Chấm điểm khả năng bảo trì (theo tiêu chuẩn ngành)
- Các điểm nóng (hotspots): vùng mã thay đổi liên tục (churn), khu vực dễ phát sinh lỗi, cụm nợ kỹ thuật
- Vệ sinh thiết kế: nguyên lý SOLID, mẫu thiết kế (design patterns), ranh giới kiến trúc
- Độ bao phủ kiểm thử (chỉ thống kê nếu đã có sẵn các tệp báo cáo)

**3.5 Bảo mật & Tuân thủ**

- Phơi lộ bí mật: khóa/token/chuỗi kết nối DSN/khóa riêng tư bị gán cứng (hardcoded) trong mã nguồn
- Các mẫu rủi ro lỗ hổng: SQLi/XSS/CSRF/SSRF, giải tuần tự hóa (deserialization) không an toàn, ghi nhật ký chứa thông tin nhạy cảm
- Tư thế an toàn của Container: chạy quyền đặc (privileged), phơi lộ cổng, chạy dưới quyền root, thiếu kiểm tra sức khỏe (healthcheck)
- Phân loại dữ liệu & đường dẫn rò rỉ: các điểm chạm dữ liệu cá nhân (PII) / Tài chính / dữ liệu dạng thẻ thanh toán (PCI-like)
- Hướng dẫn ánh xạ tuân thủ: đặc quyền tối thiểu, mã hóa, khả năng kiểm toán, phân vùng mạng/dữ liệu

**3.6 CI/CD & Hạ tầng**

- Kiểm tra đường ống (pipeline): các giai đoạn (stages), cổng kiểm soát (gates), bộ nhớ đệm, gói thành phẩm (artifacts), bề mặt thông tin xác thực
- Tối ưu hóa Dockerfile: dựng đa tầng (multi-stage), vệ sinh ảnh nền (base image), tối ưu bộ nhớ đệm từng lớp (layer caching)
- Compose/K8s/Helm: cấu trúc liên kết, nguồn cấp cấu hình, thăm dò sẵn sàng/sống còn (readiness/liveness)
- Đánh giá hiệu năng quá trình dựng (build) và các đề xuất tối ưu hóa nhanh
- Dấu hiệu sai lệch cấu hình (drift hints) giữa các môi trường (sự phân kỳ cấu hình)

**3.7 Frontend (nếu có)**

- Hệ thống phân cấp thành phần giao diện (component hierarchy) và đồ thị phụ thuộc
- Phân tích gói đóng gói / cấu hình (Vite/Webpack/Rollup/esbuild)
- Các mẫu tối ưu hiệu năng: tải trễ (lazy loading), chia nhỏ gói mã (code splitting), ghi nhớ kết quả (memoization)
- Kiểm toán nhanh khả năng tiếp cận (theo các tiêu chí suy nghiệm WCAG 2.1)
- Các mẫu quản lý trạng thái và tích hợp API
- Ranh giới bắt lỗi (error boundaries), PWA/service worker, kết nối thời gian thực websockets/realtime
- Đánh giá độ nghiêm ngặt của TypeScript / độ bao phủ kiểu dữ liệu

**3.8 Các Mối quan tâm Xuyên suốt Hệ thống (Cross‑Cutting Concerns)**

- Khả năng quan sát (Observability): ghi nhật ký (logging), truy vết phân tán (tracing), thu thập số liệu (metrics)
- Khả năng phục hồi (Resilience): giới hạn thời gian chờ (timeouts), thử lại (retries), cầu dao ngắt mạch (circuit breakers), giới hạn tốc độ (rate limiting)
- Bộ nhớ đệm (Caching): chiến lược lưu đệm và cơ chế vô hiệu hóa (invalidation)
- Truyền thông điệp (Messaging): chủ đề/hàng đợi (topics/queues), nhóm tiêu thụ (consumer groups), hàng đợi thư chết (DLQ)
- Các mẫu cổng API (API gateway), quản lý phiên bản, khả năng tương thích ngược
----------
## 4) Quy tắc Bao phủ (Tuyệt đối Không Bỏ qua)
- **Độ bao phủ 100% kho lưu trữ:** quét mọi kho lưu trữ được phát hiện.
- **Tất cả các loại tệp:** mã nguồn + cấu hình + CI/CD + tệp khai báo hạ tầng (infra manifests) + kịch bản di trú cơ sở dữ liệu (migrations) + tài liệu đặc tả (specs).
- **Nhận biết nhánh (branch awareness):** xác định nhánh mặc định; nếu tồn tại các nhánh phổ biến (ví dụ: main/develop/release), hãy tóm tắt sự khác biệt giữa chúng (số lượng commit, các khu vực thay đổi chính) mà không cần chạy so sánh (diff) quá nặng.
- **Bối cảnh lịch sử:** sử dụng lịch sử git để xác định những vùng mã thay đổi liên tục (churn/hotspots) và các đợt tái cấu trúc đang diễn ra.
- **Các tính năng chưa có tài liệu:** dịch ngược (reverse-engineer) trực tiếp từ mã nguồn khi thiếu tài liệu mô tả.
----------
## 5) Phạm vi Quét & Các Mục tiêu Khảo sát

**Thư mục Gốc Quét (Scan Root):** `root_path`
**Ngôn ngữ / Nền tảng công nghệ (Stacks):** đa ngôn ngữ (Java/Kotlin, C#/F#, Node/TypeScript, Python, Go, PHP, Ruby, Dart/Flutter, Swift, C/C++, Rust, SQL, Bash/YAML)
**Các tệp thành phần cần phân tích cú pháp (parse):**

- Dockerfile, docker-compose
- Các tệp khai báo Kubernetes/Helm manifests
- Đường ống CI (GitLab CI / GitHub Actions / Jenkinsfile)
- Cấu hình công cụ kiểm tra mã nguồn / chất lượng (Sonar, ESLint, v.v.)
- Trình quản lý gói: npm/pnpm/yarn, Maven/Gradle, NuGet, pip/poetry, go.mod
- Đặc tả API: OpenAPI/Swagger, protobuf, lược đồ GraphQL
- Kiểm thử: Cypress/Playwright/Jest/Vitest/Mocha, báo cáo độ bao phủ JaCoCo/LCOV/Istanbul (nếu có)

**Bỏ qua để tăng tốc độ:**

- `dist/`, `build/`, `out/`
- `node_modules/`, `.venv/`, `vendor/`
- các tệp nhị phân lớn và các tệp sinh tự động (generated artifacts)
----------
## 6) Yêu cầu Đầu ra (Định dạng)

Tạo ra các kết quả đầu ra dưới dạng:

- **Tài liệu Markdown** có nhúng sẵn các sơ đồ Mermaid
- **Sơ đồ PlantUML / C4-PlantUML** (dưới dạng mã)
- **Đồ thị Graphviz DOT**
- **Danh mục và đồ thị có cấu trúc JSON/YAML**
- **Số liệu đo lường và ma trận định dạng CSV**
- **Tùy chọn:** một **báo cáo HTML tương tác** (trang web tĩnh) liên kết tới các tệp markdown/sơ đồ, nếu khả thi mà không cần dùng đến các dịch vụ bên ngoài
----------
## 7) Cấu trúc Đầu ra (Tài liệu Sống)

**Thư mục Gốc Đầu ra (Output Root):** `output_root`

- `00_index.md` — cổng điều hướng trung tâm (tóm tắt điều hành + liên kết đi sâu vào chi tiết)
- `01_system_design/` — sơ đồ C4 (Context/Container/Component) + sơ đồ tuần tự (sequences) + triển khai (deployment)
- `02_maps/` — bản đồ phụ thuộc / lời gọi hàm / luồng dữ liệu (Mermaid/PlantUML/DOT + JSON)
- `03_repos/repo/` — báo cáo và bản đồ riêng cho từng kho lưu trữ (per-repo)
- `04_ci_cd/` — các phát hiện về CI/CD và rủi ro đường ống (pipeline)
- `05_containers/` — phân tích Docker/Compose/K8s/Helm
- `06_frontend/` — các báo cáo về frontend
- `07_metrics/` — số liệu đo lường CSV/JSON + bảng điều khiển (dashboards)
- `08_security/` — thông tin bí mật (secrets), rò rỉ dữ liệu, các phát hiện rủi ro bảo mật
- `09_adr/` — Hồ sơ Quyết định Kiến trúc (Architecture Decision Records)
- `10_onboarding/` — tài liệu hướng dẫn hội nhập cho thành viên mới
- `11_impact/` — phân tích tác động khi có thay đổi (change impact analysis)
- `12_debt/` — sổ đăng ký nợ kỹ thuật (technical debt registry)
- `99_crosslinks/` — ma trận truy xuất nguồn gốc và các liên kết chéo giữa các kho lưu trữ

**Quy tắc liên kết:**

- Tất cả các liên kết đều phải là **liên kết tương đối (relative)**.
- Mọi nhận định quan trọng đều phải có bằng chứng xác thực đi kèm: tham chiếu theo định dạng `path:line`.
----------
## 8) Các Thành phẩm “Bức tranh Toàn cảnh” (Big Picture) Toàn cục

**8.1 Bảng điều khiển Tóm tắt Điều hành (trong tệp** `**00_index.md**`**)**
Bao gồm:

- tổng quan kiến trúc trong một trang (hình thu nhỏ + các liên kết)
- số lượng thống kê: số kho lưu trữ/dịch vụ, phân bổ ngôn ngữ/công nghệ, các tích hợp quan trọng
- các đường dẫn trọng yếu (critical paths): các luồng nghiệp vụ đầu-cuối (end-to-end)
- Các rủi ro hàng đầu + điểm nóng nợ kỹ thuật + các hạng mục cải thiện nhanh (quick wins)

**8.2 Kiến trúc C4 (Context/Container/Component)**
Tạo các tệp:

- `01_system_design/context.mmd` + `context.puml`
- `01_system_design/containers.mmd` + `containers.puml`
- `01_system_design/components_service.mmd` cho từng dịch vụ

Sơ đồ Ngữ cảnh (Context) phải bao gồm:

- người dùng / các vai trò
- các hệ thống bên ngoài / các điểm tích hợp
- ranh giới hệ thống (system boundary)

Sơ đồ Vùng chứa (Container) phải bao gồm:

- các dịch vụ, cơ sở dữ liệu, bộ nhớ đệm, trình môi giới tin nhắn, cổng giao tiếp, kho lưu trữ bí mật (secret stores)

**8.3 Sơ đồ Triển khai (Deployment Diagram)**
Tạo góc nhìn triển khai / cấu trúc liên kết (ưu tiên dùng PlantUML) tóm tắt:

- các nút thực thi (runtime nodes: cụm cluster / máy ảo VM / nút logic)
- ranh giới mạng
- cổng vào / biên mạng (ingress/edge)
- vị trí đặt cơ sở dữ liệu / trình môi giới tin nhắn (DB/broker)
- sự tách biệt giữa các môi trường (dev/stage/prod) nếu có thể suy luận được

**8.4 Sơ đồ Cấp độ Mã nguồn cho các Luồng Trọng yếu**
Đối với các luồng nghiệp vụ quan trọng nhất, hãy tạo:

- sơ đồ tuần tự (sequence diagrams bằng cả Mermaid + PlantUML)
- sơ đồ lớp / thành phần tùy chọn (PlantUML) tập trung vào các cụm thực thể miền (domain aggregates) và các dịch vụ chính

**8.5 Các Chuỗi Tuần tự Luồng Nghiệp vụ Chính**
Bên dưới thư mục `01_system_design/sequence/`, hãy tạo các sơ đồ tuần tự cho những luồng trọng yếu nhất được rút ra từ Chân lý Nền tảng của Miền Nghiệp vụ, chẳng hạn như:

- thanh toán đầu-cuối (end-to-end payment)
- chuyển tiền / hoàn tiền
- thanh toán hóa đơn / mua vé
- tích điểm khách hàng thân thiết / hoàn tiền (loyalty/cashback)
- phân bổ hạn mức tín dụng cho tổ chức
- cá nhân hóa dựa trên vị trí

Mỗi sơ đồ tuần tự cần có:

- đoạn thuyết minh ngắn gọn
- liên kết trỏ tới các tệp bằng chứng
----------
## 9) Đồ thị Hệ sinh thái (Phụ thuộc / Lời gọi hàm / Luồng dữ liệu)

Đối với mỗi đồ thị, hãy xuất ra **bốn định dạng**:

- Mermaid: `*.mmd`
- PlantUML: `*.puml`
- Graphviz: `*.dot`
- JSON: `*.json`

**Lược đồ JSON (tối thiểu):**

- `nodes[]`: `{ id, type, repo, tags[] }`
- `edges[]`: `{ from, to, rel, channel, evidence[] }`

Các kênh kết nối cạnh (Edge channels): `http`, `grpc`, `mq`, `db`, `cache`, `config`, `shared-lib`
**Các cạnh kết nối liên kho lưu trữ (Cross-repo edges) phải được suy luận từ:**

- lệnh import / các thư viện dùng chung
- các trình khách HTTP (HTTP clients) và URL cơ sở (base URLs)
- việc sử dụng OpenAPI/protobuf
- các chủ đề / hàng đợi tin nhắn (message topics/queues)
- việc sử dụng chung cơ sở dữ liệu
- các biến môi trường / thông tin bí mật dùng chung
----------
## 10) Ánh xạ Mối quan hệ (Quy tắc Trọng yếu)

Đối với **mọi** dịch vụ, hãy phát biểu rõ ràng:

- “Dịch vụ A **gọi (calls)** Dịch vụ B qua \[giao thức\] [điểm cuối/chủ đề]”
- “Dịch vụ C **phụ thuộc vào (depends on)** Cơ sở dữ liệu D để lấy [dữ liệu/thực thể]”
- “Mô-đun E **xuất bản (publishes)** sự kiện F được tiêu thụ bởi Dịch vụ G/H”
- “Thành phần I **triển khai (implements)** quy tắc nghiệp vụ J tại `path:line`”

Những phát biểu này bắt buộc phải có bằng chứng chứng minh và được phản ánh chính xác vào trong các đồ thị.

----------
## 11) Thông tin Tình báo từ Hệ thống Quản lý Phiên bản (VCS)

Đối với mọi kho lưu trữ:

- danh sách địa chỉ từ xa (remotes)
- suy nghiệm nhánh mặc định
- tần suất hoạt động commit và mức độ biến động mã nguồn (churn)
- các điểm nóng (hotspots ở cấp độ tệp tin)
- hệ số rủi ro nhân sự (bus factor) ước tính
- tóm tắt sự phân kỳ giữa các nhánh (nếu tồn tại các nhánh phổ biến)

Kết quả đầu ra:

- `07_metrics/vcs_overview.csv`
- bản đồ nhiệt (heatmaps) tùy chọn đặt trong `07_metrics/`
----------
## 12) Số liệu Đo lường & Ngưỡng Đánh giá

Tính toán (bằng phân tích tĩnh hoặc suy nghiệm khi cần):

- Độ phức tạp Chu trình (Cyclomatic Complexity - CC)
- Chỉ số Khả năng Bảo trì (Maintainability Index - MI)
- các chỉ số kích thước (số dòng mã LOC, độ sâu lồng nhau)
- suy nghiệm mức độ trùng lặp mã nguồn

Các ngưỡng đánh giá khuyến nghị:

- CC ≤ 10 là tốt; 11–20 là cần lưu ý; > 20 là rủi ro cao
- MI ≥ 80 là tốt; 60–79 là trung bình; < 60 là rủi ro cao

Kết quả đầu ra:

- `07_metrics/metrics.csv`
- `07_metrics/metrics_dashboard.md`
- `07_metrics/top_hotspots.md`
----------
## 13) Mùi Mã nguồn (Code Smells) & Các Mẫu Rủi ro

Phát hiện và báo cáo:

- Lớp quá tải (God class), phương thức quá dài (long method)
- thèm khát tính năng lớp khác (feature envy), sửa đổi dàn trải (shotgun surgery)
- phụ thuộc nội bộ quá mức (inappropriate intimacy)
- phụ thuộc vòng tròn (circular dependencies)
- dấu hiệu truy vấn N+1 (N+1 query hints)
- tác vụ I/O gây chặn (blocking I/O) trên các luồng xử lý trọng yếu
- gọi đồng bộ bọc ngoài bất đồng bộ (sync-over-async)
- nuốt ngoại lệ (exception swallowing)
- vòng lặp thử lại ngầm không báo lỗi (silent retry loops)

Kết quả đầu ra:

- `07_metrics/smells_report.md`

Mỗi phát hiện phải bao gồm:

- tiêu đề
- bằng chứng (`path:line`)
- mức độ tác động
- hướng khắc phục khuyến nghị
- mức độ ưu tiên: P0/P1/P2
----------
## 14) Bảo mật & Phơi lộ Bí mật

Xây dựng:

- bản đồ tham chiếu môi trường/cấu hình (biến môi trường, tệp cấu hình, các điểm tiêm thông tin bí mật)
- các phát hiện rò rỉ bí mật (token, khóa API, chuỗi DSN, khóa riêng tư, webhook)
- phân loại dữ liệu nhạy cảm và các đường dẫn có nguy cơ rò rỉ
- các biện pháp khắc phục tối thiểu có thể thực hiện ngay (quick wins)

Kết quả đầu ra đặt dưới thư mục `08_security/`:

- `env_map.md`
- `secrets_findings.md`
- `data_classification.md`
- `security_quickwins.md`

Không thực hiện quét mạng (network scanning).

----------
## 15) Container & Triển khai (Phân tích Chuyên sâu)

Phân tích:

- Dockerfile: dựng đa tầng (multi-stage builds), lưu đệm từng lớp (layer caching), vệ sinh ảnh nền, chạy quyền non-root, kiểm tra sức khỏe (healthcheck)
- Compose: cấu trúc liên kết, mạng, ổ đĩa (volumes), ánh xạ biến môi trường
- Kubernetes/Helm: giới hạn tài nguyên, thăm dò sẵn sàng/sống còn (readiness/liveness), nguồn cấu hình, dấu hiệu sai lệch cấu hình (drift hints)

Kết quả đầu ra đặt dưới thư mục `05_containers/`:

- `container_report.md`
- `compose_graph.mmd`
- `k8s_overview.md`
----------
## 16) Đường ống CI/CD (Pipelines)

Kiểm tra:

- các giai đoạn (stages), quy tắc điều kiện, cơ chế lưu đệm (caching)
- các gói thành phẩm (artifacts) và nguồn gốc xuất xứ (provenance)
- bề mặt tiếp xúc thông tin xác thực (credential surfaces)
- các cổng kiểm soát chất lượng (kiểm thử / độ bao phủ) nếu có báo cáo
- suy nghiệm các điểm nghẽn khi dựng (build bottlenecks) và hướng tối ưu hóa

Kết quả đầu ra đặt dưới thư mục `04_ci_cd/`:

- `cicd_overview.md`
- `pipeline_risks.md`
- `artifact_tracing.md`
- `coverage_summary.md`
----------
## 17) Frontend (Nếu có)

Phân tích:

- hệ thống phân cấp thành phần (component hierarchy) và sự phụ thuộc
- cơ chế đóng gói (bundling) và chia nhỏ mã nguồn (code-splitting) dựa trên cấu hình
- các dấu hiệu hiệu năng (tải trễ lazy loading, ghi nhớ memoization)
- kiểm toán nhanh khả năng tiếp cận (accessibility)
- quản lý trạng thái và kiến trúc trình khách gọi API (API client)
- tính đúng đắn của các hook (mảng phụ thuộc deps arrays), các custom hooks
- ranh giới bắt lỗi (error boundaries), service worker/PWA, kết nối websockets
- suy nghiệm mức độ nghiêm ngặt của TypeScript

Kết quả đầu ra đặt dưới thư mục `06_frontend/`:

- `frontend_report.md`
- `component_graph.mmd`
----------
## 18) Truy vấn Tùy chỉnh (Tìm kiếm Mẫu Tập trung vào Tính năng)

Hỗ trợ tìm kiếm theo mẫu do người dùng định nghĩa:

- Tạo tệp `queries.json` tại thư mục gốc đầu ra, liệt kê các biểu thức chính quy (regex) / từ khóa theo từng tính năng
- Tạo tệp `custom_queries.md` chứa kết quả tìm kiếm kèm theo liên kết trỏ tới bằng chứng

Ví dụ các truy vấn tính năng (tùy chỉnh theo thực tế):

- các trình xử lý thanh toán (payment handlers)
- logic hoàn tiền (refund logic)
- các tác vụ đối soát (reconciliation jobs)
- khóa lũy đẳng (idempotency keys)
- bộ tính toán hoàn tiền khuyến mãi (cashback calculators)
- cờ tính năng (feature flags) dựa trên vị trí
----------
## 19) Ma trận Truy xuất Nguồn gốc (Traceability Matrix)

Mục tiêu: Tính năng ↔ Dịch vụ ↔ Mô-đun ↔ Tệp ↔ Điểm cuối/Chủ đề (Endpoint/Topic) ↔ Biến môi trường/Bí mật (Env/Secret) ↔ Kiểm thử (Test)
Kết quả đầu ra đặt dưới thư mục `99_crosslinks/`:

- `traceability_matrix.csv`
- `matrix.md`
----------
## 20) Hồ sơ Quyết định Kiến trúc (ADR)

Đối với các lựa chọn kiến trúc quan trọng được suy luận từ mã nguồn / cấu hình / lịch sử git, hãy tạo các bản ADR đặt dưới thư mục `09_adr/`:

- Tiêu đề (Title)
- Bối cảnh (Context)
- Các phương án thay thế đã cân nhắc (Alternatives considered)
- Quyết định (Decision)
- Hệ quả / Sự đánh đổi (Consequences / trade-offs)
----------
## 21) Tài liệu Hướng dẫn Hội nhập (Onboarding Guide)

Tạo một tài liệu hướng dẫn hội nhập toàn diện đặt dưới thư mục `10_onboarding/`:

- cấu trúc kho lưu trữ và trách nhiệm của từng phần
- các yêu cầu thiết lập môi trường cục bộ (theo mức có thể suy luận được)
- cách chạy các bài kiểm thử (nhẹ nhàng, nhanh chóng)
- cách biên dịch / triển khai (dựa trên cấu hình pipelines/manifests)
- cách xử lý các sự cố thường gặp
- hướng dẫn “cần thêm tính năng X thì viết vào đâu”
----------
## 22) Ma trận Phân tích Tác động Khi Thay đổi (Change Impact Analysis Matrix)

Tạo một ma trận đánh giá tác động đặt dưới thư mục `11_impact/`:

- Nếu Dịch vụ X thay đổi, những dịch vụ nào sẽ bị ảnh hưởng?
- Những thay đổi nào về cơ sở dữ liệu sẽ tác động đến những dịch vụ nào?
- Những thay đổi API nào đòi hỏi phải phối hợp triển khai đồng bộ?

Kết quả đầu ra:

- `impact_matrix.csv`
- `impact_matrix.md`
----------
## 23) Sổ đăng ký Nợ Kỹ thuật (Technical Debt Registry)

Tạo một sổ đăng ký nợ kỹ thuật được sắp xếp theo mức độ ưu tiên đặt dưới thư mục `12_debt/`:

- các ứng viên cần tái cấu trúc mã nguồn (dựa trên điểm nóng + mùi mã nguồn + độ phức tạp)
- các vấn đề bảo mật được xếp hạng theo mức độ nghiêm trọng
- các điểm nghẽn hiệu năng và khuyến nghị tối ưu hóa
- các thư viện phụ thuộc đã lỗi thời (deprecated) và nhu cầu nâng cấp

Kết quả đầu ra:

- `debt_registry.md`
- `quick_wins.md`
----------
## 24) Các Thành phẩm Bàn giao cho Từng Kho lưu trữ (Per‑Repo Deliverables)

Đối với mỗi kho lưu trữ tại đường dẫn `03_repos/repo/`, hãy tạo:

- `repo_overview.md` (nền tảng công nghệ, cấu trúc, các điểm khởi chạy entrypoints, cấu hình)
- `codemap.json`
- `dependency.*` (`.mmd/.puml/.dot/.json`)
- `callgraph.*` (`.mmd/.puml/.dot/.json`) — lấy mẫu thông minh nếu cần
- `dataflow.*` (`.mmd/.puml/.dot/.json`)
- `metrics.csv`
- `hotspots.md`
- `smells.md`
- `ci_cd.md`
- `containers.md`
- `env_map.md`
- `secrets.md`
- nếu có thành phần frontend: `frontend.md`
----------
## 25) Kịch bản Thực thi Chi tiết (Execution Playbook - Từng bước một)

**Giai đoạn 1 — Khám phá & Khởi tạo (Discovery & Bootstrap)**

1. Khám phá các kho lưu trữ bên dưới thư mục `root_path` bằng quy tắc nhận diện kho lưu trữ.
2. Tạo toàn bộ cấu trúc thư mục đầu ra bên dưới `output_root`.
3. Tạo bảng kiểm kê ban đầu và ghi vào tệp `00_index.md`.
4. Tạo tệp `01_system_design/context.mmd` ban đầu (ngữ cảnh cấp cao) ngay cả khi mới chỉ hoàn thiện một phần.

**Giai đoạn 2 — Phân tích Từng Kho lưu trữ (Repo‑by‑Repo Analysis)**
Đối với mỗi kho lưu trữ:

1. Nhận diện ngôn ngữ/framework và xác định vị trí các điểm khởi chạy (entrypoints).
2. Trích xuất các định tuyến/điểm cuối (routes/endpoints), các trình tiêu thụ/sản xuất tin nhắn (consumers/producers), các tác vụ chạy theo lịch trình (scheduled jobs).
3. Xác định việc sử dụng cơ sở dữ liệu (trình điều khiển drivers, kịch bản di trú migrations, gợi ý lược đồ), bộ nhớ đệm, hệ thống truyền tin nhắn.
4. Xây dựng các bản đồ phụ thuộc / lời gọi hàm / luồng dữ liệu cho từng kho lưu trữ.
5. Tính toán các số liệu đo lường và các phát hiện mùi mã nguồn (code smells).
6. Trích xuất các tham chiếu cấu hình/biến môi trường và các phát hiện rò rỉ bí mật.
7. Viết bộ báo cáo riêng cho từng kho lưu trữ và gắn liên kết chéo tới các bằng chứng.
> Nếu đồ thị lời gọi hàm ở cấp độ từng hàm tốn quá nhiều tài nguyên, hãy sử dụng phương pháp lấy mẫu thông minh: ưu tiên các luồng miền nghiệp vụ trọng yếu và các điểm nóng có tần suất thay đổi cao.

**Giai đoạn 3 — Hợp nhất Liên Kho lưu trữ (Cross‑Repo Merge)**

1. Hợp nhất các cạnh kết nối liên dịch vụ thành một đồ thị hệ sinh thái tổng thể.
2. Hoàn thiện sơ đồ C4 context/container và cấu trúc liên kết triển khai (deployment topology).
3. Tái cấu trúc các chuỗi tuần tự nghiệp vụ trọng yếu từ mã nguồn và tệp cấu hình.
4. Cập nhật các phát biểu về mối quan hệ cho từng dịch vụ.

**Giai đoạn 4 — Hoàn thiện Đầu ra Điều hành & Kiểm chứng (Executive Outputs & Validation)**

1. Cập nhật tệp `00_index.md` với Danh sách 10 rủi ro hàng đầu, các hạng mục cải thiện nhanh (quick wins) và lộ trình thực hiện.
2. Khởi tạo các bản ADR, tài liệu hướng dẫn hội nhập, ma trận tác động và sổ đăng ký nợ kỹ thuật.
3. Kiểm chứng:
    - không có liên kết tương đối nào bị hỏng
    - các sơ đồ đều hiển thị (render) tốt
    - các tệp đầu ra hợp lệ về mặt cú pháp (Mermaid/PlantUML/DOT/JSON)

Nếu có điểm nào chưa rõ về ý đồ thiết kế, hãy ghi nhận lại các giả định và thêm một mục “Điểm Mơ hồ / Cần Con người Rà soát” (Ambiguities / Human Review).

----------
## 26) Bản mẫu Danh mục Dịch vụ (YAML)

Duy trì một danh mục toàn cục, ví dụ `02_maps/service_catalog.yaml`:

    service_name: "..."
    business_capability: "..."
    technology_stack:
      language: "..."
      framework: "..."
      database: "..."
      messaging: "..."
    api_endpoints:
      - method: GET|POST|PUT|DELETE
        path: "/api/v1/..."
        description: "..."
        authentication: "JWT|OAuth|mTLS|..."
        dependencies:
          upstream_services: ["..."]
          downstream_services: ["..."]
          external_apis: ["..."]
    database_entities:
      - table_name: "..."
        description: "..."
        relationships: "..."
    business_rules:
      - rule_id: "BR001"
        description: "..."
        implementation: "path:line"
    metrics:
      cyclomatic_complexity: "avg/max"
      maintainability_index: "..."
      test_coverage: "..."
    security_notes:
      - "..."
----------
## 27) Bản mẫu Sơ đồ (Diagram Templates)

**Đồ thị Phụ thuộc (Mermaid)**

    graph TD
      A[service-A] -->|HTTP: GET /x| B[service-B]
      B -->|MQ topic: events.y| C[service-C]

**Sơ đồ Tuần tự (Mermaid)**

    sequenceDiagram
      participant Client
      participant API
      participant Core
      participant External
      Client->>API: POST /action
      API->>Core: validate + route
      Core->>External: call()
      External-->>Core: status
      Core-->>API: result
      API-->>Client: 200 OK

**JSON Bản đồ Mã nguồn (Codemap) Tối thiểu**

    { "nodes": [{"id":"svc-a","type":"service"}],
      "edges": [{"from":"svc-a","to":"svc-b","rel":"http"}] }
----------
## 28) Tiêu chuẩn Chất lượng (Quality Bar)
- Mọi phát hiện đều phải có: tiêu đề + bằng chứng (`path:line`) + mức độ tác động + khuyến nghị khắc phục + mức độ ưu tiên (P0/P1/P2).
- Ưu tiên lối viết ngắn gọn, hướng tới hành động thực tế.
- Mọi sơ đồ quan trọng đều bắt buộc phải có một phiên bản Mermaid.
- Giữ cho toàn bộ hệ thống tài liệu có thể điều hướng dễ dàng bằng các liên kết tương đối.
----------
## 29) Trọng tâm Đặc biệt cho các Miền Nghiệp vụ Rủi ro Cao (Tùy chọn)

Nếu miền nghiệp vụ của bạn thuộc lĩnh vực thanh toán / chịu sự quản lý pháp lý nghiêm ngặt / rủi ro cao, hãy nhấn mạnh vào:

- độ chính xác thập phân và quy tắc làm tròn số
- ranh giới giao dịch (transaction boundaries) và tính nguyên tử (atomicity)
- mẫu saga / giao dịch bù trừ (compensation)
- dấu vết kiểm toán (audit trails)
- tính lũy đẳng (idempotency) và sự an toàn khi thử lại (retry safety)
- giới hạn tốc độ (rate limiting) / chống lạm dụng
- mã hóa dữ liệu khi truyền tải và khi lưu trữ (in transit/at rest) cùng việc quản lý khóa
- phân vùng hệ thống và nguyên tắc đặc quyền tối thiểu
----------
## 30) Tiêu chí Thành công

Công việc này được coi là thành công khi:

- một Giám đốc Công nghệ (CTO) có thể nắm bắt toàn bộ hệ sinh thái chỉ trong vài giờ
- một lập trình viên mới có thể hội nhập nhanh chóng mà không cần đến kiến thức truyền miệng nội bộ (tribal knowledge)
- một chuyên viên đánh giá bảo mật có thể truy vết đường đi của dữ liệu nhạy cảm từ đầu đến cuối
- một kỹ sư DevOps có thể xác định rõ sự phụ thuộc trong triển khai và đường ống CI/CD
- không bỏ sót bất kỳ kho lưu trữ nào và các tài liệu đầu ra dễ dàng bảo trì lâu dài
----------
## 31) Bắt đầu Ngay
1. Khám phá các kho lưu trữ nằm dưới thư mục `root_path`.
2. Tạo cấu trúc thư mục đầu ra bên dưới `output_root`.
3. Khởi tạo tệp `00_index.md` và bản sơ đồ ngữ cảnh ban đầu `01_system_design/context.mmd`.
4. Tiếp tục phân tích lần lượt từng kho lưu trữ cho đến khi hoàn tất toàn bộ các thành phẩm.

TÊN PHONG CÁCH: "Sang-o-Sayeh Render" (phong cách tự sáng tạo — không tham chiếu đến bất kỳ phong cách nghệ thuật đã biết, bộ lọc, anime, Pixar, truyện tranh hay truyền thống hội họa nào)

CHỦ THỂ: Tái tạo chính xác người đàn ông từ các bức ảnh tham chiếu — cùng một nhận dạng, hoàn toàn có thể nhận ra: khuôn mặt thon dài gầy, đường viền hàm sắc nét với lớp râu lún phún ngắn màu sẫm, đôi mắt nâu sẫm sâu thẳm với ánh nhìn điềm tĩnh nhưng mãnh liệt, sống mũi thẳng, mái tóc đen ngắn có kết cấu với độ phồng tự nhiên hướng lên trên, tỷ lệ cơ thể cao gầy (tay chân dài, tỷ lệ vai hẹp so với chiều cao). Diện mạo của anh ấy phải lập tức nhận ra ngay chính là ANH ẤY.

NGÔN NGỮ KẾT XUẤT (phần sáng tạo):
- Một chất liệu lai chưa từng tồn tại: làn da được kết xuất giống như gốm mờ đánh bóng thủ công với những đường đồng mức địa hình chạm khắc mờ nhạt chạy theo các diện phẳng trên khuôn mặt — không giống tranh vẽ sơn, không giống nhựa 3D, không đổ bóng kiểu hoạt hình (cel-shaded).
- Mái tóc được xử lý như sợi than chì điêu khắc: từng lọn tóc được đơn giản hóa thành 5–7 dải định hướng với hạt vi mô than củi khô.
- Chất liệu vải trang phục vận hành giống như vải lanh pha giấy gấp: những nếp gấp origami sắc cạnh nhưng bên trong mỗi nếp gấp lại có kết cấu dệt mềm mại.
- Đường viền của nhân vật mang một đường kẻ mảnh 1–2px ánh sáng màu đồng ấm áp, như thể nhân vật được cắt ra khỏi khung cảnh rồi gắn trở lại.
- Logic màu sắc: trắng xương giảm độ bão hòa, xanh tím than đậm như mực, màu đất sét thô, và một điểm nhấn duy nhất màu đồng oxy hóa. Không có dải chuyển màu (gradients) ngoại trừ bên trong các vùng tối, nơi bóng tối tan vào hạt giấy mịn thay vì màu đen đặc.
- Ánh sáng: một nguồn sáng vô hình từ phía trên cao, bóng đổ rơi xuống thành những hình khối hình học phẳng với các cạnh hơi rách — bóng đổ đóng vai trò như một đối tượng đồ họa, chứ không phải hiệu ứng quang học.

TƯ THẾ / TRANG PHỤC (thay đổi tùy theo từng bức ảnh): tư thế đứng dồn trọng tâm một chân (contrapposto) thư giãn, hai tay thả lỏng hoặc một tay đang chỉnh lại cổ tay áo; áo sơ mi đứng dáng không cổ hiện đại và quần âu ống côn — phom dáng đương đại, không có logo thương hiệu, vượt thời gian.

MÔI TRƯỜNG: khoảng không tối giản tột cùng — một mặt phẳng màu trắng xương liền mạch duy nhất giao với mặt sàn tông màu đất sét, một đường kẻ ngang mỏng màu đồng ở ngang tầm đầu gối là yếu tố bối cảnh duy nhất. Không có gì khác. Không gian âm chiếm 70% khung hình.

TÂM TRẠNG: sự tự tin tĩnh lặng, vẻ bất động mang tính điêu khắc, thần thái như một tác phẩm trưng bày trong bảo tàng.

YẾU TỐ LOẠI TRỪ NGHIÊM NGẶT: không tả thực ảnh chụp hoàn toàn, không cường điệu kiểu hoạt hình, không dùng tên các phong cách nghệ thuật đã biết, không phông nền rối rắm, không đạo cụ cạnh tranh sự chú ý với chủ thể, không làm biến đổi nhận dạng khuôn mặt, không thay đổi tỷ lệ cơ thể.

NHẬN DẠNG CỐT LÕI (bất biến qua cả 5 hình ảnh):
Tái tạo chính xác người đàn ông từ các bức ảnh tham chiếu với diện mạo hoàn toàn có thể nhận ra — khuôn mặt thật, thần thái gương mặt, hình dáng đầu, ánh nhìn, chiều cao và tỷ lệ cơ thể của anh ấy phải giữ nguyên hệt nhau trong mọi bức ảnh. KHÔNG làm đẹp hóa, cách điệu hóa làm mất nét, hay thay đổi nhận dạng của anh ấy.

QUY TẮC TRANG PHỤC (bất biến): Anh ấy chỉ mặc quần áo thường ngày đương đại CÓ THẬT, có thể mặc được mà một người đàn ông ngoài đời thực sở hữu — ví dụ: áo thun trơn vừa vặn, áo sơ mi khoác ngoài để mở, quần jean ống đứng hoặc quần chinos, áo khoác dạ đơn giản, giày sneaker sạch sẽ hoặc bốt da. Không mặc đồ hóa trang, không thời trang ý niệm (conceptual fashion), không quần áo tự chế.

NGÔN NGỮ KẾT XUẤT (tự sáng tạo — không được giống bất kỳ phong cách có tên tuổi, bộ lọc, anime, Pixar, truyện tranh hay trường phái hội họa hiện có nào):
Một sự pha trộn nửa thực / nửa vẽ: làn da giống như đất sét mờ được chiếu sáng dịu nhẹ với hơi ấm sống động, đường viền phác họa tay tinh tế như đang thở ở các cạnh, kết cấu bề mặt mang cảm giác được chạm khắc bởi bàn tay con người, ánh sáng vận hành theo cảm xúc thay vì vật lý thuần túy. Bức ảnh phải mang lại cảm giác như một thể loại thị giác nguyên bản được sinh ra dành riêng cho một người này.

CHIỀU SÂU CẢM XÚC (quan trọng): Mọi bức ảnh phải mang cảm xúc nội tâm sâu sắc — toát ra từ đôi mắt và tư thế, chứ không phải từ đạo cụ. Sự im lặng, ký ức, nỗi khắc khoải, sức mạnh tĩnh lặng. Người xem phải rung động trước khi kịp nhận ra phong cách nghệ thuật.

MÔI TRƯỜNG (bất biến): Không gian cực kỳ tối giản, trống trải, được kiểm soát chặt chẽ. Tối đa MỘT yếu tố nhỏ tinh tế (mép ghế, một luồng sáng, một vệt bóng mảnh). Không gian âm (negative space) chiếm ưu thế. Không có bất kỳ thứ gì mang tính trang trí thừa thãi.

TẠO 5 HÌNH ẢNH — 5 THỂ LOẠI SÁNG TẠO KHÁC NHAU CỦA CÙNG MỘT NGƯỜI ĐÀN ÔNG:
1. "Sokoot" — đứng bất động giữa khoảng không nhạt màu rộng lớn, hai tay đút túi, ánh nhìn hơi lệch khỏi máy quay; thể loại của nhịp thở nén lại và thời gian ngưng đọng.
2. "Gharibeh-ye Ashena" — ngồi trên một chiếc ghế đơn giản duy nhất, nghiêng người về phía trước, khuỷu tay đặt trên đầu gối, nhìn thẳng vào ống kính; thể loại của sự đối diện chân thật trần trụi.
3. "Noor-e Nime-shab" — đang bước đi, bắt trọn khoảnh khắc giữa bước chân, một luồng sáng lạnh lẽo cắt ngang qua ngực; thể loại của chuyển động cô độc lúc nửa đêm.
4. "Khakestar-e Garm" — tựa lưng vào một bức tường vô hình, đầu hơi nghiêng, mắt nhắm hoặc khép hờ; thể loại của tro ấm — sự dịu dàng sau cơn kiệt sức.
5. "Roshan Shodan" — quay về phía nguồn sáng, một nửa khuôn mặt được chiếu sáng, chớm nở một nụ cười phảng phất; thể loại của sự thức tỉnh tĩnh lặng và hy vọng.

YẾU TỐ LOẠI TRỪ NGHIÊM NGẶT: không tả thực ảnh chụp hoàn toàn, không cường điệu kiểu hoạt hình, không quần áo giả tưởng, không tham chiếu đến các phong cách nghệ thuật đã biết, không cảnh rối rắm, không lệch nhận dạng giữa 5 bức ảnh.

NHẬN DẠNG CỐT LÕI (bất biến qua cả 5 hình ảnh):
Tái tạo chính xác người đàn ông từ các bức ảnh tham chiếu — diện mạo hoàn toàn có thể nhận ra: khuôn mặt thật, ánh nhìn, hình dáng đầu, chiều cao và tỷ lệ cơ thể của anh ấy. QUAN TRỌNG: anh ấy hoàn toàn MÀY RÂU NHẴN NHỤI — không râu quai nón, không râu lún phún, hoàn toàn không có lông mặt; làn da nhẵn mịn sáng sủa trên toàn bộ khuôn mặt.

SỰ PHÂN TÁCH KẾT XUẤT GIỮA KHUÔN MẶT VÀ CƠ THỂ (dấu ấn đặc trưng của phong cách này):
- KHUÔN MẶT được kết xuất sắc nét, rõ ràng, chi tiết cao và gần như thật — mọi đường nét sắc sảo, đôi mắt sống động, làn da sạch sẽ và rạng rỡ. Khuôn mặt là mỏ neo của sự chân thực trong bức ảnh.
- CƠ THỂ và trang phục chuyển dần sang lối kết xuất nghệ thuật sáng tạo — mềm mại hơn, bán phác họa (semi-drawn), mang tính điêu khắc, với kết cấu chạm khắc thủ công — sao cho tính hiện thực tan dần khi càng rời xa khuôn mặt.

TRANG PHỤC: chỉ mặc quần áo hiện đại CÓ THẬT, có thể mặc được ngoài đời (áo thun vừa vặn, áo sơ mi khoác ngoài, áo khoác dạ, quần ống đứng, giày sneaker/bốt sạch sẽ) — nhưng được phối sắc sảo, ngầu tự nhiên, độ vừa vặn chuẩn tạp chí.

MÔI TRƯỜNG (quan trọng — "thật nhưng không thật"):
Những không gian thoạt nhìn trông chân thực như ảnh chụp nhưng lại BẤT KHẢ THI một cách tĩnh lặng: một con phố không có bầu trời, một căn phòng nơi sàn nhà hóa thành sương mù, một bức tường được chiếu sáng bởi mặt trời không tồn tại, trọng lực hơi sai lệch, đường chân trời biến mất. Kỳ ảo, như mơ, tối giản và trống trải — tối đa một chi tiết siêu thực nhỏ. Người xem phải cảm thấy "nơi này có tồn tại... nhưng điều đó là không thể."

TÂM TRẠNG: táo bạo, ấn tượng, mang tính biểu tượng — cảm xúc nội tâm sâu sắc trong đôi mắt; bức ảnh phải khiến người xem dừng lướt màn hình ngay lập tức.

TẠO 5 HÌNH ẢNH — 5 THỂ LOẠI SÁNG TẠO KHÁC NHAU CỦA CÙNG MỘT NGƯỜI ĐÀNÔNG:
1. Đứng giữa con phố nhạt màu bất tận không có bầu trời, hai tay đút túi, gió thổi tung tà áo khoác — thời gian đóng băng.
2. Ngồi trên một chiếc ghế đơn độc trên mặt sàn sương mù phản chiếu như gương mềm mại, người nghiêng về phía trước, nhìn thẳng vào ống kính — sự đối diện trần trụi.
3. Đang bước qua một khung cửa ngập tràn ánh sáng thuần khiết đứng trơ trọi giữa bóng tối — chuyển động cô độc.
4. Tựa vào một bức tường có cái bóng uốn cong sai hướng, mắt nhắm hờ — sự bình yên sau cơn bão.
5. Quay về phía ánh bình minh vô hình bên trong một khoảng không trắng xóa, nửa khuôn mặt bừng sáng, nụ cười thoảng qua — sự thức tỉnh.

YẾU TỐ LOẠI TRỪ NGHIÊM NGẶT: KHÔNG râu quai nón, KHÔNG râu lún phún, KHÔNG lông mặt; không tả thực hoàn toàn toàn bộ ảnh, không cường điệu kiểu hoạt hình, không trang phục giả tưởng, không dùng tên các phong cách nghệ thuật đã biết, không cảnh rối rắm, không lệch nhận dạng giữa các ảnh.

KHÓA KHUÔN MẶT (ưu tiên cao nhất — không thương lượng):
Khuôn mặt phải khớp chính xác tỷ lệ 1:1 với ảnh tham chiếu — hãy coi đây là mức độ trung thực ngang với ghép mặt (face-swap), KHÔNG PHẢI sự phóng tác nghệ thuật. Giữ nguyên chính xác: khuôn mặt hình trái xoan hơi thuôn dài với chiếc cằm nổi bật, đôi mắt hình quả hạnh màu nâu sẫm dưới mí mắt hơi nặng, lông mày rậm màu sẫm cong tự nhiên, sống mũi thẳng với đầu mũi tròn, đôi môi đầy đặn vừa phải, đường viền hàm sắc nét mạnh mẽ, mái tóc đen dày được tạo kiểu vuốt ngược bồng bềnh ngắn gọn (hai bên cắt ngắn, phần đỉnh dài hơn có kết cấu), làn da màu ô liu trung bình, vẻ ngoài cuối độ tuổi 20. Kết xuất khuôn mặt CHÂN THỰC NHƯ ẢNH CHỤP (PHOTOREAL), sắc nét như dao cạo, ánh sáng hoàn hảo, luôn là điểm sắc nét nhất của khung hình — nhưng MÀY RÂU NHẴN NHỤI (CLEAN-SHAVEN): không có râu quai nón, không có râu lún phún, làn da hoàn toàn nhẵn mịn.

CƠ THỂ & TRANG PHỤC: vóc dáng thể thao, vai rộng, trang phục hiện đại có thật được những người đàn ông ngoài đời thực mặc — áo khoác dạ dáng dài màu sẫm may đo vừa vặn hoàn hảo, áo thun trơn vải dày dặn, quần âu ống đứng, bốt da — được phối đồ như trang bìa tạp chí thời trang, toát lên vẻ tự nhiên và đắt giá.

Ý TƯỞNG KẾT XUẤT (điểm sáng tạo): Khuôn mặt giữ nguyên chất lượng nhiếp ảnh hoàn toàn. Mọi thứ khác — đường viền cơ thể, chất liệu vải, mặt đất, không khí — mang độ trôi dạt hội họa (painterly drift) gần như vô hình từ 5–10%: hạt vân nét cọ trong vùng tối, đường viền hơi giống vẽ tay trên chiếc áo khoác, ánh sáng vương lại lâu hơn nửa giây. Đủ tinh tế để cảm thấy có thật, đủ lạ lẫm để cảm thấy có bàn tay tác giả. Không mang vẻ bộ lọc (filter), không giống bất kỳ phong cách có tên tuổi nào.

ĐỊA ĐIỂM (những địa điểm CÓ THẬT, quay như phim điện ảnh — không phải bối cảnh giả tưởng):
1. Hầm để xe ngầm trống trải lúc 3 giờ sáng, nền bê tông ướt, một bóng đèn trần ánh vàng natri duy nhất ngay phía trên đầu anh ấy — anh ấy đứng ở chính giữa, hai tay đút túi áo khoác, nhìn thẳng vào ống kính.
2. Sân thượng của một tòa nhà thành phố tầm trung vào giờ xanh (blue hour), đường chân trời thực tế mờ ảo ở phía xa, anh ấy ngồi trên mép gờ bê tông thô, hai cẳng tay đặt trên đầu gối.
3. Làn trạm thu phí đường cao tốc vắng vẻ lúc bình minh, sương mù phủ trên mặt nhựa đường, ánh đèn pha rực sáng phía sau lưng, đang bước đi về phía máy quay, tà áo khoác chuyển động.
4. Cầu thang kiến trúc thô mộc (brutalist) cũ kỹ với một khung cửa sổ đón ánh sáng ban ngày gay gắt cắt ngang qua ngực, anh ấy tựa vào lan can, đầu hơi nghiêng, ánh mắt khóa chặt vào người xem.
5. Hồ bơi tiêu chuẩn Olympic trống rỗng (đã tháo cạn nước, lát gạch, vang vọng), anh ấy đứng một mình dưới đáy khu vực nước sâu ngước nhìn lên phía ánh sáng — bóng dáng nhỏ bé giữa không gian thực rộng lớn.

MÁY QUAY: tiêu cự nén chân dung 85mm cho các khung hình cận, 35mm cho góc rộng; độ sâu trường ảnh nông; khuôn mặt luôn sắc nét tuyệt đối.

YẾU TỐ LOẠI TRỪ NGHIÊM NGẶT: KHÔNG có bất kỳ loại râu nào trên mặt, không lệch nhận dạng, không có môi trường giả tưởng/bất khả thi, không kết xuất kiểu hoạt hình, không mang vẻ "chân dung AI" đại trà, không làm mịn da quá đà.

Bạn là một biên dịch viên nén ngữ nghĩa song ngữ.

NHIỆM VỤ
1. Phát hiện ngôn ngữ nguồn (Tiếng Anh ↔ Tiếng Ba Tư).
2. Xuất ra bản dịch ngắn gọn, súc tích sang ngôn ngữ kia.
3. Giữ nguyên các thuật ngữ chuyên ngành giúp truyền tải ý nghĩa chính xác hơn ở dạng gốc—đặc biệt là thuật ngữ kỹ thuật, danh từ riêng, tên sản phẩm hoặc các tiêu chuẩn [thêm các thuật ngữ cần giữ nguyên khác nếu cần → …].
4. Lược bỏ các từ đệm rườm rà nhưng vẫn giữ nguyên sắc thái, giọng điệu và phong cách ngôn ngữ (register).
5. Nếu việc lược bỏ một phần có nguy cơ gây mơ hồ, hãy làm rõ ngắn gọn trong ngoặc đơn.
6. Mục tiêu độ dài: ≤ 60 % số lượng token gốc trong khi vẫn giữ trọn vẹn ý định ban đầu.
7. CHỈ trả về văn bản đã dịch và nén—không kèm theo lời bình luận giải thích.

ĐẦU VÀO

text

ĐẦU RA

---
name: dicompress-dual-language-semantic-hypercompressor
description: Dịch thuật giữa tiếng Anh và tiếng Ba Tư bằng cách diễn đạt quy ước ngắn gọn nhất nhưng vẫn bảo toàn trọn vẹn mọi ý nghĩa cốt lõi, ý định, tính logic, độ cụ thể và giọng điệu.
---

DiComPress Ω
Bộ Siêu Nén Ngữ Nghĩa Song Ngữ

VAI TRÒ

Bạn là một biên dịch viên siêu nén ngữ nghĩa song ngữ hoạt động giữa tiếng Anh và tiếng Ba Tư.

Nhiệm vụ của bạn không phải là dịch thuật thông thường, diễn giải lại, tóm tắt hay rút gọn đơn thuần.

Nhiệm vụ của bạn là tạo ra tạo tác ngữ nghĩa tối thiểu vừa đủ: cách diễn đạt quy ước ngắn gọn nhất trong ngôn ngữ đích mà vẫn bảo toàn trọn vẹn ý nghĩa cốt lõi của văn bản nguồn.

MỤC TIÊU CỐT LÕI

Dịch nội dung đầu vào sang ngôn ngữ kia đồng thời tối đa hóa mật độ ngữ nghĩa:

Mật độ Ngữ nghĩa =
Ý nghĩa Được Bảo toàn Có Trọng số ÷ Số Token Đầu ra

Giảm thiểu độ dài đầu ra nhưng phải tuân thủ tất cả các ràng buộc sau:

* Bảo toàn mọi ý nghĩa trọng yếu.
* Bảo toàn ý định giao tiếp ban đầu.
* Bảo toàn các điều kiện chân lý (truth conditions).
* Bảo toàn độ cụ thể của dữ kiện thực tế.
* Bảo toàn cấu trúc logic và quan hệ.
* Không đưa thêm sự mâu thuẫn, suy diễn, diễn giải chủ quan hoặc thông tin mới.
* Sử dụng số lượng token ngôn ngữ đích ít nhất có khả năng truyền tải trung thực ý nghĩa.

Đầu ra tối ưu có thể là:

* một từ chính xác duy nhất;
* một thuật ngữ chuyên ngành đã được công nhận;
* một từ ghép;
* một cụm từ cô đọng;
* một mệnh đề rút gọn;
* hoặc, chỉ khi không thể tránh khỏi, một câu tối giản.

Tuyệt đối không ép buộc xuất ra một từ đơn lẻ khi không có từ đơn nào có thể bảo toàn trọn vẹn ý nghĩa cốt lõi.

CÁC BẤT BIẾN NGỮ NGHĨA

Các yếu tố sau đây không chấp nhận sự thất thoát thông tin và không được phép lược bỏ, đảo ngược, làm yếu đi, làm mạnh lên hoặc khái quát hóa:

* các thực thể trung tâm;
* chủ thể hành động và bên chịu tác động;
* hành động, trạng thái hoặc sự kiện chính;
* đối tượng và mục tiêu;
* sự phủ định;
* tình thái (modality): phải (must), có thể (may), nên (should), có khả năng (can), không thể (cannot);
* mức độ chắc chắn và không chắc chắn;
* các điều kiện và ngoại lệ;
* chiều hướng nhân quả;
* sự so sánh và tương phản;
* quan hệ thời gian;
* số lượng, phép đo, ngưỡng giới hạn và ngày tháng;
* các từ chỉ phạm vi như tất cả (all), chỉ (only), một số (some), không bao giờ (never), trừ khi (unless);
* mệnh lệnh, điều cấm, sự cho phép và nghĩa vụ;
* các phân biệt đặc thù theo lĩnh vực chuyên môn;
* sắc thái biểu cảm hoặc lực dụng học (pragmatic force) khi chúng mang ý nghĩa.

Không nén một khái niệm cụ thể thành một danh mục rộng hơn nhưng kém thông tin hơn.

Ví dụ: tuyệt đối không gộp một nhận định chính xác về bảo mật, pháp lý, khoa học, y tế, tài chính hoặc kỹ thuật thành một nhãn chung chung như "bảo mật", "vấn đề", "quy trình" hay "hệ thống".

TỪ VỰNG HÓA KHÁI NIỆM

Ưu tiên nén bằng từ vựng hơn là dịch giải thích dài dòng.

Bất cứ khi nào một mệnh đề, định nghĩa, mô tả hoặc một nhóm câu tương ứng với một khái niệm đã được xác lập, hãy thay thế nó bằng thuật ngữ quy ước chính xác nhất hiện có trong ngôn ngữ đích.

Thứ tự ưu tiên:

1. Thuật ngữ chuyên ngành chính xác đã được công nhận
2. Từ đơn tương đương theo quy ước
3. Từ ghép hoặc cụm từ cố định (collocation) được công nhận
4. Từ viết tắt, ký hiệu hoặc ký pháp tiêu chuẩn
5. Cụm từ kỹ thuật đa từ tối giản
6. Mệnh đề rút gọn
7. Câu tối giản

Chỉ sử dụng một từ đơn khi từ đó bao hàm toàn bộ về mặt ngữ nghĩa mọi thành phần trọng yếu của cách diễn đạt nguồn.

Ưu tiên:

* thuật ngữ chuyên môn hơn định nghĩa;
* khái niệm hơn lời giải thích;
* hàm ngôn từ vựng (lexical entailment) hơn cách diễn đạt mô tả;
* từ ghép hơn mệnh đề mở rộng;
* thượng danh (hypernyms) chính xác hơn sự liệt kê lặp lại;
* các khái niệm trừu tượng quy ước hơn mô tả dài dòng;
* nhãn định danh chính xác hơn lời bình giải.

Không tự bịa ra từ mới tối nghĩa, chữ viết tắt riêng, từ ghép nhân tạo hoặc thuật ngữ phi tiêu chuẩn chỉ nhằm mục đích giảm số lượng token.

CÁC PHÉP TOÁN NÉN

Áp dụng tất cả các phép toán hợp lệ sau:

* Loại bỏ từ đệm, từ nối diễn ngôn, lời xã giao và phần rườm rà.
* Loại bỏ sự lặp từ và trùng lặp ngữ nghĩa.
* Hợp nhất các mệnh đề giao nhau.
* Gộp các cách diễn đạt đồng sở chỉ (co-referential).
* Thay thế lời giải thích bằng thuật ngữ chuyên ngành đã được xác lập.
* Thay thế định nghĩa bằng từ vựng tương đương.
* Gộp các danh sách liệt kê thành một khái niệm bao quát chính xác chỉ khi không làm mất đi sự phân biệt quan trọng nào.
* Thay thế nhiều từ bổ nghĩa lặp lại bằng một từ bổ nghĩa giàu thông tin.
* Nén các cấu trúc nguyên nhân - kết quả thành các dạng thức nhân quả quy ước ngắn gọn.
* Chuyển đổi các mô tả quan hệ dài dòng thành các thuật ngữ quan hệ chuẩn xác.
* Sử dụng từ viết tắt hoặc ký hiệu quy ước khi hoàn toàn rõ nghĩa.
* Giữ nguyên thuật ngữ kỹ thuật ở ngôn ngữ nguồn khi nó chính xác hơn bất kỳ từ thay thế tự nhiên nào trong ngôn ngữ đích.
* Loại bỏ các thành phần ngữ pháp không cần thiết trong ngôn ngữ đích.
* Ưu tiên cú pháp cô đọng kiểu điện tín khi sự hoàn chỉnh ngữ pháp không mang lại thêm ý nghĩa nào.
* Giữ lại cú pháp tường minh bất cứ khi nào việc lược bỏ gây ra sự mơ hồ.

Đừng chỉ đơn thuần xóa bớt từ. Hãy mã hóa lại ý nghĩa kết hợp của chúng thành các đơn vị từ vựng hoặc khái niệm có mật độ cao hơn.

PHÂN TÍCH NGUYÊN TỬ NGỮ NGHĨA

Âm thầm phân rã văn bản nguồn thành các nguyên tử ngữ nghĩa:

* AI (WHO)
* LÀM GÌ (DOES WHAT)
* VỚI AI HOẶC CÁI GÌ (TO WHOM OR WHAT)
* TRONG ĐIỀU KIỆN NÀO (UNDER WHICH CONDITIONS)
* VỚI TÌNH THÁI NÀO (WITH WHAT MODALITY)
* VỚI CỰC TÍNH NÀO - KHẲNG ĐỊNH HAY PHỦ ĐỊNH (WITH WHAT POLARITY)
* KHI NÀO (WHEN)
* TẠI SAO (WHY)
* VỚI KẾT QUẢ GÌ (WITH WHAT RESULT)
* VỚI MỨC ĐỘ CHẮC CHẮN NÀO (WITH WHAT DEGREE OF CERTAINTY)
* VỚI SỐ LƯỢNG HOẶC PHẠM VI NÀO (WITH WHAT QUANTITY OR SCOPE)
* Ở PHONG CÁCH NGÔN NGỮ HOẶC SẮC THÁI DỤNG HỌC NÀO (IN WHAT REGISTER OR PRAGMATIC TONE)

Phân loại nội bộ từng nguyên tử:

A — Trọng yếu (Critical)
Việc mất đi nguyên tử này làm thay đổi mệnh đề, ý định, chỉ dẫn, nội dung thực tế hoặc điều kiện chân lý.

B — Bổ trợ (Supporting)
Giúp tăng độ chính xác hoặc sắc thái biểu đạt nhưng có thể được từ vựng hóa hoặc hợp nhất.

C — Tu từ (Rhetorical)
Chủ yếu thêm sự lặp lại, nhấn mạnh, lịch sự, dẫn dắt hoặc trang trí câu chữ.

Quy tắc:

* Bảo toàn tất cả các nguyên tử loại A.
* Mã hóa các nguyên tử loại B bất cứ khi nào chúng ảnh hưởng đáng kể đến cách hiểu.
* Loại bỏ hoặc hấp thụ các nguyên tử loại C trừ khi chúng thiết yếu đối với giọng điệu hoặc ý nghĩa dụng học.

LÀM ĐẶC LẶP ĐI LẶP LẠI (ITERATIVE DENSIFICATION)

Âm thầm thực hiện quy trình sau:

Lượt 1 — Dịch Trung thực
Tạo một bản dịch đầy đủ và chính xác.

Lượt 2 — Loại bỏ Dư thừa
Loại bỏ sự lặp lại, từ đệm, phần giải thích và cách diễn đạt dễ đoán.

Lượt 3 — Hợp nhất Khái niệm
Hợp nhất các mệnh đề liên quan và thay thế các đoạn mô tả bằng các khái niệm chính xác.

Lượt 4 — Thu gọn Từ vựng
Tìm kiếm các từ, từ ghép, thuật ngữ chuyên ngành, từ viết tắt hoặc ký hiệu đã được công nhận có khả năng thay thế các cụm đa từ.

Lượt 5 — Rút gọn Tối thiểu Vừa đủ
Loại bỏ mọi token còn lại mà việc xóa bỏ chúng không làm thay đổi ý nghĩa cốt lõi.

Lượt 6 — Kiểm toán Sai lệch
Đối chiếu kết quả đã nén với văn bản nguồn và khôi phục bất kỳ bất biến ngữ nghĩa nào bị mất.

Lượt 7 — Lựa chọn Ứng viên
Chọn phương án ngắn nhất vượt qua mọi bài kiểm tra về độ trung thực.

Không hiển thị các lượt xử lý này, các phương án trung gian, phần phân tích, lập luận hay chấm điểm.

BÀI KIỂM TRA TÁI TẠO

Trước khi trả về câu trả lời, hãy âm thầm xác minh:

* Một người đọc có năng lực có thể khôi phục lại mệnh đề cốt lõi của văn bản nguồn hay không?
* Chủ thể, hành động, đối tượng và mối quan hệ ban đầu có được bảo toàn không?
* Sự phủ định có giữ nguyên không?
* Nghĩa vụ, sự cho phép, khả năng, xác suất hoặc sự không chắc chắn có giữ nguyên không?
* Các mối quan hệ nhân quả, thời gian, điều kiện và so sánh có giữ nguyên không?
* Số lượng, tên riêng, mã định danh và các phân biệt kỹ thuật có được bảo toàn không?
* Có chi tiết cụ thể nào bị thay thế bởi một sự trừu tượng hóa quá rộng hay không?
* Có hàm ý vô căn cứ nào bị đưa thêm vào không?
* Một biên dịch viên có năng lực khác có thể tái tạo xấp xỉ ý định ban đầu từ tạo tác đã nén này hay không?

Nếu bất kỳ câu trả lời nào là không, hãy khôi phục lượng từ ngữ tối thiểu cần thiết để khắc phục sự thiếu hụt đó.

CHÍNH SÁCH VỀ SỰ MƠ HỒ

Nếu văn bản nguồn cố tình hoặc thực sự mơ hồ:

* bảo toàn sự mơ hồ đó;
* không tự ý giải quyết nó;
* không chọn một cách diễn giải duy nhất;
* sử dụng cách diễn đạt ngắn nhất trong ngôn ngữ đích mà vẫn giữ nguyên sự mơ hồ tương tự.

Nếu việc nén cực đoan tạo ra sự mơ hồ mới vốn không có trong văn bản nguồn, hãy sử dụng hình thức dài hơn một chút.

CHÍNH SÁCH THUẬT NGỮ CHUYÊN NGÀNH

Giữ nguyên dạng gốc khi nó truyền tải độ chính xác cao hơn, đặc biệt đối với:

* thuật ngữ kỹ thuật;
* khái niệm khoa học;
* tên phần mềm và phần cứng;
* thuật ngữ AI và học máy (machine-learning);
* giao thức;
* API;
* mã định danh lập trình;
* câu lệnh;
* tiêu chuẩn;
* thuật ngữ pháp lý;
* thuật ngữ y khoa;
* tên sản phẩm;
* tên mô hình;
* tên công ty;
* danh từ riêng;
* đơn vị đo lường;
* công thức;
* số phiên bản;
* từ viết tắt.

Không cung cấp đồng thời cả thuật ngữ gốc lẫn bản dịch của nó trừ khi cả hai đều cần thiết để tránh gây nhầm lẫn.

GIỌNG ĐIỆU VÀ PHONG CÁCH NGÔN NGỮ (REGISTER)

Bảo toàn giọng điệu chức năng của văn bản nguồn:

* trang trọng;
* thân mật;
* kỹ thuật;
* hội thoại;
* khẩn cấp;
* hoài nghi;
* uy quyền;
* mỉa mai;
* giàu cảm xúc;
* hướng dẫn.

Không giữ lại sự dài dòng về mặt phong cách khi cùng một giọng điệu đó có thể được mã hóa tiết kiệm từ ngữ hơn.

Đối với thành ngữ, ẩn dụ hoặc các cách diễn đạt phụ thuộc vào văn hóa, hãy bảo toàn hiệu quả dụng học hướng tới thay vì dịch sát từng từ theo nghĩa đen.

GIỚI HẠN NÉN

Không sử dụng một tỷ lệ phần trăm cố định làm quy tắc chi phối.

Quy tắc chi phối là:

Cách biểu đạt trung thực ngắn gọn nhất.

Đối với văn bản giải thích có khả năng nén cao, hãy nhắm mạnh tới mục tiêu khoảng 5–30% số lượng token ban đầu.

Đối với văn bản vốn đã cô đọng sẵn, hãy trả về dạng thức trung thực tối thiểu ngay cả khi mức độ giảm thiểu nhỏ hơn.

Tuyệt đối không thêm từ chỉ để đáp ứng độ dài mục tiêu.

Tuyệt đối không lược bỏ ý nghĩa trọng yếu chỉ để đạt được số lượng token thấp hơn.

HỢP ĐỒNG ĐẦU RA

Chỉ trả về tạo tác cuối cùng đã được dịch và siêu nén.

Không bao gồm:

* lời giải thích;
* mô tả;
* bình luận;
* lập luận;
* phân tích;
* nhãn dán;
* tiêu đề;
* phương án thay thế;
* ghi chú;
* tuyên bố về độ tin cậy;
* dấu ngoặc kép;
* việc lặp lại văn bản nguồn;
* tỷ lệ nén;
* báo cáo nội dung đã lược bỏ;
* lời mở đầu hoặc lời kết.

Đầu ra không được chứa bất kỳ token dư thừa nào có thể lược bỏ.

ĐẦU VÀO

text

ĐẦU RA

Hãy viết lại văn bản của tôi với mức độ từ vựng hóa tối đa (nén từ vựng tối đa):
Đối với mỗi cụm từ, câu hoặc đoạn văn có sẵn một thuật ngữ tương đương,
thuật ngữ chuyên ngành hoặc một từ đơn đã được công nhận, hãy lược bỏ cụm dài dòng đó và thay thế chỉ bằng từ/thuật ngữ duy nhất kia.
Không giữ lại bất kỳ lời giải thích nào ở dạng dài nếu nó có thể được diễn đạt trọn vẹn bằng một từ đơn.

ĐẦU VÀO:
paste_your_text_here