- New models: WarrantyModel, WalletModel, SystemConfigModel - New schemas: WarrantySchema, RefundSchema, SystemConfig, CrmTaskCalendar, NotificationTemplate, NotificationGateway, RepairErp, ReviewModeration, InventoryPos, MultiDashboard, BillingFinance - New services: WarrantyService, RefundService, CrmService, CrmTaskCalendarService, DeliveryService, EmailTemplateService, InventoryPosService, MultiDashboardService, NotificationGatewayService, RepairErpService, ReviewModerationService, SystemConfigService, TemplateService, CreditService - Updated routers: AdminOrder, BillingFinance, Cart, Catalog, Checkout, Crm, InventoryPos, NotificationGateway, RolePermission, ServiceJob, Settings, Storefront, UserCreation - Updated models: Inventory, Notification, Order, Product, Service, Setting, SystemConfig, User - Updated core: database init, invoice generator, main app - Added WarrantyRouter with full CRUD and claim flow
117 lines
4.4 KiB
Python
117 lines
4.4 KiB
Python
"""
|
|
@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"])
|