ifixkart-admin/Backend/app/services/DeliveryService.py
Adithiyan bbd3a3e959 feat: initial commit — full platform snapshot
- Backend: FastAPI app with all models, services, schemas, routes
- Admin Panel: Next.js dashboard with all modules
  (CRM, POS, repairs, warranties, billing, notifications, etc.)
- Ecommerce: storefront (submodule) + product catalog
- AI Agents: .agents/ skill library for Antigravity IDE
- Docs: architecture, billing, notification gateway markdown
- Submodules: Backend/OpenWA, Ecommerce/File 2/storefront
2026-10-13 12:59:47 +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"])