ifixkart-backend/app/services/DeliveryService.py
adithiyan 10bfba7d58 feat: add warranties, refunds, notifications, CRM calendar, system config & delivery modules
- 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
2026-10-13 22:05:16 +05:30

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"])