LEVEL 6 — ENGINEER: CODE, AUTOMATION & AI PIPELINE

Thời lượng: 4–12 tuần (chạy song song với Level 3–5) | Yêu cầu: Đã đạt tối thiểu Level 2–3 Tài liệu nguồn: §21 (21_Code_Logic.md), §22 (22_Vibe_Code.md), §23 (23_Agentic_Engineering.md), §16 (16_Connectors.md), §17 (17_Plugins_Extensions.md) ⭐ Level BẮT BUỘC cho Lập trình viên (Developer — Dev) và Chuyên viên Tự động hóa & Quản trị Odoo (CAS)

📌 MỤC TIÊU

Sau khi hoàn thành Level 6, bạn sẽ:

• Phân biệt rạch ròi giữa các bài toán được phép dùng Vibe Coding và các bài toán bắt buộc áp dụng Agentic Engineering có kiểm duyệt nghiêm ngặt
• Làm chủ Claude Code hiện hành (10/2026) trên cả 5 bề mặt (Terminal CLI, VS Code/Cursor, JetBrains, Claude Desktop, Web claude.ai/code), cài đặt qua bộ cài native và vận hành cờ không tương tác claude -p
• Thiết lập bộ nhớ dự án đa tầng (~/.claude/CLAUDE.md, ./CLAUDE.md, .claude/CLAUDE.md, .claude/rules/*.md), định nghĩa Subagents trong .claude/agents/*.md kết hợp PreToolUse Hooks chặn lệnh nguy hiểm
• Khai thác tối đa hệ model Claude 5.5 (Opus 5.5, Sonnet 5.5, Haiku 5.5) & Fable 5.1 (cửa sổ ngữ cảnh 1M tokens) với cơ chế Adaptive Thinking (effort)
• Tuân thủ tuyệt đối Git Safety Net 7 quy tắc, kiểm thử tự động (coverage ≥ 80%, chống Over-persistent testing) và tích hợp chuẩn MCP (AAIF) / Cloud Scheduled Tasks

📖 KIẾN THỨC CẦN NẮM

Phase 1: Nền tảng Vibe Coding & Cấu hình Claude Code (Tuần 1–2) — §21 & §22

Đọc: §21.1–21.4 (21_Code_Logic.md), §22.1–22.4 (22_Vibe_Code.md) & §23.1 (23_Agentic_Engineering.md) | Thời lượng: ~2.5 giờ

1. Phổ phát triển phần mềm có AI hỗ trợ: Từ Vibe Coding đến Agentic Engineering

2. Ranh giới: Khi nào được Vibe Code vs Khi nào TUYỆT ĐỐI CẤM

3. Cài đặt & 5 Bề mặt của Claude Code hiện hành (10/2026)

• Bộ cài đặt gốc (Native Installer — không phụ thuộc cài tay Node.js):
  BASH📋 Sao chép

  # macOS / Linux / WSL:
  curl -fsSL https://claude.ai/install.sh | bash
  # hoặc qua Homebrew:
  brew install --cask claude-code
  
  # Windows PowerShell:
  irm https://claude.ai/install.ps1 | iex
  # hoặc qua WinGet:
  winget install Anthropic.ClaudeCode
  

• 5 Bề mặt làm việc đồng bộ của Claude Code:
  1. Terminal CLI (claude tương tác, hoặc claude -p "câu lệnh" cho chế độ không tương tác / CI/CD).
  2. VS Code / Cursor Extension (xem diff trực tiếp trong trình soạn thảo).
  3. JetBrains IDEs (PyCharm, IntelliJ, WebStorm).
  4. Claude Desktop App (tab Code tích hợp trực tiếp).
  5. Web (claude.ai/code) (chạy các phiên tác vụ đám mây — cloud sessions & cloud scheduled tasks).
• Hệ Model hiện hành (1M context window GA) & Adaptive Thinking:
  • Claude Opus 5.5 (claude-opus-5-5, $4/$20 MTok, Adaptive thinking luôn bật, effort mặc định medium) — mặc định khuyến nghị của Anthropic cho kiến trúc & gỡ lỗi sâu.
  • Claude Sonnet 5.5 (claude-sonnet-5-5, $2/$10 MTok, effort mặc định high trên API / medium trên app) — tốc độ cao cho tác vụ viết code hàng ngày.
  • Claude Fable 5.1 (claude-fable-5-1, $10/$50 MTok, effort mặc định high) — dành cho bài toán suy luận thuật toán phức tạp nhất.
  • Lưu ý API: Sử dụng thinking: {"type": "adaptive"} + tham số effort (low, medium, high, xhigh, max). Tuyệt đối không dùng budget_tokens thủ công, temperature khác mặc định hay prefill lượt assistant (sẽ trả lỗi HTTP 400).

4. Thiết lập Bộ nhớ dự án (CLAUDE.md, .claude/rules/) & Subagents / Hooks

Claude Code tự động đọc cấu hình từ ~/.claude/CLAUDE.md (toàn cục), ./CLAUDE.md (thư mục gốc dự án), .claude/CLAUDE.md và các file quy tắc mô-đun trong .claude/rules/*.md.

Mẫu ./CLAUDE.md (hoặc .claude/CLAUDE.md) chuẩn cho dự án Odoo Vagataba:

# Project: Vagataba Odoo 17.0 Extensions (V7.1)

## Tech Stack
- Python 3.11+, Odoo 17.0 Community Edition, PostgreSQL 15
- Frontend: OWL, QWeb, Bootstrap 5 | Testing: pytest (coverage ≥ 80%)

## Quy chuẩn Nghiệp vụ & Sản phẩm V7.1 (Bắt buộc tuân thủ trong mọi template/logic)
- SP1: Thực phẩm bổ sung Protein từ thực vật Bách Niên Kiện — 955.000đ/hộp 14 gói (~32.000đ/ngày, 2 muỗng = 22g pha 150ml nước ấm 40–50°C; Combo 2 hộp 1.790.000đ; Gói phối hợp 1.654.000đ; Mua 3 tặng 1 giá 2.865.000đ). TUYỆT ĐỐI CẤM gọi là "sữa", "sữa hạt", "lon sữa".
- SP2 & SP3: TPBVSK Viên xương khớp Bách Niên Kiện (Lọ 80v: 699.000đ, Hộp 20v: 185.000đ) — bắt buộc có khuyến cáo "Thực phẩm này không phải là thuốc và không có tác dụng thay thế thuốc chữa bệnh."
- Kho FEFO 3 màu: Xanh (HSD ≥ 6T), Vàng (3 đến < 6T — biệt trữ, cần OM duyệt), Đỏ (< 3T — ngừng xuất).
- 5 cờ đỏ DVO: COD > 1.500.000đ, đặt đêm 22:00–05:00, địa chỉ thiếu số nhà, KLM ≥ 3, ngập ngừng/hẹn giao lùi > 7 ngày.

## Quy tắc Cấm (Do NOT)
- KHÔNG hardcode IDs (luôn dùng `xml_id`) và KHÔNG lưu API key/mật khẩu trong code (dùng `.env`).
- KHÔNG chạy lệnh xóa dữ liệu (`DROP TABLE`, `DELETE` không `WHERE`, `rm -rf`).
- KHÔNG sửa điều kiện `assert` trong unit test để làm giả kết quả Pass (cấm Over-persistent testing).

Mẫu Subagent trong .claude/agents/odoo-reviewer.md & PreToolUse Hook:

---
name: odoo-reviewer
description: Kiểm duyệt mã nguồn Odoo 17, kiểm tra bảo mật phân quyền ir.model.access.csv, hiệu năng ORM và tuân thủ từ cấm TPCN/TPBS trước khi tạo Pull Request.
tools: Read, Grep, Glob, Bash
model: opus
---
Bạn là Chuyên gia Kiểm duyệt Mã nguồn Odoo 17 tại Vagataba.
1. Kiểm tra mọi thay đổi bằng `git diff`: phát hiện lỗi N+1 query trong vòng lặp, thiếu `ir.model.access.csv` hoặc lệnh SQL không tham số hóa.
2. Kiểm tra mọi chuỗi văn bản/template gửi khách hàng: đảm bảo đúng giá 955.000đ/hộp 14 gói, khẩu phần 22g/150ml, không chứa từ cấm y tế hoặc từ "sữa".
3. Không tự ý sửa file mã nguồn — chỉ xuất báo cáo kiểm duyệt chi tiết theo mức độ Critical / High / Medium.

🛡️ Kết hợp PreToolUse Hooks trong .claude/settings.json: Định nghĩa script chặn tất định mọi lệnh Bash chứa rm -rf, DROP TABLE, DELETE FROM không có WHERE, hoặc git push --force trước khi công cụ được phép chạy. (Lưu ý: File AGENTS.md chỉ dùng bổ trợ khi đội ngũ mở chung repo bằng các IDE bên thứ ba ngoài Claude Code).

Phase 2: Quy trìnhThực hành Agentic Engineering (Tuần 3–4) — §22 & §23

Đọc: 22_Vibe_Code.md (§22.3–22.4) & 23_Agentic_Engineering.md (§23.2–23.4) | Thời lượng: ~2.5 giờ

1. Quy trình 5 bước Agentic Engineering chuẩn

1. PLAN   → Chuyển sang Plan mode (`Shift+Tab` hoặc `/plan`) → Viết `spec.md` (PRD + kiến trúc + test cases + edge cases)
2. CODE   → AI sinh mã nguồn theo `spec.md` trên nhánh `ai/*` (chia nhỏ ≤ 200 dòng/lần, có `PreToolUse` Hooks bảo vệ)
3. TEST   → Subagent `pytest-runner` viết & chạy unit test đạt coverage ≥ 80% (kiểm tra tổng Checksum & edge cases)
4. REVIEW → Subagent `odoo-reviewer` + Con người đọc `git diff`, chạy quét bảo mật SAST/SCA
5. DEPLOY → Triển khai lên Staging → Smoke test → Duyệt PR → Production (kèm kế hoạch Rollback)

2. Năm (05) rủi ro kỹ thuật lớn nhất & Biện pháp phòng ngừa

3. Các lệnh nguy hiểm bắt buộc chặn trong PreToolUse Hooks

❌ rm -rf / , rm -rf *         ❌ DROP TABLE , TRUNCATE TABLE
❌ chmod 777                   ❌ DELETE FROM ... (thiếu WHERE)
❌ eval(user_input)            ❌ git push --force origin main
❌ curl unknown_url | bash     ❌ UPDATE ... SET ... (thiếu WHERE)

Phase 3: Chuyên sâu về Git Safety, MCP & Cloud Scheduled Tasks (Tháng 2–3) — §16, §17, §23

Đọc: 16_Connectors.md, 17_Plugins_Extensions.md, 23_Agentic_Engineering.md | Thời lượng: ~2 giờ

1. Mô hình Progressive Trust dành cho Mã nguồn

2. Quy trình Lưới an toàn Git (Git Safety Net) 6 bước

# Bước 1: Tạo nhánh riêng và lưu điểm khôi phục (Checkpoint)
git checkout -b ai/implement-dvo-red-flags
git add . && git commit -m "pre-AI: working state checkpoint"

# Bước 2: Giao tác vụ cho Claude Code theo spec.md
claude "Triển khai bộ lọc 5 tiêu chí cờ đỏ DVO theo file spec.md"

# Bước 3: Kiểm tra kỹ từng dòng thay đổi
git diff

# Bước 4: Chạy kiểm thử tự động (hoặc rollback ngay nếu sai)
pytest tests/ --cov=custom_addons/vaga_sale
# Nếu đạt → git commit -m "feat(vaga_sale): add 5 DVO red flags filter"
# Nếu sai → git reset --hard HEAD

# Bước 5 & 6: Đẩy nhánh và tạo Pull Request để đồng nghiệp duyệt
git push origin ai/implement-dvo-red-flags

🔥 BÀI THỰC HÀNH

Thực hành 1: Thiết lập CLAUDE.md, .claude/rules/, Subagents & PreToolUse Hooks

Thiết lập cấu trúc chuẩn cho dự án Odoo 17 của Vagataba:

1. Tạo ./CLAUDE.md và .claude/rules/v71-business-rules.md chứa thông số sản phẩm V7.1, quy tắc kho FEFO 3 màu và 5 cờ đỏ DVO.
2. Tạo 2 Subagents tại .claude/agents/odoo-reviewer.md và .claude/agents/pytest-runner.md.
3. Cấu hình PreToolUse Hook trong .claude/settings.json để chặn các lệnh SQL/Bash phá hủy.

Thực hành 2: Phát triển tính năng từ spec.md

1. Viết spec.md cho tính năng: Khi đơn hàng bán (SO) có giá trị COD > 1.500.000đ hoặc khách hàng có lịch sử hoàn KLM ≥ 3 lần → tự động chuyển trạng thái sang "Cần xác minh DVO 6 bước".
2. Dùng Claude Code triển khai mã nguồn trên nhánh ai/dvo-verification-gate.
3. Kiểm duyệt bằng git diff, viết và chạy pytest đạt coverage ≥ 80%.

Thực hành 3: Gỡ lỗi (Debug) và Chạy không tương tác với claude -p

<role>Bạn là Kỹ sư Odoo 17 (Senior Odoo Developer) tại Vagataba.</role>

<context>
- Môi trường: Python 3.11, Odoo 17.0 Community, PostgreSQL 15.
- Module: custom_addons/vaga_stock (quản lý xuất kho theo quy tắc FEFO 3 màu: Xanh ≥ 6 tháng, Vàng 3 đến < 6 tháng biệt trữ cần OM duyệt, Đỏ < 3 tháng ngừng xuất).
</context>

<error_log trust="untrusted">
[DÁN ĐOẠN CODE BỊ LỖI VÀ TRACEBACK LOG ĐÃ ẨN DANH PII VÀO ĐÂY]
</error_log>

<task>
1. Phân tích nguyên nhân gốc (Root cause) khiến lô hàng màu Vàng (HSD 4 tháng) vẫn bị tự động gán vào phiếu xuất kho bán mới.
2. Đề xuất đoạn mã sửa lỗi chính xác trong hàm `_get_fefo_quants()`.
3. Viết 3 bài kiểm thử `pytest` bao phủ đủ 3 trường hợp biên: Lô Xanh (≥ 6T), Lô Vàng (3–<6T), Lô Đỏ (< 3T).
</task>

<output_contract>
Trả về: (1) Giải thích nguyên nhân gốc; (2) Khối code diff cần sửa; (3) Mã nguồn đầy đủ của 3 hàm test pytest.
</output_contract>

Thực hành 4: Tự động hóa Dashboard KPI kèm Kiểm chứng Checksum

<role>Bạn là Chuyên viên Tự động hóa Hệ thống (CAS) tại Vagataba.</role>

<context>
Dữ liệu nguồn: Sheet "Raw_Daily" gồm các cột: Date | SC_Code | Calls | Orders | Gross_Revenue | RTS_Orders (đã xóa toàn bộ tên và SĐT khách hàng theo Luật 91/2025/QH15).
Quy tắc hoa hồng 5 bậc (<50M: 1.0%, 50–<80M: 1.5%, 80–<120M: 2.0%, 120–<180M: 2.5%, ≥180M: 3.0%) và chế tài RTS (<10%: hưởng 100%, 10–12%: hưởng 80%, >12%: hưởng 50%).
</context>

<task>
Viết script tự động (Apps Script hoặc Python):
1. Tính toán các chỉ số: CVR (%), AOV (VNĐ), Tỷ lệ hoàn RTS (%), và Hoa hồng dự kiến theo đúng bảng 5 bậc & chế tài RTS.
2. Tạo bước kiểm tra tổng Checksum: đối chiếu tổng doanh thu các SC với tổng cột Gross_Revenue gốc, báo lỗi ngay nếu lệch > 1 VNĐ.
3. Định dạng màu cảnh báo (🟢 RTS < 10% | 🟡 RTS 10–12% | 🔴 RTS > 12%).
4. Gửi cảnh báo qua webhook vào lúc 19:00 hàng ngày nếu tỷ lệ RTS toàn đội vượt 10%.
</task>

<constraints>
- Không hard-code webhook URL hoặc khóa bí mật trong mã nguồn (đọc từ biến môi trường / Script Properties).
- Có xử lý ngoại lệ khi gặp dòng dữ liệu trống hoặc số cuộc gọi bằng 0 (tránh lỗi chia cho 0).
</constraints>

<output_contract>
Trả về mã nguồn hoàn chỉnh có chú thích tiếng Việt + hướng dẫn kiểm thử trên 5 dòng dữ liệu mẫu.
</output_contract>

🧪 BÀI KIỂM TRA CUỐI KHÓA

Bài 1: Xây dựng tính năng tự động hóa đạt chuẩn Staging/Production (10 điểm)

Bài 2: Gỡ lỗi (Debug) và Tối ưu mã nguồn hiện hữu (10 điểm)

Bài 3: Thiết kế & Triển khai Pipeline Agentic / MCP End-to-End (10 điểm)

✅ ĐIỀU KIỆN HOÀN THÀNH LEVEL 6 (ENGINEER)

✅ Chúc mừng bạn hoàn thành Level 6 (Engineer)! Bạn có thể kết hợp thêm kiến thức của Level 4–5 để dẫn dắt và huấn luyện tự động hóa cho toàn bộ các phòng ban tại Vagataba.

Tài liệu nội bộ Vagataba — V7.1 — 10/2026