# QUY TRÌNH LÀM VIỆC VỚI CSDLA — NHẬN ẢNH, CẬP NHẬT & ĐỀ XUẤT **Dự án A — Phân tích & nhận định quy trình sơn gỗ nội thất** · Công ty TNHH SX-TM Hóa Keo Bình Thạnh (BT CHEM) **Cập nhật:** 05/10/2026 · **CSDL:** `CSDLA.db` (7 bảng, 842 dòng) · **Bộ chuẩn:** 34 bước Step Finish --- ## 1. HAI CHẾ ĐỘ NHẬN ẢNH | | **CHẾ ĐỘ A — CẬP NHẬT CSDL** | **CHẾ ĐỘ B — ĐỀ XUẤT QUY TRÌNH** | |---|---|---| | Khi nào dùng | Chủ dự án gửi **phiếu làm mẫu / phiếu quy trình / bảng công thức / thẻ màu** của các mẫu đã làm | Chủ dự án gửi **ảnh mẫu màu cần đạt + ảnh phôi gỗ** của một đơn hàng mới | | Thư mục nhận ảnh | `anh_cap_nhat\` | `anh_mau_moi\` | | Bản yêu cầu giao cho AGY | `YEU_CAU_cap_nhat_csdl.txt` | `YEU_CAU_de_xuat_quy_trinh.txt` | | Quyền với CSDLA | **GHI** (thêm quy trình + bước + mã màu; **backup trước khi ghi**) | **CHỈ ĐỌC** | | Kết quả | `CAP_NHAT_CSDLA_.md` + CSDLA dày thêm + báo số dòng trước/sau | `DE_XUAT_GON__.md` + DOCX: **1 bảng quy trình ngắn gọn, KHÔNG ghi tên thương mại/mã sản phẩm sơn** | | Lệnh chạy | `python _run_agy_theo_lo.py cap_nhat` | `python _run_agy_theo_lo.py de_xuat` | *(Không gõ lệnh cũng được: `python _run_agy_theo_lo.py` sẽ tự nhận — có ảnh trong `anh_cap_nhat` thì chạy chế độ A, có ảnh trong `anh_mau_moi` thì chạy chế độ B.)* --- ## 2. VIỆC HỆ THỐNG TỰ LÀM MỖI LẦN CÓ ẢNH MỚI (5 bước) 1. **Nhặt ảnh mới**: chỉ lấy ảnh **mới hơn lần chạy trước** trong kho ảnh Telegram, khử trùng theo md5 → copy vào thư mục nhận, đặt tên thứ tự (`capnhat_01…` / `mau_moi_01…`). 2. **Dọn lô cũ**: ảnh của lô trước (đã xử lý) tự chuyển sang `da_xu_ly\` → thư mục nhận luôn chỉ chứa lô mới, không xử lý lại ảnh cũ. 3. **Giao AGY** (đúng dự án A, model đọc ảnh): phân loại ảnh → trích **nguyên văn** màu sắc · công thức/tỉ lệ pha · từng bước → **áp vào đúng số + tên chuẩn trong bộ 34 bước** → với chế độ A thì **backup CSDLA rồi ghi**; với chế độ B thì truy vấn CSDLA để tìm quy trình gần nhất rồi lập quy trình đề xuất. 4. **Kiểm chứng độc lập**: đối chiếu số liệu agy trích với CSDLA và với ảnh; kiểm số dòng các bảng trước/sau; xác nhận **không có dòng cũ nào bị sửa/xoá**; kiểm **không lọt tên riêng** khách hàng/kỹ thuật viên. 5. **Xuất & gửi**: `CAP_NHAT_CSDLA_.md` hoặc `DE_XUAT_QUY_TRINH_.md` → **DOCX trắng đen** gửi Telegram + ghi `NHAT_KY_du-an-A.md`. --- ## 3. ĐỂ AGY ĐỌC ĐƯỢC NHIỀU NHẤT, ẢNH NÊN CÓ - **Phiếu làm mẫu / phiếu quy trình**: chụp **thẳng, đủ 4 góc phiếu, đủ chữ** (nếu phiếu 2 mặt hoặc 2 trang → chụp/gửi **cả 2**); chụp **cả tấm mẫu gỗ thành phẩm** cạnh phiếu như đang làm. - **Bảng công thức pha màu**: chụp rõ phần ghi **mã nguyên liệu + khối lượng** và **thẻ bước mẫu phân bậc** (nếu có). - **Mẫu màu cần đạt**: chụp **cận bề mặt**, ánh sáng ban ngày hoặc đèn trung tính, **không dùng đèn vàng**, không bóng loá — để đọc đúng tông màu và độ bóng. - **Phôi gỗ nền**: chụp **mặt mộc chưa sơn** (thấy rõ vân, mạch gỗ, màu mộc, vết keo/lỗi mộc) và nếu biết thì nói thêm **tên gỗ** (sồi, tràm, thông, cao su, veneer…). - **Ghi kèm 1 dòng nếu có**: mã mẫu/mã màu, loại gỗ, hệ sơn mong muốn (NC / PU / nước / UV / dầu), độ bóng (5 % · 10 % · 15 %…), sản phẩm (bàn, tủ, giường…). ## 4. NGUYÊN TẮC DỮ LIỆU (áp dụng mọi lần) 1. **Giữ nguyên văn** số liệu, mã nguyên liệu, cả lỗi chính tả của nguồn — không tự sửa. 2. Ô nào nguồn không ghi thì ghi rõ **“nguồn không ghi”**, tuyệt đối **không bịa**. 3. CSDLA chỉ **ghi thêm**, không sửa/xoá dòng cũ; **backup trước mỗi lần ghi**. 4. **Không lưu tên riêng** khách hàng/kỹ thuật viên trong CSDLA. 5. Mọi con số trích ra đều phải **kiểm chứng được** với CSDL hoặc ảnh gốc. ## 5. VỊ TRÍ CÁC THƯ MỤC & FILE (thư mục dự án) | Đường dẫn | Dùng để | |---|---| | `CSDLA.db` | Cơ sở dữ liệu quy trình sơn (bản chính) | | `01-Bo-dinh-nghia-34-buoc.md` | Bộ bước chuẩn 34 bước, 3 ngôn ngữ | | `anh_cap_nhat\` · `anh_mau_moi\` | Thư mục nhận ảnh của 2 chế độ | | `da_xu_ly\` | Ảnh của các lô đã xử lý (lưu vết) | | `YEU_CAU_cap_nhat_csdl.txt` · `YEU_CAU_de_xuat_quy_trinh.txt` | Bản yêu cầu giao AGY | | `_run_agy_theo_lo.py` | Chạy agy theo chế độ (tự nhặt ảnh, tự dọn lô cũ) | | `NHAT_KY_du-an-A.md` | Nhật ký dự án (mỗi lô 1 mục) | | `_backup_CSDLA_*.db` | Các bản backup trước mỗi lần ghi CSDL | ## 6. KỸ THUẬT TẠO HIỆU ỨNG TỐI / GIẢ CỔ — QUY TẮC ĐÃ CHỐT (chủ dự án, 05/10/2026) > **Với hiệu ứng 2 tông màu (nền tối + lộ nâu ấm ở gờ vân), ưu tiên tuyệt đối tuyến “LÓT MÀU + CHÀ LIGHT/CHÀ MÒN” — KHÔNG dùng lau glaze làm tuyến chính.** - **Lý do (có bằng chứng trong CSDLA):** glaze bám dính cơ học tạm thời, màng bán khô yếu ⇒ tróc khi cắt ca-rô giật băng keo — **ID 44 (glaze đen BT 2203: tróc 12/12 vị trí** trên cả gỗ thông và cao su), **ID 70–71 (DL 16/19: cả 4 phương án công thức glaze tróc không đạt)**, **ID 98 (KPH #422: glaze đọng khe cước + màng 75 µm ⇒ không khô chân cước)**. - **Tuyến thay thế (đã chứng minh đạt bám):** **sơn lót PHA MÀU (lót màu)** cùng hệ nhựa với lớp sau → màng liền khối; tạo hiệu ứng bằng **chà light/chà mòn trên đỉnh gờ** để lộ lớp stain ấm bên dưới — **ID 5 · ID 8 · ID 31–32 đạt 4B/5B**. - **Điều kiện bắt buộc mọi đề xuất:** **test cắt ca-rô + giật băng keo (ASTM D3359) trên thẻ mẫu, khô ≥ 20–24 giờ, chỉ chạy chuyền khi đạt 4B–5B**; phun **2 passes, màng ướt 100–125 µm**; hỗn hợp lót màu NC dùng hết trong **2–3 giờ**. - **Glaze chỉ dùng có điều kiện:** khi rãnh cước quá sâu (> 0,8 mm) súng phun lót màu không tới đáy — khi đó phải lau sạch mặt phẳng, khô 45–60 phút, phủ lớp khoá **≥ 100–120 µm** và vẫn phải test ca-rô đạt. - **Hệ sơn:** NC (stain NC · lót màu NC · lót NC trong · bóng NC NY) — **không dùng 2K** trừ khi chủ dự án yêu cầu. ## 7. QUY TẮC TRÌNH BÀY BẢN ĐỀ XUẤT — CHỐT 06/10/2026 (theo yêu cầu trực tiếp của chủ dự án) ### 7.0 ⭐ QUY TRÌNH LÀM VIỆC 2 BƯỚC VỚI AGY — BẮT BUỘC (chốt 06/10/2026) > *“phải luôn kết hợp với agy khi thực hiện công việc… Đầu tiên là prompt như đã được huấn luyện cho agy phân tích hình ảnh. Sau đó lấy những phân tích của agy áp dụng vào các kiến thức đã được huấn luyện trong cơ sở dữ liệu để đưa ra quy trình đề nghị chuẩn.”* 1. **BƯỚC 1 — AGY PHÂN TÍCH ẢNH:** prompt huấn luyện **`YEU_CAU_BUOC1_phan_tich.txt`** → đọc ảnh `mau_*`, `moc_*` (nếu có), **tất cả ô `zoom_*`**, số đo `_zoom_do_mau.txt` → xuất **`PHAN_TICH__.md`**. 2. **BƯỚC 2 — ÁP KIẾN THỨC CSDLA:** prompt **`YEU_CAU_BUOC2_ap_csdl.txt`** → nạp file phân tích + **`CSDLA_KIEN_THUC_HUAN_LUYEN.md`** (bảng `huan_luyen` + quy trình chuẩn **id 116** + bộ 34 bước + QT_ công ty) → xuất **`QUY_TRINH_DE_XUAT__.md`** (PA 1 = kỹ thuật chuẩn, PA 2 = thay thế). 3. **Thực thi:** chạy `snapshot_kien_thuc_CSDLA.py` (cập nhật gói kiến thức) rồi `_pipeline_agy_2_buoc.py ` — **2 lượt agy liên tiếp, không bỏ bước, không tự làm tắt.** > **Tài liệu gửi đi CHỈ gồm các QUY TRÌNH SƠN ĐỀ XUẤT — ngắn gọn, 2 phương án, kèm ảnh mẫu (và ảnh gỗ mộc nếu có).** 0. **⭐ PHẠM VI TÀI LIỆU (chốt 06/10/2026):** chỉ in: (a) tiêu đề ngắn; (b) ảnh mẫu màu + ảnh gỗ mộc nếu có (thiếu thì 1 dòng *“THIẾU ẢNH GỖ MỘC — đề nghị cung cấp”*); (c) **2 bảng quy trình ≤ 8 dòng**; (d) **3–5 dòng lưu ý bắt buộc**. **KHÔNG in**: dữ liệu phân tích màu/zoom/L\*a\*b\*, nhận diện loài gỗ, mảng–khối màu, mục căn cứ & truy vết (mã sản phẩm, ID CSDLA, trích dẫn quy trình chuẩn), **và TUYỆT ĐỐI KHÔNG nhắc KPH/sự cố**. Phân tích vẫn làm nội bộ để chọn kỹ thuật, chỉ in khi chủ dự án yêu cầu. > **Mô tả NGẮN GỌN, mỗi lô đưa ra 2 quy trình, kèm ảnh gỗ mộc, và luôn kiểm tra–dặm màu sau chà nhám.** 1. **NGẮN GỌN — CHỈ MÔ TẢ QUY TRÌNH:** dùng **bảng + gạch đầu dòng**, **mỗi bước 1 dòng**; **không viết đoạn văn dài**; phần phân tích ≤ 8 dòng; tài liệu ≤ 1–2 trang A4. 2. **2 QUY TRÌNH ĐỀ XUẤT mỗi lô:** **PA 1 (khuyến nghị — bám mẫu nhất)** và **PA 2 (thay thế — ít lớp/ít rủi ro/dễ thi công hoặc rẻ hơn, cùng tông màu)**; mỗi PA **1 bảng ≤ 8 dòng** + **1 dòng khác biệt chính** + **1 dòng ưu/nhược**; ghi rõ PA khuyến nghị. 3. **ẢNH GỖ MỘC (gỗ chưa sơn) — PHẢI CÓ:** tài liệu chèn **cả ảnh mẫu màu và ảnh gỗ mộc**. Quy ước tên trong `anh_mau_moi\`: **`mau_*.jpg` = ảnh mẫu**, **`moc_*.jpg` = ảnh gỗ mộc**. Nếu chủ dự án **chưa gửi ảnh mộc** → in **1 dòng ngay đầu tài liệu**: *“THIẾU ẢNH GỖ MỘC — đề nghị chủ dự án cung cấp”*; **không tự suy diễn/bịa** đặc điểm gỗ mộc. - Khi nhận ảnh: nếu **không rõ ảnh nào là gỗ mộc** → dùng `vision_analyze` xem từng ảnh rồi mới đặt tên; nếu ảnh mộc là **cùng tấm gỗ với mẫu** thì ghi rõ trong tài liệu (mộc → thành phẩm). 4. **CHÀ NHÁM LÀM LÁC MÀU → BẮT BUỘC KIỂM TRA MÀU & DẶM MÀU:** mọi bước chà nhám (kể cả chà mòn/highlight) **có thể làm lác/bạt màu lớp trước** ⇒ trong bảng quy trình, **sau mỗi lần chà nhám và trước công đoạn sơn phủ kế tiếp** phải có dòng **“KIỂM TRA MÀU – DẶM MÀU NẾU LÁC”** (dùng **Bước 6 – Sơn màu điều chỉnh/dặm sương màu loãng** hoặc **Bước 7 – Màu PAD**), kèm **tỉ lệ pha loãng + cách dặm + phạm vi dặm**. Ngoài bảng luôn có **1 dòng lưu ý**: *“Sau MỖI lần chà nhám: kiểm tra màu dưới đèn — vùng nào lác/bạt màu thì dặm lại đúng tông rồi mới phủ lớp kế tiếp.”* 5. **ZOOM ẢNH ≥ 5 ĐIỂM TRƯỚC KHI KẾT LUẬN HIỆU ỨNG MÀU (chốt 06/10/2026):** mỗi lô **tự động cắt sẵn các ô zoom** bằng script `tao_zoom.py` → sinh `anh_mau_moi\zoom_1..8_*.jpg` (6 điểm rải đều 30 %×30 % phóng 3× + ô tối nhất + ô sáng nhất) và **file số liệu đo sẵn** `anh_mau_moi\_zoom_do_mau.txt` (RGB/hex + L\*a\*b\* + mức biến thiên từng ô). AGY **bắt buộc đọc các ô zoom này**, ghi **1 dòng/điểm** và **dùng đúng số đo sẵn** (không tự đoán màu), rồi kết luận kỹ thuật tạo màu theo bảng dấu hiệu: | Hiệu ứng | Dấu hiệu trên ảnh | |---|---| | **Stain màu (nhuộm)** | nhuộm **đều** trên nền gỗ, **không đọng** ở ghim sớ, chuyển tiếp mượt, chênh sáng giữa các điểm **nhỏ** | | **Lau màu (wiping stain)** | **đậm hơn nhưng kém đều** (dễ đốm) ⇒ **BẮT BUỘC có LÓT LỎNG / washcoat trước khi lau màu để không bị đốm** | | **Lau glaze LỎNG** | **ám đen ĐỀU trên NỀN LÓT** (mặt thịt bị ám mờ) **+ để lại màu trong GHIM SỚ** — **giống Duro stain** ⇒ kèm cảnh báo bám dính, test ca-rô tại giao diện | | **Duro stain** | màu **chỉ đậm ở vân/mạch**, mặt phẳng hầu như sạch | 6. **PHÂN TÍCH MÀU GỖ MỘC:** khi có ảnh mộc, so sánh số đo màu mộc ↔ màu mẫu để tính **độ hạ tông cần thiết**; khi chưa có, dùng giả định của chủ dự án và **ghi rõ là giả định**. 7. **CÁCH PHA MÀU ĐỂ LAU — DÙNG GLAZE PHA TINH MÀU (chủ dự án xác nhận 06/10/2026):** bước **Lau màu (Bước 9)** có thể dùng **glaze nền pha tinh màu rồi pha loãng** để lau, không cần sản phẩm “wiping stain” riêng. Ghi vào bảng: **glaze : tinh màu ≈ 100 : 3–8** (đánh dấu là *tỉ lệ đề nghị thử* nếu CSDLA chưa có tỉ lệ chuẩn) + **dung môi bay hơi chậm** tới ~10–12 s; **dùng hết trong 2–3 h**; lau **miết theo chiều thớ** cho màu chui vào ghim sớ rồi **lau sạch mặt thịt** — màu nằm TRONG rãnh, mặt phẳng sạch. 8. **⚠️ TRƯỚC KHI LAU GLAZE MÀU — KHÔ HOÀN TOÀN & KHÔNG CHÀ XƯỚC (lưu ý trực tiếp của chủ dự án 06/10/2026):** (1) bề mặt lót phải **khô tương đối hoàn toàn**; (2) **tuyệt đối không xả nhám/gây xước mặt lót trước khi lau** — màu chui xuống **vết sắt nhám ⇒ THÂM MÀU**; (3) **không để sơn chịu khô (dry spray)/rãnh sơn khô** — màu thấm vào đó cũng **thâm màu**; (4) nếu buộc phải xả nhám: nhám rất mịn + xả cực nhẹ (ghi chú chuẩn công ty id 111: *“chú ý không chà xước lẹm bay mất màu”*), rồi thổi bụi + lau tack. ⇒ **Bước chà nhám trong bảng phải đặt SAU lớp khoá lót trong (B20), không đặt trước bước lau màu.** 9. **MÀU CÓ CHIỀU SÂU — NHIỀU LỚP MÀU (luật huấn luyện id 20, chốt 06/10/2026):** với mẫu nhiều khối màu, **cho phép chia nhiều lần sơn màu** theo nguyên tắc **MÀU DƯỚI ĐẬM HƠN MÀU TRÊN** (tạo độ sâu, màu “trong” hơn); **pad stain / đánh glaze** phải tạo **chuyển màu tối → sáng, nhạt dần** ở vùng cần sáng (đánh khối có chủ đích, không dàn đều). Bảng quy trình phải ghi rõ thứ tự lớp màu (đậm trước, nhạt sau). * **09 (mới, 06/10/2026) — Phân loại theo LOẠI MÀU, không quan tâm hệ sơn:** mỗi lớp trong bảng phải ghi rõ thuộc **SƠN KHÔNG MÀU / SƠN CÓ MÀU (pigmented) / MÀU TRONG SUỐT / LOẠI KHÁC** (dầu, chất ngấm, phụ gia, dung môi…). Không đưa NC/PU/nước vào kết luận. * **10 (mới, 06/10/2026) — Chọn chuẩn theo dạng mẫu:** mẫu **đều một tông** → **chuẩn chung id 116**; mẫu **già cổ/rustic có ghim sớ tương phản trên Sồi/Veneer Oak** → **chuẩn NHÁNH 2 id 118** (chất ngấm dầu + cấu trúc bóng 2 lớp kẹp glaze, quét cọ 2 cấp) — đúng như phiếu làm mẫu THẬT PT-008H (id 117).