# HDSD — AGENT-LAB: Đề nghị quy trình sơn & công thức pha màu

**Dành cho:** nhân viên phòng Lab (người ra công thức + quy trình đề nghị cho bộ phận kỹ thuật)
**Chạy trên:** máy chủ nội bộ `C:\Claw 2\Nghien cuu\Agent-Lab` · **địa chỉ Web UI:** `http://127.0.0.1:8098`
**Ngày lập:** 08/10/2026

## 1. Nguyên tắc làm việc (đọc trước khi dùng)

1. Agent trả về **ĐỀ NGHỊ**, không phải quy trình được duyệt. **Bắt buộc làm thẻ mẫu xác nhận** trước khi đưa cho chuyền sản xuất.
2. Ảnh là **đầu vào quan trọng nhất** — chụp sai thì kết quả sai: cần đủ sáng, không dùng đèn vàng, có **thẻ chuẩn màu/bảng trắng** trong khung, chụp **vuông góc**, và nếu được **chụp chung mẫu màu cạnh gỗ mộc trong cùng một khung**.
3. Ghi rõ **loại gỗ + nguồn gỗ + đặc tính quan sát được** (mạch hở/kín, dầu–nhựa, thớ xoáy, phôi mới chà nhám cấp nào, có vệt dầu/keo tràn không). Càng rõ, agent càng chọn đúng bước xử lý.
4. **Không tin tuyệt đối phần AI đọc màu.** Agent có thể nhìn nhầm chữ viết tay/nhãn, hoặc lệch tông do ảnh; luôn đối chiếu lại với thẻ mẫu màu đã đo hoặc máy đo màu.
5. Agent **chỉ dùng mã nguyên liệu có trong danh mục CSDL B**. Mã nào không có tồn kho sẽ được ghi rõ và đề xuất mã thay thế — Lab xác nhận lại với kho trước khi pha.

## 2. Cách chạy trên máy

Bấm đúp **`Chay_Agent-Lab.bat`** trong thư mục `C:\Claw 2\Nghien cuu\Agent-Lab`. File này sẽ:
- tắt bản đang chạy (nếu còn) để tránh trùng cổng,
- mở **server** (Web UI) và **worker** (xử lý hàng đợi) ở 2 cửa sổ thu nhỏ,
- tự mở trình duyệt tới `http://127.0.0.1:8098`.

> Agent chạy **tuần tự từng việc** (không chạy song song) vì mỗi việc cần 2 lượt AI. Gửi nhiều việc một lúc thì chúng xếp hàng chờ.

## 2b. Dùng từ máy khác (qua Tailscale) — có mật khẩu

- **Địa chỉ:** `https://desktop-9gsdkd2.tail0ffe94.ts.net/lab/` (nhớ có **dấu `/` cuối**).
- **Mật khẩu:** xem trong `mat_khau.txt` cùng thư mục (mặc định sinh tự động, dạng `lab-xxxxxx`). Muốn đổi: sửa file đó rồi chạy lại server (mật khẩu mới có hiệu lực, mọi người phải đăng nhập lại).
- Phiên đăng nhập giữ **12 giờ**; nút **Thoát** ở trang danh sách việc.
- Đây là đường truy cập **công khai trên internet** (Tailscale Funnel) — hãy giữ mật khẩu trong nội bộ phòng Lab. Muốn tắt hẳn truy cập ngoài: chạy `tailscale funnel --set-path=/lab off`.

## 3. Các bước gửi việc

