User story và tiêu chí chấp nhận: ngôn ngữ chung giữa bạn, team và AI

Scenario: Tạo đơn bánh kem hợp lệ
  Given Hà đăng nhập với vai trò staff tại chi nhánh Phú Nhuận
  And bây giờ là 10:00 ngày 12/10/2026
  And khách có số điện thoại 0901234567 đã tồn tại
  When Hà tạo đơn gồm 1 "Bánh kem tùy chỉnh 20cm", vị "Chanh dây", chữ "Mừng sinh nhật Mẹ Ánh"
  And giờ nhận 17:00 ngày 13/10/2026, nhận tại chi nhánh, kênh Zalo
  Then đơn được tạo với trạng thái "moi" và mã dạng "BM-261012-xxx"
  And tổng tiền bằng đơn giá trong danh mục nhân số lượng
  And chữ trên bánh được lưu đúng "Mừng sinh nhật Mẹ Ánh", giữ nguyên dấu

Scenario: Thiếu vị bánh
  Given Hà đang tạo đơn có "Bánh kem tùy chỉnh 20cm"
  When Hà bấm "Tạo đơn" mà chưa chọn vị
  Then đơn không được tạo
  And ô "Vị" được đánh dấu lỗi với thông báo "Vui lòng chọn vị bánh"

Scenario: Chữ trên bánh quá dài
  When Hà nhập chữ trên bánh dài 41 ký tự
  Then hệ thống báo "Chữ trên bánh tối đa 40 ký tự" và không cho tạo đơn

Scenario: Nhân viên đặt bánh kem gấp dưới 24 giờ
  Given bây giờ là 10:00 ngày 12/10/2026
  When Hà (staff) chọn giờ nhận 08:00 ngày 13/10/2026
  Then hệ thống báo "Bánh kem tùy chỉnh cần đặt trước ít nhất 24 giờ. Liên hệ quản lý để tạo đơn gấp."

Scenario: Quản lý tạo đơn gấp có lý do
  Given anh Tuấn đăng nhập với vai trò manager
  When anh Tuấn tạo đơn bánh kem nhận sau 6 giờ và nhập lý do "Khách quen, bếp đã nhận"
  Then đơn được tạo và được đánh dấu "Đơn gấp" kèm lý do

Scenario: Bấm "Tạo đơn" hai lần liên tiếp
  When Hà bấm "Tạo đơn" hai lần trong vòng 1 giây
  Then chỉ có đúng một đơn được tạo

Scenario: Tìm thấy khách với số có định dạng khác
  Given khách "Trần Văn B" có số 0901234567
  When Hà nhập "+84 901 234 567" vào ô tìm kiếm
  Then hệ thống hiển thị khách "Trần Văn B" và 3 đơn gần nhất

Scenario: Không tìm thấy khách
  When Hà nhập "0912 000 111" và không có khách nào trùng
  Then hệ thống mở form tạo khách mới với số "0912000111" đã điền sẵn

Scenario: Số điện thoại không hợp lệ
  When Hà nhập "09123"
  Then hệ thống báo "Số điện thoại cần 10 chữ số, bắt đầu bằng 0"

Scenario: Cọc đủ 50% thì xác nhận được đơn
  Given đơn BM-261012-012 có tiền bánh 600.000đ, nhận tại tiệm (tổng 600.000đ), trạng thái "moi", chưa thanh toán
  When Hà ghi nhận 300.000đ chuyển khoản, mã giao dịch "FT2610121234"
  Then trạng thái thanh toán là "deposit" và số tiền còn lại hiển thị 300.000đ
  And nút "Xác nhận đơn" được bật

Scenario: Cọc chưa đủ 50% với đơn bánh kem
  Given đơn bánh kem tiền bánh 600.000đ, giao tận nơi phí 30.000đ (tổng 630.000đ)
  When Hà ghi nhận cọc 200.000đ và bấm "Xác nhận đơn"
  Then đơn vẫn ở trạng thái "moi"
  And hệ thống báo "Đơn bánh kem cần cọc tối thiểu 300.000đ (50% tiền bánh) trước khi xác nhận"

