更新记录

1.0.6（2026-08-31） 下载此版本

Bug 修复

桌号改为本地持久化，重启小程序不再丢失；退出登录仍自动清空，防止同设备串桌； 修复商品列表快速切换分类时的加载竞态（旧请求不再覆盖新数据）； 「我的评价」入口此前实际跳转「已完成」订单，行为与文案不符，已修正； 登录页《隐私协议》改为可点击查看全文，满足小程序提审合规要求； 登录守卫改为返回 false 中断导航，不再抛异常，避免影响其它拦截器。 流程 / 交互优化

商品详情、购物车、确认下单三处步进器统一为公共组件，数量减到 0 自动移除商品； 优惠券选择弹层改为可滚动，超长列表不再溢出遮挡； 新增收货地址「新增 / 编辑」表单页，地址管理功能完整可用； 订单列表支持下拉刷新。 架构 / 质量优化

订单状态、订单页签、优惠券页签抽为公共常量，多页复用、杜绝文案漂移； 购物车本地状态统一复用接口层，消除重复路径； mock 演示数据重构：订单扩展至 20 条并支持真实分页、订单时间自动相对当天，分页 / 下拉刷新可完整演示； 图片上传在演示环境直接返回本地路径，不再发起无效上传请求； 清理冗余代码与空回调。

1.0.5（2026-08-31） 下载此版本

Bug 修复

修复登录成功后回跳 tabBar 页面失效的问题 修复下单成功后误删购物车未选中商品的问题 修复时间格式化在 iOS 真机上解析失败的问题 修复 mock 优惠券有效期过期的问题（改为相对今天的动态日期） 流程 / 交互优化

优惠券「立即使用」一键带入确认页，无需手动重选 订单详情支持「再次下单」一键回填购物车 确认页加减商品数量后优惠券自动重算 订单列表支持触底分页加载，加载失败不丢失已有数据 未登录收藏时引导登录，不再被 401 打断 图片上传失败不再提交失效的临时路径 下单前校验桌号有效性，无效桌号阻止下单 架构 / 质量优化

修复购物车与用户模块循环引用，改用事件解耦 升级系统信息 API 为 uni.getWindowInfo（兼容旧基础库） 修复 eslint 自身报错，代码质量通过 lint 校验

1.0.4（2026-08-30） 下载此版本

安全存储：token 与用户信息加密落盘（新增 utils/crypto.js + utils/storage.js），避免明文暴露 购物车跨设备同步：防抖上报 syncCart、启动拉取合并 pullCart/mergeCart（仅真实后端 + 已登录生效，mock 自动跳过） 优化：退出登录清空购物车与桌号，防串桌/串号 修复：pullCart 接口由未定义的 /api/cart/pull 统一为 /api/cart/list 修复：占位符 appid 导致微信开发者工具 × preparing 的问题，并补充常见问题说明

平台兼容性

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：首次发布。