vn-law-check
Open-source compliance audit for Vietnamese websites and apps. Bảo AI coding agent rà soát các rủi ro pháp lý theo luật Việt Nam và gợi ý chỗ cần sửa trước khi ra mắt.
Dùng cho Claude Code, Cursor, Copilot, Windsurf, Cline, Codex. Hỗ trợ cả website lẫn mobile app.
English
Nó giúp gì?
Nếu website hoặc app của bạn có một trong các dấu hiệu sau thì nên check ngay:
- form thu thập email, số điện thoại, họ tên
- Google Analytics, Meta Pixel, TikTok Pixel, ads SDK
- đăng nhập, giỏ hàng, thanh toán, đặt lịch
- chatbot AI hoặc tool AI trên frontend
- cookie banner, privacy policy, consent flow
- nội dung quảng cáo, chính sách hoàn tiền, điều khoản sử dụng
Từ 01/01/2026, Luật Bảo vệ dữ liệu cá nhân 91/2025 yêu cầu rõ ràng hơn về mục đích thu thập, đồng ý, lưu trữ và chia sẻ dữ liệu. Nhiều doanh nghiệp nhỏ và startup đang phát triển nhanh nhưng bỏ qua các điểm này. Repo này giúp bắt lỗi sớm trước khi bị phạt hoặc bị khách phản hồi.
Bạn không cần đọc luật từ đầu. Chỉ cần cho AI biết project hoặc URL, nó sẽ phân loại site, rà soát các checklist dựa trên luật Việt Nam và trả về báo cáo có mức ưu tiên: 🔴 cần sửa ngay, 🟡 nên cải thiện, 🟢 đạt, ⚪ không áp dụng.
Vì sao repo này có giá trị?
- Tập trung vào luật Việt Nam, hiện đang có rất ít tool open-source theo đúng quy định mới nhất.
- Dành cho đội dev và AI agent: bạn không cần đọc luật dài, chỉ cần “audit pháp lý website này”.
- Có thể dùng từ giai đoạn xây dựng sản phẩm, không cần chờ legal team review toàn bộ.
- Cung cấp nguồn tham chiếu, checklist và tài liệu để kiểm tra lại.
Kết quả trông như thế nào?
Trích từ báo cáo trên site demo, một shop cà phê giả lập:
🔴 Coi việc "tiếp tục sử dụng website" là đồng ý
chinh-sach-bao-mat.html:12: "Bằng việc tiếp tục sử dụng website, bạn được xem là đã đồng ý..."- Căn cứ: Điều 9 khoản 4 điểm d Luật 91/2025/QH15: im lặng hoặc không phản hồi không được coi là đồng ý.
- Đề xuất: bỏ câu này, xin đồng ý rõ ràng tại đúng chỗ thu thập dữ liệu.
Mỗi lỗi được xếp mức: 🔴 cần xử lý ngay, 🟡 nên cải thiện, 🟢 đạt, ⚪ không áp dụng. Blog hay trang tĩnh không thu thập gì thì chỉ nhận về 1 dòng nhắn ngắn; nhưng site bán hàng, có login, tracking hoặc AI chatbot thì báo cáo sẽ dài và chi tiết hơn.
Dùng thế nào?
Bước 1: cài. Chọn theo tool bạn đang dùng.
Claude Code (gõ trong Claude Code, không phải terminal):
/plugin marketplace add mhfed/vn-law-check
/plugin install vn-law-check
Cursor, Windsurf, Copilot, Cline, Codex (chạy trong thư mục project):
curl -fsSL https://raw.githubusercontent.com/mhfed/vn-law-check/main/install.sh | bash
Clone thẳng vào thư mục skills của Claude, không qua marketplace:
git clone --depth=1 https://github.com/mhfed/vn-law-check ~/.claude/skills/vn-law-check
Muốn cài riêng cho 1 project thì đổi ~/.claude/skills/ thành .claude/skills/ trong project đó.
install.sh cài checklist vào .vn-law-check/ và không ghi đè file nào của bạn. Nếu project đã có AGENTS.md, CLAUDE.md... thì script chỉ chèn thêm một đoạn ngắn tóm tắt để AI biết cách dùng toolkit.
Bước 2: bảo AI kiểm tra. Mở project rồi gõ:
audit pháp lý website này theo luật Việt Nam
Không có source code, chỉ có địa chỉ website cũng được:
audit pháp lý https://ten-mien-cua-ban.vn
Bước 3: sửa. Đọc báo cáo, rồi bảo tiếp: "sửa giúp các mục 🔴".
Chưa có chính sách bảo mật, hoặc có mà copy từ đâu đó? Bảo tiếp:
soạn chính sách bảo mật cho dự án này
Agent soạn một bản nháp dựa trên code của bạn: site đang thu dữ liệu gì, gửi cho dịch vụ nào (Google Analytics, Firebase, OpenAI...), rồi gợi ý sửa form đồng ý, banner, privacy policy, và các điểm cần cân nhắc trước khi ship.
Làm app bằng Lovable, Bolt, v0 hay Cursor?
Không cần cài gì. Mở bộ prompt dán là chạy (bản web: mhfed.github.io/vn-law-check/prompt-cho-vibe-coder.html), copy rồi dán vào khung chat của công cụ. Có sẵn prompt kiểm tra app theo luật Việt Nam, banner cookie chỉ bật Google Analytics, Pixel sau khi đồng ý, ô đồng ý và bảng Supabase lưu thời điểm đồng ý, trang chính sách bảo mật, nút xóa tài khoản.
Lưu ý: Repo này chỉ hướng dẫn AI làm rà soát sơ bộ, không đảm bảo kết quả đúng luật 100%. Mục tiêu là giúp bạn biết mình đang thiếu gì và cần chốt ở đâu. Nếu có hoạt động nhạy cảm về thu thập dữ liệu, thanh toán, quảng cáo hoặc AI, nên có bên pháp lý review lại.
Hỏi nhanh
Có thay được luật sư không? Không. Kết quả do AI tạo, chỉ để tham khảo, giúp bạn biết mình đang thiếu gì. Đừng hoảng khi thấy 🔴: phần lớn là chỉnh sửa nhỏ trong code, làm được trong vài giờ. Việc gì quan trọng thì hỏi lại người làm luật. Xem DISCLAIMER.md.
Mình không dùng AI agent thì sao? Hiện tại cần một trong các tool ở trên. Bạn vẫn có thể đọc thẳng các checklist trong references/ như một danh sách kiểm tra cho team.
Có tốn tiền không? Repo miễn phí. Chi phí duy nhất là lượt dùng AI trong tool bạn đang có sẵn.
Theo luật nào? Các văn bản mới nhất, đối chiếu lần gần nhất ngày 03/11/2026:
- Luật Bảo vệ dữ liệu cá nhân 91/2025 + NĐ 356/2025
- Luật Thương mại điện tử 122/2025 + NĐ 248/2026
- Luật An ninh mạng 116/2025 + NĐ 333/2026
- Luật Quảng cáo sửa đổi 75/2025 + NĐ 342/2025
- Luật Trí tuệ nhân tạo 134/2025 + NĐ 142/2026
- Luật Bảo vệ quyền lợi người tiêu dùng, Luật Giao dịch điện tử
Link toàn văn ở sources/legal-references.md.
Khác gì các skill compliance khác? Các bộ có sẵn gần như toàn GDPR, CCPA. Chưa có bộ nào theo luật Việt Nam, trong khi luật VN vừa thay gần hết trong 2025-2026.
Góp ý: không cần biết code
Mình là dev, không phải luật sư. Chỗ nào chưa đối chiếu được với toàn văn, mình ghi thẳng "CHƯA XÁC MINH". Hiện còn vài chục chỗ như vậy, phần lớn ở các giao dịch/thu thập dữ liệu có tính chất đặc thù.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
