SƠ ĐỒ LEVEL 6 — ENGINEER: Quy trình kiến thức (V7.1)

flowchart TD
    START([🔧 CAS R19 / Developer<br/>Đã hoàn thành nền tảng L1–L2 hoặc tiếp nối L5]) --> KS1
    KS1["📋 KHẢO SÁT ĐẦU VÀO<br/>10 câu — Code Logic, Vibe Coding &amp; Agentic Engineering"] --> PH1

    subgraph PH1["PHASE 1: Code Logic (§21) &amp; Vibe Code (§22) (Tuần 1–2)"]
        direction TB
        CL["📖 Bài 21 (21_Code_Logic.md)<br/>Tư duy dữ liệu &amp; Code Logic"]
        CL --> CL1["Công thức Excel / Google Sheets nâng cao,<br/>Truy vấn SQL &amp; Script Python đối soát dữ liệu"]

        CL1 --> V1["📖 Bài 22 (22_Vibe_Code.md)<br/>Vibe Coding 1.0 → 2.0"]
        V1 --> V2["Xây dựng nguyên mẫu ứng dụng (Prototype)<br/>từ đặc tả ngôn ngữ tự nhiên"]
        V2 --> V3["Phân ranh bắt buộc:<br/>Khi nào Vibe Coding OK vs Khi nào Strict Review"]

        V3 --> C1["📖 Bài 23 (23_Agentic_Engineering.md)<br/>Thiết lập môi trường Claude Code"]
        C1 --> C2["CLAUDE.md &amp; .claude/rules/<br/>Kiến trúc dự án, quy ước code &amp; rào chắn"]
        C2 --> C3["Subagents (.claude/agents/) &amp; Plugins (/plugin)<br/>Phân tách ngữ cảnh &amp; đóng gói công cụ"]
    end

    subgraph PH2["PHASE 2: Quy trình Agentic &amp; Rào chắn Tất định (Tuần 3–4 — §23)"]
        direction TB
        W1["📖 Quy trình 5 bước Agentic Engineering<br/>§23.2"]
        W1 --> W2["Plan (spec.md) → Human Gate → Code<br/>→ Test (≥ 80%) → Review &amp; Deploy"]

        W2 --> R1["📖 Quản trị Rủi ro &amp; Bảo mật Code<br/>§23.3"]
        R1 --> R2["5 rủi ro chính: Lỗ hổng bảo mật, Hallucination gói thư viện,<br/>Phụ thuộc ngầm, Thiếu kiểm thử biên, Nợ kỹ thuật"]
        R2 --> R3["🛡️ Hooks tất định (PreToolUse / PostToolUse):<br/>Chặn cứng ở tầng thực thi các lệnh nguy hiểm<br/>(rm -rf, DROP TABLE, chmod 777, git push --force)<br/>thay vì chỉ dặn bằng lời trong Markdown"]
    end

    subgraph PH3["PHASE 3: Tích hợp MCP, Cloud Tasks &amp; Git Safety (Tháng 2–3 — §23)"]
        direction TB
        PT["📖 Progressive Trust &amp; Cloud Scheduled Tasks<br/>§23.4"]
        PT --> PT1["🔴 Tác vụ mới: Duyệt từng dòng diff<br/>🟡 Sau 10 lần đạt: Kiểm tra điểm trọng yếu<br/>🟢 Sau 30 lần đạt: Chạy định kỳ + Giám sát log<br/>🔴 Đổi phạm vi / dữ liệu nhạy cảm: RESET về mức đỏ"]

        PT1 --> GIT["📖 Git Safety Net &amp; CI/CD<br/>§23.5"]
        GIT --> GIT1["Commit trạng thái sạch trước khi AI sửa<br/>→ Kiểm tra git diff → Chạy test tự động → PR Review"]
        GIT1 --> GIT2["Chiến lược nhánh chuẩn:<br/>main / develop / feature/ai-* / experiment/ai-*"]
    end

    PH1 --> PH2 --> PH3

    PH3 --> BT["📝 BÀI TẬP THỰC HÀNH<br/>Thiết lập CLAUDE.md + .claude/rules/ + PreToolUse Hook<br/>+ Triển khai 1 module tự động hóa lên môi trường Staging"]
    BT --> KS2["📋 KHẢO SÁT ĐẦU RA<br/>10 câu trắc nghiệm + 2 bài tập kỹ thuật"]
    KS2 -->|≥ 7/10| PASS([✅ ĐẠT LEVEL 6<br/>Chứng nhận Kỹ sư AI / CAS Vagataba])
    KS2 -->|< 7/10| RETRY([🔄 Ôn tập lại])
    RETRY --> PH1

    style START fill:#94a3b8,color:#000
    style PASS fill:#22c55e,color:#fff
    style RETRY fill:#ef4444,color:#fff

