Computer >> Hướng Dẫn Máy Tính >  >> Lập Trình >> Redis

Xây Dựng Session Store An Toàn, Mở Rộng Với Clerk & Upstash Redis

Một trong những use case chính của Redis là lưu trữ và quản lý user session để duy trì state qua các request trong ứng dụng web. Điều này có thể làm theo nhiều cách, và một số công cụ serverless mới cung cấp các tùy chọn triển khai dễ dàng.

Quản lý dữ liệu user session quan trọng cho nhiều ứng dụng kinh doanh. Ví dụ, nền tảng cá nhân hóa dùng Redis lưu trữ tương tác và sở thích người dùng, cho phép cung cấp nội dung hoặc gợi ý sản phẩm tùy chỉnh. Trong game, Redis giúp quản lý dữ liệu người dùng để cung cấp trải nghiệm multiplayer mượt mà bằng cách theo dõi tương tác người chơi real-time. Nền tảng quảng cáo cũng dựa trên Redis lưu session data, tối ưu hóa phân phối quảng cáo và cá nhân hóa chiến dịch tương lai. Trong ví dụ sau, chúng ta tập trung vào ứng dụng e-commerce và khám phá cách Redis quản lý giỏ hàng hiệu quả.

Mô Tả Dự Án

Trong bài viết này, chúng ta dùng Clerk, Next.js và Upstash Redis xây dựng session store cho ứng dụng mua sắm. Danh sách tính năng triển khai:

  • User có thể sign-up, sign-in và sign-out.
  • Mỗi user thêm, xóa item vào giỏ hàng riêng.
  • User cập nhật số lượng item trong giỏ hàng.

Dự án còn có tính năng liên quan QStash và Upstash Ratelimit:

  • Một số hành động trong app kích hoạt event, dẫn đến lên lịch gửi email qua QStash. Email sau đó gửi bằng Resend. Ví dụ, khi checkout, email xác nhận vận chuyển lên lịch 24h sau. Tương tự, sau mua hàng, user nhận prompt sau độ trễ nhất định, khuyến khích đánh giá mua hàng.
  • User cũng có tùy chọn đánh giá item. Tất cả dữ liệu rating lưu trong cấu trúc dữ liệu phù hợp trên Upstash Redis. Để đảm bảo luồng tương tác cân bằng và ngăn chặn lạm dụng, event rating được quản lý bởi khả năng rate-limiting của Upstash Ratelimit.

Demo

Bạn xem demo triển khai tại đây.

Repository GitHub tại đây.

Tạo Next.js Application

Mở terminal mới, tạo ứng dụng với lệnh:

npx create-next-app@latest 

Lệnh này hỏi các tùy chọn dự án, bạn sẽ có template Next.js sẵn sàng.

npx create-next-app@latest
Need to install the following packages: create-next-app@13.4.18
Ok to proceed? (y) y
✔ What is your project named? shopstash
✔ Would you like to use TypeScript? No / -> Yes
✔ Would you like to use ESLint? No / -> Yes
✔ Would you like to use Tailwind CSS? No / -> Yes
✔ Would you like to use `src/` directory? -> No / Yes
✔ Would you like to use App Router? (recommended) No / -> Yes
✔ Would you like to customize the default import alias? -> No / Yes
Creating a new Next.js app in /Users/***/shopstash.

Tích Hợp Clerk

Thêm Clerk vào dự án khá đơn giản. Dùng Next.js SDK của Clerk cho component và hook có sẵn. Trước tiên, cài đặt:

npm install clerk@nextjs 

Sau đó, tạo ứng dụng trên Clerk dashboard. Cấu hình thông tin sign-up yêu cầu theo ý bạn. Sau khi tạo app, credentials cần thiết sẽ hiện. Copy vào file .env.local. Ví dụ:

NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_********
CLERK_SECRET_KEY=sk_test_********

Cấu hình thêm path cho Clerk trong .env.local:

NEXT_PUBLIC_CLERK_SIGN_IN_URL=/sign-in
NEXT_PUBLIC_CLERK_SIGN_UP_URL=/sign-up
NEXT_PUBLIC_CLERK_AFTER_SIGN_IN_URL=/
NEXT_PUBLIC_CLERK_AFTER_SIGN_UP_URL=/

Bây giờ, dùng active session và user context, wrap root layout với <ClerkProvider>. Sau trong tutorial, cũng triển khai component Header.

