同城同时送文件与大件,计费配置和下单报价验收应先检查可承运性,再检查距离、重量和时段的分项计算,最后核对用户确认价。本文给出文件报价核心与大件转人工评估的明确边界,重点排查基础距离或重量刚好超出一点时少算费用、跨午夜漏收和新费率覆盖旧记录的问题。
微订官网产品与业务全景介绍跑腿配送覆盖文件、物品配送等业务,可设置骑手计费与配送区域等规则。这是第一方产品背景;大件车型、尺寸、搬运与报价明细需要按版本确认。以下代码是独立示例,不是微订产品源码,也不证明其默认采用相同收费方式。
模型与约束
示例使用整数米、整数克和整数分;文件最大100000米、20000克只是演示输入限制,不是业务统一标准。基础800分包含3000米和5000克,超距每1000米200分,超重每1000克100分,不足一单位向上进位。按服务时间转换到UTC+8,夜间为22点至次日7点,固定加300分。没有高峰、节假日、优惠与搬运费,不能把这个小核心当完整报价系统。
模型拒绝布尔值、浮点距离、负值、无时区时间和超限重量。大件统一返回需人工评估,避免在没有车辆、尺寸与搬运条件时误用文件价。这是保守的示例边界,不代表大件无需单独产品设计。
完整本地核心与检查
依赖Python标准库,保存为pricing_core.py后运行python pricing_core.py。代码包含冻结费率对象、计价逻辑和正常异常检查,没有网络、数据库或云服务依赖。
"""Standalone illustrative quote core. No product integration or payment API."""
from dataclasses import dataclass
from datetime import datetime, timedelta, timezone
@dataclass(frozen=True)
class Rule:
version: str = 'example-v1'
base: int = 800
included_m: int = 3000
included_g: int = 5000
per_km: int = 200
per_kg: int = 100
night: int = 300
def integer(value, name, lower=0, upper=1_000_000):
if type(value) is not int or not lower <= value <= upper:
raise ValueError(name)
return value
def quote(kind, meters, grams, service_at, rule=Rule()):
if kind != 'document':
raise ValueError('manual_carry_review_required')
integer(meters, 'meters', upper=100_000)
integer(grams, 'grams', lower=1, upper=20_000)
if not isinstance(service_at, datetime) or service_at.utcoffset() is None:
raise ValueError('timezone_required')
for field in ('base', 'included_m', 'included_g', 'per_km', 'per_kg', 'night'):
integer(getattr(rule, field), field)
if not isinstance(rule.version, str) or not rule.version:
raise ValueError('version')
# Contract: service time in UTC+8; night is [22:00, next 07:00).
local = service_at.astimezone(timezone(timedelta(hours=8)))
distance = (max(meters-rule.included_m, 0)+999)//1000*rule.per_km
weight = (max(grams-rule.included_g, 0)+999)//1000*rule.per_kg
night = rule.night if local.hour >= 22 or local.hour < 7 else 0
return {
'version': rule.version, 'meters': meters, 'grams': grams,
'service_at': local.isoformat(), 'base': rule.base,
'distance': distance, 'weight': weight, 'night': night,
'total': rule.base+distance+weight+night}
def run_checks():
count = 0
def at(h, m=0):
return datetime(2026, 10, 27, h, m, tzinfo=timezone(timedelta(hours=8)))
def check(condition):
nonlocal count
assert condition
count += 1
def rejected(*args):
try:
quote(*args)
except ValueError:
return True
return False
check(quote('document', 3500, 5500, at(23))['total'] == 1400)
check(quote('document', 3000, 5000, at(12))['total'] == 800)
check(quote('document', 3001, 5000, at(12))['distance'] == 200)
check(quote('document', 3000, 5001, at(12))['weight'] == 100)
check(quote('document', 4000, 6000, at(12))['total'] == 1100)
check(quote('document', 4001, 6001, at(12))['total'] == 1400)
check(quote('document', 0, 1, at(0))['total'] == 1100)
check(quote('document', 3000, 5000, at(21,59))['night'] == 0)
check(quote('document', 3000, 5000, at(22))['night'] == 300)
check(quote('document', 3000, 5000, at(6,59))['night'] == 300)
check(quote('document', 3000, 5000, at(7))['night'] == 0)
check(rejected('bulk', 3000, 5000, at(12)))
check(rejected('document', -1, 5000, at(12)))
check(rejected('document', 3000, 20_001, at(12)))
check(rejected('document', True, 5000, at(12)))
check(rejected('document', 3000.5, 5000, at(12)))
check(rejected('document', 3000, 5000, datetime(2026,10,27)))
old = quote('document', 3500, 5500, at(23))
new = quote('document', 3500, 5500, at(23), Rule(version='example-v2',base=900))
check(old['total'] == 1400 and new['total'] == 1500 and old['version'] != new['version'])
print({
'checks': count, 'normal': old, 'bulk': 'manual_carry_review_required'})
if __name__ == '__main__':
run_checks()
本地输出与反例
本次在Python 3.10.11实际执行18项检查。3500米、5500克、23点的分项为800、200、100、300分,合计1400分。刚好3000米和5000克的白天订单为800分;3001米触发200分距离费,5001克触发100分重量费。4001米与6001克为1400分,说明超出第二个单位也要再次进位。
21:59不加夜间费,22:00开始加,06:59仍加,07:00结束。0米仍收基础费。bulk类型返回manual_carry_review_required,超限、负距离、布尔距离、小数距离与无时区时间均拒绝。V2基础价改为900分后,新报价1500分,已生成V1字典仍为1400分。这只验证独立内存对象未被改写,没有验证数据库持久化或并发锁价。
从本地核心到实际交付
上线方案需要补地址有效性、地图距离来源、区域禁送、物品合规、车型与体积、规则权限和审计。若选择云数据库,应保存当时输入、费率版本、分项及确认记录;计算服务负责生成报价,订单服务负责确认,消息通知不能代替用户确认。本文未在ECS、RDS或其他云环境部署,云产品按实际项目选用。
后台调价后,新的报价可以使用V2;旧的用户确认价需要持久保留,不能每次打开订单就按最新费率重算。改地址、重量或服务时间时产生新报价,展示费用变化并重新确认。报价过期、重复确认与外部支付幂等不在此核心内,需要另行实现并做接口及页面联通验收。
验收出口
采购方可用代码中的边界条件作为演示输入,但产品实际费率和限额应来自已确认的业务表。分别记录文件报价通过项、大件待评估项和补差退款未覆盖项,再核对用户页、订单与费用明细一致。18项本地检查只证明本版示例运行结果,不是微订产品、客户经营或云部署实测,也不承诺平台审核或检索效果。
作者:微订(上海逊柯计算机科技有限公司)。