Quay lại Trang chủ
Featured Case Study

Laptop Shop - REST API Thương mại Điện tử & Storefront

Nền tảng thương mại điện tử tách rời frontend/backend: REST API phục vụ storefront và trang quản trị Next.js, bao gồm tìm kiếm danh mục, giỏ hàng, checkout idempotent, thanh toán chuyển khoản, flash sale, đánh giá và hậu mãi.

Vai trò
Fullstack Developer (Trọng tâm Backend, Dự án Cá nhân)
Thời gian thực hiện
Tháng 6/2025 - Hiện tại

Tổng quan Dự án

Nền tảng thương mại điện tử tách rời frontend/backend: REST API phục vụ storefront và trang quản trị Next.js, bao gồm tìm kiếm danh mục, giỏ hàng, checkout idempotent, thanh toán chuyển khoản, flash sale, đánh giá và hậu mãi.

Công nghệ

Frontend
Next.jsReactTanStack Query
Backend
Node.jsExpress 5TypeScriptZodJWT
Cơ sở dữ liệu
Prisma ORMMySQL 8Redis
Hạ tầng
BullMQDocker ComposeGitHub Actions
Kiểm thử & Công cụ
JestSupertestVitest

Trách nhiệm chính & Triển khai thực tế

  • Kiến trúc: Tổ chức API thành hơn 20 module tính năng theo luồng routes → controller → service → Prisma, validate request bằng Zod, DTO mapper và định dạng lỗi thống nhất. Sinh tài liệu OpenAPI và Swagger UI từ Zod schema; kiểu dữ liệu phía web client được sinh tự động từ tài liệu này.
  • Xác thực: JWT access token ngắn hạn kết hợp refresh token dạng opaque lưu trong HttpOnly cookie. Refresh token được lưu dạng băm và xoay vòng; việc tái sử dụng token đã thu hồi sẽ thu hồi toàn bộ họ token. Bổ sung phân quyền theo vai trò (Admin/User), kiểm tra origin và giới hạn tần suất (rate limiting) dựa trên Redis cho đăng nhập và đăng ký.
  • Đơn hàng và tồn kho: Checkout yêu cầu Idempotency-Key, tính giá sản phẩm phía server và khóa bản ghi sản phẩm bằng cập nhật tồn kho có điều kiện trong cùng một Prisma transaction để tránh bán vượt tồn kho. Hủy đơn hàng sẽ hoàn lại tồn kho.
  • Flash sale: Giữ chỗ hạn mức theo từng chương trình khuyến mãi và giới hạn theo từng người dùng một cách nguyên tử bằng cập nhật có điều kiện, và giải phóng khi đơn hàng bị hủy.
  • Xử lý bất đồng bộ: Triển khai transactional outbox: dispatcher phát sự kiện vào các hàng đợi BullMQ, được tiêu thụ bởi các worker riêng cho thanh toán, thông báo, hậu mãi và cảnh báo giá, chạy dưới dạng các service Docker Compose.
  • Thanh toán và lưu trữ: Tích hợp thanh toán chuyển khoản SePay qua một provider interface kèm đối soát. Lưu ảnh đánh giá và hậu mãi trên storage tương thích S3, kèm script đối soát các file mồ côi.
  • Chất lượng và triển khai: Unit test với Jest và Supertest (mock Prisma), ESLint/Prettier với Husky hooks, CI trên GitHub Actions (lint, typecheck, test, build, Docker build), endpoint health/readiness và log có cấu trúc với Pino và Sentry.
  • Frontend: Xây dựng storefront và trang quản trị bằng Next.js: Server Components cho các trang danh mục, TanStack Query cho giỏ hàng, checkout và tài khoản.