更新记录

4.4.8（2025-06-13） 下载此版本

更新了前端页面全部流程直接可以使用

作者微信

平台兼容性

uni-app(4.53)

uni-app x(4.45)

其他

棋牌小程序功能说明文档

项目概述

本小程序是基于uni-app框架开发的棋牌室预约管理系统，支持微信小程序和H5多平台部署。项目采用Vue 3 + TypeScript + Vite技术栈，通过uni-app实现跨端开发，为用户提供棋牌室信息展示、预约、支付等功能。

功能模块

1. 门店管理

• 门店列表：展示附近的棋牌室店铺，支持按距离排序
• 搜索功能：支持按店铺名称搜索
• 门店详情：展示店铺基本信息、图片、地址和联系方式
• 导航功能：支持一键导航到店铺位置
• 电话咨询：快捷拨打门店电话

2. 房间预约

• 房间列表：展示门店内所有包间信息
• 空闲状态显示：直观展示房间当前状态（空闲/已预约/使用中/待打扫/打扫中）
• 时间段选择：时间轴形式展示可预约时间段
• 预约时间冲突提示：已预约时间段醒目标记
• 房间分类：按大小规格（小包/中包/大包/豪包）分类
• 特色标签：展示房间特色功能标签

3. 用户中心

• 用户登录/注册：支持手机号登录和注册
• 个人信息管理：查看、编辑个人资料
• 会员充值：支持会员充值功能
• 收藏管理：收藏喜爱的棋牌室店铺
• 密码管理：修改密码、找回密码

4. 订单与支付

• 在线支付：支持微信支付
• 订单管理：查看订单历史和状态
• 支付结果反馈：支付后状态实时反馈

5. 资讯功能

• 公告信息：展示平台公告和门店信息
• 常见问题：提供常见问题解答
• 资讯详情：查看平台资讯详情

技术特点

1. 跨平台开发：使用uni-app框架，一套代码支持微信小程序和H5多平台
2. 响应式设计：适配不同屏幕尺寸设备
3. 地理位置服务：集成地图定位、距离计算和导航功能
4. 实时预约系统：直观展示房间预约状态和可用时间段
5. 现代化UI：使用uView UI组件库，提供美观的用户界面

项目配置

• API域名：https://shipin.jietu.site（配置于.env.production文件）
• 请求前缀：/api（配置于src/utils/request/index.ts）
• 微信小程序APPID：wx5c4f420e5de8207d（配置于src/manifest.json）
• H5路由基础路径：/mobile/（配置于src/manifest.json的h5部分）

启动与构建

开发环境

# 微信小程序开发
npm run dev:mp-weixin

# H5开发
npm run dev:h5

生产环境

# 微信小程序构建
npm run build:mp-weixin

# H5构建
npm run build:h5

注意事项

1. 项目使用TypeScript进行开发，需要合理定义和使用类型
2. 在跨平台开发中，需注意平台差异性，如微信小程序API在H5环境中可能不存在
3. 如遇到"登录超时"错误，需检查用户登录状态
4. 部分功能需要获取用户位置授权
5. 微信小程序环境中需要正确配置域名白名单