首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >家政预约系统前端架构:一套代码输出小程序与H5预约页面

家政预约系统前端架构:一套代码输出小程序与H5预约页面

原创
作者头像
芮安科技
发布于 2026-11-18 14:08:30
发布于 2026-11-18 14:08:30
390
举报

家政预约系统前端架构:一套代码输出小程序与H5预约页面

家政预约业务流量渠道分散,用户既可以通过微信小程序长期留存下单,也能通过H5分享链接快速访问。如果分开维护两套前端项目,页面迭代、组件修改、bug修复都需要重复开发,版本对齐成本高。本文基于UniApp搭建家政预约前端架构,实现一套业务代码编译输出小程序、H5两套产物,同时结合SpringBoot后端统一接口,解决多端样式兼容、平台能力差异、数据交互一致性等问题。

一、多端独立前端的开发痛点

分开开发小程序和H5前端,会出现页面交互不一致、字段校验规则不一样的问题。小程序拥有微信原生登录、订阅消息、微信支付等能力,H5依赖网页授权、JSAPI支付,两者API调用方式不同。 同时,两套项目的组件库、状态管理、请求封装独立,修改预约表单、调整时段选择逻辑时,两处代码都要同步改动,很容易出现逻辑差异。在业务快速迭代阶段,测试回归工作量成倍增加,跨端操作订单时容易出现数据不一致。

二、前端分层架构设计

整体架构分为四层:业务页面层、公共组件层、工具适配层、编译输出层。 业务页面层只关心预约业务逻辑,包括服务选择、预约时间、地址填写、订单提交,不嵌入平台专属代码;公共组件层封装时间选择器、地址选择、服务卡片、订单状态标签等通用组件,所有页面直接复用;工具适配层统一封装请求、登录、定位、支付、消息通知,通过条件编译隔离平台差异;编译输出层将同一套代码,分别编译成微信小程序代码包和H5网页资源。 前后端交互采用统一接口规范,后端不区分前端渠道,通过请求头的渠道标识做差异化通知适配,业务参数、返回结构体完全统一。

三、公共组件与状态管理设计

预约相关的通用组件全部抽离,组件对外暴露统一的入参和事件回调,内部渲染逻辑保持一致。时间组件、地址组件前面已经做标准化封装,接收后端返回的时段列表、地址数据,选中后输出固定结构的JSON。 状态管理使用Pinia维护全局用户信息、权限、订单缓存,小程序和H5共用一套状态逻辑。状态持久化做适配封装,底层自动区分存储载体:小程序存入storage,H5存入localStorage,上层业务代码无需感知。

四、条件编译的规范使用

条件编译仅用来处理平台独有API,业务判断逻辑不写在条件编译分支内。

代码语言:javascript
复制
// utils/location.js
export function getLocation() {
	// #ifdef MP-WEIXIN
	return uni.getLocation({type: 'gcj02'});
	// #endif
	// #ifdef H5
	return new Promise((resolve, reject) => {
		if (!navigator.geolocation) {
			reject('当前浏览器不支持定位');
			return;
		}
		navigator.geolocation.getCurrentPosition(resolve, reject);
	})
	// #endif
}

像表单校验、价格计算、时段禁用逻辑,全部写在通用代码中,保证两端业务规则完全一致,避免出现一端可以下单、一端拦截的情况。

五、后端统一接口与校验逻辑

前端不管是小程序还是H5提交预约,都调用同一套后端接口,后端接收渠道标识,用于后续消息分发。核心档期锁单逻辑统一,防止超约。

代码语言:javascript
复制
@Service
public class AppointOrderService {
    @Autowired
    private StringRedisTemplate redisTemplate;
    @Autowired
    private OrderMapper orderMapper;
    private static final String LOCK_PREFIX = "house:slot:lock:";

    @Transactional(rollbackFor = Exception.class)
    public ResultDTO submitOrder(AppointDTO dto) {
        String lockKey = LOCK_PREFIX + dto.getServiceId() + ":" + dto.getAppointTime();
        Boolean lock = redisTemplate.opsForValue().setIfAbsent(lockKey, "1", 5, TimeUnit.SECONDS);
        if (Boolean.FALSE.equals(lock)) {
            return ResultDTO.fail("该时段已被预约,请选择其他时间");
        }
        AppointOrder order = new AppointOrder();
        BeanUtils.copyProperties(dto, order);
        order.setChannel(dto.getChannel());
        order.setOrderStatus(0);
        orderMapper.insert(order);
        return ResultDTO.success(order);
    }
}

后端同时做参数校验、服务范围校验、档期校验,前端校验仅作为体验优化,不能作为安全屏障。

六、样式兼容与适配处理

H5在不同移动端浏览器存在样式差异,小程序有自身的渲染规范。样式上优先使用rpx单位,UniApp编译时自动转换,H5端自动转为rem。 针对H5特有的问题,比如输入框弹出挤压页面、滚动穿透,在适配层增加补丁样式;小程序的胶囊按钮、原生导航栏,单独配置,不改动页面主体布局。核心预约表单布局保持一致,给用户跨端操作相近的体验。

七、打包、发布与版本管理

代码仓库只维护一份前端源码,CI脚本分别执行打包命令,输出小程序包和H5静态资源。 小程序包上传到微信后台提交审核;H5资源部署到静态资源服务器,配置域名、HTTPS。版本号统一管理,同一个版本号对应两套前端产物,方便问题追溯。

八、测试重点

测试需要覆盖:小程序、H5打开同一个预约页面,组件、表单、可选时段一致;H5多浏览器兼容;跨端下单,订单状态同步;定位授权拒绝、表单非法输入等边界场景。同时检查条件编译是否污染业务逻辑,修改通用代码后,两端都要回归验证。

总结

这套基于UniApp的前端架构,核心价值是一份源码编译多端,把平台差异收敛到适配层,预约业务页面、组件、校验逻辑统一复用,大幅降低多端开发和维护成本。搭配后端统一接口,保障小程序和H5下单、预约、查看订单的业务规则一致,从前端层面减少跨端数据不一致问题。该架构后续新增技师端页面、营销活动页面,都可以复用这套组件和适配能力。落地时需要控制条件编译的使用范围,做好样式兼容回归,同时依靠CI流水线自动化打包,保证两端版本同步发布。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

目录
  • 家政预约系统前端架构:一套代码输出小程序与H5预约页面
    • 一、多端独立前端的开发痛点
    • 二、前端分层架构设计
    • 三、公共组件与状态管理设计
    • 四、条件编译的规范使用
    • 五、后端统一接口与校验逻辑
    • 六、样式兼容与适配处理
    • 七、打包、发布与版本管理
    • 八、测试重点
    • 总结
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档