1. Mở Web UI → điền **Người gửi / bộ phận**, **Loại gỗ / nền** (gõ tự do hoặc chọn trong danh sách hồ sơ gỗ: Cao su, Tràm, Sồi trắng/đỏ, Óc chó, Tần bì, Beech, Thông, Keo, Teak, Gỗ Dầu, MDF chuẩn/HMR/cán UV, veneer trên MDF…).
2. **Đặc tính gỗ** — ghi những gì mắt thấy (VD: *phôi mới chà #240, mạch hở, có vệt dầu ở mặt, thớ xoáy*).
3. **Yêu cầu chất lượng của khách** (gợi ý có sẵn: chống ẩm tủ bếp, chống ố vàng, chống cồn/dung môi, độ cứng màng 2H–H, chống bám bẩn dễ lau…) + **Độ bóng yêu cầu** (5–10 GU mờ / 25–35 GU satin / 60–80 GU bóng / > 90 GU bóng cao).
4. Đính **2 ảnh bắt buộc**: **ảnh gỗ mộc** và **ảnh mẫu màu cần đạt**.
5. **Email nhận kết quả** (tùy chọn, nên điền): gõ email vào ô đó — khi agent chạy xong, hệ thống **tự gửi file Word kết quả vào email này** (tiêu đề *"Agent-Lab — Đề nghị quy trình & công thức pha màu (việc #N · <loại gỗ>)"*, nội dung tóm tắt yêu cầu + link xem trên web, file `KET_QUA.docx` đính kèm). Để trống thì chỉ xem/tải trên web.
6. Bấm **Gửi cho agent**. Trang sẽ tự theo dõi trạng thái (`cho` → `dang_chay` → `xong`) và hiện kết quả + nút **Tải file Word** + dòng xác nhận **đã gửi email tới …**. Nếu gửi mail lỗi, dòng đó ghi rõ lỗi nhưng **kết quả vẫn xem/tải được bình thường** (log ở `viec\V####_ddmm\_log_mail.txt`).

> Gmail giới hạn ~25 MB/thư. Ảnh càng lớn thì file Word càng nặng (2 ảnh 1–1,5 MB ⇒ DOCX ~2,5 MB vẫn gửi được bình thường).

## 4. Agent chạy những gì

**Bước 1 — Phân tích ảnh (AI nhìn ảnh):** nhận diện loài/nền gỗ + mạch gỗ + thớ/vân + dấu hiệu dầu–nhựa/tanin; đọc mẫu màu (tông, độ sáng, tương phản, mức bóng, ước lượng dải L\*a\*b\*); **kết luận DYE / PIGMENT / DYE+PIGMENT kèm %**; cảnh báo rủi ro (loang đốm, cháy màu ở rãnh) và **những gì không thể kết luận từ ảnh**.

**Bước 2 — Áp 3 kho kiến thức để ra kết quả:**
- **CSDL A** (quy trình): 29 luật + 34 bước chuẩn + các quy trình mốc 112/116/118.
- **CSDL B** (màu): 26 mã danh mục + 121 ô màu đã đo từ bảng in.
- **CSDL D** (vật liệu & yêu cầu chất lượng): 24 loài/nền gỗ, 12 yếu tố ảnh hưởng, map bước theo nhóm nền, yêu cầu chất lượng → hệ sơn, hiệu chỉnh nồng độ theo độ hút màu.

**Kết quả trả về (file Word, kèm 2 ảnh đầu vào + phụ lục phân tích ảnh):**
- **PHẦN 1 — Bảng quy trình:** **đúng 2 phương án** (PA1 khuyến nghị, PA2 thay thế), chỉ gồm các **công đoạn phủ sơn**, ghi theo **số bước + tên chuẩn**; **sau mỗi lần chà nhám có dòng “KIỂM TRA MÀU – DẶM MÀU NẾU LÁC”**.
- **PHẦN 2 — Công thức pha màu:** bảng riêng cho **từng công đoạn có màu** (mã · tỉ lệ % · vai trò), thứ tự cho nguyên liệu, thời gian khuấy, yêu cầu lọc, bảng 4 dòng chỉnh lệch, và **3 ô thử nồng độ**.
- **PHẦN 3 — Cần làm thẻ mẫu xác nhận:** ô thử, tiêu chí đạt (GU, màu so mẫu, bám dính) và giới hạn của ảnh.

## 5. Sau khi nhận kết quả

1. In file Word, **làm thẻ mẫu** theo các ô thử trong PHẦN 3.
2. Đo lại màu/độ bóng thật; nếu lệch, dùng bảng chỉnh lệch hoặc gửi lại việc mới kèm ghi chú *(VD: “mẻ thử 5% còn đỏ hơn mẫu 2 đơn vị a\*”)* — càng ghi cụ thể càng tốt.
3. Ghi lại **kết quả thử (đạt/không đạt)** để bộ phận kỹ thuật đối chiếu về sau.

## 6. Khi có sự cố

| Hiện tượng | Cách xử lý |
|---|---|
| Trang không mở | Chạy lại `Chay_Agent-Lab.bat`; kiểm tra cổng 8098 có bị chiếm không |
| Việc ở trạng thái `loi` | Mở `viec\V####_ddmm\_log_b1.txt` / `_log_b2.txt` xem lỗi; gửi lại việc mới (ảnh giữ nguyên) |
| Kết quả nói “không có tồn kho” | Xác nhận với kho; Lab chọn mã thay thế cùng loại màu rồi ghi vào công thức |
| Ảnh mờ/thiếu sáng, kết quả lệch nhiều | Chụp lại theo mục 1 (thẻ chuẩn màu + đủ sáng) rồi gửi lại |
| Máy chạy chậm, RAM thấp | Việc chạy tuần tự; đợi việc trước xong rồi gửi tiếp |

## 7. Nơi lưu kết quả

`C:\Claw 2\Nghien cuu\Agent-Lab\viec\V####_ddmm\` — gồm `anh\` (2 ảnh dùng cho AI), `anh_goc\` (ảnh gốc Lab gửi), `PHAN_TICH.md`, `QUY_TRINH_VA_CONG_THUC.md`, `KET_QUA.md`, `KET_QUA.docx`, `_log_b1.txt`, `_log_b2.txt`.
Danh sách việc: `http://127.0.0.1:8098/danh-sach`