# 📚 HỆ THỐNG QUY CHUẨN KHO TRI THỨC VÀ TÀI LIỆU KỸ THUẬT (/home/books)
> **Tài liệu tham chiếu chuẩn quốc tế dành cho Kỹ sư và AI Assistant (LLM Prompt Protocol)**  
> *Phiên bản:* 1.0.0 · *Cập nhật lần cuối:* 2026-09-09 · *Vị trí gốc:* `/home/books/RULES.md`

---

## 🎯 I. MỤC TIÊU VÀ TẦM NHÌN (MISSION & VISION)

Kho thư mục `/home/books/` là **thư viện tri thức kỹ thuật tập trung vĩnh cửu** của người dùng. Mọi kiến thức thu nhận được từ thực tế vận hành, xử lý sự cố (troubleshooting), tối ưu hệ thống, kiến trúc phần mềm, bảo mật hay AI đều bắt buộc phải được đóng gói thành các tài liệu Markdown chuẩn mực, khoa học, dễ tra cứu và có tính kế thừa cao.

Khi bất kỳ AI Assistant nào (Antigravity, ChatGPT, Claude, Gemini, Copilot...) hoặc con người nhận được yêu cầu "đóng thành sách", "ghi chép vào books", hay "lưu tài liệu học tập", **BẮT BUỘC TUÂN THỦ 100% BỘ QUY CHUẨN NÀY**.

---

## 🗂️ II. QUY CHUẨN PHÂN NHÓM CHUYÊN ĐỀ (TAXONOMY & CLUSTERS)

Mọi tài liệu không được để trôi nổi tự do tại thư mục gốc `/home/books/` mà **BẮT BUỘC** phải nằm trong đúng cụm chuyên đề tương ứng:

```text
/home/books/
├── RULES.md                        # Bộ quy chuẩn và luật quản trị kho sách (Tài liệu này)
├── README.md                       # Mục lục tổng quan và danh mục tra cứu toàn bộ sách
│
├── 01-devops-security/             # CỤM 1: BẢO MẬT & HẠ TẦNG VẬN HÀNH
│   └── (Firewall, DDoS, SYN Flood, Nginx Hardening, Fail2ban, SSH Key, Cloudflare, SSL...)
│
├── 02-system-optimization/         # CỤM 2: TỐI ƯU HÓA HỆ THỐNG LINUX & TÀI NGUYÊN
│   └── (Kernel sysctl, RAM, Swap, OOM Killer, Disk I/O, Systemd, Process Management...)
│
├── 03-backend-architecture/        # CỤM 3: THIẾT KẾ & KIẾN TRÚC BACKEND
│   └── (Database Design, Modular Architecture, Eloquent ORM, Transactions, API Design...)
│
├── 04-frontend-ui/                 # CỤM 4: GIAO DIỆN & TRẢI NGHIỆM NGƯỜI DÙNG (UI/UX)
│   └── (Dense UI, Dark VSCode Theme, TailwindCSS, Lucide Icons, Client Validation...)
│
├── 05-ai-engineering/              # CỤM 5: KỸ THUẬT AI & AGENT AUTOMATION
│   └── (Prompt Protocol, Agent Hub, TTS Hoài My, Task Tracking, Memory & Brain...)
│
└── 06-ai-training/                 # CỤM 6: HUẤN LUYỆN MÔ HÌNH AI & XỬ LÝ DỮ LIỆU
    └── (Dataset Curation, JSONL, LoRA, QLoRA, Fine-tuning, DPO, RLHF, Quantization GGUF...)
```

*Lưu ý: Nếu phát sinh thêm chuyên đề hoàn toàn mới chưa thuộc 6 nhóm trên, hãy tạo thư mục mới theo định dạng: `07-[ten-chuyen-de-kebab-case]/` và cập nhật vào `README.md`.*

---

## 🏷️ III. QUY CHUẨN ĐẶT TÊN FILE (FILE NAMING CONVENTION)