Scenario: Ghi nhận vượt số tiền còn lại
  Given đơn tổng 600.000đ đã cọc 300.000đ
  When Hà ghi nhận thêm 400.000đ
  Then hệ thống báo "Số tiền vượt quá số còn phải thu (300.000đ)"

Scenario: Nhóm bánh theo chuyến xe
  Given ngày 13/10/2026 có 3 đơn bánh kem đã xác nhận: nhận 10:00, 14:30 và 17:00
  When anh Tuấn mở màn hình bếp ngày 13/10/2026
  Then nhóm "Chuyến 07:30" có 2 bánh (10:00 và 14:30), sắp theo giờ nhận
  And nhóm "Chuyến 13:00" có 1 bánh (17:00)
  And mỗi bánh hiển thị: mã đơn, chi nhánh nhận, size, vị, chữ trên bánh nguyên văn

Scenario: Đơn chưa xác nhận không hiện ở bếp
  Given đơn bánh kem nhận ngày 13/10 đang ở trạng thái "moi"
  Then đơn đó không xuất hiện trên màn hình bếp

Scenario: Đơn bị hủy sau khi bếp đã thấy
  Given đơn BM-261012-011 đang hiển thị ở bếp
  When quản lý hủy đơn này
  Then lần tải lại kế tiếp, đơn hiển thị gạch ngang với nhãn "ĐÃ HỦY" thay vì biến mất lặng lẽ

Scenario: Hủy đơn chưa làm
  Given đơn ở trạng thái "da_xac_nhan" đã cọc 300.000đ
  When quản lý hủy đơn với lý do "Khách đổi ngày, đặt đơn mới"
  Then đơn chuyển "da_huy", lịch sử trạng thái ghi người hủy, thời điểm và lý do
  And hệ thống nhắc "Đơn đã cọc 300.000đ — xử lý hoàn cọc theo quy định của tiệm"

Scenario: Nhân viên không được hủy đơn bếp đang làm
  Given đơn ở trạng thái "dang_lam"
  When Hà (staff) mở đơn
  Then không có nút "Hủy đơn" và có dòng "Liên hệ quản lý để hủy đơn đang làm"

Scenario: Thiếu lý do hủy
  When quản lý bấm "Hủy đơn" mà để trống lý do
  Then hệ thống không hủy và báo "Vui lòng nhập lý do hủy"

Scenario: Chủ xem toàn chuỗi
  Given hôm nay có 40 đơn ở Phú Nhuận, 35 ở Thảo Điền, 30 ở Gò Vấp
  When chị Lan (owner) mở dashboard
  Then thấy tổng 105 đơn và bảng số đơn theo trạng thái cho từng chi nhánh

Scenario: Quản lý chỉ thấy chi nhánh mình
  When quản lý chi nhánh Gò Vấp mở dashboard
  Then chỉ thấy số liệu của Gò Vấp

Scenario: Đơn treo
  Given có đơn ở trạng thái "moi" đã quá 2 giờ kể từ khi tạo
  Then dashboard hiển thị đơn đó trong mục "Cần xử lý"

// tests/unit/orders/lead-time.test.ts
import { describe, it, expect } from "vitest";
import { checkLeadTime } from "@/features/orders/rules";

