TIỂU PHẨM L6-02: NV CÔNG NGHỆ VÀ "CLAUDE CODE SỬA LỖI ODOO" 🔧

📍 Module: §22 (Vibe Coding) & §23 (Agentic Engineering — Claude Code) | Level: L6 Engineer 🎓 Slide: L6 S8-S22 ⭐ Format: Demo — NV công nghệ dùng Claude Code sửa lỗi module Odoo theo quy chuẩn CLAUDE.md, .claude/rules/ và 7 quy tắc Git | 🎯 Bài học: 5 bề mặt của Claude Code / 3 chế độ quyền (Plan, Normal, Auto/Bypass trong Sandbox) / CLAUDE.md & .claude/rules/ / 7 quy tắc Git an toàn ⏱ ~8 phút | Số vai: 2 NV (NV công nghệ, trưởng nhóm) + Vân Anh tổng kết

Comedy Tools: The Game (Auto / Bypass ⚠️ chỉ được bật trong Sandbox cô lập!) + Escalation (Plan → Normal → Auto trong Sandbox) + Dramatic Irony (bài học AI agent xóa nhầm database khi chạy trực tiếp trên Production) + Callback (Checkpoint / Git stash = dây bảo hiểm quay lại an toàn)

Xưng hô cố định: NV công nghệ↔Trưởng nhóm: em/anh

BỐI CẢNH

[Phòng công nghệ, 14:00 chiều. Chuyên viên Quản trị Hệ thống & Tự động hóa Odoo (CAS) nhận phiếu báo lỗi: bộ lọc đối soát tiền thu hộ (COD) trong addon Odoo nội bộ chỉ hiển thị đơn trong ngày, không lọc được các đơn quá hạn > T+3 trong 7 ngày gần nhất. Cần khoanh vùng và sửa lỗi an toàn.]

🎬 MÀN 1 — "Claude Code = Tác tử lập trình đa bề mặt"

NV CÔNG NGHỆ: (mở Claude Code trên Terminal CLI — hoặc có thể dùng đồng bộ trên VS Code, JetBrains, tab Code của ứng dụng Claude Desktop, hay trên nền web claude.ai/code đã mở cho các gói Pro/Max/Team/Enterprise bao gồm cả ghế Team Standard)

claude "Lỗi: bộ lọc tiền thu hộ trong Odoo chỉ hiện đơn hôm nay,
không hiện đủ 7 ngày gần nhất để quét đơn quá hạn > T+3.
File: custom_addons/cod_module/models/cod.py.
Hãy phân tích nguyên nhân ở chế độ Plan trước khi đề xuất bản vá."

3 chế độ kiểm soát quyền trong Claude Code

NV CÔNG NGHỆ: (bắt đầu bằng Plan để xem phân tích → chuyển sang Normal) Claude hiển thị dòng mã sửa bộ lọc ngày → em kiểm tra logic → bấm đồng ý → lưu vào nhánh kiểm thử.

⚡ MÀN 2 — "CLAUDE.md, .claude/rules/ + 7 Quy tắc Git"

CLAUDE.md & .claude/rules/ = Bộ hiến pháp kỹ thuật cho Claude Code

# CLAUDE.md — Dự án Custom Addons Odoo Vagataba

## Cấu trúc thư mục
- custom_addons/ — Các module nghiệp vụ riêng của Vagataba (COD, FEFO, DVO)
- .claude/rules/ — Các quy tắc kiểm tra mã nguồn, bảo mật PII và chuẩn đặt tên
- tests/ — Bộ kiểm thử tự động (pytest)

## Quy tắc bắt buộc
- KHÔNG BAO GIỜ sửa trực tiếp vào thư mục mã nguồn gốc (core) của Odoo
- LUÔN viết kiểm thử tự động (unit test) cho mọi hàm mới hoặc bản vá lỗi
- Dung sai đối soát COD mặc định: ≤ 5.000 VNĐ/đơn (TK 6418); > 5.000 VNĐ/đơn gắn cờ Đỏ
- Chú thích (docstring) bằng tiếng Việt rõ ràng, tuân thủ chuẩn PEP 8
- Không bao giờ đưa khóa bí mật (.env, API key) hoặc dữ liệu PII thật vào kho code

💡 Mẹo nâng cao L6: Ngoài file CLAUDE.md ở gốc dự án, nhóm công nghệ Vagataba còn khai thác thư mục .claude/rules/ (quy tắc theo từng module), subagents (tác tử con chuyên chạy kiểm thử), hooks (tự động chạy trình kiểm tra cú pháp trước khi lưu), và cloud scheduled tasks (/schedule để quét lỗi bảo mật định kỳ mỗi đêm).

