feat: add comment in module product

Author: anh-tus

backend/src/main/java/com/smalltrend/controller/products/ProductController.java

@@ -33,6 +33,7 @@
 @RequiredArgsConstructor
 public class ProductController {
 
+    // REVIEW FLOW: Controller nhận request -> phân quyền @PreAuthorize -> chuyển cho service xử lý nghiệp vụ -> trả response cho frontend.
     private final ProductService productService;
     private final ProductVariantService productVariantService;
     private final UnitConversionService unitConversionService;
@@ -187,6 +188,7 @@ public ResponseEntity<String> deleteUnit(@PathVariable("id") Integer id) {
     }
 
     // ─── Variant Prices ──────────────────────────────────────────────────────
+    // REVIEW FLOW (PRICE): tạo/lấy/cập nhật giá theo variant -> service tự quản lý active/inactive + lịch sử hiệu lực giá.
     // Tạo giá mới cho variant (giá cũ chuyển INACTIVE)
     @PostMapping("/variants/{variantId}/prices")
     @PreAuthorize("hasAnyAuthority('MANAGER','ROLE_MANAGER')")
@@ -271,6 +273,7 @@ public ResponseEntity<java.util.Map<String, Object>> sendPriceExpiryAlertsNow()
         ));
     }
 
+    // REVIEW FLOW (PRODUCT CRUD): tạo/cập nhật/toggle/xoá product sẽ gọi ProductService, nơi enforce rule validate + propagate trạng thái xuống variants.
     @PostMapping
     @PreAuthorize("hasAnyAuthority('MANAGER','ROLE_MANAGER')")
     public ResponseEntity<ProductResponse> create(@RequestBody CreateProductRequest request) {

backend/src/main/java/com/smalltrend/service/products/ProductComboServiceImpl.java

@@ -31,6 +31,7 @@
 @RequiredArgsConstructor
 public class ProductComboServiceImpl implements ProductComboService {
 
+    // REVIEW FLOW: validate combo + items -> chuẩn hoá giá -> kiểm tra giá so với tổng cost -> lưu combo -> lưu danh sách item.
     private static final BigDecimal PRICE_ROUND_STEP = BigDecimal.valueOf(100);
 
     private final ProductComboRepository productComboRepository;

backend/src/main/java/com/smalltrend/service/products/ProductServiceImpl.java

@@ -19,6 +19,7 @@
 @RequiredArgsConstructor
 public class ProductServiceImpl implements ProductService {
 
+    // REVIEW FLOW: validate dữ liệu product -> map request vào entity -> lưu DB -> map response trả về.
     private final ProductRepository productRepository;
     private final ProductValidator productValidator;
 
@@ -77,6 +78,7 @@ public ProductResponse create(CreateProductRequest request) {
 
     // Sửa thông tin Sản phẩm đã tồn tại. Nếu cập nhật trạng thái (Active)
     // thì thay đổi sẽ áp dụng lan truyền xuống các Biến thể (Variants) con
+    // REVIEW FLOW (UPDATE): lấy product cũ -> validate tên mới -> apply request -> nếu đổi trạng thái thì propagate xuống variant -> save.
     @Override
     @Transactional
     public ProductResponse update(Integer id, CreateProductRequest request) {

backend/src/main/java/com/smalltrend/service/products/ProductVariantService.java

@@ -39,6 +39,7 @@
 @RequiredArgsConstructor
 public class ProductVariantService {
 
+    // REVIEW FLOW: validate product/unit/SKU/barcode -> tạo/cập nhật variant -> đồng bộ batch, conversion, stock và dữ liệu giá liên quan.
     private final ProductVariantRepository productVariantRepository;
     private final UnitRepository unitRepository;
     private final InventoryStockRepository inventoryStockRepository;
@@ -87,6 +88,7 @@ public List<ProductVariantRespone> getVariantsByProductId(Integer productId) {
      * Tạo mới một variant cho product. Thực hiện đầy đủ validate nghiệp vụ
      * trước khi lưu.
      */
+    // REVIEW FLOW (CREATE): validate product/unit + rule SKU/Barcode/PLU -> dựng entity variant -> lưu variant -> (nếu có) tạo batch giá vốn ban đầu.
     public ProductVariantRespone createVariant(Integer productId, CreateVariantRequest request) {
         Product product = productVariantValidator.requireExistingProduct(productId);
         Unit unit = productVariantValidator.requireExistingUnit(request.getUnitId());
@@ -132,6 +134,7 @@ public ProductVariantRespone createVariant(Integer productId, CreateVariantReque
      * Cập nhật thông tin variant hiện có. Nếu có costPrice thì cập nhật batch
      * mới nhất hoặc tạo batch mới khi chưa có dữ liệu batch.
      */
+    // REVIEW FLOW (UPDATE): tìm variant hiện tại -> validate unique/format -> cập nhật trường thay đổi -> đồng bộ costPrice vào batch gần nhất.
     public ProductVariantRespone updateVariant(Integer variantId, CreateVariantRequest request) {
         ProductVariant variant = productVariantValidator.requireExistingVariant(variantId);
         Unit unit = productVariantValidator.requireExistingUnit(request.getUnitId());

backend/src/main/java/com/smalltrend/validation/product/ProductComboValidator.java

@@ -16,6 +16,7 @@
 @Component
 public class ProductComboValidator {
 
+    // REVIEW FLOW: validate tên/giá/items combo -> chặn trùng variant trong cùng combo -> kiểm tra unique tên và mã combo trước khi lưu.
     private final ProductComboRepository productComboRepository;
     private final ProductVariantRepository productVariantRepository;
 

backend/src/main/java/com/smalltrend/validation/product/ProductValidator.java

@@ -18,6 +18,7 @@
 @RequiredArgsConstructor
 public class ProductValidator {
 
+    // REVIEW FLOW: đảm bảo tồn tại dữ liệu liên quan (product/category/brand/tax) và chặn vi phạm rule tên trùng hoặc xoá quá 2 phút.
     private final ProductRepository productRepository;
     private final BrandRepository brandRepository;
     private final CategoryRepository categoryRepository;

backend/src/main/java/com/smalltrend/validation/product/ProductVariantValidator.java

@@ -16,6 +16,7 @@
 @RequiredArgsConstructor
 public class ProductVariantValidator {
 
+    // REVIEW FLOW: kiểm tra tồn tại product/unit/variant -> validate format + unique SKU/Barcode/PLU -> chặn activate sai trạng thái product cha.
     private final ProductVariantRepository productVariantRepository;
     private final ProductRepository productRepository;
     private final UnitRepository unitRepository;

frontend/src/pages/Products/ProductManager/AddNewProduct.jsx

@@ -177,6 +177,7 @@ const AddNewProduct = () => {
   };
 
   // --- HANDLER SUBMIT TỔNG CHÍNH ---
+  // REVIEW FLOW: validate form -> upload ảnh (nếu có) -> gọi API tạo product -> điều hướng về list.
   const handleSubmit = async (e) => {
     e.preventDefault();
 

frontend/src/pages/Products/ProductManager/AddNewProductVariant.jsx

@@ -16,6 +16,7 @@ import api from "../../../config/axiosConfig";
  * Hỗ trợ sinh SKU/Barcode tự động, khai báo thuộc tính và cấu hình quy đổi đơn vị.
  */
 const AddNewProductVariant = () => {
+  // REVIEW FLOW: nhập mã/đơn vị/thuộc tính -> (tuỳ chọn) upload ảnh + khai báo quy đổi -> tạo variant -> tạo conversion -> quay về màn detail.
   const navigate = useNavigate();
   const location = useLocation();
   const product = location.state?.product;
@@ -283,6 +284,7 @@ const AddNewProductVariant = () => {
   };
 
   // Hàm Submit: Tiến hành Upload image (nếu có) trước rồi lấy URL đính vào payload Variant để Post tạo mới
+  // REVIEW FLOW (SUBMIT): validate -> upload ảnh -> tạo variant -> nếu có thì tạo conversion -> quay về detail.
   const handleSubmit = async (e) => {
     e.preventDefault();
     setErrorMsg("");

frontend/src/pages/Products/ProductManager/CategoryAndBrand.jsx

@@ -14,6 +14,7 @@ import { useAuth } from "../../../context/AuthContext";
 import { canManageProducts } from "../../../utils/roleUtils";
 
 const Category_Brand = () => {
+  // REVIEW FLOW: chọn tab Category/Brand -> lọc/sắp xếp dữ liệu -> add/edit/delete qua modal -> refresh và hiển thị toast phản hồi.
   const { user } = useAuth();
   const canEditProducts = canManageProducts(user);
   // Trạng thái quản lý điều hướng và modal
@@ -204,7 +205,7 @@ const Category_Brand = () => {
     return [...new Set(countries)].sort();
   }, [brands, activeTab]);
 
-  // Bộ tổng hợp Filter: Chỉ hiện các từ khoá trùng, quốc gia khớp và sắp xếp theo ngày sinh
+  // REVIEW FLOW (LIST): lấy data theo tab hiện tại -> lọc theo search/country -> sort theo ngày tạo để render bảng.
   const filteredData = useMemo(() => {
     let filtered = data.filter(item =>
       item.name?.toLowerCase()?.includes(searchQuery.toLowerCase())