""" @service DeliveryService (Backend/app/services/DeliveryService.py) @purpose Dynamic delivery & shipping fee management, free delivery thresholds, and order shipping cost calculation. """ from typing import Dict, Any, Optional from sqlalchemy.orm import Session from sqlalchemy import select import ulid from app.models.SettingModel import Setting DEFAULT_DELIVERY_CHARGE = 99.0 DEFAULT_FREE_DELIVERY_ENABLED = False DEFAULT_FREE_DELIVERY_MIN_ORDER_AMOUNT = 999.0 class DeliveryService: @staticmethod def _get_setting_val(db: Session, key: str, default: Any) -> Any: try: setting = db.execute( select(Setting).where(Setting.setting_key == key) ).scalar_one_or_none() if setting and setting.setting_value: if isinstance(setting.setting_value, dict) and "value" in setting.setting_value: return setting.setting_value["value"] return setting.setting_value except Exception: pass return default @staticmethod def _set_setting_val(db: Session, key: str, value: Any, desc: str, group: str = "shipping", is_public: bool = True): setting = db.execute( select(Setting).where(Setting.setting_key == key) ).scalar_one_or_none() if not setting: setting = Setting( setting_id=str(ulid.ULID()), setting_key=key, group=group, type="json", setting_value={"value": value}, description=desc, is_public=is_public, ) db.add(setting) else: setting.setting_value = {"value": value} setting.description = desc setting.is_public = is_public @classmethod def get_delivery_settings(cls, db: Session) -> Dict[str, Any]: """ Retrieves active delivery charge, free delivery enable status, and threshold. """ delivery_charge = float(cls._get_setting_val(db, "shipping_delivery_charge", DEFAULT_DELIVERY_CHARGE)) free_delivery_enabled = bool(cls._get_setting_val(db, "shipping_free_delivery_enabled", DEFAULT_FREE_DELIVERY_ENABLED)) free_delivery_min = float(cls._get_setting_val(db, "shipping_free_delivery_min_order_amount", DEFAULT_FREE_DELIVERY_MIN_ORDER_AMOUNT)) return { "delivery_charge": delivery_charge, "free_delivery_enabled": free_delivery_enabled, "free_delivery_min_order_amount": free_delivery_min, } @classmethod def update_delivery_settings( cls, db: Session, delivery_charge: Optional[float] = None, free_delivery_enabled: Optional[bool] = None, free_delivery_min_order_amount: Optional[float] = None, ) -> Dict[str, Any]: """ Updates shipping and delivery fee settings in the database. """ if delivery_charge is not None: cls._set_setting_val( db, "shipping_delivery_charge", float(delivery_charge), "Standard delivery fee for ecommerce orders" ) if free_delivery_enabled is not None: cls._set_setting_val( db, "shipping_free_delivery_enabled", bool(free_delivery_enabled), "Enable or disable free delivery promotional threshold" ) if free_delivery_min_order_amount is not None: cls._set_setting_val( db, "shipping_free_delivery_min_order_amount", float(free_delivery_min_order_amount), "Minimum order amount required for free delivery when enabled" ) db.commit() return cls.get_delivery_settings(db) @classmethod def calculate_shipping_cost(cls, db: Session, subtotal: float) -> float: """ Calculates shipping fee for a given subtotal. If free_delivery_enabled is False, ALWAYS returns delivery_charge regardless of subtotal. If free_delivery_enabled is True and subtotal >= min_amount, returns 0.0. """ settings = cls.get_delivery_settings(db) if settings["free_delivery_enabled"] and subtotal >= settings["free_delivery_min_order_amount"]: return 0.0 return float(settings["delivery_charge"])