# NGUỒN — BẢNG MÀU TẢI TỪ TRANG mausac.ngoducminh.com

**Ngày lấy:** 06/10/2026 · **Người lấy:** trợ lý (theo yêu cầu anh Minh)

## 1. Nguồn dữ liệu

- **Trang:** https://mausac.ngoducminh.com/danh-sach-mau.html (tiêu đề “Danh Sách Màu”)
- **Bản HTML lưu:** `trang-mausac\trang_danh-sach-mau.html`
- **11 ảnh bảng màu tải về:** `trang-mausac\images\` (bản gốc 936×742 → 1920×2560 px)
  - `danh-sach-mau.jpg` — ảnh banner “BẢNG MÃ MÀU” (không phải bảng ô màu)
  - Nhóm **DYE** (màu tan): `danh-sach-mau-dye-bang-1.jpg` … `-bang-4.jpg`
  - Nhóm **PIGMENT** (màu đặc): `danh-sach-mau-pigment-bang-1.jpg` … `-bang-6.jpg`
- **Trang web liệt kê 2 nhóm**, mỗi nhóm chia theo màu: Vàng · Đỏ · Đen · Xanh (+ Nâu · Hồng · Base trắng ở nhóm PIGMENT).

## 2. Cách đọc — 2 nguồn độc lập

| Nguồn | Việc | Kết quả |
|---|---|---|
| **AGY** (`gemini-3.8-flash-high`, 580,4 s · 231.248 token) | Đọc từng ảnh: cấu trúc hàng/ô, **nhãn in dưới mỗi ô** (mã màu + nồng độ %), tông màu nhìn thấy | `_agy_bang_mau_web.md` — **156 ô màu** |
| **Code (OpenCV)** | Dò ô màu trên ảnh → **cân trắng cục bộ** bù gradient ánh sáng → **hex · RGB · L\*a\*b\*** | `_bang_mau_web_chot.csv` — 112/121 dòng có màu đo được |
| **AGY (lượt 2)** | Đọc **hex xấp xỉ từng ô** để đối chiếu nguồn | `_agy_hex_tung_o.md` → cột `hex_agy` + `dE_hai_nguon` trong CSDL B |

**Vì sao không lấy hex của AI làm số chính:** AI đọc ảnh chỉ *ước lượng* màu; lấy **trung vị pixel** trong ô màu rồi quy đổi CIE Lab là phép đo lặp lại được và kiểm chứng được. Hex của AGY dùng để **đối chiếu chéo** (xem cột `dE_hai_nguon`).

## 3. Cảnh báo độ chính xác (bắt buộc đọc trước khi dùng số)

1. Số hex/Lab đo từ **ảnh chụp bảng in**, **KHÔNG phải** đo bằng máy quang phổ trên mẫu vật lý ⇒ sai khác do: ánh sáng chụp, góc chụp, màu giấy nền (giấy xanh nhạt), chất lượng in.
2. Các ô mẫu trên bảng là **dán thủ công** ⇒ không phải lúc nào cũng đậm dần đúng theo 5 % → 10 % → 30 %; chênh lệch nhỏ (1–3 đơn vị L\*) là bình thường.
3. Muốn số liệu dùng để **giao hàng/đối chiếu khách**: phải đo **mẫu vật lý** bằng máy đo màu (D65/10°) + đo độ bóng theo ASTM D523.
4. Nhãn/mã màu và nồng độ trong CSDL là **nguyên văn theo bảng in** (AGY đọc) — không tự sửa.

## 4. Nơi lưu trong CSDL B

- Bảng **`mau_bang_in`** trong `CSDLB.db`: `nhom` (DYE/PIGMENT) · `ma_mau` · `nong_do` (%) · `hex` · `r_srgb/g_srgb/b_srgb` · `L_star/a_star/b_star` · `hex_agy` · `dE_hai_nguon` · `file_anh` · `o` (hàng-cột) · `nhan_goc` · `tong_mau` (tông màu AGY đọc) · `do_duoc` · `cach_gan` · `mau_id` (liên kết bảng `mau`) · `nguon_url` · `ngay_tai` · `ghi_chu`.
- Cột `mau_id` trống nghĩa là mã màu trên bảng in **chưa có** trong bảng `mau` (danh mục pigment/nguyên liệu của dự án B) — cần bổ sung khi có TDS/tồn kho.

## 5. File kèm trong thư mục

- `_agy_bang_mau_web.md` — AGY đọc nhãn + tông màu (11 ảnh)
- `_agy_hex_tung_o.md` — AGY đọc hex từng ô (đối chiếu)
- `_bang_mau_web_chot.csv` — bảng chốt: nhãn + màu đo được (nguồn để nạp CSDL B)
- `BOI_CANH.txt` / `YEU_CAU.txt` — yêu cầu giao cho AGY (để chạy lại được)
- `_do_o_mau_v4.py` · `_do_o_mau_v5.py` · `_ghep_nhan_va_mau.py` · `_chot_cuoi.py` — mã dò ô màu & ghép nhãn
