更新记录

1.0.1（2025-12-15） 下载此版本

用户端

1. 首次使用需要登录/注册
2. 浏览菜单，选择商品加入购物车
3. 确认订单信息，选择是否使用礼品卡
4. 提交订单并支付
5. 在"订单"页面查看订单状态
6. 在"我的"页面管理个人信息、查看积点、兑换礼品卡等

管理端

1. 进入管理后台
2. 管理订单、菜单、礼品卡等
3. 查看数据统计
4. 配置系统参数

平台兼容性

uni-app(4.87)

one岁屋点餐系统 - 功能介绍文档

项目简介

one岁屋点餐系统是一款基于 uni-app 和 uniCloud 开发的点餐小程序，支持微信小程序等多端运行。系统提供完整的点餐、订单管理、会员积分、礼品卡等功能，同时包含管理后台用于商家管理。

技术架构

• 前端框架: uni-app (Vue.js)
• 后端服务: uniCloud (阿里云)
• UI组件库: uView UI
• 状态管理: Vuex
• 数据库: uniCloud 云数据库

核心功能模块

1. 首页模块

1.1 首页展示

• 轮播图: 展示活动banner，支持自动轮播
• 用户问候: 显示用户昵称和欢迎语
• 快捷入口:
  • 点我下单：跳转到点餐页面
  • 菜单收集：查看菜单信息
• 积点信息: 显示用户当前积点数量，点击可进入积点商城
• 今日限量: 显示今日订单数量/限量
• 导航区域:
  • 万岁屋的便当：品牌介绍
  • 干饭送水果：活动入口
  • 我的优惠券：卡券管理入口
• 新鲜事: 展示品牌动态和活动信息

1.2 礼品卡入口

• 首页提供礼品卡兑换入口，点击可跳转到礼品卡兑换页面

2. 点餐模块

2.1 菜单浏览

• 分类导航: 左侧分类菜单，支持快速切换
• 商品列表: 右侧展示商品信息，包括：
  • 商品图片
  • 商品名称
  • 商品价格
  • 商品描述
  • 商品类型（荤/素）
• 轮播广告: 顶部展示活动广告轮播图
• 点餐截止时间: 显示当日点餐截止时间（第二天10:00）

2.2 商品选择

• 商品详情: 点击商品可查看详细信息
• 购物车:
  • 实时显示购物车商品数量
  • 支持增减商品数量
  • 显示购物车总价
• 点餐规则:
  • 支持荤素搭配（2荤1素、2荤2素等）
  • 自动计算套餐价格

2.3 配送方式

• 自取: 选择取餐地点（默认：中电软件园一期）
• 外卖: 选择配送地址（需先设置收货地址）

3. 支付模块

3.1 订单确认

• 商品清单: 显示所选商品及数量
• 配送信息: 显示配送地址或取餐地点
• 备注信息: 支持添加订单备注
• 礼品卡选择:
  • 可选择使用礼品卡优惠
  • 显示可用礼品卡列表（图片、名称、有效期）
  • 支持不使用礼品卡选项
  • 显示优惠金额或折扣信息
• 价格计算:
  • 显示商品总价
  • 显示礼品卡优惠金额
  • 显示最终支付金额

3.2 支付流程

• 提交订单
• 创建订单记录
• 如果使用礼品卡，自动更新礼品卡状态为已使用
• 记录礼品卡使用记录
• 扣除用户积点（如果使用积点）

4. 订单模块

4.1 订单列表

• 订单查询: 默认显示过去一周的订单
• 下拉刷新: 支持下拉刷新订单列表
• 上滑加载: 支持上滑加载更多订单（分页）
• 订单信息:
  • 订单编号
  • 订单状态（待支付、待配送、已完成等）
  • 订单时间
  • 订单金额
  • 礼品卡信息（显示使用的礼品卡名称，未使用显示"未使用"）
  • 商品信息（荤素搭配）

4.2 订单详情

• 订单基本信息: 订单号、下单时间、订单状态
• 商品详情: 商品列表、数量、价格
• 配送信息: 配送地址或取餐地点
• 支付信息:
  • 商品总价
  • 礼品卡优惠
  • 实付金额
