# Hàng Rào Kiểm Chứng Chất Lượng 6 Giai Đoạn (Verification Quality Gate)

Mọi thay đổi mã nguồn trước khi bàn giao bắt buộc phải đi qua 6 bước kiểm duyệt:

## Giai đoạn 1: Build & Server Health Check
- Kiểm tra tiến trình FastAPI / Uvicorn đang chạy với cờ `--reload`.
- Đảm bảo server khởi động sạch sẽ, không có syntax error hoặc import vòng (circular import).

## Giai đoạn 2: Static Type & Schema Validation
- Kiểm tra kiểu dữ liệu tĩnh trên Python (Pydantic models, typing) và JavaScript/TypeScript.
- Đảm bảo 100% số liệu tài chính VNĐ dùng `Decimal` / `NUMERIC(18, 4)` / `BIGINT`.

## Giai đoạn 3: Linting & Code Hygiene
- Quét sạch toàn bộ `console.log`, `print` debug, commented-out dead code.
- Tuân thủ nguyên tắc Modular: File dưới 200 dòng, phân tách rõ các tầng Domain - Application - Infrastructure - UI.

## Giai đoạn 4: Automated Test Suite (100% Passed)
- Chạy bộ kiểm thử tự động `pytest tests -v` đạt 100% Passed.
- Đảm bảo cơ chế Teardown / Cleanup sạch sẽ 100% dữ liệu test, không để sót bản ghi mock trong DB.

## Giai đoạn 5: Security & Data Integrity Scan
- Zero-Secret Leakage: Không hardcode API key, password hay token.
- SQL Injection & Parameterization: 100% truy vấn DB có tham số hóa.
- Tuân thủ quy định Zero-Tolerance Synthetic Data: Chỉ sử dụng dữ liệu thực từ GDT, Odoo dump và hồ sơ Công ty Định Sơn MST `0202111150`.

## Giai đoạn 6: Real Browser Interaction Verification
- Kiểm thử trực tiếp trên trình duyệt thực bằng Playwright (mô phỏng mousedown, mousemove, mouseup, click, phím tắt, kéo dãn cột bảng tính).
- Đảm bảo giao diện Dark Slate `#0b0f19`, mật độ thông tin cao, Zero-Occlusion (menu không đè nội dung).