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.
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ệ
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.
Dự án liên quan
DevLink – Cổng Tuyển Dụng CNTT
Nền tảng tuyển dụng IT kết nối ứng viên và nhà tuyển dụng, tích hợp so khớp hồ sơ với sự hỗ trợ của AI, định hướng nghề nghiệp và tự động tổng hợp việc làm từ các nguồn bên ngoài.
Next.jsReactRedux Toolkit+11Ecochic - Nền tảng Quản lý Doanh nghiệp Nội bộ
Nền tảng doanh nghiệp nội bộ hỗ trợ HRM, quản lý tài chính và quy trình ký số điện tử, được xây dựng theo kiến trúc hướng vi dịch vụ (microservices).
NestJSFastifyPostgreSQL+12