家政上门预约多端兼容:表单校验、价格计算双端统一逻辑
在家政预约下单流程中,表单校验、价格计算是核心环节。小程序、H5如果各自实现一套校验和计价逻辑,很容易出现两端判定结果不一致:H5允许提交的表单,小程序拦截报错;或者两端算出的服务总价不一样,引发用户投诉。本文基于UniApp前端+SpringBoot后端,采用后端作为唯一可信源、前端同步规则做体验层校验的方案,实现表单校验、价格计算逻辑在小程序和H5上统一,规避多端业务规则差异问题。
一、双端独立实现的业务痛点
家政预约表单字段动态性强,包含上门地址、预约时段、服务面积、附加项目、加急选项等,不同服务类型的必填项、取值范围不一样。
如果前端单独写校验逻辑,小程序和H5分开维护,正则、字段范围、时段限制容易出现版本差异;价格计算逻辑分散在前端,小数精度、加价规则、优惠叠加顺序一旦两端代码不一致,价格就会出现偏差。
前端校验只能提升交互体验,不能作为安全防线,直接放开前端提交会存在参数篡改风险。同时家政计价规则经常调整(夜间加价、节假日溢价、起步价修改),每次改规则都需要同时发布小程序版本和H5资源,迭代成本高、版本对齐难度大。
二、整体方案架构设计
整套方案分为两层:前端轻量化展示层、后端权威计算层。
后端维护一套完整的校验规则引擎和计价引擎,对外提供统一的核价校验接口,小程序、H5复用同一个接口。前端从后端拉取当前服务对应的校验规则(必填、最大最小值、正则、时段限制),渲染表单和实时校验提示,只做体验层面的预校验;最终提交订单时,以后端的校验和计价结果为准。
计价引擎采用策略模式,区分按小时、按面积、固定套餐等多种计费类型,支持叠加附加费、时段溢价、优惠券减免,统一处理BigDecimal小数运算,避免浮点精度丢失。Redis缓存服务规则和计价模板,减少重复查库。
三、后端计价引擎与表单校验核心实现
后端定义统一的入参DTO,接收表单全部字段:服务ID、预约时间、面积、附加项目、用户地址、优惠券编号等。校验模块先对字段合法性、服务范围、时段占用状态做校验,校验通过后进入计价策略,返回明细(基础价、附加费、溢价、优惠、实付金额)。
Java核心代码示例:
public interface PricingStrategy {
BigDecimal calculate(OrderPriceContext context);
}
@Service("areaPricing")
public class AreaPricingStrategy implements PricingStrategy {
@Override
public BigDecimal calculate(OrderPriceContext context) {
BigDecimal basePrice = context.getUnitPrice().multiply(context.getArea());
// 起步价兜底
if(basePrice.compareTo(context.getMinPrice()) < 0){
basePrice = context.getMinPrice();
}
// 夜间溢价计算
if(context.isNightTime()){
basePrice = basePrice.add(context.getNightAddFee());
}
return basePrice;
}
}
@Service
public class OrderCheckPriceService {
@Autowired
private Map<String, PricingStrategy> strategyMap;
@Autowired
private OrderValidator orderValidator;
public ResultDTO<PriceResultDTO> checkAndCalculate(OrderFormDTO formDTO) {
// 后端完整表单校验
ValidateResult validateResult = orderValidator.validate(formDTO);
if(!validateResult.isPass()){
return ResultDTO.fail(validateResult.getMsg());
}
// 根据服务类型匹配计价策略
PricingStrategy strategy = strategyMap.get(formDTO.getPricingType());
BigDecimal amount = strategy.calculate(OrderPriceContext.build(formDTO));
PriceResultDTO result = new PriceResultDTO();
result.setBaseAmount(amount);
result.setRealAmount(amount.subtract(formDTO.getCouponDiscount()));
return ResultDTO.success(result);
}
}
校验逻辑包含:地址是否在服务半径内、预约时间是否小于当前时间、面积数值是否在上下限、附加项目是否允许搭配,所有规则统一在后端维护。
四、前端规则同步与预校验实现
前端不再硬编码校验规则,进入预约页面时,先调用接口获取该服务对应的rule配置,包含字段名、是否必填、正则、最大值最小值、错误提示文案。
基于UniApp的通用表单组件,绑定动态rules,小程序和H5使用同一套校验配置。用户修改表单(填写面积、切换预约时间、勾选附加项)时,实时调用后端核价接口,刷新价格明细,页面展示和后端计算结果保持同步。
前端校验只用来实时提示,点击提交下单,依然走后端完整校验流程,防止绕过前端校验直接提交非法参数。
五、价格计算的精度与明细规范
价格统一使用BigDecimal运算,禁止前端JS浮点直接计算,规避0.1+0.2类精度问题。
后端返回结构化价格明细,前端只负责渲染展示,不参与计算逻辑。明细包含:基础服务费、附加项目费、时段溢价、优惠券减免,用户在小程序、H5看到的明细条目完全一致。
规则变更只需要在后台配置修改,缓存刷新后,小程序和H5无需发版,立刻生效,解决多端版本不同步问题。
六、边界场景与兼容处理
重点覆盖几类容易不一致的场景:预约跨零点、节假日加价、面积阶梯计价、优惠券叠加上限。
增加校验日志,每次核价和校验都记录表单参数、校验结果、价格明细,出现两端展示差异时,直接对比后端日志定位问题。
前端兼容H5浏览器输入框自动填充、数字输入小数点限制,小程序兼容原生picker时间选择,但是时间解析、时段判定逻辑全部交给后端,前端只做格式转换。
七、测试验证要点
测试场景:同一套表单数据,分别在小程序、H5提交,校验结果、最终价格完全一致;修改后台计价规则,两端页面刷新后价格同步更新;传入非法参数(超出服务范围、负数面积、过期预约时间),两端报错提示一致;小数、优惠叠加场景核对金额明细。同时验证离线缓存规则失效、前端篡改表单参数提交,后端可以拦截。
总结
这套方案的核心思路是后端作为校验和计价的唯一可信源,前端拉取规则做体验预校验,小程序和H5共用同一套接口、同一套业务规则,从根源消除双端表单校验、价格计算逻辑不一致的问题。计价引擎使用策略模式,方便后续新增保洁、家电清洗、保姆等不同家政品类的计费方式,规则配置化之后,迭代时不需要前端发版。落地时需要严格区分前端预校验和后端强校验,重点做好金额BigDecimal运算、规则缓存、日志埋点,保障下单链路稳定,减少用户对价格、表单规则的争议。