import { ClerkProvider } from "@clerk/nextjs";
import Header from "./components/Header";
export default function RootLayout({ children, }: { children: React.ReactNode; }) {
  return (
    <ClerkProvider>
      <html lang="en">
        <body className="bg-white">
          <Header />
          <main className="container bg-white">
            <div className="flex min-h-screen items-start justify-center ">
              <div className="mt-5">{children}</div>
            </div>
          </main>
        </body>
      </html>
    </ClerkProvider>
  );
}

Clerk đã cài đặt. Bước tiếp theo quyết định page nào ẩn sau authentication. Thực hiện trong file middleware.tsx ở root folder.

import { authMiddleware } from "@clerk/nextjs";
export default authMiddleware({});
export const config = {
  matcher: ["/((?!.*\\..*|_next).*)", "/", "/(api|trpc)(.*)"],
};

Với này, toàn bộ app được bảo vệ. Nếu truy cập page nào mà chưa sign-in, redirect về index page để xác thực.

Lúc này app cần page sign-up và sign-in. Cung cấp navigation đến file này từ Header, component render dựa trên active user. Nếu có active user, user sign-out và xem profile. Ngược lại, hiển thị route sign-in và sign-up.

Trạng thái header khi không có active user:

Xây Dựng Session Store An Toàn, Mở Rộng Với Clerk & Upstash Redis

Bước cuối xây dựng route cần thiết cho user action. Dùng builtin Clerk sign-up/sign-in component, nhưng có thể tùy chỉnh thiết kế page cho flow sign-in riêng. Cho sign-up, tạo route app/sign-in/[[...sign-up]]/page.tsx.

import { SignUp } from "@clerk/nextjs";
const SignUpPage = () => {
  return (
    <>
      <SignUp />
    </>
  );
};
export default SignUpPage;

Sign in page gần như giống hệt sign up, triển khai ở path tương tự.

import { SignIn } from "@clerk/nextjs";
const SignInPage = () => {
  return (
    <>
      <SignIn />
    </>
  );
};
export default SignInPage;

Với tích hợp Clerk thành công, chúng ta sẵn sàng tiến xa hơn. Tính năng active user đã có, chuẩn bị thiết lập unique session store trên Redis cho mỗi user. Chiến lược: lấy user ID từ Clerk, lưu session data cho user đó trên Upstash Redis. Minh họa bằng xây dựng giỏ hàng. Mỗi session giữ dữ liệu cart item riêng.

Trước hết, cần khái niệm cart item. Đây là blueprint khi xây dựng phần còn lại. Nếu muốn populate app với nhiều item đa dạng, công cụ như ChatGPT rất hữu ích. Hoặc cách trực tiếp hơn: lấy từ GitHub repo liên quan ví dụ. Và để frontend sống động, cần thiết kế hoặc tìm image phù hợp cho từng item.

export const items = [
  {
    id: 1,
    title: "Elegant Leather Watch",
    image: "/images/1.png",
    description: "A sophisticated leather watch for all occasions.",
    company: "Timepiece Creations",
    price: 99.99,
  },
];

Triển Khai Giỏ Hàng

Trong ứng dụng mua sắm điển hình, giỏ hàng user nên truy cập được từ nhiều section. Cho phép component liên quan render dựa trên nội dung giỏ hàng. Ví dụ, चाहे bạn ở trang chi tiết item hay xem danh sách tất cả item, bạn nên thấy sản phẩm đã có trong giỏ. Sneak peek ví dụ:

Xây Dựng Session Store An Toàn, Mở Rộng Với Clerk & Upstash Redis

Để làm được, dùng React Context API, cung cấp truy cập các operation giỏ hàng cần thiết (thêm item, xóa, reset) ở quy mô semi-global.

Thiết lập kết nối Upstash Redis, copy UPSTASH_REDIS_REST_URL và UPSTASH_REDIS_REST_TOKEN từ Console dán vào file .env.

UPSTASH_REDIS_REST_URL=<YOUR_URL>
UPSTASH_REDIS_REST_TOKEN=<YOUR_TOKEN>

Cart Context đặt ở app/context/CartContext.tsx. Wrap context quanh main app, cho phép dùng các method nó cung cấp. Tóm tắt khả năng:

  • User thêm item vào giỏ và điều chỉnh số lượng.
  • Xóa item khỏi giỏ.
  • Reset toàn bộ giỏ.
  • Tính năng checkout. Tổng quan context API. Triển khai từng method bước بخطوة.

