Files
shanxia2.0/backend/app/services/pl_carrier_service.py
T
2026-07-12 17:55:11 +08:00

102 lines
3.4 KiB
Python

"""运输计划 - 承运商资质与运输资格"""
from __future__ import annotations
from datetime import date
from typing import Optional
from fastapi import HTTPException
from app.models.pl_models import PlCarrier
def _urls_nonempty(value: Optional[str]) -> bool:
return bool(value and str(value).strip())
def carrier_qualification_complete(carrier: PlCarrier) -> bool:
return (
_urls_nonempty(carrier.business_license_urls)
and _urls_nonempty(carrier.road_transport_license_urls)
and _urls_nonempty(carrier.transport_agreement_urls)
)
def carrier_agreement_expired(carrier: PlCarrier, today: Optional[date] = None) -> bool:
if not carrier_qualification_complete(carrier):
return False
ref = today or date.today()
expire = carrier.transport_agreement_expire_date
return expire is not None and expire < ref
def carrier_audit_approved(carrier: PlCarrier) -> bool:
return getattr(carrier, "audit_status", None) == "approved"
def carrier_eligible_for_transport(carrier: PlCarrier, today: Optional[date] = None) -> bool:
if carrier.status != "1":
return False
if not carrier_audit_approved(carrier):
return False
if not carrier_qualification_complete(carrier):
return False
if carrier_agreement_expired(carrier, today):
return False
return True
def assert_carrier_eligible_for_transport(
carrier: PlCarrier,
*,
rearrange: bool = False,
) -> None:
if carrier.status != "1":
raise HTTPException(status_code=400, detail="该承运商已终止合作,无法安排运输")
if not carrier_audit_approved(carrier):
raise HTTPException(status_code=400, detail="该承运商尚未审核通过,无法安排运输")
if not carrier_qualification_complete(carrier):
raise HTTPException(status_code=400, detail="该承运商资质附件不完整,无法安排运输")
if carrier_agreement_expired(carrier):
if rearrange:
raise HTTPException(
status_code=400,
detail="该承运商运输协议已过期,请先更新协议后再调整运输",
)
raise HTTPException(status_code=400, detail="该承运商运输协议已过期,无法安排运输")
def normalize_carrier_urls(value: Optional[str]) -> Optional[str]:
if value is None:
return None
trimmed = str(value).strip()
return trimmed or None
def validate_carrier_qualification_fields(
*,
business_license_urls: Optional[str],
road_transport_license_urls: Optional[str],
transport_agreement_urls: Optional[str],
transport_agreement_expire_date: Optional[date],
require_all: bool,
) -> None:
if not require_all:
touched = any(
item is not None
for item in (
business_license_urls,
road_transport_license_urls,
transport_agreement_urls,
transport_agreement_expire_date,
)
)
if not touched:
return
if not _urls_nonempty(business_license_urls):
raise HTTPException(status_code=400, detail="请上传营业执照")
if not _urls_nonempty(road_transport_license_urls):
raise HTTPException(status_code=400, detail="请上传道路经营许可证")
if not _urls_nonempty(transport_agreement_urls):
raise HTTPException(status_code=400, detail="请上传运输协议")