Nhận hàng · Vicomart · v2.0 (KHOÁ ĐƠN ĐÃ NHẬN — không cho nhận lần 2. Trước đây openReceive mở được cả đơn status='received' và confirmReceive vẫn chạy → nhận lại tạo phiếu kho_confirm_receipt TRÙNG, cộng tồn 2 lần + sinh lô pos_expiry trùng. NAY 3 lớp chặn: (1) openReceive đánh dấu _locked khi status='received'; (2) confirmReceive chặn ngay đầu nếu _locked (chốt logic, UI lách vẫn chặn); (3) applyLockUI ẩn nút 'Hoàn tất nhận' + banner vàng '🔒 Đơn đã nhận xong — chỉ xem, không nhận lại'. Đơn 'partial' (nhận một phần) KHÔNG khoá, vẫn cho nhận tiếp phần còn lại. Về 2 CHIP: app ĐÃ có sẵn 'Chờ nhận / Đã nhận / Tất cả' trong renderList (DB: 158 chờ nhận, 654 đã nhận) — nếu không thấy là do đang chạy bản cũ, deploy v2.0 là có. Giữ nguyên v1.9 (BẮT ĐƯỢC SP MỚI THÊM Ở MÀN QUY CÁCH BÊN POS. Anh Kay hỏi: thêm SP mới vào quy cách thì app Nhận hàng có tự cập nhật không — KHÔNG. ensureShelfLife() nạp 1 lần rồi đặt _shelfReady=true và không bao giờ nạp lại, nên SP vừa thêm bên POS chỉ tới được điện thoại sau khi TẮT HẲN app mở lại. Nay thêm tham số force: MỖI LẦN MỞ ĐƠN và ngay TRƯỚC KHI bấm "Áp dụng HSD" đều nạp lại bảng — chỉ 96 dòng nên rất nhẹ. Điểm vốn đã đúng: shelfMatch dùng (match_kw || name) nên SP mới không cần điền từ khoá vẫn khớp được, và POS cũng tự sinh match_kw khi lưu. Giữ nguyên v1.8 (hiện đủ ngày HSD + số ngày còn lại), v1.7 (hàng ngoài PO vào đủ 3 nhánh HSD), v1.6 (bắt bấm chọn NSX), v1.5, v1.4, v1.3.) | v1.8 (HIỆN ĐỦ NGÀY HSD, KHÔNG CÒN CẮT CÒN THÁNG. Anh Kay chỉ ra: bấm Áp dụng HSD xong thì Cà Rốt và Rau dền bó đều hiện "T8/2026" y hệt nhau. Đúng là lỗi hiển thị — dữ liệu lưu ĐỦ NGÀY (cà rốt 2026-08-08 = NSX 03/08 + 5 ngày, rau dền 2026-08-06 = +3 ngày) nhưng cả 2 chỗ vẽ (danh sách trong đơn và danh sách SP ngoài PO) đều cắt bằng 'T'+parseInt(expiry.slice(5,7))+'/'+expiry.slice(0,4) nên vứt mất ngày. Hậu quả: hai mặt hàng hạn khác nhau 2 ngày hiện GIỐNG HỆT, nhân sự không kiểm được app tính đúng hay sai, và với hàng tươi hạn 3-7 ngày thì đơn vị THÁNG là vô nghĩa. NAY thêm hàm dùng chung _hsdLabel: HSD dạng YYYY-MM-DD (hàng tươi, tính từ NSX) hiện đủ "08/08/2026 · còn 5 ngày", tự đổi thành "hết hạn hôm nay" hoặc "quá hạn" khi tới ngưỡng; HSD dạng YYYY-MM (hàng khô chọn tay theo bao bì) vẫn hiện "T6/2029" như cũ vì bao bì chỉ in tháng. Giữ nguyên v1.7 (hàng ngoài PO vào đủ 3 nhánh HSD), v1.6 (bắt bấm chọn NSX), v1.5 (không cache promise hỏng, select đủ cột khung giờ), v1.4 (chỉ hàng tươi nhập lô), v1.3 (múi giờ, .order, ghi 4 trường khung giờ).) | v1.7 (HÀNG NGOÀI PO BỊ BỎ QUÊN Ở CẢ 3 CHỖ — lỗi thật sự khiến cà rốt không tự áp HSD. Ảnh anh Kay gửi cho thấy Cà Rốt nằm ở mục "SP NGOÀI PO", NSX đã chọn 03/08 và số lô 260803 đã sinh, quy cách HSD cũng đã nạp xong, nhưng vẫn báo "Chưa nhận diện loại rau củ". GỐC RỄ: hàng nhận thêm nằm ở mảng RIÊNG S.rcv.extra (dùng trường _qty), còn mọi hàm HSD chỉ duyệt S.rcv.items (dùng _toRecv) — hai mảng khác nhau, hàng ngoài PO bị bỏ quên ở CẢ BA chỗ: (1) applyHsdFromNsx không duyệt nên không bao giờ áp được HSD dù bảng quy cách CÓ mặt hàng đó; (2) rcvHasFresh không xét nên đơn chỉ có rau củ ngoài PO bị coi là đơn hàng khô, không hiện nhắc chọn NSX; (3) nghiêm trọng nhất — expRows dựng từ recvItems (= rc.items lọc theo _toRecv) nên HSD của hàng ngoài PO KHÔNG BAO GIỜ sinh bản ghi trong pos_expiry, KHO không cảnh báo và POS không giảm giá cho hàng đó. Lưu ý hàng ngoài PO VẪN vào purchase_orders.items qua extraNewItems nên sổ kho và hạch toán vẫn đúng — chỉ đứt ở nhánh HSD/lô. NAY: cả 3 chỗ gộp [].concat(items, extra), riêng nhánh pos_expiry ánh xạ _qty→_toRecv trước khi lọc; vẽ lại nhóm ngoài PO sau khi áp (renderExtraItems); thông báo khi không nhận diện được SP nào đổi sang màu cảnh báo và nói rõ số SP bị bỏ qua thay vì báo thành công. DRY-RUN đúng cảnh của anh Kay (đơn gốc toàn hàng khô + cà rốt ngoài PO, NSX 03/08): rcvHasFresh=true; áp HSD được 1 SP tự theo quy cách; cà rốt ra HSD 08/08 (= NSX + 5 ngày) kèm km_days 3, giảm 30%, khung giờ 16h/19h; pos_expiry ghi 2 lô gồm cả cà rốt. Giữ nguyên v1.6 (bắt bấm chọn NSX), v1.5 (không cache promise hỏng, select đủ cột khung giờ), v1.4 (chỉ hàng tươi nhập lô), v1.3 (múi giờ, .order("sku"), ghi 4 trường khung giờ).) | v1.6 (BỎ TỰ ĐIỀN NSX — NGƯỜI NHẬN PHẢI BẤM CHỌN. Anh Kay chỉ ra: NSX đang hiện mặc định, mà ô này dành riêng cho hàng tươi nên phải bấm chọn. Đúng — tự điền là ĐOÁN THAY người nhận: rau về sáng nay thường HÁI TỪ HÔM QUA, app điền hôm nay thì HSD sai 1 ngày mà không ai biết; với rau ăn lá hạn 3 ngày đó là sai 33% vòng đời, rau hỏng mà hệ thống báo còn tốt. NAY: (1) BỎ hẳn dòng tự điền value; autoNsxIfFresh() chỉ còn NHẮC, không điền. (2) Đơn có hàng tươi hiện khối vàng nổi bật "Đơn này có HÀNG TƯƠI — cần chọn NSX thì mới tính được HSD" kèm câu nhắc "Rau về sáng nay hái HÔM QUA thì bấm Hôm qua, đừng bấm Hôm nay" và 3 nút to: Hái HÔM NAY (xanh) · Hái HÔM QUA (cam) · 2 hôm trước. (3) Bấm "Áp dụng HSD" khi CHƯA chọn NSX thì CHẶN, báo rõ và tự cuộn tới ô NSX — trước đây im lặng bỏ qua. (4) Nhãn ô đổi thành "NSX (ngày HÁI/SX — bấm chọn)"; thêm chip "2 hôm trước" cho rau về muộn. Đơn hàng khô vẫn để trống, không sinh lô. Giữ nguyên v1.5 (ensureShelfLife không cache promise thất bại, select đủ km_hour/km2_hour/km2_pct), v1.4 (chỉ hàng tươi nhập lô) và v1.3 (múi giờ _ymdLocal, .order("sku"), ghi 4 trường khung giờ vào lô).) | v1.5 (SỬA LỖI "CHƯA TẢI ĐƯỢC QUY CÁCH HSD" — LỖI DO CHÍNH BẢN v1.3 CỦA EM. Anh Kay bấm "Áp dụng HSD" cho cà rốt thì báo không kết nối. Kiểm DB: bảng pos_shelf_life đọc được bằng quyền anon 96/96 dòng đủ khung giờ, RLS và grant đều ổn — không phải lỗi máy chủ. GỐC RỄ: ensureShelfLife() em viết ở v1.3 CACHE CẢ PROMISE THẤT BẠI — hàm gọi lần đầu lúc boot khi mạng chưa sẵn sàng, nếu hỏng thì _shelfLoading giữ đúng promise hỏng đó, mọi lần bấm sau đều await lại promise cũ và trả về ngay mà KHÔNG thử lại ⇒ kẹt vĩnh viễn ở thông báo "Chưa tải được quy cách HSD". Nay chỉ giữ promise khi THÀNH CÔNG, thất bại thì xoá để lần bấm sau tự thử lại; thêm _shelfReady trả Promise.resolve() ngay nếu đã nạp xong. LỖI THỨ HAI cùng gốc: câu select của loadShelfLife THIẾU 3 cột km_hour/km2_hour/km2_pct nên dù có nạp được thì v1.3 vẫn ghi undefined vào lô, POS không biết khung giờ 16h/19h của hàng tươi — đã lấy đủ. Thông báo lỗi nay hiện RÕ nguyên nhân (HTTP mấy, message gì) thay vì câu chung chung "kiểm tra mạng", và nói rõ "bấm lại để thử lại" vì giờ đã thử lại được. Giữ nguyên toàn bộ v1.3 (múi giờ _ymdLocal, .order("sku"), ghi 4 trường khung giờ vào lô) và v1.4 (chỉ hàng tươi mới nhập lô, hàng khô để trống).) | v1.4 (CHỈ HÀNG TƯƠI MỚI NHẬP LÔ — hàng khô để trống. Anh Kay chỉ ra: nên ghi rõ "nhập lô, NSX = ngày nhập" là dành cho hàng tươi sống, còn lại mặc định KHÔNG nhập lô. BẰNG CHỨNG dữ liệu: 27/27 lô đang có trong pos_expiry đều là HÀNG KHÔ (đường Biên Hoà, sáp Glade, xịt Raid, bánh tráng Mikiri…) mà đều mang lô "260801" = ngày nhận — VÔ NGHĨA, vì lô hàng khô phải là lô NHÀ SẢN XUẤT in trên bao bì. Gốc rễ: openReceive tự điền NSX = hôm nay VÔ ĐIỀU KIỆN cho mọi đơn rồi sinh lô từ đó. NAY: (1) BỎ tự điền vô điều kiện; thêm rcvHasFresh() nhận diện đơn có hàng tươi qua NGÀNH HÀNG (rau củ / trái cây / thực phẩm - rau) HOẶC khớp bảng quy cách rau củ; (2) autoNsxIfFresh() chỉ tự điền NSX = ngày nhập khi đơn CÓ hàng tươi, đơn hàng khô để TRỐNG nên lot_code ghi NULL, không sinh lô rác; (3) ô gợi ý ngay dưới tiêu đề nói rõ đang ở trường hợp nào — "🥬 Đơn có hàng tươi — đã điền NSX = ngày nhập, nếu rau hái hôm trước bấm Hôm qua" hoặc "📦 Đơn hàng khô — không cần nhập lô, chỉ bấm HSD từng SP theo bao bì"; (4) đổi nhãn khu vực thành "Lô hàng & Hạn dùng — chỉ dùng cho HÀNG TƯƠI", ô NSX ghi "(hàng tươi = ngày nhập)", ô Số lô đổi placeholder thành "để trống nếu hàng khô". DRY-RUN nhận diện: đơn toàn hàng khô → không sinh lô; đơn có cà rốt → tự điền NSX + sinh lô; đơn "Bánh gạo vị cà rốt" → KHÔNG sinh lô (bẫy đồng âm bị chặn đúng vì thuộc ngành Sữa). Vẫn giữ nguyên 4 bản vá v1.3.) | v1.3 (SỬA 4 LỖI TRÊN ĐƯỜNG HSD/LÔ — tìm ra khi anh Kay hỏi "sao cà rốt không tự map HSD". (1) LỆCH MÚI GIỜ: expiryToDate dùng d.toISOString() mà new Date(y,m,0) là 00:00 giờ VN (UTC+7), đổi sang UTC lùi 7 tiếng ⇒ rơi về NGÀY HÔM TRƯỚC — 26/27 bản ghi pos_expiry đang SỚM HƠN 1 NGÀY so với bao bì (chọn T4/2027 ra 29/04 thay vì 30/04); nay ghép chuỗi theo giờ địa phương qua _ymdLocal, sửa cả setNsx và applyHsdFromNsx. (2) QUY CÁCH HSD NẠP QUÁ MUỘN: loadShelfLife() nằm LỒNG bên trong loadAllProducts() và gọi không await, phải chờ nạp xong 16.605 sản phẩm qua 17 lần gọi trang mới tới lượt ⇒ bấm "Áp dụng HSD" sớm thì _shelfLife rỗng, shelfMatch trả null, báo "chưa nhận diện loại rau củ" dù bảng CÓ Cà rốt (match_kw "ca rot", 5 ngày) — đây chính là lỗi anh Kay gặp; nay tách ensureShelfLife() nạp ĐỘC LẬP (96 dòng, tức thì) ngay từ lúc boot và lúc mở đơn. (3) PHÂN TRANG KHÔNG SẮP THỨ TỰ: loadAllProducts dùng .range() qua 17 trang mà thiếu .order() — Postgres không bảo đảm thứ tự ổn định giữa các dòng bằng nhau nên có SP bị lặp và có SP KHÔNG BAO GIỜ được nạp, đúng lỗi đã sửa ở app KHO v5.40; nay thêm .order("sku"). (4) GHI THIẾU KHUNG GIỜ + MỨC GIẢM: lệnh ghi pos_expiry bỏ trống discount_pct/km_hour/km2_hour/km2_pct nên DB lấy mặc định km_days=15/warn_days=7 — rau hạn 3 ngày mà ngày sale rơi 12 ngày TRƯỚC khi nhập hàng; nay chép đủ 4 trường từ quy cách vào từng lô. Thêm guard: bấm "Áp dụng HSD" lúc bảng chưa nạp xong thì CHỜ rồi tính, không im lặng bỏ qua. DRY-RUN: 4 mốc HSD tháng đều ra đúng ngày cuối tháng; NSX+3/+7 ngày đúng kể cả bắc cầu sang tháng sau; khớp tên bỏ dấu chạy đúng và vẫn chặn đồng âm theo ngành hàng ("Bánh gạo vị cà rốt" khớp tên nhưng bị chặn vì thuộc ngành Sữa). PHÍA DB cùng đợt: 6 mặt hàng (hành lá, ngò rí, thì là, giá đỗ, rau mầm, nấm rơm) đổi hạn 1→3 ngày theo rau ăn lá, dâu tây 1→7 ngày; không còn mặt hàng nào hạn 1 ngày; khung giờ 16h tầng 1 / 19h tầng 2 cho toàn bộ 96 SP tươi.)

Danh sách hàng

Lô hàng & Hạn dùng — chỉ dùng cho HÀNG TƯƠI (rau củ · trái cây · thực phẩm tươi)

NSX (ngày HÁI/SX — bấm chọn)

Số lô (tự sinh từ NSX)

Tính HSD nhanh cho hàng tươi (NSX + số ngày)

Điền HSD = NSX + số ngày cho các mặt hàng chưa có HSD. Vẫn bấm HSD riêng từng SP để đè.

Hoá đơn VAT (có thể để kế toán điền sau)

Số hoá đơn

Ngày HĐ

Ghi chú nhận hàng

📷 Ảnh HĐ
* bắt buộc

0SL nhận