7 quy tắc Git bắt buộc khi lập trình cùng AI

Quy trình Điểm lưu (Checkpoint) 5 bước

1. Tạo điểm lưu an toàn trạng thái hiện tại (git stash / tạo nhánh mới)
2. Giao nhiệm vụ cho Claude Code ở chế độ Plan → Normal
3. Chạy bộ kiểm thử tự động (pytest) trên môi trường thử nghiệm
4. ĐẠT 100% → Lưu chính thức (git commit) & mở yêu cầu duyệt (Pull Request)
5. KHÔNG ĐẠT → Khôi phục ngay về điểm lưu (git checkout / git stash pop)

Kiến trúc Kết nối (MCP Connectors) cho Vagataba

📋 Mở L6 Slide 8-22 — "Claude Code đa bề mặt, CLAUDE.md, 7 quy tắc Git & Kiến trúc MCP an toàn."

🎤 VÂN ANH TỔNG KẾT

[Vân Anh bước ra.]

🎤 VÂN ANH: Claude Code (§23) là tác tử lập trình chuyên nghiệp hiện đã có mặt trên 5 bề mặt: Terminal CLI, VS Code, JetBrains, ứng dụng Claude Desktop và trình duyệt Web (claude.ai/code).

Để khai thác sức mạnh của Claude Code mà không bao giờ gặp thảm họa xóa nhầm dữ liệu, kỹ sư L6 tại Vagataba luôn khóa chặt 3 lớp bảo vệ:

1. Về chế độ quyền: Bắt đầu bằng Plan (phân tích, không sửa), làm việc hàng ngày ở Normal (hỏi trước khi sửa), và chỉ bật Auto / Bypass bên trong môi trường Sandbox cô lập để chạy kiểm thử tự động — tuyệt đối không bật Bypass trên máy chủ Production.
2. Về hiến pháp dự án: Thiết lập đầy đủ CLAUDE.md, .claude/rules/ và hooks để Claude luôn hiểu rõ cấu trúc thư mục và những điều cấm kỵ trước khi viết dòng code đầu tiên.
3. Về quy trình Git: Luôn tạo Điểm lưu (Checkpoint), làm việc trên nhánh riêng và có kỹ sư duyệt mã (PR Review) trước khi đưa lên hệ thống thật.

Trong ngành: Claude Code (Tác tử lập trình đa bề mặt), CLAUDE.md & .claude/rules/ (Tệp cấu hình quy tắc dự án), Sandbox Auto Mode (Chế độ tự chạy trong môi trường cô lập), Git Checkpoint (Điểm lưu khôi phục mã nguồn), Action Gate (Cổng người duyệt hành động).

📋 3 Bài học

1. Claude Code đa bề mặt & 3 chế độ quyền: Sử dụng linh hoạt trên CLI/IDE/Desktop/Web với chế độ Plan (lập kế hoạch), Normal (duyệt từng bước) và Auto / Bypass (chỉ bật trong Sandbox cô lập).
2. CLAUDE.md & .claude/rules/: Định nghĩa rõ cấu trúc dự án, chuẩn nghiệp vụ (như dung sai COD ≤ 5.000đ, > T+3) và các quy tắc cấm sửa core để Claude đọc trước mọi phiên làm việc.
3. 7 quy tắc Git & Điểm lưu (Checkpoint): Nhánh riêng, lưu nhỏ, kiểm thử tự động và con người duyệt mã trước khi gộp là lưới bảo hiểm cuối cùng của kỹ sư L6.

💬 Câu hỏi thảo luận

1. Tại sao khi cần sửa một lỗi phức tạp trên Odoo, kỹ sư L6 luôn yêu cầu Claude Code chạy ở chế độ Plan trước thay vì cho sửa file ngay lập tức?
2. Hãy viết thử 5 quy tắc cốt lõi trong file CLAUDE.md cho dự án hoặc kho kịch bản tự động hóa mà bạn đang phụ trách.
3. Vì sao chế độ Auto / Bypass rất hữu ích khi chạy kiểm thử tự động trong Docker/Sandbox cô lập, nhưng lại là điều tối kỵ trên máy chủ Production?

📹 KỊCH BẢN GỐC

Mapping nguyên bản → Vagataba

BVT Analysis

Tài liệu nội bộ Vagataba — V7.1 — 20/10/2026 Tiểu phẩm L6-02 — NV Công Nghệ Và "Claude Code Sửa Lỗi Odoo" Dẫn vào L6 Slide 8-22: Claude Code, CLAUDE.md, 7 quy tắc Git & MCP an toàn (§22 & §23)