1. **Định dạng chuẩn:** `[so-thu-tu]-[slug-noi-dung-chinh-bang-tieng-anh-kebab-case].md`
   - *Ví dụ đúng:* 
     - `01-vps-ddos-synflood-defense-and-investigation.md`
     - `02-nginx-reverse-proxy-and-rate-limiting.md`
     - `03-mariadb-transaction-isolation-and-deadlock-prevention.md`
   - *Ví dụ sai:*
     - `bai-hoc-bao-mat.md` (Thiếu số thứ tự chuyên đề)
     - `01_DDoS_Protection.MD` (Dùng dấu gạch dưới, chữ hoa)
     - `note.md` hoặc `doc.md` (Đặt tên vô nghĩa, không thể hiện nội dung)
2. **Số thứ tự (`01-`, `02-`, ...):** Tăng dần theo trình tự thời gian hoặc lộ trình học tập trong từng thư mục chuyên đề.
3. **Tính độc lập:** Mỗi file đại diện cho một chủ đề/cuốn sách trọn vẹn, có thể đọc và áp dụng độc lập.

---

## 🛡️ IV. NGUYÊN TẮC BẤT DI BẤT DỊCH VỀ SỬA ĐỔI FILE CŨ (IMMUTABILITY & SAFE EDITING)

Để tránh tình trạng AI tự tiện ghi đè làm mất kiến thức hoặc sửa lung tung:

1. **NGUYÊN TẮC BẢO TỒN NỘI DUNG (Content Preservation):**
   - **TUYỆT ĐỐI KHÔNG** xóa hoặc ghi đè toàn bộ một file sách đã có trừ khi người dùng nói rõ: *"Hãy viết lại hoàn toàn file X"*.
   - Mọi kiến thức đã được ghi lại là lịch sử kinh nghiệm quý giá.
2. **QUY TRÌNH BỔ SUNG KIẾN THỨC MỚI VÀO SÁCH CŨ (Append & Versioning):**
   - Khi có kiến thức mới liên quan đến một chủ đề đã có file:
     + **Bước A:** Giữ nguyên các phần nội dung cũ.
     + **Bước B:** Bổ sung thêm một chương/mục mới ở cuối file với tiêu đề:
       `### 📌 BỔ SUNG [NGÀY DD/MM/YYYY]: [TIÊU ĐỀ NỘI DUNG MỚI]`
     + **Bước C:** Cập nhật trường `updated_at` trong phần Frontmatter YAML ở đầu file.
3. **KHI NÀO TẠO FILE MỚI?**
   - Nếu kiến thức mới là một phân nhánh sâu, một công nghệ khác hoặc một bài toán độc lập: **BẮT BUỘC TẠO FILE MỚI** với số thứ tự kế tiếp (`02-...`, `03-...`) thay vì cố nhồi nhét vào file cũ làm loãng nội dung.

---

## 📐 V. TIÊU CHUẨN CẤU TRÚC NỘI DUNG MỘT CUỐN SÁCH TÀI LIỆU

Mỗi file tài liệu trong `/home/books/` bắt buộc phải có đủ **5 phần chuẩn mực** sau:

