Giá bán, VAT & phí giao dịch

thứ tự tính (đơn vị: đồng) - giá hiển thị ĐÃ GỒM VAT, shop tự chịu phí

tiền hàng     = Σ (đơn giá hiển thị × số lượng)   # đã gồm VAT
giảm giá      = voucher / khuyến mãi
TỔNG khách trả = tiền hàng − giảm giá             # đã gồm VAT, KHÔNG đội phí
  ↳ tiền VAT   = làm tròn(TỔNG / 11)              # phần VAT nằm trong giá
  ↳ giá chưa thuế = TỔNG − tiền VAT                # suy ra để LUÔN khớp
# Phí SePay là chi phí cố định của shop, tính vào giá vốn - không cộng vào đơn.

tách ngược VAT từ giá đã gồm thuế (số nguyên đồng)

gia_hien_thi = 110000               # đã gồm VAT
tien_vat     = round(gia_hien_thi / 11)   # 10.000đ
gia_chua_thue = gia_hien_thi - tien_vat   # 100.000đ
# 100.000 + 10.000 = 110.000  ✓ khớp

gõ trong ô Claude Code

Trên trang sản phẩm (route app/(shop)/san-pham/[slug]/page.tsx) và trên các thẻ sản phẩm ở trang danh sách, hiển thị giá đã gồm VAT cho khách lẻ.

Yêu cầu:
- Cột giá trong schema Drizzle là số nguyên đồng (integer), tên gia_da_gom_vat. Đây là giá khách thấy và sẽ trả.
- Render giá định dạng tiền Việt (vd 110.000đ), ngay dưới mỗi giá thêm một nhãn nhỏ chữ xám "đã bao gồm VAT".
- Viết một hàm format ở lib/money.ts để dùng chung mọi nơi (trang sản phẩm, danh sách, giỏ hàng).
- Tuyệt đối không hiển thị giá chưa thuế cho khách lẻ ở bất kỳ màn nào.

Xong khi: mỗi sản phẩm chỉ hiện một con số duy nhất (giá đã gồm VAT) kèm chú thích "đã bao gồm VAT", grep toàn bộ phần khách lẻ không còn chỗ nào render giá chưa thuế.

gross-up - khách gánh phí % mà shop vẫn nhận đủ

base = 198000              # số shop muốn NHẬN ĐỦ (giá đã gồm VAT, sau giảm)
f    = 0.02                # phí cổng thẻ 2%
tong = ceil(base / (1 - f))   # ceil(198000 / 0.98) = 202.041đ
phi  = tong - base            # 4.041đ
# Kiểm: cổng cắt f × tong = 0.02 × 202.041 ≈ 4.041 → shop nhận
#       tong − phi = 198.000  ✓ đúng

gõ trong ô Claude Code

Dựng bảng tổng kết checkout cho trang thanh toán, và tính tổng Ở SERVER, không tin số tiền client gửi lên.

Yêu cầu:
- Viết một hàm thuần ở lib/checkout.ts tên tinhTong(items, voucher) nhận danh sách order_items và voucher, trả về một object gồm: tien_hang, giam_gia, tong_thanh_toan, tien_vat (làm tròn tong_thanh_toan / 11), gia_chua_thue (= tong_thanh_toan trừ tien_vat). Tất cả là số nguyên đồng, không dùng float.
- Thứ tự tính: tien_hang = tổng đơn giá đã gồm VAT nhân số lượng; tong_thanh_toan = tien_hang trừ giam_gia. Không cộng thêm phí giao dịch (shop tự chịu phí SePay).
- Trong Server Action hoặc route handler tạo đơn, GỌI LẠI tinhTong từ giá gốc lấy trong database theo product id, bỏ qua mọi số tiền do client gửi.
- UI bảng checkout hiển thị 3 dòng: Tiền hàng, Giảm giá, Tổng thanh toán; dưới Tổng thêm một dòng nhỏ chữ xám "trong đó VAT: X đồng".
- Viết một test (vitest) cho tinhTong: một giỏ mẫu ra đúng các con số, và gia_chua_thue cộng tien_vat bằng tong_thanh_toan.

Xong khi: sửa giá ở client bằng dev tools rồi bấm thanh toán, số tiền server thực trừ vẫn là tổng tính lại từ database, không đổi theo client.

schema gợi ý - tách từng cột tiền (tất cả số nguyên đồng)

orders(id, tien_hang, giam_gia,
       gia_chua_thue, thue_suat, tien_thue,
       loai_phi, tien_phi,        -- = 0 khi shop tự chịu phí
       tong_thanh_toan, ...)

order_items(id, order_id, ten, so_luong,
            don_gia_da_gom_vat, thanh_tien)

bất biến - test để chắc không lệch một đồng

tong_thanh_toan == tien_hang − giam_gia + tien_phi   # tien_phi = 0 khi shop chịu
gia_chua_thue + tien_thue == tien_hang − giam_gia    # tách thuế luôn khớp
shop_thuc_nhan >= tien_hang − giam_gia               # shop không bao giờ hụt
mọi cột tiền là số nguyên đồng (không float)

gõ trong ô Claude Code

Dựng trang hoá đơn (route app/(shop)/don-hang/[id]/page.tsx) ghi chi tiết từng loại tiền, và LƯU SNAPSHOT BẤT BIẾN khi tạo đơn.

Schema Drizzle (số nguyên đồng):
- Bảng orders thêm/đảm bảo các cột: tien_hang, giam_gia, gia_chua_thue, thue_suat, tien_thue, loai_phi, tien_phi (= 0 khi shop tự chịu), tong_thanh_toan.
- Bảng order_items có: order_id, ten, so_luong, don_gia_da_gom_vat, thanh_tien.

Lưu snapshot:
- Khi tạo đơn, COPY đơn giá và thuế suất tại thời điểm mua vào order_items và orders, KHÔNG tham chiếu sống tới bảng product. Sau đó không sửa các cột này nữa.
- Trang hoá đơn dựng số liệu CHỈ từ các cột đã lưu trong orders/order_items, tuyệt đối không đọc giá hiện tại của product.

UI hoá đơn hiển thị: từng dòng hàng (tên, số lượng, đơn giá đã gồm VAT, thành tiền), rồi tien_hang, giam_gia, gia_chua_thue, tien_thue (VAT 10%), tong_thanh_toan (số và chữ), mã đơn, thời gian, phương thức.

Bất biến + test (vitest):
- tong_thanh_toan == tien_hang trừ giam_gia cộng tien_phi
- gia_chua_thue cộng tien_thue == tien_hang trừ giam_gia
- mọi cột tiền là số nguyên đồng.

Sau khi xong, cho subagent bảo mật/data-integrity rà lại phần tính tiền và snapshot.

Xong khi: mở lại một đơn cũ thấy đủ giá chưa thuế / VAT / tổng khớp từng đồng, và đổi giá sản phẩm ở hiện tại (sửa cột product) không làm đổi bất kỳ con số nào trên hoá đơn cũ.