Thuật toán hoạt động ở mức tổng quan:

  • Giỏ hàng, xem như session store, giữ trong hash trên Upstash Redis. Unique identifier cho hash dựa trên user ID, mỗi user có giỏ tên cart:<USER_ID>.
  • Khi lưu cart data vào Redis hash, dùng item ID làm key, quantity làm value. Nhờ built-in command của Redis, sửa giỏ hàng dễ dàng.
  • Client-side, giỏ hàng quản lý bằng state mảng object Item. Khi load page, hook useEffect fetch cart data từ Upstash Redis. Có thay đổi giỏ hàng, component liên quan rerender.
  • Cấu trúc dữ liệu đơn giản của Redis đơn giản hóa addItem và removeItem. Dùng command redis.hincrby() xử lý từ thêm/xóa item đến điều chỉnh số lượng. Điều này nhấn mạnh sức mạnh của Redis.
  • Function resetCart, chỉ xóa key của hash khỏi database Upstash dùng redis.del().

Nắm rõ khái niệm giỏ hàng, đến lúc triển khai core method.

Thêm Item Vào Giỏ

Từ góc độ Redis hash, thêm item hoặc thay đổi số lượng dùng cùng command. hincrby hoặc tạo key set value 1, hoặc tăng value dựa trên tham số increment.

Client-side, mirror hành động bằng cách thêm item mới hoặc điều chỉnh quantity trong state giỏ hàng.

const addItem = async (id: number) => {
  const item = items.find((i) => i.id === id);
  if (!item) return;
  const doesItemExist = cart.some((i) => {
    return id === i.id;
  });
  let newCart: Item[];
  if (!doesItemExist) {
    newCart = [...(cart || []), item];
    redis.hincrby(`user:${userId}`, id.toString(), 1);
    // Tạo item trong state object với id cho trước, set quantity = 1.
    const newCartItemIDs = { ...cartItems, [id]: 1 };
    setCartItemIDs(newCartItemIDs);
    setCart(newCart);
  } else {
    const item = items.find((i) => i.id === id);
    // Item này hiện tồn tại trong state object như key, tăng value 1.
    const updatedItemQuantities = { ...cartItems, [id]: cartItems[id] + 1 };
    setCartItems(updatedItemQuantities);
    redis.hincrby(`user:${userId}`, id.toString(), 1);
  }
};

Xóa Item Khỏi Giỏ

Xóa tương tự thêm. Giảm hash value dùng hincrby, cho tham số increment là -1.

const removeItem = async (id: number, force: boolean = false) => {
  const doesItemExist = cart.some((i) => {
    return id === i.id;
  });
  if (!doesItemExist) return;
  if (cartItems[id] === 1 || force) {
    const newCart: Item[] = cart.filter((item: { id: number }) => {
      return item.id !== id;
    });
    // Tạo state object mới cho cart
    const newCartItems = { ...cartItems };
    delete newCartItems[id];
    // Xóa item khỏi Upstash Redis hashset.
    redis.hdel(`user:${userId}`, id.toString());
    setCart(newCart);
    setCartItems(newCartItems);
  } else if (cartItems[id] > 1) {
    const updatedItemQuantities = { ...cartItems, [id]: cartItems[id] - 1 };
    setCartItems(updatedItemQuantities);
    redis.hincrby(`user:${userId}`, id.toString(), -1);
  }
};

Chức năng giỏ hàng đã sẵn sàng với mọi method thiết yếu. Tích hợp liền mạch khắp dự án với truy cập global. Hai use case minh họa:

  • Index Page: Hiển thị tất cả item. Nút riêng cho mỗi item, thêm vào giỏ. Nếu sản phẩm đã trong giỏ, có tùy chọn xóa.

  • Dùng shadcnui React UI library, xây modal/sheet gom tất cả item giỏ hàng trên một page. Không chỉ xem, còn sửa số lượng. Tùy chọn reset giỏ hoặc checkout ngay đó.

Index Page

Lưu ý: item trên index page chỉ hiển thị cho user đã sign-in active. Đầu tiên, fetch user data từ Clerk và render component dựa trên response Clerk.

Trong component card, lấy function và object cần thiết từ CartContext.

export default function CardComponent(props: { item: cardProps }) {
  const { item } = props;
  const { id, title, image, company } = item;
  const { addItem, removeItem, cartItems } = useContext(CartContext);
  return (
    <>
      <Card className="transition duration-200 hover:shadow-lg">
        <Link href={`/products/${id}`}>
          <CardHeader>
            <CardTitle>{title}</CardTitle>
          </CardHeader>
          <CardContent>
            <Image src={image} alt={title} width={300} height={300}></Image>
            <CardDescription>{company}</CardDescription>
          </CardContent>
        </Link>
        <CardFooter>
          <div className="grid grid-rows-2">
            <CartButton id={id} cartItems={cartItems} addItem={addItem} removeItem={removeItem} />
          </div>
        </CardFooter>
      </Card>
    </>
  );
}

