addio-admin-sdk 1.7.103 → 1.7.104

package/dist/rules/GR/utils/expedition.js

@@ -11,19 +11,25 @@ const floor_1 = __importDefault(require("lodash/floor"));
 const round_1 = __importDefault(require("lodash/round"));
 const sumBy_1 = __importDefault(require("lodash/sumBy"));
 const toNumber_1 = __importDefault(require("lodash/toNumber"));
+// Rule specific interfaces
 const products_1 = require("../interfaces/products");
+// Rule specific functions/constants
 const data_1 = require("./data");
 const products_2 = require("./products");
 const cart_1 = require("./cart");
 const g2_1 = require("./g2");
 const data_2 = require("../constants/data");
+// General interfaces
 const Cart_1 = require("../../../Interfaces/Cart");
+// General utils
 const data_3 = require("../../../utils/data");
 const products_3 = require("../../../utils/products");
 const cart_2 = require("../interfaces/cart");
 const data_4 = require("../interfaces/data");
 const products_4 = require("../constants/products");
 const object_1 = require("../../../utils/object");
+// ------------------------------------------------------------------------------------------
+// #region HOURS
 const getDefaultTimeValues = () => {
     let values = ['AM', 'PM'];
     return values.map((v) => ({ label: v, value: v }));
@@ -38,6 +44,7 @@ const getAvailableHours = (minDeliveryDate, selectedDate, grassProduct, concrete
             ? (0, moment_1.default)(testDate).toDate()
             : (0, moment_1.default)(testDate).set('hours', (0, moment_1.default)().hours()).toDate()
         : (0, moment_1.default)().toDate();
+    // If concreteOrder and product in stock and is pickup, can select 'now' (AM if before noon, PM if after)
     if (!!concreteOrder && !!concreteOrder.inStock && expeditionMethod === 'pickup') {
         const isPM = today.getHours() >= 12;
         if (!!isPM) {
@@ -48,6 +55,8 @@ const getAvailableHours = (minDeliveryDate, selectedDate, grassProduct, concrete
             newSelectedDeliveryTime: !!isPM ? { label: 'PM', value: 'PM' } : undefined
         };
     }
+    // ------------------------------------------------------------------------------------------------------
+    // enable all hours in selection
     const resetHours = (d) => {
         d.setHours(0);
         d.setMinutes(0);
@@ -69,34 +78,51 @@ const getAvailableHours = (minDeliveryDate, selectedDate, grassProduct, concrete
         }
         deliveryTimes = ['PM'];
     };
+    // EDIT - Ajusted logic that excluded saturdays from time selection if not pro to make available if expeditionMethod = shipping [ 03-10-2022 ]
     if (selectedDateDay === 0 || (selectedDateDay === 6 && !!!isPro && expeditionMethod === 'pickup')) {
         deliveryTimes = [];
         newSelectedDeliveryTime = undefined;
     }
-    else if (!(!!concreteOrder && concreteOrder.type == 'green' && (!concreteOrder.inStock || expeditionMethod == 'delivery'))) {
+    else if (
+    // Bug GR-I505 - AM / PM toujours disponnible pour Beton Vert en livraison
+    // Bug GR-I511 - Pickup for concrete not in stock only change de available day
+    !(!!concreteOrder && concreteOrder.type == 'green' && (!concreteOrder.inStock || expeditionMethod == 'delivery'))) {
         if (isSelectedSameAsTarget) {
             if (!!grassProduct || (!!concreteOrder && concreteOrder.type === 'green')) {
                 let todayReset = !!testDate ? (0, moment_1.default)(testDate).toDate() : (0, moment_1.default)().toDate();
                 resetHours(todayReset);
+                // If today is either saturday of sunday
                 if (!![6, 0].includes(todayReset.getDay())) {
+                    // Two options :
+                    //   - is non-speciality grass OR [ concrete + type green + pickup + not in stock ] and target day is NOT a tuesday
+                    //   - is any other kind of grass and target day is NOT a wednesday or thursday
                     if ((![2].includes(targetDateDay) &&
                         (!!isNonSpecialityGrass ||
                             (!!concreteOrder && !concreteOrder.inStock && expeditionMethod === 'pickup'))) ||
                         (![3, 4].includes(targetDateDay) && !!!isNonSpecialityGrass)) {
+                        // EDIT - Ajusted logic that excluded saturdays from time selection if not pro to make available if expeditionMethod = shipping [ 03-10-2022 ]
                         if (targetDateDay === 6 && !!!isPro && expeditionMethod === 'pickup') {
                             newSelectedDeliveryTime = undefined;
                             deliveryTimes = [];
                         }
                         else {
                             const amTimeToCheck = !!grassProduct && expeditionMethod == 'pickup' ? 12 : 10;
+                            // Logic ajusted on 08-05-2025 (task #GR-I377 in Sprint) - If grass & pickup, first check starts at noon. If not, at 10am.
+                            // Check if later than specific AM time
                             if (today.getHours() >= amTimeToCheck) {
                                 onlyPm();
                             }
                         }
                     }
+                    // If none of the above options are true, both time periods are available to the user
                 }
                 else {
+                    // Today is any other day than the weekend
+                    // Check if later than target hour
+                    // Logic updated on 08-05-2025, #GR-I377 in Sprint
                     let targetHour = !!grassProduct && expeditionMethod == 'pickup' ? 12 : 10;
+                    // If grass or green concrete pickup, and today is Friday, AM stays available until after 16h
+                    // Logic updated on 17-02-2025, GR-I150 dans Zoho Sprint
                     if (todayDay == 5 &&
                         (!!grassProduct || (!!concreteOrder && concreteOrder.type == 'green' && expeditionMethod == 'pickup'))) {
                         targetHour = 16;
@@ -106,7 +132,9 @@ const getAvailableHours = (minDeliveryDate, selectedDate, grassProduct, concrete
                     }
                 }
             }
+            // If order contains samples or is of any other type than grass or concrete
             if ((!!!grassProduct && !!!concreteOrder) || !!isSample || !!isAccessoriesOnly) {
+                // Check if later than 10 AM
                 if (today.getHours() > 10) {
                     onlyPm();
                 }
@@ -119,10 +147,15 @@ const getAvailableHours = (minDeliveryDate, selectedDate, grassProduct, concrete
     };
 };
 exports.getAvailableHours = getAvailableHours;
+// Date de dégel (hardcodée, sera modifiée directement dans le code à la demande des clients)
 const isDegel = (dateToCheck) => {
     let date = !!dateToCheck ? (0, moment_1.default)(dateToCheck) : (0, moment_1.default)();
     return date.isBetween('2024-03-04 00:00:01', '2024-04-15 23:59:59', undefined, '[]');
 };
+/**
+ * Function getMinDatePicker
+ * @description Sets the minimum shipping day for delivery
+ */
 const getMinDatePicker = (cartData, grassProduct, concreteOrder, expeditionMethod, isPro, testDate, blockedShippingDates, vracType, isPOS, spaceSchedule) => {
     const cartContainsInstallation = (0, cart_1.checkIfCartContainsType)(cart_2.CartGeneralTypeEnum.INSTALLATION, cartData);
     const cartContainsVrac = (0, cart_1.checkIfCartContainsType)(cart_2.CartGeneralTypeEnum.VRAC, cartData);
@@ -133,7 +166,13 @@ const getMinDatePicker = (cartData, grassProduct, concreteOrder, expeditionMetho
     }
     let now = testDate || (0, moment_1.default)().toDate();
     let min_date = testDate || (0, moment_1.default)().toDate();
+    // =======================================================================================
+    // #region MIN DATE OFFSET
     const nbDaysOffset = (0, exports.getMinDateOffset)(now, cartContainsInstallation, cartContainsVrac, cartData, grassProduct, concreteOrder, isAccessoriesOnly, expeditionMethod, vracType);
+    // #endregion
+    // =======================================================================================
+    // =======================================================================================
+    // #region BLOCKED DAYS/DATES
     const typeToCheck = !!concreteOrder
         ? 'beton'
         : !!grassProduct
@@ -144,6 +183,9 @@ const getMinDatePicker = (cartData, grassProduct, concreteOrder, expeditionMetho
     let dateToCheck = new Date(min_date);
     dateToCheck.setDate(min_date.getDate() + nbDaysOffset);
     let pickupDateSameAsNewDate = false;
+    // ---------------------------------------------------------------------------------------
+    // Check if space has blocked days
+    // NEW!!! - For now, blocked days are hardcoded here. Will be moved to space eventually.
     const blockedDays = {
         vrac: [0],
         beton: [0],
@@ -152,6 +194,7 @@ const getMinDatePicker = (cartData, grassProduct, concreteOrder, expeditionMetho
     const getNextAvailableDay = (type) => {
         const dayToCheck = dateToCheck.getDay();
         if (!!blockedDays[type]) {
+            // Right now we ignore blocked days on pickup because we check the schedules in the space. If days are added to the blockedDays dictionnary, validate that they still shouldn't apply on pickup
             if (blockedDays[type].includes(dayToCheck) && expeditionMethod !== 'pickup') {
                 dateToCheck.setDate(dateToCheck.getDate() + 1);
                 return getNextAvailableDay(type);
@@ -175,6 +218,8 @@ const getMinDatePicker = (cartData, grassProduct, concreteOrder, expeditionMetho
             pickupDateSameAsNewDate = true;
         }
     }
+    // ---------------------------------------------------------------------------------------
+    // Check if space has blocked dates
     if (!!blockedShippingDates && blockedShippingDates.length && !!typeToCheck && expeditionMethod === 'delivery') {
         const blockedDatesToCheck = blockedShippingDates.find((blockedDate) => blockedDate.cart_type === typeToCheck);
         if (!!blockedDatesToCheck && !!blockedDatesToCheck.dates && !!blockedDatesToCheck.dates.length) {
@@ -194,6 +239,8 @@ const getMinDatePicker = (cartData, grassProduct, concreteOrder, expeditionMetho
             }
         }
     }
+    // #endregion
+    // =======================================================================================
     if (!!!concreteOrder || concreteOrder.type !== 'yellow') {
         min_date.setDate(dateToCheck.getDate());
         min_date.setHours(0);
@@ -211,8 +258,10 @@ exports.getMinDatePicker = getMinDatePicker;
 const getSamplesMinDateOffset = () => {
     const now = new Date();
     const year = now.getFullYear();
-    const startWinterPeriod = new Date(year, 11, 1);
-    const endWinterPeriod = new Date(year + 1, 2, 1);
+    // December 1st
+    const startWinterPeriod = new Date(year, 11, 1); // December == 11
+    // March 1st
+    const endWinterPeriod = new Date(year + 1, 2, 1); // March == 2
     const isWinterPeriod = (0, moment_1.default)().isBetween((0, moment_1.default)(startWinterPeriod), (0, moment_1.default)(endWinterPeriod), 'day', '[]');
     return isWinterPeriod ? 14 : 7;
 };
@@ -221,8 +270,25 @@ const getMinDateOffset = (now, cartContainsInstallation, cartContainsVrac, cartD
     const current_hour = now.getHours();
     const current_day = now.getDay();
     let nb_days_offset = 1;
+    // Variable to set all grass delays the same as non-speciality grasses (as of now, Kentucky and Prestige).
+    // Use this instead of changing all values, in case our clients change their mind later!
     const allGrassDelaysSameAsNonSpecialityGrasses = true;
+    // ========================
+    // IF INSTALL
+    // Install logic adjusted on 01-05-2024 (task #GR7-T429)
     if (!!cartContainsInstallation) {
+        // --------------------
+        // "Low staff" logic = 96hours delay for first available date
+        // switch (current_day) {
+        // 	case 3:
+        // 		nb_days_offset = 5
+        // 		break
+        // 	default:
+        // 		nb_days_offset = 4
+        // 		break
+        // }
+        // --------------------
+        // "Medium staff" logic = 48hours delay for first available date
         switch (current_day) {
             case 5:
                 nb_days_offset = 3;
@@ -231,7 +297,23 @@ const getMinDateOffset = (now, cartContainsInstallation, cartContainsVrac, cartD
                 nb_days_offset = 2;
                 break;
         }
+        // --------------------
+        // Regular logic (if fee applies for current year) = 24 hour delay for first available date
+        // switch (current_day) {
+        // 	case 5:
+        // 		nb_days_offset = current_hour < 10 ? 1 : 3
+        // 		break
+        // 	case 6:
+        // 	case 0:
+        // 		nb_days_offset = 2
+        // 		break
+        // 	default:
+        // 		nb_days_offset = 1
+        // 		break
+        // }
     }
+    // ========================
+    // IF SAMPLE OR ACCESSORIES ONLY
     else if (cartData.items.find((item) => item.is_sample) || !!isAccessoriesOnly) {
         if (expeditionMethod === 'delivery') {
             nb_days_offset = !!isAccessoriesOnly ? 7 : (0, exports.getSamplesMinDateOffset)();
@@ -255,33 +337,42 @@ const getMinDateOffset = (now, cartContainsInstallation, cartContainsVrac, cartD
             }
         }
     }
+    // ========================
+    // IF VRAC PRODUCTS WITH DELIVERY
     else if (expeditionMethod === 'delivery' &&
         !!cartContainsVrac &&
         !!(0, object_1.recursiveCheckObject)(vracType, 'vrac_type') &&
         [products_1.VracTypeEnum.AUTRE_TONNE, products_1.VracTypeEnum.NOBEL_TONNE].includes(vracType.vrac_type)) {
         nb_days_offset = 1;
     }
+    // ========================
+    // IF BASE GRASS / ALL GRASSES ARE SAME
     else if (!!grassProduct &&
         ([products_4.kentucky, products_4.prestige].includes(grassProduct.sku) || !!allGrassDelaysSameAsNonSpecialityGrasses)) {
         const amTimeToCheck = !!grassProduct && expeditionMethod == 'pickup' ? 12 : 10;
+        // Logic ajusted on 08-05-2025 (task #GR-I377 in Sprint) - If grass & pickup, first check starts at noon. If not, at 10am.
         switch (current_day) {
             case 5:
-                nb_days_offset = current_hour < amTimeToCheck ? 1 : current_hour < 16 ? 3 : 3;
+                nb_days_offset = current_hour < amTimeToCheck ? 1 : current_hour < 16 ? 3 : 3; // earliest is tomorrow if before 10AM, else after tomorrow, not counting the weekend (on fridays)
+                // Logic ajusted on 14-02-2025 (task #GR-I151 in Sprint) - New check for between 10h (or 12h if grass&pickup) and 16h
                 break;
             case 6:
-                nb_days_offset = 3;
+                nb_days_offset = 3; // earliest is after tomorrow, not counting the weekend (on fridays or saturdays)
                 break;
             case 0:
-                nb_days_offset = 2;
+                nb_days_offset = 2; // earliest is after tomorrow, not counting the weekend (on sundays)
                 break;
             default:
-                nb_days_offset = 1;
+                nb_days_offset = 1; // earliest is tomorrow
         }
     }
+    // ========================
+    // IF CONCRETE WITH PICKUP | UNAVAILABLE PRODUCT
     else if (!!concreteOrder &&
         concreteOrder.type === 'green' &&
         !concreteOrder.inStock &&
         expeditionMethod === 'pickup') {
+        // 13-08-2025 : Bug GR-I511 - Pickup for concrete not in stock only change the available day
         const amTimeToCheck = 10;
         switch (current_day) {
             case 0:
@@ -300,23 +391,29 @@ const getMinDateOffset = (now, cartContainsInstallation, cartContainsVrac, cartD
                 nb_days_offset = current_hour < amTimeToCheck ? 1 : 2;
         }
     }
+    // ========================
+    // IF CONCRETE WITH PICKUP | ONLY AVAILABLE PRODUCTS
     else if (!!concreteOrder &&
         concreteOrder.type === 'green' &&
         concreteOrder.inStock &&
         expeditionMethod === 'pickup') {
         nb_days_offset = 0;
     }
+    // ========================
+    // IF SPECIALITY GRASS
     else if (!!grassProduct && !!![products_4.kentucky, products_4.prestige].includes(grassProduct.sku)) {
         switch (current_day) {
             case 5:
             case 6:
             case 0:
-                nb_days_offset = 4;
+                nb_days_offset = 4; // if we are on friday and it's earlier than 10
                 break;
             default:
-                nb_days_offset = 2;
+                nb_days_offset = 2; // earliest is after tomorrow
         }
     }
+    // ========================
+    // IF CONCRETE WITH DELIVERY | ONLY AVAILABLE PRODUCTS
     else if (!!concreteOrder && concreteOrder.type === 'green' && expeditionMethod === 'delivery') {
         switch (current_day) {
             case 0:
@@ -329,9 +426,11 @@ const getMinDateOffset = (now, cartContainsInstallation, cartContainsVrac, cartD
                 break;
             case 4:
                 nb_days_offset = current_hour < 10 ? 2 : current_hour < 16 ? 4 : 5;
+                // Logic ajusted on 14-02-2025 (task #GR-I151 in Sprint) - New check for between 10h and 16h
                 break;
             case 5:
                 nb_days_offset = current_hour < 16 ? 4 : 5;
+                // Logic ajusted on 14-02-2025 (task #GR-I151 in Sprint) - New check for 16h instead of 10h
                 break;
             case 6:
                 nb_days_offset = 4;
@@ -340,6 +439,8 @@ const getMinDateOffset = (now, cartContainsInstallation, cartContainsVrac, cartD
                 break;
         }
     }
+    // ========================
+    // IF ANY PRODUCT WITH DELIVERY THAT DID NOT FIT IN PREVIOUS CATEGORIES
     else if (expeditionMethod === 'delivery') {
         switch (current_day) {
             case 0:
@@ -366,10 +467,21 @@ const getMinDateOffset = (now, cartContainsInstallation, cartContainsVrac, cartD
     return nb_days_offset;
 };
 exports.getMinDateOffset = getMinDateOffset;
+/**
+ * Function shouldDisableDate
+ * @description compares date with blockedDates from DB and blocked days (currently hardcoded in function)
+ * @param date - Date to check
+ * @param blockedDates - Blocked dates from DB
+ * @param expeditionMethod - pickup or shipping
+ * @param cartData
+ */
 const shouldDisableDate = (date, blockedDates, expeditionMethod, cartData, schedule, selectedStore) => {
     if (!!!cartData)
         return false;
     const typeToCheck = (0, cart_1.getCartType)(cartData);
+    // ---------------------------------------------------------------------------------------
+    // Blocked days check
+    // NEW!!! - For now, blocked days are hardcoded here. Will be moved to space eventually.
     const blockedDays = {
         vrac: [0],
         beton: [0],
@@ -381,6 +493,8 @@ const shouldDisableDate = (date, blockedDates, expeditionMethod, cartData, sched
         (!!blockedDays[typeToCheck] && !!blockedDays[typeToCheck].includes(date.getDay()) && expeditionMethod !== 'pickup')) {
         return true;
     }
+    // ---------------------------------------------------------------------------------------
+    // Blocked dates checks
     if (expeditionMethod !== 'pickup' && !!typeToCheck && !!blockedDates) {
         const sameType = blockedDates.find((blocked) => blocked.cart_type === typeToCheck);
         if (!!sameType && !!sameType.dates) {
@@ -404,8 +518,10 @@ const dateIsClosedInSchedule = (storeId, dateToCheck, spaceSchedule) => {
     const weekdayIndex = dateToCheck.getDay();
     const storeSchedules = spaceSchedule.store_schedules[storeId];
     let isExternal = false;
+    // If store schedule exists, check it, if not, set min date to dateToCheck.
     if (!!storeSchedules) {
         let selectedDaySchedule;
+        // If periods are activated for the space, check the specific period schedule, if not check the general schedule
         if (!!spaceSchedule.space_periods_active) {
             const year = dateToCheck.getFullYear().toString();
             const periods = (_a = spaceSchedule.year_periods[year]) !== null && _a !== void 0 ? _a : [];
@@ -423,6 +539,9 @@ const dateIsClosedInSchedule = (storeId, dateToCheck, spaceSchedule) => {
                 }
             }
         }
+        // If no schedule found for that day in active period, or periods aren't activated for that space, fall back to general schedule
+        // A closed day should NOT enter this if
+        // A period with an external schedule should NOT enter this if
         if (!!!isExternal &&
             (!!!selectedDaySchedule ||
                 (!!selectedDaySchedule.schedule &&
@@ -437,11 +556,13 @@ const dateIsClosedInSchedule = (storeId, dateToCheck, spaceSchedule) => {
                 selectedDaySchedule = generalSchedule.weekly_schedule[weekdayIndex];
             }
         }
+        // NEW - Returns true here even if isExternal
         if (!!selectedDaySchedule && selectedDaySchedule.open === false) {
             return true;
         }
     }
     let allClosedDays = spaceSchedule.common_closed_days;
+    // If schedule for period is external, filter out all common dates since they do not apply
     if (!!isExternal)
         allClosedDays = allClosedDays.filter((d) => d.type != 'common');
     const isClosed = allClosedDays.some((c) => {
@@ -457,6 +578,12 @@ const dateIsClosedInSchedule = (storeId, dateToCheck, spaceSchedule) => {
     return isClosed;
 };
 exports.dateIsClosedInSchedule = dateIsClosedInSchedule;
+/**
+ * Function checkIfCartTypeHasBlockedDates
+ * @description checks if type of cart corresponds to a blockedDates array and if array has dates defined
+ * @param cartData
+ * @param blockedDates
+ */
 const checkIfCartTypeHasBlockedDates = (cartData, blockedDates) => {
     if (!!!cartData || !!!blockedDates || !!!blockedDates.length)
         return false;
@@ -467,6 +594,10 @@ const checkIfCartTypeHasBlockedDates = (cartData, blockedDates) => {
     return !!sameType.dates && !!sameType.dates.length;
 };
 exports.checkIfCartTypeHasBlockedDates = checkIfCartTypeHasBlockedDates;
+// #endregion
+// ------------------------------------------------------------------------------------------
+// ------------------------------------------------------------------------------------------
+// #region FEES
 exports.slugsToCheckFromExpeditionFees = {
     pickup: ['frais-preparation-general-beton', 'frais-palette', 'minimum-facturable-commande'],
     shipping: [
@@ -499,9 +630,11 @@ const getPalletQty = (items, orderType, minQteGrassOrder = 0) => {
         if (!!!typeAttr || !!!typeAttr.length) {
             return 0;
         }
+        // If item is an accessory
         if (!!typeAttr && !typeAttr.includes('gazon') && !typeAttr.includes('beton')) {
             return (0, floor_1.default)((item.qte * sellUnit) / paletteUnit.fitting_unit);
         }
+        // If is grass and minQteGrassOrder is defined
         if (!!typeAttr.includes('gazon') && !!minQteGrassOrder && item.qte < minQteGrassOrder) {
             return minQteGrassOrder / paletteUnit.fitting_unit;
         }
@@ -513,8 +646,11 @@ const getPalletQty = (items, orderType, minQteGrassOrder = 0) => {
     return total;
 };
 exports.getPalletQty = getPalletQty;
+// Retourne un nombre de frais de palettes à ajouter au panier selon la vraie quantité de palettes calculées pour les produits de gazon
 const getGrassRoundedPickupPalletFees = (realPalletNumber) => {
+    // More than 400 square feet of grass needs another pallet
     const ratio = (0, round_1.default)(400 / 740, 3);
+    // Get only the decimals from the real calculated pallet number, if the decimal is bigger than 400 / 740, round up
     const fraction = (0, round_1.default)(realPalletNumber % 1, 3);
     if (fraction >= ratio)
         return (0, ceil_1.default)(realPalletNumber);
@@ -524,6 +660,7 @@ exports.getGrassRoundedPickupPalletFees = getGrassRoundedPickupPalletFees;
 const getPalletQtyPalletFee = (items, expeditionMethod, isGrass, isMixed) => {
     let totalPalletGrass = 0;
     let totalPalletOther = 0;
+    // For this fee specifically, remove all accessories before calculating palQty
     items = items.filter((i) => !(0, products_2.checkIfProductIsOfType)(i, 'accessoire'));
     if (!!isGrass) {
         const grassItemsToCheck = !!isMixed ? items.filter((i) => !!(0, products_2.checkIfProductIsOfType)(i, 'gazon', true)) : items;
@@ -576,14 +713,19 @@ const calculatePalFeeForOtherThanGrass = (items) => {
             sellUnit = !!sellUnitCheck.fitting_unit ? sellUnitCheck.fitting_unit : 1;
         }
         const typeAttr = item.attributes[data_4.AttributesIdEnumGR.TYPE];
+        // --------------------------------------------------
+        // 1. If not all units are defined
+        // if no palUnit or no typeAttr
         if (!!!palUnit || !!!palUnit.fitting_unit || !!!typeAttr || !!!typeAttr.length) {
             if (!!itemIsException)
                 return 1;
+            // if no rgUnit, can't calculate pallet amount
             if (!!!rgUnit || !!!rgUnit.fitting_unit) {
                 return 0;
             }
             else {
                 const nbRang = (item.qte * sellUnit) / rgUnit.fitting_unit;
+                // if has quantities but rang amount is lower than 1, return 0
                 if (nbRang > 0 && nbRang <= 1) {
                     return 0;
                 }
@@ -592,29 +734,47 @@ const calculatePalFeeForOtherThanGrass = (items) => {
                 }
             }
         }
+        // --------------------------------------------------
+        // 2. If is accessory
         if (!!typeAttr && !typeAttr.includes('gazon') && !typeAttr.includes('beton')) {
             return (0, floor_1.default)((item.qte * sellUnit) / palUnit.fitting_unit);
         }
         const palQty = (item.qte * sellUnit) / (palUnit.fitting_unit || 1);
         const rgQty = !!rgUnit ? (item.qte * sellUnit) / (rgUnit.fitting_unit || 1) : 0;
         const unitQty = !!unitUnit ? (item.qte * sellUnit) / (unitUnit.fitting_unit || 1) : !!sellUnit ? item.qte : 0;
+        // --------------------------------------------------
+        // 3. Calculate pal quantities
+        //    RULES:
+        //       - 1 pal = 1 pal
+        //       - 1 pal + 1 rang = 1 pal
+        //       - 1 pal + 2 rang = 2 pal
+        //       - 1 pal + 1 rang + 1 unité = 2 pals
+        //       - 1 pal + 1 unité = 1 pal
+        //       - 0 pal :
+        //            - If less than or equals 1 rang (or equivalent in units) = 0 pal (excluding exceptions)
+        //            - More thant 1 rang (or equivalent in units) = 1 pal
         let totalPal = (0, floor_1.default)(palQty);
         const unitsInRg = !!rgUnit ? rgUnit.fitting_unit || 0 : 0;
         const unitsInPal = palUnit.fitting_unit || 0;
+        // if qte gives round number of pallets, return totalPal
         if (item.qte / unitsInPal === totalPal)
             return totalPal;
+        // if rgQty and rgUnit are defined
         if (!!rgQty && !!rgUnit) {
             const rgInPal = (palUnit.fitting_unit || 1) / (rgUnit.fitting_unit || 1);
+            // if palQty is higher than 1 and at least 2 rang extra
             if (palQty >= 1 && (0, ceil_1.default)(rgQty % rgInPal) >= 2) {
                 totalPal += 1;
             }
             else {
                 if (palQty < 1) {
                     if (!!unitQty) {
+                        // if item is in exception list and at least 1 unit extra
                         if (!!itemIsException && unitQty % unitsInPal !== 0) {
                             totalPal += 1;
                         }
                         else if (!!unitsInRg && unitQty > unitsInRg && unitQty / unitsInRg > 1) {
+                            // if unit count does not equal rang count and total unit count is higher than rang count
                             totalPal += 1;
                         }
                     }
@@ -635,13 +795,29 @@ const calculatePalFeeForOtherThanGrass = (items) => {
 exports.calculatePalFeeForOtherThanGrass = calculatePalFeeForOtherThanGrass;
 const getMinGrassQte = (_grassProduct, expeditionMethod, _isPro) => {
     let minQteGrassOrder = 0;
+    // if (!![kentucky, prestige].includes(grassProduct.sku)) {
+    // 	if (expeditionMethod !== 'pickup') {
+    // 		minQteGrassOrder = !!isPro ? 1480 : 740
+    // 	}
+    // } else {
+    // 	// Grass product is Speciality Grass
+    // 	if (expeditionMethod === 'pickup') {
+    // 		minQteGrassOrder = 740
+    // 	} else {
+    // 		minQteGrassOrder = !!isPro ? 1480 : 740
+    // 	}
+    // }
+    // MODIF AVEC FRAIS 2024 - Même minimum facturable pour tous les gazons, et tous les clients
+    // Toujours 0 pour la cueillette (pas de minimum), et 740 en livraison
     if (expeditionMethod != 'pickup') {
-        minQteGrassOrder = 740;
+        minQteGrassOrder = 740; // 1 pallet
     }
     return minQteGrassOrder;
 };
 exports.getMinGrassQte = getMinGrassQte;
 const getMinQteInstall = (_isPro) => {
+    // return !!isPro ? 2220 : 740
+    // MODIF AVEC FRAIS 2024 - Même minimum facturable pour tous les clients pour l'installation
     return 740;
 };
 exports.getMinQteInstall = getMinQteInstall;
@@ -667,12 +843,20 @@ const resetAllFeesIfAccessoriesOnly = (currentItems) => {
     }
     return itemsToDelete;
 };
-const checkIfShouldApplySameDayGrassFee = (firstDayForExpedition, expeditionMethod, selectedExpeditionDate, testDate) => {
+const checkIfShouldApplySameDayGrassFee = (firstDayForExpedition, expeditionMethod, selectedExpeditionDate, testDate // for unit test. To test holiday + hour after 4PM
+) => {
+    // a. Check min date for expedition type (for POS carts)
     const dateToCheck = expeditionMethod === 'pickup' ? firstDayForExpedition.min_pickup : firstDayForExpedition.min_delivery;
     const dateSelectedIsBeforeFirstCalculatedDay = !!dateToCheck && (0, moment_1.default)((0, data_3.formatDate)(selectedExpeditionDate)).isBefore((0, moment_1.default)(dateToCheck), 'date');
+    // b. Check if current day is a holiday
     const isHoliday = (0, data_1.getHolidays)().some((h) => (0, moment_1.default)(h).isSame(testDate ? (0, moment_1.default)(testDate) : (0, moment_1.default)(), 'date'));
+    // c. Check if current time is after 4PM
     const isAfter4PM = (!!testDate ? (0, moment_1.default)(testDate) : (0, moment_1.default)()).hour() >= 16;
+    // d. Check if date selected is tomorrow
     const dateSelectedForExpeditionIsTomorrowOrToday = (0, moment_1.default)(selectedExpeditionDate).isSameOrBefore((0, moment_1.default)().add(1, 'day'), 'date');
+    // If date selected is before first calculated date for expedition,
+    // or order was created after 4PM/on a holiday and selected date for expedition is the next day,
+    // apply fees
     return (!!dateSelectedIsBeforeFirstCalculatedDay ||
         ((!!isHoliday || !!isAfter4PM) && !!dateSelectedForExpeditionIsTomorrowOrToday));
 };
@@ -683,17 +867,51 @@ const checkForSameGrassDayFee = (isPOS, isPro, totalPallet, grassProduct, select
     return !!selectedExepeditionDate && !!grassProduct && totalPallet >= 4 && (!!isPOS || !!isPro);
 };
 exports.checkForSameGrassDayFee = checkForSameGrassDayFee;
+// Correspond to the qte after which the expedition or installation fee should be reapplied
+// Eg. For each group of 24 pallets of a product, an expedition fee is added to the cart
 exports.expeditionFeePalletTier = 24;
 exports.installationFeePalletTier = 48;
+/**
+ * Calculates fees that should be applied to provided cart, and fetches them from database or fee array if provided.
+ * Returns the items to add, update and delete, as well as other cart info to set after fees.
+ * ** Optimized version possible, where address zones and distance are calculated before and properties are sent directly to function
+ * ** Optimized version reverted, logic found in commit here : [#2087b32]{@link https://github.com/ciaoqc/gng-tb-admin-sdk/commit/2087b3207df9e5916a979b8bb255abc2a4c1dac6}
+ * @async
+ * @param fetchProduct
+ * @param getIfAddressIsInsideZones
+ * @param getDistanceFromAddress
+ * @param cart
+ * @param expeditionMethod
+ * @param grassProduct
+ * @param concreteOrder
+ * @param cartContainsInstallation
+ * @param cartContainsVrac
+ * @param availableVracStoreIDs
+ * @param isPro
+ * @param addOnePalletToPickup
+ * @param cartContainsSample
+ * @param saveToShippingPayload
+ * @param deliveryAddress
+ * @param locale
+ * @param expeditionDate
+ * @param equipmentPickupOnSite
+ * @param cartContainsOnlyAccessories
+ * @param pickupStore
+ * @param allStores
+ * @param customPriceList
+ * @param useFeeArray
+ */
 const applyFeesToCart = async (fetchProduct, getIfAddressIsInsideZones, getDistanceFromAddress, cart, expeditionMethod, grassProduct, concreteOrder, cartContainsInstallation, cartContainsVrac, availableVracStoreIDs, isPro, addOnePalletToPickup, cartContainsSample, saveToShippingPayload, deliveryAddress, locale, expeditionDate, equipmentPickupOnSite, cartContainsOnlyAccessories, pickupStore, allStores, customPriceList, useFeeArray) => {
     let itemsToAdd = [];
     let itemsToDelete = [];
     let itemsToUpdate = [];
     let newShippingPayload = cart.shipping_payload || {};
+    // Pour le minimum facturable de la livraison
     let minQteGrassOrder = 0;
     if (!!grassProduct) {
         minQteGrassOrder = (0, exports.getMinGrassQte)(grassProduct, expeditionMethod, isPro);
     }
+    // Vérification du type du cart
     const isPOS = [Cart_1.CartTypeEnum.POS, Cart_1.CartTypeEnum.POS_TRANSACTIONNAL].includes(cart.cart_type);
     const isMixed = cart.cart_content_type === Cart_1.CartContentTypeEnum.MIXED;
     let totalPalletOther = 0;
@@ -710,9 +928,14 @@ const applyFeesToCart = async (fetchProduct, getIfAddressIsInsideZones, getDista
     }
     const totalPallet = totalPalletGrass + totalPalletOther;
     const totalPalletMinQte = (0, exports.getPalletQty)(cart.items, !!concreteOrder ? 'concrete' : !!grassProduct ? 'grass' : undefined, minQteGrassOrder);
+    // Pour le minimum facturable de l'installation
     const minQteInstall = (0, exports.getMinQteInstall)(!!isPro);
+    // Type de cart (en ligne, en magasin, avec un commis, etc...)
     const cartType = !!isPOS ? 'in_store' : !!cart.clerk_id ? 'with_clerk' : 'online';
     const installAllInclusiveActive = (0, products_2.isInstallAllInclusiveActive)(cartContainsInstallation, isPro, customPriceList);
+    // --------------------------------------------------------------------------------------------------
+    // #region FRAIS PALETTE
+    // --------------------------------------------------------------------------------------------------
     const shouldAddPaletFees = !!!cartContainsInstallation && !!!cartContainsSample && !!!cartContainsVrac;
     if ((!!isMixed || !!shouldAddPaletFees) && (!!isPro || !!!grassProduct) && !!!cartContainsOnlyAccessories) {
         let qtyOfSkuNeeded = (0, exports.getPalletQtyPalletFee)(cart.items, expeditionMethod, !!(0, cart_1.checkIfCartContainsType)(cart_2.CartGeneralTypeEnum.GRASS, cart), isMixed);
@@ -733,6 +956,10 @@ const applyFeesToCart = async (fetchProduct, getIfAddressIsInsideZones, getDista
             }
         }
     }
+    // #endregion FRAIS PALETTE
+    // --------------------------------------------------------------------------------------------------
+    // #region COMMANDE GAZON - FRAIS DE LIVRAISON
+    // --------------------------------------------------------------------------------------------------
     if (!!grassProduct) {
         if (expeditionMethod === 'delivery') {
             const parentProduct = await fetchProduct('livraison-gazon', locale, !!useFeeArray, true);
@@ -786,6 +1013,10 @@ const applyFeesToCart = async (fetchProduct, getIfAddressIsInsideZones, getDista
             return;
         });
     }
+    // #endregion COMMANDE GAZON - FRAIS DE LIVRAISON
+    // --------------------------------------------------------------------------------------------------
+    // #region COMMANDE BETON - FRAIS DE LIVRAISON
+    // --------------------------------------------------------------------------------------------------
     if (!!!cartContainsVrac && !!!cartContainsSample && !!!grassProduct && !!!cartContainsOnlyAccessories) {
         if (expeditionMethod === 'delivery') {
             const parentProduct = await fetchProduct('livraison-beton-accessoires', locale, !!useFeeArray, true);
@@ -841,7 +1072,12 @@ const applyFeesToCart = async (fetchProduct, getIfAddressIsInsideZones, getDista
             return;
         });
     }
+    // #endregion COMMANDE BETON - FRAIS DE LIVRAISON
+    // --------------------------------------------------------------------------------------------------
+    // #region COMMANDE GAZON - MINIMUM FACTURABLE
+    // --------------------------------------------------------------------------------------------------
     if (!!grassProduct) {
+        // In this case, prestige is included in speciality grasses, since the fee must include kentucky price too
         const isSpecialityGrass = !!grassProduct && !!![products_4.kentucky].includes(grassProduct.sku);
         const qtyToAdd = minQteGrassOrder - grassProduct.qte;
         if (qtyToAdd > 0) {
@@ -867,13 +1103,19 @@ const applyFeesToCart = async (fetchProduct, getIfAddressIsInsideZones, getDista
             itemsToDelete.push(minimumBillable.sku);
         }
     }
+    // #endregion COMMANDE GAZON - MINIMUM FACTURABLE
+    // --------------------------------------------------------------------------------------------------
+    // #region COMMANDE GAZON - SURCHARGE JOUR MÊME
+    // --------------------------------------------------------------------------------------------------
     const sameDayGrassFee = await fetchProduct('surcharge-jour-meme-gazon', locale, !!useFeeArray, true);
     let decli;
     if (!!sameDayGrassFee) {
         decli = sameDayGrassFee.declinations.find((d) => d.sku === '000010990');
     }
     if (!!(0, exports.checkForSameGrassDayFee)(isPOS, isPro, totalPalletGrass, grassProduct, expeditionDate, (0, object_1.recursiveCheckObject)(cart.shipping_payload, 'is_reserved'))) {
+        // a. Fetch min date for expedition type (for POS carts)
         const firstDayForExpedition = (0, exports.getMinDatePicker)(cart, grassProduct, undefined, expeditionMethod || 'delivery', !!isPro, !!cart.created_by ? (0, data_3.formatDate)(cart.created_by.date) : undefined, undefined, undefined, isPOS);
+        // b. Call function to get if fee should be applied
         const shouldApplySameDayFee = (0, exports.checkIfShouldApplySameDayGrassFee)(firstDayForExpedition, expeditionMethod, expeditionDate);
         if (!!sameDayGrassFee && !!decli) {
             if (!!shouldApplySameDayFee) {
@@ -886,6 +1128,10 @@ const applyFeesToCart = async (fetchProduct, getIfAddressIsInsideZones, getDista
             itemsToDelete.push(decli.sku);
         }
     }
+    // #endregion COMMANDE GAZON - SURCHARGE JOUR MÊME
+    // --------------------------------------------------------------------------------------------------
+    // #region LIVRAISON ÉCHANTILLONS
+    // --------------------------------------------------------------------------------------------------
     if (!!cartContainsSample) {
         let removeShippingFee = false;
         if (expeditionMethod === 'delivery') {
@@ -908,9 +1154,15 @@ const applyFeesToCart = async (fetchProduct, getIfAddressIsInsideZones, getDista
             itemsToDelete.push(sampleDeliveryFee.sku);
         }
     }
+    // #endregion LIVRAISON ÉCHANTILLONS
+    // --------------------------------------------------------------------------------------------------
+    // #region LIVRAISON ACCESSOIRES
+    // --------------------------------------------------------------------------------------------------
     const cartAccessoriesDeliveryFee = cart.items.find((i) => i.parent_slug === 'livraison-accessoires');
     if (!!cartContainsOnlyAccessories) {
+        // reset all service fees associated to grass or beton carts, if found
         itemsToDelete = resetAllFeesIfAccessoriesOnly(cart.items);
+        // check to add delivery fee
         if (expeditionMethod === 'delivery') {
             const productToAdd = await fetchProduct('livraison-accessoires', locale, !!useFeeArray, true);
             if (!!productToAdd && !!productToAdd.declinations) {
@@ -926,6 +1178,11 @@ const applyFeesToCart = async (fetchProduct, getIfAddressIsInsideZones, getDista
             itemsToDelete.push(cartAccessoriesDeliveryFee.sku);
         }
     }
+    // #endregion LIVRAISON ACCESSOIRES
+    // --------------------------------------------------------------------------------------------------
+    // #region COMMANDE GAZON - SURCHARGE DE PRIX DE GAZON
+    // --------------------------------------------------------------------------------------------------
+    // Les surcharges sur le gazon s'appliquent toujours pour les pros, ou juste dans le cas de commandes d'une palette ou plus pour les clients au détail
     const shouldApplyFees = !!isPro || totalPalletGrass >= 1;
     if (!!grassProduct) {
         const feesToAdd = [];
@@ -1004,7 +1261,10 @@ const applyFeesToCart = async (fetchProduct, getIfAddressIsInsideZones, getDista
             let allOrderFees = [];
             let allInstallationFees = [];
             if (!!shouldApplyFees) {
+                // ---------------------------------------------------
+                // #region Si la date de la commande est ...
                 if (!!surchargesCommandesGazon) {
+                    // ... un samedi et que la commande est en livraison OU en pickup dans un magasin qui n'est pas rattaché à uen gazonnière
                     if (orderDate.getDay() === 6) {
                         if (expeditionMethod === 'delivery') {
                             allOrderFees.push(['000010400', surchargesCommandesGazon]);
@@ -1015,57 +1275,75 @@ const applyFeesToCart = async (fetchProduct, getIfAddressIsInsideZones, getDista
                             }
                         }
                     }
+                    // ... un dimanche ou jours fériés officiels
+                    // NOTE: seulement pour le frais gazon, celui d'installation s'applique indépendemment plus bas dans la logique
                     if ((0, moment_1.default)(orderDate).day() === 0 ||
                         (0, data_1.getHolidays)().some((date) => (0, moment_1.default)(date).isSame((0, moment_1.default)(orderDate), 'day'))) {
                         allOrderFees = [...allOrderFees, ['000010850', surchargesCommandesGazon]];
                     }
+                    // ... dans les vacances de construction
                     const cd = (0, data_1.getContructionHolidays)();
                     if ((0, moment_1.default)(orderDate).isBetween((0, moment_1.default)(cd[0]), (0, moment_1.default)(cd[1]), 'day', '[]')) {
                         allOrderFees = [...allOrderFees, ['000010860', surchargesCommandesGazon]];
                     }
+                    // ... en été
                     const summer = (0, data_1.getSummerDate)();
                     if ((0, moment_1.default)(orderDate).isBetween((0, moment_1.default)(summer[0]), (0, moment_1.default)(summer[1]), 'day', '[]')) {
                         allOrderFees = [...allOrderFees, ['000010300', surchargesCommandesGazon]];
                     }
                 }
+                // #endregion
+                // ---------------------------------------------------
+                // ---------------------------------------------------
+                // #region Si la date de commande se trouve entre (inclusif)...
+                // NOTE : les frais d'installation ne doivent seulement s'appliquer pour les clients pros (POS et WEB)
                 const shouldAddGrassSeasonFee = !!surchargesCommandesGazonDebutFinSaison;
                 const shouldAddInstallSeasonFee = !!cartContainsInstallation && !!isPro && !!surchargesInstallationGazonDebutFinSaison;
+                // ...début de la saison au 30 avril
                 if ((0, moment_1.default)(orderDate).isBetween(`${(0, moment_1.default)().format('YYYY')}-03-01`, `${(0, moment_1.default)().format('YYYY')}-04-30`, 'day', '[]')) {
                     if (shouldAddGrassSeasonFee)
                         allOrderFees = [...allOrderFees, ['000010100', surchargesCommandesGazonDebutFinSaison]];
                     if (shouldAddInstallSeasonFee)
                         allInstallationFees.push(['000010600', surchargesInstallationGazonDebutFinSaison]);
                 }
+                // ...15 oct. au 31 oct.
                 if ((0, moment_1.default)(orderDate).isBetween(`${(0, moment_1.default)().format('YYYY')}-10-15`, `${(0, moment_1.default)().format('YYYY')}-10-31`, 'day', '[]')) {
                     if (shouldAddGrassSeasonFee)
                         allOrderFees = [...allOrderFees, ['000010840', surchargesCommandesGazonDebutFinSaison]];
                     if (shouldAddInstallSeasonFee)
                         allInstallationFees.push(['000010940', surchargesInstallationGazonDebutFinSaison]);
                 }
+                //...1er nov. au 14 nov.
                 if ((0, moment_1.default)(orderDate).isBetween(`${(0, moment_1.default)().format('YYYY')}-11-01`, `${(0, moment_1.default)().format('YYYY')}-11-14`, 'day', '[]')) {
                     if (shouldAddGrassSeasonFee)
                         allOrderFees = [...allOrderFees, ['000010700', surchargesCommandesGazonDebutFinSaison]];
                     if (shouldAddInstallSeasonFee)
                         allInstallationFees.push(['000010800', surchargesInstallationGazonDebutFinSaison]);
                 }
+                // ...15 nov. à la fin de la saison
                 if ((0, moment_1.default)(orderDate).isBetween(`${(0, moment_1.default)().format('YYYY')}-11-15`, `${(0, moment_1.default)().format('YYYY')}-12-31`, 'day', '[]')) {
                     if (shouldAddGrassSeasonFee)
                         allOrderFees = [...allOrderFees, ['000010900', surchargesCommandesGazonDebutFinSaison]];
                     if (shouldAddInstallSeasonFee)
                         allInstallationFees.push(['000010950', surchargesInstallationGazonDebutFinSaison]);
                 }
+                // #endregion
+                // ---------------------------------------------------
+                // Si la commande est en pick-up et le magazin n'est pas une gazonnière
                 if (expeditionMethod === 'pickup' && !!surchargesGazonPickupHorsFerme) {
                     if (!!!data_2.grassFarmStores.includes(pickupStoreId)) {
                         allOrderFees = [...allOrderFees, ['000012500', surchargesGazonPickupHorsFerme]];
                     }
                 }
             }
+            // Si la commande a de l'installation et la date de la commande est un dimanche ou un jour férié
             if (!!surchargesInstallationGazon &&
                 !!cartContainsInstallation &&
                 ((0, moment_1.default)(orderDate).day() === 0 ||
                     (0, data_1.getHolidays)().some((date) => (0, moment_1.default)(date).isSame((0, moment_1.default)(orderDate), 'day')))) {
                 allInstallationFees.push(['000010750', surchargesInstallationGazon]);
             }
+            // Si la commande a été faite autrement qu'en ligne ET ne contient pas d'installation (PROS ONLY)
             if (!!fraisSiCommandePasEnLigne && !!!cartContainsInstallation && !!isPro) {
                 allOrderFees = [...allOrderFees, ['FRSGAZON', fraisSiCommandePasEnLigne]];
             }
@@ -1093,7 +1371,15 @@ const applyFeesToCart = async (fetchProduct, getIfAddressIsInsideZones, getDista
             }
         });
     }
+    // #endregion SURCHARGE DE PRIX DE GAZON
+    // --------------------------------------------------------------------------------------------------
+    // #region COMMANDE BÉTON - FRAIS DE PRÉPARATION
+    // --------------------------------------------------------------------------------------------------
     if (!!concreteOrder && !!!cartContainsSample && !!!cartContainsOnlyAccessories) {
+        // ----------------------------------------------------------------------------------------------
+        // Frais de préparation général
+        // MODIF FRAIS 2024 - Ajout du frais FP-1 seulement si le panier contient un minimum de 1 palette de produits de béton
+        // Vérifie vraiment que les produits de béton pour la quantité
         const fraisPreparationGeneralBeton = await fetchProduct('frais-preparation-general-beton', locale, !!useFeeArray, true);
         const onlyConcretePalQty = (0, exports.getPalletQty)(cart.items.filter((i) => (0, products_2.checkIfProductIsOfType)(i, 'beton', true)));
         if (!!fraisPreparationGeneralBeton && onlyConcretePalQty >= 1) {
@@ -1102,8 +1388,12 @@ const applyFeesToCart = async (fetchProduct, getIfAddressIsInsideZones, getDista
                 itemsToAdd.push(Object.assign(Object.assign({}, decli), { qte: 1, is_upsell_of_sku: 'summary', parent_slug: fraisPreparationGeneralBeton.slug, categories: fraisPreparationGeneralBeton.categories }));
             }
         }
+        // ----------------------------------------------------------------------------------------------
+        // Frais si commande pas en ligne/par un commis
         if (expeditionMethod !== 'pickup' && cartType !== 'online' && !!isPro) {
             const getFeeAmount = (decli) => {
+                // fee is a percentage of price for each item that isn't a service or fee
+                // percentage is determined by FRSBETON regular_price.value
                 const percent = (0, toNumber_1.default)(decli.regular_price.amount);
                 let amount = 0;
                 for (let item of cart.items) {
@@ -1130,6 +1420,8 @@ const applyFeesToCart = async (fetchProduct, getIfAddressIsInsideZones, getDista
                 itemsToDelete.push('FRSBETON');
             }
         }
+        // ----------------------------------------------------------------------------------------------
+        // Frais de préparation si commande contient 4 palettes incomplètes
         const concreteItems = cart.items.filter((i) => i.attributes[data_4.AttributesIdEnumGR.TYPE] && i.attributes[data_4.AttributesIdEnumGR.TYPE].includes('beton'));
         let numberOfIncompletePallets = 0;
         for (const item of concreteItems) {
@@ -1169,6 +1461,10 @@ const applyFeesToCart = async (fetchProduct, getIfAddressIsInsideZones, getDista
             itemsToDelete.push('FRSBETON');
         }
     }
+    // #endregion COMMANDE BÉTON - FRAIS DE PRÉPARATION
+    // --------------------------------------------------------------------------------------------------
+    // #region FRAIS LIVRAISON SELON L'EMPLACEMENT
+    // --------------------------------------------------------------------------------------------------
     let isOutOfArea = false;
     if (expeditionMethod === 'delivery' && !!deliveryAddress) {
         let insideZones = undefined;
@@ -1180,6 +1476,9 @@ const applyFeesToCart = async (fetchProduct, getIfAddressIsInsideZones, getDista
         }
         if (!!insideZones && !!Array.isArray(insideZones)) {
             if (!!insideZones.length && insideZones.includes('zone-gr')) {
+                // =============================================================================================
+                // TOUS TYPES DE COMMANDE
+                // Si une ou plusieurs zones correspondent
                 let productInstallToAdd;
                 if (!!grassProduct) {
                     productInstallToAdd = !!cartContainsInstallation
@@ -1194,6 +1493,7 @@ const applyFeesToCart = async (fetchProduct, getIfAddressIsInsideZones, getDista
                             itemsToAdd.push(Object.assign(Object.assign({}, mtl), { qte: (0, ceil_1.default)((0, ceil_1.default)(totalPallet) / exports.expeditionFeePalletTier), is_upsell_of_sku: 'summary', parent_slug: 'surcharges-commandes-gazon', categories: productToAdd.categories }));
                         }
                     }
+                    // If Installation ...
                     if (!!grassProduct && !!productInstallToAdd) {
                         const mtlInstall = productInstallToAdd.declinations.find((i) => i.sku === '170055500');
                         if (!!mtlInstall) {
@@ -1208,6 +1508,7 @@ const applyFeesToCart = async (fetchProduct, getIfAddressIsInsideZones, getDista
                             itemsToAdd.push(Object.assign(Object.assign({}, ontario), { qte: (0, ceil_1.default)((0, ceil_1.default)(totalPallet) / exports.expeditionFeePalletTier), is_upsell_of_sku: 'summary', parent_slug: 'surcharges-commandes-gazon', categories: productToAdd.categories }));
                         }
                     }
+                    // If Installation ...
                     if (!!grassProduct && !!productInstallToAdd) {
                         const ontarioInstall = productInstallToAdd.declinations.find((i) => i.sku === '170033ONT');
                         if (!!ontarioInstall) {
@@ -1223,11 +1524,18 @@ const applyFeesToCart = async (fetchProduct, getIfAddressIsInsideZones, getDista
                         }
                     }
                 }
+                // }
+                // =============================================================================================
+                // COMMANDES VRAC
+                // Infos pour la livraison du vrac, vérification faite maintenant dans deux zones
                 if (!!cartContainsVrac) {
                     if (insideZones.includes('zone-vrac') || insideZones.includes('zone-vrac-les-coteaux')) {
                         const deliveryTruckProduct = await fetchProduct('frais-de-livraison-vrac', locale, !!useFeeArray, true);
+                        // Fetch de l'adresse du magasin de la zone concernée, pour calculer le prix du frais de livraison
                         const storeIDToCheck = insideZones.includes('zone-vrac') ? 'sainte-julie-nobel' : 'default';
                         const storeAddress = getStoreAddressByID(allStores, storeIDToCheck);
+                        // Si le magasin de la zone ne se trouve pas dans le array de magasins disponibles pour les produits de vrac de la commande,
+                        // mettre la commande comme hors-zone automatiquement
                         if (!!availableVracStoreIDs && !availableVracStoreIDs.includes(storeIDToCheck)) {
                             isOutOfArea = true;
                         }
@@ -1265,8 +1573,16 @@ const applyFeesToCart = async (fetchProduct, getIfAddressIsInsideZones, getDista
             itemsToDelete.push(i.sku);
         }
     });
+    // #endregion FRAIS LIVRAISON SELON L'EMPLACEMENT
+    // --------------------------------------------------------------------------------------------------
+    // #region RAMASSAGE D'ÉQUIPEMENT SUR LE CHANTIER
+    // --------------------------------------------------------------------------------------------------
     if (!!equipmentPickupOnSite) {
+        // 	consoleLog({ equipmentPickupOnSite: 'true' })
     }
+    // #endregion RAMASSAGE D'ÉQUIPEMENT SUR LE CHANTIER
+    // --------------------------------------------------------------------------------------------------
+    // #region FRAIS EXTRA LIVRAISON EN PÉRIODE DE DÉGEL
     const degelFeeSku = '170000018';
     if (!!isPro &&
         expeditionMethod === 'delivery' &&
@@ -1287,6 +1603,9 @@ const applyFeesToCart = async (fetchProduct, getIfAddressIsInsideZones, getDista
             itemsToDelete.push(degelFeeSku);
         }
     }
+    // #endregion
+    // --------------------------------------------------------------------------------------------------
+    // #region Gestion d'ajout / delete des frais
     itemsToDelete = itemsToDelete.filter((i) => !itemsToAdd.map((add) => add.sku).includes(i));
     itemsToAdd = itemsToAdd
         .map((item) => {
@@ -1301,14 +1620,17 @@ const applyFeesToCart = async (fetchProduct, getIfAddressIsInsideZones, getDista
             }
         }
         else {
+            // If fee regular price is 0.00$ and item fits criteria, do not add to cart
             if (!!item.parent_slug &&
                 (0, products_2.shouldHideItemIfRegPriceIs0)(item, item.parent_slug, !!item.is_upsell_of_sku && item.parent_slug.includes('installation'))) {
                 return;
             }
         }
+        // When installation all-inclusive, force frais de livraison to 0$
         return installAllInclusiveActive ? (0, products_2.applyAllInclusiveOverrides)(item) : item;
     })
         .filter((i) => !!i);
+    // #endregion Gestion d'ajout / delete des frais
     return {
         newCart: Object.assign(Object.assign({}, cart), { shipping_payload: newShippingPayload }),
         itemsToDelete,
@@ -1319,6 +1641,19 @@ const applyFeesToCart = async (fetchProduct, getIfAddressIsInsideZones, getDista
     };
 };
 exports.applyFeesToCart = applyFeesToCart;
+// #endregion
+// ------------------------------------------------------------------------------------------
+// ------------------------------------------------------------------------------------------
+// #region SHIPPING
+/**
+ * Checks if sample shipping fee should be removed from cart depending on cart items found in cart.
+ * ** Optimized version possible using brand name instead of brand id, removing async check.
+ * ** Optimized version reverted, logic found in commit here : [#2087b32]{@link https://github.com/ciaoqc/gng-tb-admin-sdk/commit/2087b3207df9e5916a979b8bb255abc2a4c1dac6}
+ * @param fetchProduct
+ * @param cart
+ * @param locale
+ * @param useFeeArray
+ */
 const checkIfShouldRemoveSampleShippingFee = async (fetchProduct, cart, locale, useFeeArray) => {
     if (!!!cart.items)
         return false;
@@ -1327,13 +1662,16 @@ const checkIfShouldRemoveSampleShippingFee = async (fetchProduct, cart, locale,
     for (let item of currentItems) {
         if (!!!item.parent_slug)
             continue;
+        // 1. Get parent product for brand ID
         const parentProd = await fetchProduct(item.parent_slug, locale, !!useFeeArray, true);
         if (!!!parentProd)
             continue;
         const brand = parentProd.brand;
+        // 2. Check if item.attributes contains FAMILY attribute with value Tena
         const isTena = !!item.attributes &&
             !!item.attributes[data_4.AttributesIdEnumGR.FAMILY] &&
             !!item.attributes[data_4.AttributesIdEnumGR.FAMILY].includes('tena');
+        // 3. Check if item.attributes.TYPE is grass and is not Kentucky or Prestige
         const excludedGrass = [`${products_4.kentucky}-e`, `${products_4.prestige}-e`];
         const hasGrassType = (0, products_2.checkIfProductIsOfType)(item, 'gazon');
         const isExcludedGrass = excludedGrass.includes(item.sku);
@@ -1348,10 +1686,14 @@ const checkIfShouldRemoveSampleShippingFee = async (fetchProduct, cart, locale,
     if (!!currentItemsChecked.length) {
         const allIncludedBrandsNoTena = currentItemsChecked.filter((item) => !!item.brand && !!data_2.includedFreeShippingBrands.includes(item.brand) && !!!item.isTena);
         const allGrass = currentItemsChecked.filter((item) => !!item.isGrass);
+        // 3. count all items with included brands and check if length === currentItems.length
+        //    if true, remove shipping cost (set productToAdd undefined)
         if (currentItems.length === allIncludedBrandsNoTena.length || currentItems.length === allGrass.length) {
             return true;
         }
         else {
+            // 4. add IncludedBrandsNoTena + isGrass lengths and check if equals currentItems.length
+            //    if true, remove shipping cost (set productToAdd undefined)
             const added = allIncludedBrandsNoTena.length + allGrass.length;
             if (added === currentItems.length) {
                 return true;
@@ -1497,22 +1839,66 @@ const getStoreAddressByID = (allStores, storeID) => {
     const sameStore = allStores.find((s) => s.id == storeID);
     return !!sameStore ? sameStore.address : undefined;
 };
+// #endregion
+// ------------------------------------------------------------------------------------------
+// ------------------------------------------------------------------------------------------
+// #region VALIDATION
+/**
+ * Function checkIfCartExpired
+ * @description checks if cart expired using the updated_at date stored in the shipping_payload
+ * @param cartData
+ * @param grassProduct
+ * @param concreteOrder
+ * @param isPro
+ * @param options.blocked_shipping_dates
+ * @param options.vracType
+ * @param options.chosenPaymentType
+ * @param options.forceCheckForCartTypes
+ */
 const checkIfCartExpired = (cartData, grassProduct, concreteOrder, isPro, options = {}) => {
+    // ######################################################################################
+    // #region TESTS
+    // ----------------------------------------------------------
+    // 1) Is same day after 10
+    // const test1 = {
+    // 	now: moment().set('hours', 11).toDate(),
+    // 	updated_last: moment().set('hours', 9).toDate(),
+    // 	time: 'AM',
+    // 	selected_date: moment().add(4, 'day').toDate()
+    // }
+    // 2) Is same day after 10 but with AM still possible
+    // const test2 = {
+    // 	now: moment().set({ day: 6, hours: 11 }).toDate(),
+    // 	updated_last: moment().set({ day: 6, hours: 9 }).toDate(),
+    // 	time: 'AM',
+    // 	selected_date: moment().set('day', 9).toDate()
+    // }
+    // const now = test2.now
+    // const updated_last = test2.updated_last
+    // const time = test2.time
+    // const selected_date = test2.selected_date
+    //
+    // #endregion
+    // ######################################################################################
     const isPOS = Cart_1.CartTypeEnum.WEB != cartData.cart_type;
     const isSample = (0, cart_1.checkIfCartContainsType)(cart_2.CartGeneralTypeEnum.SAMPLE, cartData);
     const isAccessoriesOnly = (0, cart_1.checkIfCartContainsType)(cart_2.CartGeneralTypeEnum.ONLY_ACCESSORIES, cartData);
+    // const cartContainsInstallation = checkIfCartContainsType(CartGeneralTypeEnum.INSTALLATION, cartData)
+    // 1. Check if it is normal for selected date to be undefined / expired
     const selectedDate = !!cartData.shipping_payload && !!cartData.shipping_payload.delivery_or_pickup_date
         ? (0, data_3.formatDate)(cartData.shipping_payload.delivery_or_pickup_date)
         : undefined;
     const noDeliveryDateIsNormal = (0, exports.checkIfNoDeliveryDateIsNormal)(cartData, concreteOrder) ||
         (!!options.chosenPaymentType && ['depot'].includes(options.chosenPaymentType));
     const shouldForceCheck = (options.forceCheckForCartTypes || []).some((t) => (0, cart_1.checkIfCartContainsType)(t, cartData));
+    // If force check property sent, check event if !!noDeliveryDateIsNormal
     if (!!noDeliveryDateIsNormal && !shouldForceCheck) {
         return false;
     }
     else if (!!!selectedDate) {
         return true;
     }
+    // 2. Check date depending on when cart was last updated
     const now = (0, moment_1.default)().toDate();
     const updated_last = !!cartData.shipping_payload && !!cartData.shipping_payload.updated_at
         ? (0, data_3.formatDate)(cartData.shipping_payload.updated_at)
@@ -1541,4 +1927,6 @@ const checkIfNoDeliveryDateIsNormal = (cartData, concreteOrder, checkForInputSho
         ((!!isAccessoriesOnly || !!isSample) && !!!cartData.is_pickup));
 };
 exports.checkIfNoDeliveryDateIsNormal = checkIfNoDeliveryDateIsNormal;
+// #endregion
+// ------------------------------------------------------------------------------------------
 //# sourceMappingURL=expedition.js.map