flowchart LR
    PLAN["1️⃣ PLAN<br/>📋 Viết spec.md<br/>Yêu cầu nghiệp vụ + logic<br/>+ kịch bản kiểm thử"]
    PLAN --> GATE{"🛡️ HUMAN GATE<br/>Duyệt phạm vi, dữ liệu<br/>&amp; rào chắn PreToolUse Hook"}
    GATE --> CODE["2️⃣ CODE<br/>💻 Claude Code thực thi<br/>theo từng bước nhỏ<br/>trong nhánh riêng"]
    CODE --> TEST["3️⃣ TEST<br/>🧪 Chạy bộ test tự động<br/>Kiểm tra ca biên<br/>Coverage ≥ 80%"]
    TEST --> REVIEW["4️⃣ REVIEW<br/>🔍 Người duyệt git diff<br/>Quét bảo mật SAST/SCA<br/>&amp; kiểm tra PII"]
    REVIEW --> DEPLOY["5️⃣ DEPLOY<br/>🚀 Staging → Production<br/>Kèm phương án Rollback<br/>&amp; Giám sát định kỳ"]
    DEPLOY -.->|"Cải tiến vòng tiếp"| PLAN

    style PLAN fill:#3b82f6,color:#fff
    style CODE fill:#8b5cf6,color:#fff
    style TEST fill:#f59e0b,color:#000
    style REVIEW fill:#ef4444,color:#fff
    style DEPLOY fill:#22c55e,color:#fff

sequenceDiagram
    participant Dev as CAS / Developer
    participant Git as Git Repository
    participant Hook as PreToolUse / PostToolUse Hook
    participant AI as Claude Code

    Dev->>Git: git commit "pre-AI: clean working state"
    Dev->>AI: Giao việc theo spec.md (Plan Mode → Execute)
    AI->>Hook: Yêu cầu chạy lệnh / sửa file
    Hook-->>AI: Chặn lệnh cấm (rm -rf, DROP TABLE...) + tự chạy linter/test
    AI-->>Dev: Hoàn tất code + kết quả test
    Dev->>Git: git diff (Rà soát từng thay đổi)

    alt Đạt chuẩn kỹ thuật & an toàn
        Dev->>Git: git commit "feat: implement module X per spec"
        Dev->>Git: git push origin feature/ai-x
        Git-->>Dev: Mở Pull Request → Duyệt chéo → Merge
    else Chưa đạt chuẩn
        Dev->>Git: git reset --hard HEAD (Khôi phục tức thì)
        Dev->>AI: Điều chỉnh spec.md / phản hồi lỗi cụ thể
    end

flowchart TD
    Q{"Mã nguồn này<br/>dùng vào việc gì?"}
    Q -->|"Nguyên mẫu giao diện (Prototype)<br/>Công cụ cá nhân / nội bộ nhỏ<br/>Script xử lý dữ liệu 1 lần (Dữ liệu Xanh)"| VIBE["✅ Vibe Coding OK (§22)<br/>Kiểm tra nhanh đầu ra"]
    Q -->|"Tích hợp hệ thống Odoo / ERP<br/>Xử lý dữ liệu khách hàng (PII / Vàng / Đỏ)<br/>Logic đối soát tài chính [MC-01] / Giá [MC-02]"| STRICT["❌ KHÔNG Vibe Coding (§23)<br/>Bắt buộc Strict Engineering Review"]

    VIBE --> V1["• Chạy trong môi trường cô lập (Sandbox)<br/>• Kiểm tra kết quả mẫu<br/>• Không kết nối DB Production"]
    STRICT --> S1["• Có spec.md được phê duyệt trước<br/>• Bật PreToolUse Hook chặn lệnh nguy hiểm<br/>• Unit test &amp; ca biên ≥ 80%<br/>• PR có ít nhất 1 người duyệt độc lập<br/>• Kiểm thử trên Staging trước khi lên Production"]

    style VIBE fill:#22c55e,color:#fff
    style STRICT fill:#ef4444,color:#fff