• 礼品卡详情:
  • 如果使用礼品卡，显示礼品卡名称、图片、有效期
  • 点击礼品卡名称可查看详细信息弹窗
  • 未使用礼品卡显示"未使用礼品卡"

5. 我的模块

5.1 个人中心

• 用户信息: 显示用户头像、昵称、手机号
• 会员信息:
  • 会员码（二维码）
  • 会员等级
  • 入会时间
• 功能入口:
  • 我的订单
  • 我的卡券
  • 我的地址
  • 会员储值
  • 积分商城
  • 礼品卡
  • 签到打卡
  • 更多服务

5.2 用户信息管理

• 编辑信息:
  • 昵称（必填）
  • 手机号码
  • 性别（先生/女士）
  • 生日（日期选择器）
• 数据同步:
  • 保存时同步更新本地状态（Vuex）
  • 同步更新数据库（wsw-user表）
  • 支持昵称、性别、生日、手机号字段更新

5.3 会员码

• 生成并显示会员二维码
• 可用于门店核销

6. 礼品卡模块

6.1 礼品卡兑换

• 礼品卡列表:
  • 从数据库（wsw-gift-card）获取礼品卡数据
  • 按描述（description）分组展示
  • 显示礼品卡图片、名称、所需积点
• 兑换流程:
  • 点击礼品卡弹出兑换确认对话框
  • 验证用户积点是否足够
  • 积点不足时提示用户
  • 确认兑换后：
  • 创建用户礼品卡记录（wsw-user-gift-card）
  • 扣除用户积点（更新wsw-user-member-info）
  • 记录积点使用明细（wsw-point-record）
  • 设置礼品卡有效期（90天）

6.2 我的礼品卡

• 分类展示:
  • 可使用：显示未使用且未过期的礼品卡
  • 不可使用：显示已使用或已过期的礼品卡
• 礼品卡信息:
  • 礼品卡图片
  • 礼品卡名称
  • 到期时间
  • 优惠信息（固定金额或折扣比例）
  • 状态标识（已使用/已过期）
• 性能优化:
  • 缓存用户所有礼品卡数据
  • 在内存中过滤分类，提升切换流畅度

7. 积分系统

7.1 积点商城

• 积点展示: 显示用户当前积点数量
• 商品分类: 按分类展示可兑换商品
• 商品详情: 显示商品图片、名称、所需积点
• 兑换功能: 支持使用积点兑换商品

7.2 积点明细

• 明细列表: 显示积点变动记录
• 记录类型:
  • 获得（签到、消费等）
  • 使用（兑换礼品卡、兑换商品等）
• 详细信息: 显示时间、类型、积点数量、余额、备注

7.3 签到打卡

• 每日签到获得积点
• 签到日历展示
• 连续签到奖励

8. 地址管理

8.1 地址列表

• 显示所有收货地址
• 支持设置默认地址
• 支持编辑和删除地址

8.2 添加/编辑地址

• 地址信息:
  • 收货人姓名
  • 手机号码
  • 详细地址
  • 地址标签（家、公司等）
• 数据存储: 保存到数据库（wsw-address）

9. 卡券管理

9.1 我的卡券

• 显示用户拥有的优惠券
• 按状态分类（未使用、已使用、已过期）
• 显示优惠券详情和使用条件

10. 管理后台

10.1 管理功能入口

• 订单管理
• 今日菜单
• 发布点餐
• 轮播图管理
• 字典管理
• 图片管理
• 今日订单
• 卡券管理

10.2 订单管理

• 订单列表:
  • 显示所有订单
  • 支持按状态筛选
  • 显示订单详细信息：
  • 收货人
  • 荤素搭配
  • 礼品卡名称（使用礼品卡显示名称，未使用显示"未使用"）
  • 订单状态
• 订单操作:
  • 查看订单详情
  • 更新订单状态
  • 取消订单

10.3 菜单管理

• 今日菜单: 查看和编辑当日菜单
• 发布点餐: 发布新的点餐活动
• 商品管理: 添加、编辑、删除商品

10.4 轮播图管理

• 添加、编辑、删除轮播图
• 设置轮播图顺序
• 设置跳转链接

10.5 礼品卡管理

• 添加、编辑、删除礼品卡
• 设置礼品卡信息：
  • 名称
  • 图片
  • 描述
  • 所需积点
  • 优惠类型（固定金额/折扣比例）
  • 优惠值