describe("QT-02: bánh kem tùy chỉnh đặt trước tối thiểu 24 giờ", () => {
  // Given: bây giờ là 10:00 ngày 12/10/2026 (giờ Việt Nam)
  const now = new Date("2026-10-12T10:00:00+07:00");

  it("chấp nhận khi giờ nhận cách hiện tại đúng 24 giờ (ranh giới)", () => {
    const result = checkLeadTime({
      hasCustomCake: true,
      deliveryAt: new Date("2026-10-13T10:00:00+07:00"),
      now,
      role: "staff",
    });
    expect(result.ok).toBe(true);
  });

  it("từ chối staff khi giờ nhận chỉ cách 22 giờ", () => {
    // When: Hà chọn giờ nhận 08:00 ngày 13/10
    const result = checkLeadTime({
      hasCustomCake: true,
      deliveryAt: new Date("2026-10-13T08:00:00+07:00"),
      now,
      role: "staff",
    });
    // Then: bị từ chối với mã lỗi rõ ràng
    expect(result.ok).toBe(false);
    expect(result.code).toBe("LEAD_TIME_TOO_SHORT");
  });

  it("cho manager tạo đơn gấp khi có lý do", () => {
    const result = checkLeadTime({
      hasCustomCake: true,
      deliveryAt: new Date("2026-10-12T16:00:00+07:00"),
      now,
      role: "manager",
      rushReason: "Khách quen, bếp đã nhận",
    });
    expect(result.ok).toBe(true);
  });
});

// src/lib/phone.ts
/** Chuẩn hóa số điện thoại Việt Nam về dạng 0xxxxxxxxx; trả về null nếu không hợp lệ. */
export function normalizePhone(input: string): string | null {
  // Bỏ khoảng trắng, dấu chấm, gạch ngang, ngoặc
  let digits = input.trim().replace(/[\s.\-()]/g, "");
  // +84xxxxxxxxx hoặc 84xxxxxxxxx -> 0xxxxxxxxx
  if (digits.startsWith("+84")) digits = "0" + digits.slice(3);
  else if (digits.startsWith("84")) digits = "0" + digits.slice(2);
  if (!/^\d+$/.test(digits)) return null; // còn ký tự lạ → không hợp lệ
  if (/^0[35789]\d{8}$/.test(digits)) return digits; // di động: 10 số
  if (/^02\d{9}$/.test(digits)) return digits; // cố định: 11 số, đầu 02
  return null; // thiếu số, thừa số, đầu số lạ
}

// tests/unit/customers/phone.test.ts
import { describe, it, expect } from "vitest";
import { normalizePhone } from "@/lib/phone";

describe("QT-05: chuẩn hóa số điện thoại", () => {
  it.each([
    ["0901 234 567", "0901234567"],
    ["+84 901 234 567", "0901234567"],
    ["84901234567", "0901234567"],
    ["090.123.4567", "0901234567"],
  ])("chuẩn hóa '%s' thành '%s'", (input, expected) => {
    expect(normalizePhone(input)).toBe(expected);
  });

  it("trả về null với số không đủ 10 chữ số", () => {
    expect(normalizePhone("09123")).toBeNull();
  });
});

// tests/e2e/tao-don-banh-kem.spec.ts
import { test, expect } from "@playwright/test";

test("US-01: Hà tạo đơn bánh kem hợp lệ", async ({ page }) => {
  // Given: đã đăng nhập vai trò staff (trạng thái đăng nhập chuẩn bị sẵn trong cấu hình test)
  await page.goto("/orders/new");

  // When: nhập thông tin đơn
  await page.getByLabel("Số điện thoại").fill("0901234567");
  await page.getByRole("button", { name: "Tìm khách" }).click();
  await page.getByLabel("Sản phẩm").selectOption({ label: "Bánh kem tùy chỉnh 20cm" });
  await page.getByLabel("Vị").selectOption({ label: "Chanh dây" });
  await page.getByLabel("Chữ trên bánh").fill("Mừng sinh nhật Mẹ Ánh");
  await page.getByLabel("Giờ nhận").fill("2026-10-13T17:00");
  await page.getByRole("button", { name: "Tạo đơn" }).click();

  // Then: thấy mã đơn và chữ trên bánh giữ nguyên dấu
  await expect(page.getByText(/BM-\d{6}-\d{3}/)).toBeVisible();
  await expect(page.getByText("Mừng sinh nhật Mẹ Ánh")).toBeVisible();
});