抖音小程序 - 自助台球

扫码开台 · 随时开局。基于抖音小程序（字节跳动小程序）原生框架开发的 24 小时无人自助台球俱乐部运营管理模板，开箱即用，可二次开发接入真实门店、球桌物联与在线支付能力。

一、产品简介

抖音小程序 - 自助台球 是一套面向无人自助台球厅、台球俱乐部、共享台球室的球桌预约与运营管理类小程序源码。覆盖「在线选球桌 → 选套餐开台 → 计时使用 → 结账离场 → 订单管理」完整业务闭环，界面精致、交互流畅、布局自适应。内置本地模拟数据与模拟接口层（套餐、球桌、订单、设置完整 CRUD），无需后端即可在抖音开发者工具中直接预览运行，是搭建自助台球、共享球房、台球俱乐部类预约小程序的优质起步模板。

二、功能介绍

1. 首页（工作台）

• 门店品牌信息与 24 小时营业标识（含品牌口号）
• 注册会员、用户评分、在线球桌三联指标
• 实时球桌状态三列统计：空闲台 / 使用中 / 今日营收（上浮卡片）
• 快捷入口：扫码开台 / 球桌大厅 / 我的订单 / 会员中心（固定双列）
• 门店特色：24 小时营业 / 智能计时 / 无人自助 / VIP 雅间
• 球桌大厅双列卡片（台呢底色 + 彩色台球 + 实时状态，VIP 雅间带金边样式，可一键开台）
• 热门套餐双列卡片（含现价、划线价、时长、标签，尊享卡带金边专属样式）
• 门店公告

2. 球桌大厅（核心选球桌）

• 球桌关键字搜索（名称 / 类型）
• 状态筛选：空闲 / 使用中 / 维护中
• 区域筛选：大厅 / 雅间
• 球桌双列卡片（台呢底色、彩色台球、状态标识、类型、区域、时价）
• 空闲球桌一键开台（非空闲按钮置灰禁用）

3. 开台订单（CRUD）

• 订单关键字搜索（订单号 / 客户 / 球桌 / 套餐）
• 状态筛选：已预约 / 使用中 / 已结账 / 已取消
• 待开台与使用中订单汇总提醒
• 订单卡片：状态色标识、套餐、球桌、类型、时长、时间、渠道、金额
• 一键新增开台

4. 订单详情

• 套餐名称、订单号、状态、金额、球桌、计时时长
• 订单信息：客户、电话、球桌、类型、时长、开台时间、渠道、备注
• 3 步使用流程进度条（已预约 → 使用中 → 已结账，当前及之前步骤自动高亮）
• 状态流转操作：开始使用 / 结账离场 / 取消预约
• 删除订单（状态联动球桌状态与流程进度）

5. 预约开台（下单表单）

• 选择计费套餐（单选列表，尊享样式高亮）
• 选择球桌（双列选择，非空闲置灰）
• 计时时长加减选择（按小时计费自动算价）
• 客户信息表单：姓名、电话、开台时间、备注
• 实时费用明细与合计（按时长自动计价）
• 确认开台一键下单

6. 会员中心（个人中心）

• 门店信息卡（名称、运营方、等级、地址、营业时间）
• 数据看板（双列）：空闲球桌 / 使用中 / 待开台 / 总订单
• 运营设置开关：自动结账 / 会员折扣 / 深夜模式 / 教练待命
• 数据管理：恢复初始数据、清除本地缓存
• 版本信息

7. 底部导航

• 自定义 TabBar：首页 / 球桌 / 订单 / 我的

三、使用场景

四、技术特点

• 框架：抖音小程序（字节跳动小程序）原生开发，基于 tt API
• 界面：自定义导航栏 + 自定义 TabBar，适配状态栏与右上角原生胶囊按钮；台呢主题视觉（深绿台呢 + 金币金 + 彩色台球，体现台球运动的竞技与品质感）
• 数据：内置本地 Mock 数据与模拟接口层（utils/mock-api.js），基于本地存储模拟后端 CRUD，调用方式贴近真实 API
• 业务逻辑完备：套餐/球桌/订单全链路增删改查、订单 3 步流程状态流转与进度联动、球桌状态自动联动（开台占用、结账释放）、按时长与单价自动计价、运营数据看板汇总
• 自适应布局：所有列表/网格使用 CSS Grid 双列布局（repeat(2, minmax(0,1fr))），不同手机屏宽下始终保持固定 2 列展示
• 结构：页面（pages）、组件（components）、数据（data）、工具（utils）、资源（assets）分层清晰，注释完善
• 图标：内置多套配色图标资源
• 版本管理：含 APP 版本号机制，发版时自动清空旧缓存与旧数据，保证真机调试始终为最新代码

五、交付内容

项目目录结构（解压后）

源码_自助台球/
├── app.js                  # 小程序入口（导航栏适配、版本缓存初始化）
├── app.json                # 全局配置（页面路由、窗口、自定义组件）
├── app.ttss                # 全局样式（主题变量、通用类）
├── project.config.json     # 项目配置
├── assets/                 # 静态资源（多套配色图标）
├── components/             # 公共组件
│   ├── tabbar/             # 自定义底部导航
│   └── empty/              # 空状态组件
├── data/
│   ├── mock-data.js        # 种子演示数据（门店/套餐/球桌/订单/公告/设置）
│   └── mock-data.json      # 同结构 JSON 数据
├── utils/
│   └── mock-api.js         # 模拟接口层（套餐/球桌/订单/设置 CRUD + 看板）
└── pages/                  # 页面
    ├── index/              # 首页（工作台）
    ├── tables/             # 球桌大厅
    ├── orders/             # 开台订单
    ├── detail/             # 订单详情（使用流程进度）
    ├── booking/            # 预约开台（下单表单）
    └── my/                 # 会员中心（设置/数据管理）

六、运行方式

1. 下载并安装 抖音开发者工具（字节跳动小程序开发者工具）。
2. 解压 源码_自助台球.zip。
3. 在开发者工具中选择「导入项目」，项目目录指向解压后的 源码_自助台球 文件夹。
4. 填写自己的 AppID（或使用测试号），点击导入即可预览。
5. 真机调试时如遇旧缓存，可在「会员中心」页点击「清除本地缓存」，或调大 app.js 中 APP_VER 版本号强制刷新。
6. 如需接入真实能力，替换 utils/mock-api.js 中的套餐、球桌、订单等接口实现，对接实际后端即可上线运营。

说明：源码中所有门店、公司、人员、地址、电话均为演示占位数据，无任何真实信息。