10.6 字典管理

• 管理系统配置字典
• 支持增删改查

10.7 图片管理

• 上传、管理图片资源
• 支持图片分类

数据库设计

核心数据表

1. wsw-user: 用户信息表

   • 用户基本信息（昵称、手机号、性别、生日等）

2. wsw-order: 订单表

   • 订单基本信息
   • 商品信息
   • 配送信息
   • 礼品卡信息（user_gift_card_id, gift_card_name, gift_card_discount）

3. wsw-gift-card: 礼品卡模板表

   • 礼品卡基本信息（名称、图片、描述、所需积点、优惠信息）

4. wsw-user-gift-card: 用户礼品卡表

   • 用户拥有的礼品卡记录
   • 状态（未使用、已使用、已过期）
   • 有效期

5. wsw-user-member-info: 用户会员信息表

   • 会员积点
   • 会员等级
   • 会员状态

6. wsw-point-record: 积点记录表

   • 积点变动记录
   • 变动类型（获得/使用）
   • 关联信息（礼品卡ID、订单ID等）

7. wsw-goods: 商品表

   • 商品基本信息
   • 商品分类
   • 商品价格

8. wsw-address: 地址表

   • 用户收货地址信息

9. wsw-banner: 轮播图表

   • 轮播图信息

10. wsw-dict: 字典表

    • 系统配置字典

特色功能

1. 礼品卡系统

• 完整的礼品卡兑换流程
• 支持固定金额和折扣比例两种优惠方式
• 礼品卡状态自动管理（未使用、已使用、已过期）
• 订单中自动应用礼品卡优惠

2. 积点系统

• 积点获得（签到、消费等）
• 积点使用（兑换礼品卡、兑换商品）
• 完整的积点流水记录
• 积点商城兑换功能

3. 订单管理

• 支持下拉刷新和上滑加载更多
• 默认查询过去一周订单
• 分页加载，性能优化
• 礼品卡信息完整展示

4. 数据同步

• 用户信息修改同步更新数据库
• 订单创建自动更新礼品卡状态
• 积点变动实时记录

5. 性能优化

• 礼品卡列表缓存，内存过滤
• 订单列表去重处理
• 防止重复加载数据
• 图片懒加载

用户体验

1. 界面设计

• 简洁美观的UI设计
• 符合小程序设计规范
• 响应式布局，适配不同屏幕

2. 交互体验

• 流畅的页面切换动画
• 清晰的操作反馈
• 友好的错误提示
• 加载状态提示

3. 功能完整性

• 完整的点餐流程
• 完善的订单管理
• 丰富的会员功能
• 便捷的管理后台

技术亮点

1. uni-app跨平台: 一套代码多端运行
2. uniCloud云开发: 无需搭建服务器，快速开发
3. Vuex状态管理: 统一管理应用状态
4. 组件化开发: 可复用的组件设计
5. 数据库设计: 合理的数据表结构设计
6. 性能优化: 数据缓存、去重、分页等优化策略

使用说明

用户端

1. 首次使用需要登录/注册
2. 浏览菜单，选择商品加入购物车
3. 确认订单信息，选择是否使用礼品卡
4. 提交订单并支付
5. 在"订单"页面查看订单状态
6. 在"我的"页面管理个人信息、查看积点、兑换礼品卡等

管理端

1. 进入管理后台
2. 管理订单、菜单、礼品卡等
3. 查看数据统计
4. 配置系统参数

更新日志

最新功能

• ✅ 礼品卡兑换功能
• ✅ 礼品卡在订单中的应用
• ✅ 用户信息同步更新数据库
• ✅ 订单列表优化（过去一周、下拉刷新、上滑加载）
• ✅ 礼品卡信息在订单详情中的展示
• ✅ 管理后台礼品卡列展示

注意事项

1. 礼品卡兑换需要足够的积点
2. 礼品卡有有效期限制（90天）
3. 订单提交后礼品卡状态会自动更新
4. 用户信息修改会同步到数据库
5. 订单列表默认显示过去一周的数据

联系方式

如有问题或建议，请联系开发团队。

版本: 1.0.0
更新日期: 2025年12月12日