```markdown
---
title: "Tên Tiêu Đề Cuốn Sách Viết Hoa Chuẩn Kỹ Sư"
cluster: "01-devops-security" # Tên thư mục cụm
document_id: "BOOK-SEC-001"
author: "Crystal Aress (Admin) & AI Assistant"
created_at: "YYYY-MM-DD"
updated_at: "YYYY-MM-DD"
tags: [tag1, tag2, tag3]
status: "Completed" # Completed | In-Progress | Archived
---

# [ICON] [TÊN SÁCH ĐẦY ĐỦ]
> **Tóm tắt cốt lõi:** 2 - 3 câu đúc kết bản chất vấn đề và giải pháp đạt được.

---

## 📑 MỤC LỤC CHI TIẾT (TABLE OF CONTENTS)
1. Bối cảnh thực tế & Dấu hiệu nhận biết
2. Bản chất kỹ thuật & Phân tích nguyên nhân gốc rễ
3. Quy trình điều tra thực chiến (Từng bước & Câu lệnh)
4. Giải pháp khắc phục & Triển khai từng tầng
5. Bài học xương máu & Checklist phòng thủ định kỳ

---

## 🎯 1. BỐI CẢNH THỰC TẾ & DẤU HIỆU NHẬN BIẾT
(Mô tả tình huống thực tế đã trải qua, các triệu chứng lag, treo, sập, error code...)

---

## 🔬 2. BẢN CHẤT KỸ THUẬT (UNDER THE HOOD)
(Phân tích sâu về cơ chế tầng mạng, tầng OS kernel, tầng ứng dụng, lý do tại sao xảy ra...)

---

## 🛠️ 3. HƯỚNG DẪN THỰC CHIẾN TỪNG BƯỚC (STEP-BY-STEP RUNBOOK)
(Các câu lệnh one-liner chạy ngay được, giải thích rõ từng tham số, không viết chung chung)

---

## 🛡️ 4. KIẾN TRÚC PHÒNG THỦ LÂU DÀI & BEST PRACTICES
(Sơ đồ ASCII/Text, ma trận so sánh, khuyến nghị chuẩn công nghiệp)

---

## ⚠️ 5. BÀI HỌC KINH NGHIỆM & CHECKLIST ĐỊNH KỲ
(Những cạm bẫy cần tránh, lệnh kiểm tra nhanh khi gặp lại sự cố)
```

---

## 🎨 VI. QUY CHUẨN HIỂN THỊ TRÌNH BÀY (PRESENTATION STANDARD)

1. **Cấm Bảng Markdown Gãy Layout:**
   - Tuyệt đối **KHÔNG DÙNG BẢNG MARKDOWN DẠNG `| col | col |`** nếu có nhiều cột hoặc nội dung dài gây vỡ màn hình.
   - **BẮT BUỘC DÙNG KHỐI CODE BASH/TEXT MONOSPACE (` ```text ` hoặc ` ```bash `)** với ký tự vẽ bảng ASCII thẳng hàng (`+---+---+`, `| |`) hỗ trợ cuộn ngang/dọc không bao giờ bị vỡ chữ.
2. **Code & Lệnh Thực Chiến Phải Có Chú Thích:**
   - Mọi khối lệnh bash phải kèm theo comment `#` giải thích lệnh đó làm gì, kết quả mong đợi ra sao.
3. **Sơ Đồ Luồng Dữ Liệu:**
   - Ưu tiên dùng sơ đồ khối văn bản (ASCII Diagram) hoặc Mermaid flowchart để trực quan hóa luồng kiến trúc.

---

## 🤖 VII. CHỈ DẪN DÀNH CHO AI CHATBOT (AI INSTRUCTION PROMPT PROTOCOL)

Khi người dùng ra lệnh bằng bất kỳ câu thoại nào như:
- *"Lưu kiến thức này vào sách cho tôi"*
- *"Đóng thành tài liệu lưu vào thư mục books"*
- *"Thêm bài học hôm nay vào books"*

**AI BẮT BUỘC THỰC HIỆN THEO 4 BƯỚC TỰ ĐỘNG:**

```text
BƯỚC 1: Đọc /home/books/RULES.md để nạp toàn bộ quy chuẩn.
BƯỚC 2: Phân tích kiến thức cần lưu thuộc cụm thư mục nào (01 đến 05).
BƯỚC 3: Kiểm tra thư mục đó xem đã có file liên quan chưa:
        ├── Nếu chưa có -> Tạo file mới với số thứ tự kế tiếp: [XX]-[slug].md
        └── Nếu đã có và chỉ cần bổ sung -> Thêm mục mới ở cuối file (Append Section),
            TUYỆT ĐỐI KHÔNG ghi đè xóa mất nội dung cũ.
BƯỚC 4: Tự động cập nhật mục lục cuốn sách mới vào /home/books/README.md.
```

---
*Tài liệu này là chuẩn mực tối thượng của `/home/books/`. Mọi hành động ghi chép tài liệu phải đối chiếu theo văn bản này.*