Component quan trọng ở đây là cart button, thêm hoặc xóa item khỏi giỏ. Button render dựa trên state hiện tại của giỏ.

const CartButton = ({ id, cartItems, addItem, removeItem, }: { id: number; cartItems: cartContent; addItem: (id: number) => Promise<void>; removeItem: (id: number, force: boolean) => Promise<void>; }) => {
  const itemExists: boolean = cartItems?.hasOwnProperty(id);
  const { triggerEvent } = useContext(UserStateContext);
  return (
    <button className={`${ itemExists ? "bg-red-400 text-black" : "bg-cyan-500 text-black" } flex items-center justify-center gap-3 rounded-full px-4 py-2 transition-all duration-300`} onClick={() => {
      if (itemExists) {
        removeItem(id, true);
      } else {
        addItem(id);
      }
    }} >
      <p className="text-sm font-bold">
        {itemExists ? "Remove from Cart" : "Add to Cart"}
      </p>
      <FaCartShopping size="25" />
    </button>
  );
};

Với state giỏ hàng dynamic, nó prompt render component cụ thể dựa trên trạng thái hiện tại. Tiếp theo, giới thiệu component giỏ hàng chuyên biệt. Không gian này trung tâm xem toàn bộ nội dung giỏ, điều chỉnh số lượng, hoặc nhấn reset.

Dùng shadcn/ui sheet component làm base, tùy chỉnh nội dung.

Khi giỏ hàng trống, component hiển thị rõ ràng:

Xây Dựng Session Store An Toàn, Mở Rộng Với Clerk & Upstash Redis

Khi item xuất hiện trong giỏ, chúng hiển thị sẵn sàng. Không chỉ thấy lựa chọn, còn tự do điều chỉnh số lượng hoặc xem tổng giá trị.

Xây Dựng Session Store An Toàn, Mở Rộng Với Clerk & Upstash Redis

Để walkthrough đầy đủ component này, xem bên dưới. Nếu tìm chi tiết như cấu hình button, khuyến khích ghé GitHub repo, toàn bộ codebase tại chỗ.

Với đoạn code cuối, dự án hoàn tất. Chúng ta đã đi từ concept đến triển khai, mang giỏ hàng sống nhờ Upstash Redis và sự linh hoạt của shadcn/ui.

Kết Luận

Sự kết hợp Clerk quản lý user và Upstash Redis lưu trữ dữ liệu hiệu quả đã đóng vai trò then chốt tạo ra hệ thống giỏ hàng dynamic. Cùng nhau, chúng hình thành xương sống ứng dụng, đảm bảo cả bảo mật và hiệu suất. Dự án này là ví dụ tuyệt vời cách các công cụ mạnh mẽ như Upstash Redis, Clerk dùng cùng nhau giải quyết vấn đề phức tạp mượt mà.

Đề xuất cải tiến thêm:

  • Trải nghiệm User: Mặc dù giỏ hàng robust và functional, đi sâu vào UI enhancement—animation, feedback loop, preview sản phẩm chi tiết—có thể mang lại hành trình user mượt mà hơn.

  • Hiệu suất: Với nền tảng Upstash Redis, có thể đi sâu vào advanced caching strategy, tích hợp service worker cải thiện load time và trải nghiệm offline phong phú hơn.

  • Tính năng: Mở rộng khả năng giỏ hàng với wishlist, gợi ý sản phẩm dựa trên nội dung giỏ hiện tại, hoặc hệ thống áp mã khuyến mãi để nâng cao trải nghiệm mua sắm.

  • Tích hợp: Tiềm năng tích hợp payment gateway cho checkout mượt mà hoặc kết nối hệ thống inventory/CRM thứ ba cho giải pháp eCommerce toàn diện.

Cảm ơn bạn đã theo dõi cuộc phiêu lưu phát triển này. Chúng tôi mong nghe feedback và thấy những đổi mới bạn mang đến cho cấu trúc nền tảng này! Nếu có câu hỏi hoặc vấn đề, liên hệ fahreddin@upstash.com.

GitHub Repository dự án tại đây.

Phần lên lịch email dùng QStash và Resend sẽ cover trong bài khác. Tạm thời check example repo xem triển khai.