更新记录

1.0.1（2026-08-14） 下载此版本

【1.0.1】修复

• 修复 appid 占位符导致微信开发者工具无法打开/编译（无反应）的问题
• 新增「appid 使用说明」：本地开发用真实 appid，发布插件市场用占位符，避免误用
• 新增一键打包发布脚本（一键打包发布.bat）：自动切换占位符 → 打包 → 恢复真实 appid

1.0.0（2026-08-14） 下载此版本

阳光点餐 · 到店扫码点餐小程序模板（uni-app Vue3）

功能亮点

• 桌号二维码扫码入座：后端生成小程序码，扫码自动绑定桌号，未绑定不可下单
• 点餐全流程：选菜 → 规格平铺选择 → 购物车勾选结算 → 优惠券自动/手动选券 → 确认下单（挂单）
• 订单管理：待确认 / 制作中 / 待取餐 / 待结账 / 已完成 多状态流转，订单详情含进度步骤条
• 我的：手机号验证码登录、优惠券、收藏、订单入口、退出登录
• 纯前端 Mock 数据：内置完整菜品 / 订单 / 优惠券，无需后端即可整站演示

页面清单（11 页）

首页 / 商品详情 / 购物车 / 确认点餐 / 提交成功 / 订单列表 / 订单详情 / 我的 / 收货地址 / 优惠券 / 登录

技术要点

• uni-app Vue3 + Pinia 风格状态管理（Vue3 reactive）
• 金额单位「分」，前端统一分转元
• 全部静态资源为内置占位图，替换即可上线

使用方式

1. HBuilderX 打开工程目录
2. 运行 → 运行到小程序模拟器（微信开发者工具）
3. 默认 mock=true 离线运行；对接后端改 config/env.js

配套文档

• docs/backend-dev.md：PHP(ThinkPHP/Laravel)+MySQL 后端开发文档（含数据库表设计、接口契约、桌号二维码方案）

平台兼容性

uni-app

阳光点餐 · 插件使用说明

到店扫码点餐小程序模板（uni-app Vue3） 版本：1.0.1

一、功能简介

• 桌号扫码入座：后端生成微信小程序码，顾客扫码进入小程序自动绑定桌号；未绑定桌号不能下单。
• 点餐全流程：选菜 → 规格平铺选择 → 购物车勾选结算 → 优惠券匹配 → 确认下单（挂单，不支付）。
• 订单管理：待确认 / 制作中 / 待取餐 / 待结账 / 已完成 多状态流转，详情含进度步骤条。
• 优惠券：可领取券池、自动匹配最优 / 手动选券、满减试算。
• 用户中心：手机号验证码登录、收藏、订单入口、退出登录。
• 纯前端 Mock：内置完整菜品 / 订单 / 优惠券数据，无需后端即可整站运行演示。

二、快速运行

方式一：HBuilderX 运行（推荐）

1. 用 HBuilderX 打开工程根目录（order-food/）。
2. 点击菜单「运行 → 运行到小程序模拟器 → 微信开发者工具」。
3. 首次运行前完成以下配置：

4. 默认 config/env.js 中 mock: true，无需后端即可整站离线运行。

方式二：导入微信开发者工具

1. 微信开发者工具 → 导入项目。
2. 目录选择编译产物：unpackage/dist/dev/mp-weixin。
3. AppID 填真实 appid 或选「测试号」。

⚠️ 勿直接打开项目根目录（那里没有 app.json），微信开发者工具会报「未找到 app.json」。

三、⚠️ appid 使用提醒

• 开发期用真实 appid，发版前替换为占位符再打包。
• 已提供一键脚本 一键打包发布.bat：自动「切换占位符 → 打包 → 恢复真实 appid」，打包后源码保持可运行。

四、对接真实后端

1. 修改 config/env.js：

2. 后端按 docs/backend-dev.md 实现接口（含数据库表设计、接口契约、桌号小程序码方案）。
3. 统一约定：返回 { code, msg, data, requestId }，金额单位分。

五、目录结构

order-food/
├── api/          # 接口封装（login/shop/cart/order/coupon/user/favorite/statistics）
├── components/   # 公共组件
├── config/env.js # 环境配置（对接后端入口）
├── mock/         # 本地模拟数据（mock=true 时生效）
├── pages/        # 11 个业务页面
├── store/        # 状态管理（购物车/用户/门店）
├── utils/        # money(分转元) / time
├── static/       # 图片资源（png，含商品/图标/tabBar）
├── docs/         # 后端开发文档
├── README.md     # 工程说明

六、前端平台兼容性

七、常见问题

Q：微信开发者工具打不开/无反应？ A：多为 appid 为占位符所致，填入真实 appid 后重试；或先完全关闭微信开发者工具再重新运行。

Q：报 ws://127.0.0.1:8090 不在合法域名？ A：开发调试提示，在微信开发者工具「详情」勾选「不校验合法域名」即可。

Q：商品图显示「商品图」占位？ A：替换 static/goods/*.png 为真实商品图即可。

八、更新日志

• 1.0.1：修复 appid 占位符导致微信开发者工具无法打开的问题；新增 appid 使用说明与一键打包脚本。
• 1.0.0：首次发布。