更新记录

1.0.0（2026-02-22）

首次发布，详情查看下方说明，微信搜“聚云优选”小程序体验完整功能

平台兼容性

云端兼容性

uni-app(3.6.17)

云函数类插件通用教程

使用云函数类插件的前提是：使用HBuilderX 2.9+

聚云优选 - 电商小程序用户端

基于 uni-app + uniCloud + vk-unicloud 框架开发的全功能电商小程序系统

📋 目录（微信搜“聚云优选”小程序体验完整功能）

• 项目概述
• 技术架构
• 功能模块总览
• 目录结构
• 核心功能模块详解
  • 商品模块
  • 订单模块
  • 购物车模块
  • 用户中心模块
• 业务功能模块详解
  • VIP会员系统
  • 分销系统
  • 优惠券系统
  • 任务系统
  • 营销活动系统
• 业务流程图
• 功能关联图
• 数据库设计
• 部署说明
  • 一、uniCloud 服务空间
  • 二、微信小程序配置
  • 三、微信支付配置
  • 四、支付宝支付配置
  • 五、支付回调通信密钥
  • 六、uni-id 安全密钥
  • 七、vk-unicloud 服务端配置
  • 八、uni-id 第三方登录
  • 九、DCloud 应用标识
  • 十、管理端特有配置
  • 十一、应用名称与品牌
  • 十二、第三方 API 密钥
  • 十三、数据库配置表
  • 十四、CDN 静态资源域名
  • 十五、定时任务
  • 十六、数据库
  • 十七、迁移操作检查清单
• 开发规范
• 项目特色

项目概述（微信搜“聚云优选”小程序体验完整功能）

系统简介（微信搜“聚云优选”小程序体验完整功能）

聚云优选是一个功能完善的电商小程序系统，涵盖商品展示、购物车、订单管理、支付结算、会员体系、分销系统、优惠券、积分系统、任务系统等完整的电商业务流程。

核心特性（微信搜“聚云优选”小程序体验完整功能）

• ✅ 完整电商流程：商品浏览 → 加购 → 下单 → 支付 → 物流 → 评价
• ✅ 会员体系：VIP会员、积分系统、余额充值
• ✅ 营销系统：优惠券、秒杀、新品首发、每日福利
• ✅ 分销系统：二级分销、佣金结算、团队管理
• ✅ 任务系统：每日签到、任务奖励、积分兑换
• ✅ 社交功能：商品评价、收藏、足迹、分享

在线体验

• 用户端：微信扫码体验

  

• 管理端：点击访问管理后台

  • 体验账号：a123123
  • 体验密码：a123123
  • 体验者角色仅支持查看，无法进行增删改操作

技术架构（微信搜“聚云优选”小程序体验完整功能）

前端技术栈（微信搜“聚云优选”小程序体验完整功能）

• uni-app: 跨平台开发框架
• Vue 2.x: 渐进式JavaScript框架
• vk-unicloud-router: 路由与云函数调用框架
• Vuex: 状态管理
• SCSS: CSS预处理器

后端技术栈（微信搜“聚云优选”小程序体验完整功能）

• uniCloud: 云开发平台（支付宝云空间）
• 云函数: Serverless函数计算
• 云数据库: MongoDB数据库
• uni-pay: 统一支付插件

功能模块总览（微信搜“聚云优选”小程序体验完整功能）

首页模块

• Banner轮播（翻页动画效果）
• 快捷入口
• 商品分类
• 营销活动（秒杀/新品/福利）
• 商品推荐

商品模块

• 商品列表
• 商品详情
• 商品搜索
• 商品分类
• 品牌筛选

购物车模块

• 商品管理
• 规格选择
• 优惠计算
• 结算功能

订单模块

• 订单创建
• 支付结算
• 物流追踪
• 订单评价
• 售后服务

用户中心

• 个人信息
• 订单管理
• 资产管理（余额/积分/优惠券）
• 收货地址
• 收藏/足迹

目录结构

聚云优选用户端/
├── App.vue                     # 应用入口，全局样式与iconfont
├── main.js                     # 主入口文件
├── manifest.json               # 应用配置（小程序appid、权限等）
├── pages.json                  # 页面路由配置
├── app.config.js               # 应用配置（调试模式、错误页面等）
├── uni.scss                    # 全局SCSS变量（ysjl-前缀）
│
├── pages/                      # 页面目录
│   ├── index/                  # 首页模块
│   │   ├── index.vue          # 首页主文件（TabBar页面）
│   │   └── components/        # 首页组件
│   │       ├── home-content.vue      # 首页内容（Banner、分类、商品）
│   │       ├── user-content.vue      # 用户中心（个人信息、订单、工具）
│   │       ├── category-content.vue  # 分类页（分类导航、商品列表）
│   │       └── cart-content.vue      # 购物车（商品管理、结算）
│   │
│   ├── goods/                  # 商品模块
│   │   └── detail.vue         # 商品详情（图文、SKU、评价、推荐）
│   │
│   ├── order/                  # 订单模块
│   │   ├── order-list.vue     # 订单列表（状态筛选、搜索）
│   │   ├── order-detail.vue   # 订单详情（商品、物流、操作）
│   │   ├── order-submit.vue   # 订单提交（地址、优惠券、支付）
│   │   └── logistics.vue      # 物流详情（物流轨迹）
│   │
│   ├── activity/               # 活动模块
│   │   ├── new.vue            # 新品首发
│   │   ├── welfare.vue        # 每日福利
│   │   └── points-record.vue  # 积分记录（积分明细）
│   │
│   ├── category/               # 分类模块
│   │   └── category-list.vue  # 分类商品列表（筛选、排序）
│   │
│   ├── flash-sale/             # 秒杀活动模块
│   │   └── flash-sale.vue     # 限时秒杀（限时抢购）
│   │
│   ├── distribution/           # 分销模块（二级分销）
│   │   ├── center.vue         # 分销中心（数据概览、邀请码）
│   │   ├── team.vue           # 我的团队（一级/二级下线）
│   │   ├── commission-list.vue # 佣金明细（收入记录）
│   │   ├── withdraw.vue       # 提现申请（提现表单）
│   │   ├── withdraw-list.vue   # 提现记录（提现历史）
│   │   └── bank-info.vue      # 银行卡管理（提现账户）
│   │
│   ├── vip/                    # 会员模块
│   │   └── vip.vue            # 会员中心（套餐购买、权益展示）
│   │
│   ├── wallet/                 # 钱包模块
│   │   └── wallet.vue         # 我的钱包（余额、充值、明细）
│   │
│   ├── coupon/                 # 优惠券模块
│   │   ├── coupon-list.vue    # 优惠券列表（我的优惠券）
│   │   ├── coupon-center.vue  # 领券中心（可领取优惠券）
│   │   └── coupon-select.vue  # 优惠券选择（订单选择优惠券）
│   │
│   ├── address/                # 地址模块
│   │   ├── address-list.vue   # 地址列表（管理收货地址）
│   │   └── address-edit.vue   # 地址编辑（新增/修改地址）
│   │
│   ├── review/                 # 评价模块
│   │   ├── review-list.vue    # 评价列表（待评价、已评价）
│   │   └── write-review.vue   # 发表评价（图文评价、评分）
│   │
│   ├── favorite/               # 收藏模块
│   │   └── list.vue           # 收藏列表（收藏的商品）
│   │
│   ├── history/                # 足迹模块
│   │   └── list.vue           # 浏览足迹（浏览历史）
│   │
│   ├── feedback/               # 反馈模块
│   │   ├── feedback-submit.vue # 提交反馈（问题反馈）
│   │   └── feedback-list.vue   # 反馈列表（我的反馈）
│   │
│   ├── search/                 # 搜索模块
│   │   └── search.vue         # 搜索页面（关键词搜索、历史记录）
│   │
│   ├── login/                  # 登录模块
│   │   └── index.vue          # 登录页面（微信授权登录）
│   │
│   ├── user-personal/          # 个人信息
│   │   └── user-personal.vue  # 个人资料（头像、昵称、手机号）
│   │
│   ├── setting/                # 设置模块
│   │   └── index.vue          # 设置中心（账号安全、清理缓存）
│   │
│   ├── verification/           # 核销模块
│   │   └── scan-result.vue    # 扫码核销（任务核销）
│   │
│   ├── about/                  # 关于模块
│   │   └── index.vue          # 关于我们
│   │
│   ├── protocol/               # 协议模块
│   │   ├── agreement.vue      # 用户协议
│   │   └── privacy.vue        # 隐私政策
│   │
│   └── webview/                # 网页模块
│       └── index.vue          # 内嵌网页（富文本展示）
│
├── components/                 # 公共组件（ysjl-前缀）
│   ├── ysjl-navbar/           # 导航栏组件（自定义导航栏）
│   ├── ysjl-tabbar/           # 底部导航（TabBar组件）
│   ├── ysjl-sku-selector/     # SKU选择器（规格选择弹窗）
│   ├── ysjl-waterfall-flow/   # 瀑布流布局（商品列表布局）
│   ├── ysjl-page-flip/        # 翻页组件（Banner翻页动画）
│   ├── ysjl-back-to-top/      # 返回顶部（浮动按钮）
│   ├── ysjl-confirm-modal/    # 确认弹窗（操作确认）
│   ├── ysjl-filter-bar/       # 筛选栏（商品筛选）
│   ├── ysjl-load-more/        # 加载更多（分页加载）
│   ├── ysjl-area-choose/      # 地区选择（省市区选择）
│   ├── ysjl-skeleton/         # 骨架屏（加载占位）
│   └── ysjl-slanted-popup/    # 斜切弹窗（活动弹窗）
│
├── store/                      # 状态管理（Vuex）
│   ├── index.js               # Vuex入口
│   └── modules/               # 模块
│       ├── $app.js            # 应用状态（全局配置）
│       └── $user.js           # 用户状态（用户信息、登录状态）
│
├── common/                     # 公共资源
│   └── function/
│       └── myPubFunction.js   # 公共函数（ysjl_前缀）
│
├── utils/                      # 工具函数
│   ├── page-flip.js           # 翻页算法（ysjl_前缀）
│   └── subscribeMsg.js        # 订阅消息工具
│
├── static/                     # 静态资源
│   ├── logo.png               # 应用图标
│   └── ...                    # 其他静态资源
│
└── uniCloud-alipay/           # 云端代码（支付宝云空间）
    └── cloudfunctions/        # 云函数
        └── router/            # 路由云函数
            ├── index.js       # 云函数入口
            ├── config/        # 配置文件
            └── service/       # 服务层
                ├── client/    # 客户端服务
                │   ├── order/              # 订单服务
                │   │   ├── kh/            # 客户端接口（kh=客户）
                │   │   │   ├── create.js         # 创建订单
                │   │   │   ├── getList.js        # 订单列表
                │   │   │   ├── getDetail.js      # 订单详情
                │   │   │   ├── cancel.js         # 取消订单
                │   │   │   ├── confirmReceive.js # 确认收货
                │   │   │   └── ...
                │   │
                │   ├── user/               # 用户服务
                │   │   └── kh/
                │   │       ├── getUserInfo.js     # 获取用户信息
                │   │       └── test.js            # 测试接口
                │   │
                │   ├── ysjl-goods/         # 商品服务
                │   │   └── pub/               # 公开接口（无需登录）
                │   │       ├── getList.js        # 商品列表
                │   │       └── getDetail.js      # 商品详情
                │   │
                │   ├── ysjl-cart/          # 购物车服务
                │   │   └── kh/
                │   │       ├── add.js            # 加入购物车
                │   │       ├── getList.js        # 购物车列表
                │   │       ├── update.js         # 更新数量
                │   │       ├── delete.js         # 删除商品
                │   │       ├── checkAll.js       # 全选/取消全选
                │   │       └── getCount.js       # 购物车数量
                │   │
                │   ├── ysjl-address/       # 地址服务
                │   │   └── kh/
                │   │       ├── getList.js        # 地址列表
                │   │       ├── add.js            # 新增地址
                │   │       ├── update.js         # 更新地址
                │   │       └── delete.js         # 删除地址
                │   │
                │   ├── ysjl-coupon/        # 优惠券服务
                │   │   └── kh/
                │   │       ├── getMyList.js      # 我的优惠券
                │   │       ├── getCenterList.js  # 领券中心
                │   │       ├── getAvailable.js   # 可用优惠券
                │   │       ├── claim.js          # 领取优惠券
                │   │       ├── getShareInfo.js   # 分享信息
                │   │       ├── shareClaim.js     # 分享领取
                │   │       └── shareInvite.js    # 分享邀请
                │   │
                │   ├── ysjl-vip/           # 会员服务
                │   │   └── kh/
                │   │       ├── getPlanList.js    # 套餐列表+会员状态+权益配置
                │   │       ├── createOrder.js    # 创建会员订单+支付单
                │   │       └── paySuccess.js     # 支付成功兜底确认
                │   │
                │   ├── ysjl-distribution/  # 分销服务（二级分销）
                │   │   └── kh/
                │   │       ├── getDistributionInfo.js  # 分销概况
                │   │       ├── getTeamList.js          # 团队列表
                │   │       ├── getCommissionList.js    # 佣金明细
                │   │       ├── getWithdrawList.js      # 提现记录
                │   │       ├── applyWithdraw.js        # 申请提现
                │   │       ├── getBankInfo.js          # 获取银行卡信息
                │   │       └── updateBankInfo.js       # 更新银行卡信息
                │   │
                │   ├── ysjl-review/        # 评价服务
                │   │   └── kh/
                │   │       ├── getList.js        # 评价列表
                │   │       ├── getSummary.js     # 评价统计
                │   │       ├── getReplyList.js   # 评价回复列表
                │   │       ├── submit.js         # 提交评价
                │   │       └── submitReply.js   # 提交回复
                │   │
                │   ├── ysjl-collect/       # 收藏服务
                │   │   └── kh/
                │   │       ├── getList.js        # 收藏列表
                │   │       ├── add.js            # 添加收藏
                │   │       ├── cancel.js         # 取消收藏
                │   │       ├── check.js         # 检查收藏状态
                │   │       └── getCount.js      # 收藏数量
                │   │
                │   ├── ysjl-footprint/     # 足迹服务
                │   │   └── kh/
                │   │       ├── add.js            # 添加足迹
                │   │       ├── delete.js         # 删除足迹
                │   │       └── getList.js        # 浏览足迹
                │   │
                │   ├── ysjl-feedback/      # 反馈服务
                │   │   └── kh/
                │   │       ├── submit.js         # 提交反馈
                │   │       └── getMyList.js      # 我的反馈
                │   │
                │   ├── ysjl-recharge/      # 充值服务
                │   │   └── kh/
                │   │       ├── getWalletInfo.js  # 钱包信息
                │   │       ├── createOrder.js    # 创建充值订单
                │   │       └── paySuccess.js     # 支付成功确认
                │   │
                │   ├── ysjl-logistics/     # 物流服务
                │   │   └── kh/
                │   │       └── query.js          # 物流查询
                │   │
                │   ├── ysjl-quick-entry/   # 快捷入口服务
                │   │   └── pub/
                │   │       └── getList.js        # 快捷入口列表
                │   │
                │   ├── ysjl-balance-log/   # 余额明细服务
                │   │   └── kh/
                │   │       ├── getList.js        # 余额明细列表
                │   │       └── getStatistics.js  # 消费/收入统计
                │   │
                │   ├── ysjl-score-log/     # 积分明细服务
                │   │   └── kh/
                │   │       └── getList.js        # 积分明细列表
                │   │
                │   ├── ysjl-subscribe-msg/ # 订阅消息服务
                │   │   └── kh/
                │   │       ├── getTemplates.js   # 获取模板列表
                │   │       └── subscribe.js      # 订阅消息
                │   │
                │   ├── ysjl-task/          # 任务服务
                │   │   └── kh/
                │   │       ├── getList.js        # 任务列表
                │   │       ├── claim.js          # 领取任务
                │   │       └── report.js         # 上报任务进度
                │   │
                │   ├── ysjl-checkin/       # 签到服务
                │   │   └── kh/
                │   │       ├── checkin.js        # 每日签到
                │   │       └── getInfo.js        # 签到信息
                │   │
                │   └── ysjl-search/        # 搜索服务
                │       └── pub/
                │           ├── addLog.js         # 记录搜索日志
                │           └── getHotList.js     # 热门搜索列表
                │
                └── admin/          # 管理端服务（独立项目）

核心功能模块详解

1. 商品模块

功能概述

商品模块是电商系统的核心，负责商品的展示、搜索、分类、详情查看等功能。

主要功能

商品列表

• 支持多种展示方式：瀑布流、列表、网格
• 分类筛选：一级分类、二级分类
• 品牌筛选：支持多品牌选择
• 排序功能：综合、销量、价格、新品
• 分页加载：上拉加载更多

商品详情

• 商品轮播图：支持图片
• SKU规格选择：多规格组合
• 商品信息：价格、库存、销量、评分
• 图文详情：富文本展示
• 商品评价：用户评价列表
• 推荐商品：相关商品推荐
• 操作按钮：加购、立即购买、收藏、分享

商品搜索

• 关键词搜索：支持模糊搜索
• 搜索历史：本地存储
• 热门搜索：推荐关键词
• 搜索建议：实时联想

数据流转

用户浏览 → 商品列表API → 展示商品
用户点击 → 商品详情API → 展示详情
用户搜索 → 搜索API → 返回结果
用户加购 → 购物车API → 更新购物车

关联模块

• 购物车模块：加入购物车
• 订单模块：立即购买
• 收藏模块：收藏商品
• 评价模块：查看评价
• 分销模块：推广商品

2. 订单模块

功能概述

订单模块管理完整的订单生命周期，从创建到完成的全流程管理。

订单状态流转

待付款(1) → 待发货/待核销(2) → 待收货(3) → 待评价(4) → 已完成(5)
    ↓
  已关闭(0)（用户取消/超时未付款）
    ↓
  退款中/已退款

注：到店自提订单状态为“待核销”，无“待收货”状态

主要功能

订单创建

• 配送方式：快递配送 / 到店自提
• 选择收货地址（快递）/ 显示商家信息（自提）
• 选择优惠券
• 积分抵扣
• 余额抵扣
• 计算运费
• 订单备注

订单支付

• 余额抵扣（可与微信支付组合使用）
• 微信支付（云函数内创建支付单，前端直接拉起）
• 余额全额抵扣时无需调用支付，直接进入待发货

订单管理

• 订单列表：按状态筛选
• 订单详情：完整信息展示
• 订单操作：
  • 取消订单（待付款）
  • 确认收货（待收货）
  • 申请退款（已付款）
  • 取消退款申请
  • 删除订单（已完成/已关闭）
  • 修改收货地址（待发货）

物流追踪

• 物流公司信息
• 物流单号
• 物流轨迹
• 实时更新

订单评价

• 商品评分（1-5星）
• 图文评价
• 匿名评价
• 追加评价

VIP会员权益

• 商品折扣：自动应用会员折扣
• 免运费：满足条件免运费
• 积分返利：确认收货后返积分

数据流转

购物车结算 → 创建订单 → 选择地址/优惠券 → 支付
    ↓
支付成功 → 订单状态更新 → 商家发货
    ↓
物流更新 → 用户确认收货 → 订单完成 → 评价

3. 购物车模块

功能概述

购物车是用户临时存放商品的地方，支持批量管理和结算。

主要功能

商品管理

• 添加商品：选择SKU规格
• 修改数量：增加/减少
• 删除商品：单个/批量删除
• 选择商品：单选/全选
• 失效商品：库存不足/已下架

价格计算

• 商品总价
• 优惠金额
• 运费计算
• 应付金额

结算功能

• 选中商品结算
• 跳转订单确认页
• 库存校验
• 价格校验

数据存储

• 云端存储：购物车数据存储在云数据库 ysjl-cart 表
• 需要登录后才能使用购物车功能

4. 用户中心模块

功能概述

用户中心是用户管理个人信息、订单、资产的统一入口。

主要功能

个人信息

• 头像上传
• 昵称修改
• 手机号绑定
• 邀请码展示

订单管理

• 订单状态统计
• 快捷入口：待付款、待发货、待收货、待评价、退款/售后

资产管理

• 余额：充值、明细
• 积分：签到、任务、消费返利
• 优惠券：领取、使用

常用工具

• 收藏列表
• 浏览足迹
• 收货地址
• 联系客服
• 意见反馈
• 设置中心

业务功能模块详解

1. VIP会员系统

功能概述

VIP会员系统为用户提供增值服务，通过购买会员套餐享受专属权益。

会员权益

• 商品折扣：购买商品享受会员专属折扣
• 免运费：满足条件免运费
• 积分返利：确认收货后额外返还积分
• 极速退款：会员享受优先退款处理

会员套餐

• 由管理端配置，支持自定义套餐名称、时长、价格、原价、徽章等
• 续费规则：未过期累加时长，已过期从当前时间开始计算

数据表设计

• ysjl-vip-config：全局权益配置
• ysjl-vip-plan：会员套餐表
• ysjl-vip-order：会员订单表
• uni-id-users.vip_info：用户会员信息

业务流程

选择套餐 → 创建订单 → 支付 → 开通会员
    ↓
会员生效 → 享受权益 → 到期提醒 → 续费

2. 分销系统（二级分销）

功能概述

二级分销系统允许用户通过推广商品赚取佣金，支持一级和二级下线。

分销层级

• 一级下线：直接邀请的用户
• 二级下线：一级下线邀请的用户

佣金规则

• 一级佣金：一级下线购买商品，获得一级佣金比例
• 二级佣金：二级下线购买商品，获得二级佣金比例
• 佣金计算：订单确认收货后记录佣金（待结算），经过配置的结算天数后自动转为可提现

主要功能

分销中心

• 数据概览：今日佣金、本月佣金、累计佣金
• 团队统计：一级人数、二级人数、总人数
• 邀请码：专属邀请码

团队管理

• 一级下线列表
• 二级下线列表
• 成员信息：昵称、注册时间、订单数

佣金管理

• 佣金明细：收入记录
• 提现申请：最低提现金额
• 提现记录：提现状态、到账时间
• 银行卡绑定：提现账户

数据表设计

• ysjl-distribution-config：分销配置
• ysjl-commission-log：佣金明细
• ysjl-withdraw-log：提现记录
• uni-id-users.inviter_uid：邀请关系（数组：[一级邀请人, 二级邀请人]）

业务流程

用户注册 → 分享邀请链接 → 用户通过链接登录/注册 → 自动绑定邀请关系
    ↓
下线购买 → 订单完成 → 计算佣金 → 佣金到账
    ↓
申请提现 → 审核 → 打款 → 提现完成

说明：邀请链接不限制是否为新用户，老用户也可以通过链接绑定邀请关系。

3. 优惠券系统

功能概述

优惠券系统为用户提供多种优惠方式，提升用户购买意愿。

优惠券类型

• 满减券：满X元减Y元
• 折扣券：X折优惠
• 无门槛券：直接抵扣

使用规则

• 使用条件：满足金额门槛
• 适用范围：全场通用/指定分类/指定商品
• 有效期：领取后X天内有效
• 使用限制：每单限用一张

主要功能

领券中心

• 可领取优惠券列表
• 优惠券详情
• 一键领取
• 领取限制：每人限领X张

我的优惠券

• 未使用：可用优惠券
• 已使用：使用记录
• 已过期：过期优惠券

订单使用

• 自动匹配可用优惠券
• 优惠金额计算
• 优惠券选择

优惠券分享

• 分享优惠券给好友
• 好友通过分享链接领取
• 分享记录追踪

数据表设计

• ysjl-coupon：优惠券模板
• ysjl-user-coupon：用户优惠券
• ysjl-coupon-share：优惠券分享记录

4. 任务系统

功能概述

任务系统通过完成任务获得奖励，提升用户活跃度。

任务类型

• 每日签到：连续签到获得积分
• 浏览商品：浏览指定数量商品
• 分享商品：分享商品到朋友圈
• 完成订单：完成购买获得奖励
• 邀请好友：邀请新用户注册

奖励类型

• 积分奖励
• 优惠券奖励
• 余额奖励

主要功能

任务列表

• 任务名称
• 任务描述
• 奖励内容
• 完成进度
• 任务状态：未完成/已完成/已领取

任务完成

• 自动检测完成条件
• 领取奖励
• 奖励发放

签到功能

• 每日签到
• 连续签到奖励
• 签到日历

数据表设计

• ysjl-task-config：任务配置
• ysjl-task-progress：用户任务进度
• ysjl-checkin-config：签到配置
• ysjl-checkin-log：签到记录

5. 营销活动系统

秒杀活动

• 限时特惠商品列表
• 秒杀专属标签展示
• 瀑布流/列表双模式切换
• 分享邀请码推广

新品首发

• 新品商品筛选展示
• 新品标识标签
• 瀑布流/列表双模式切换

每日福利

• 福利商品筛选展示
• 福利专属标签
• 瀑布流/列表双模式切换

业务流程图

1. 用户购物流程

graph TD
    A[用户进入小程序] --> B{是否登录}
    B -->|未登录| C[浏览商品]
    B -->|已登录| C
    C --> D[查看商品详情]
    D --> E[选择SKU规格]
    E --> F{操作选择}
    F -->|加入购物车| G[购物车]
    F -->|立即购买| H[订单确认页]
    G --> I[购物车结算]
    I --> H
    H --> J[选择配送方式]
    J --> K[选择地址/查看商家信息]
    K --> L[选择优惠券/积分/余额抵扣]
    L --> M[提交订单]
    M --> N{是否需要支付}
    N -->|余额全额抵扣| O[直接进入待发货]
    N -->|需要支付| P[微信支付]
    P --> Q{支付结果}
    Q -->|成功| O
    Q -->|取消/失败| R[待付款订单]
    O --> S[商家发货/待核销]
    S --> T[用户确认收货/扫码核销]
    T --> U[评价商品]
    U --> V[订单完成]

2. 分销业务流程（二级分销）

graph TD
    A[用户A注册] --> B[获得邀请码]
    B --> C[分享邀请链接]
    C --> D[用户B通过链接登录/注册]
    D --> E[自动绑定一级邀请关系]
    E --> F[用户B分享邀请链接]
    F --> G[用户C通过链接登录/注册]
    G --> H[自动绑定二级邀请关系]
    H --> I{下线购买商品}
    I -->|用户B购买| J[用户A获得一级佣金]
    I -->|用户C购买| K[用户A获得二级佣金]
    K --> L[用户B获得一级佣金]
    J --> M[订单确认收货]
    L --> M
    M --> N[佣金结算]
    N --> O[佣金到账]
    O --> P[申请提现]
    P --> Q[审核提现]
    Q --> R{审核结果}
    R -->|通过| S[打款]
    R -->|拒绝| T[驳回]
    S --> U[提现完成]

3. VIP会员流程

graph TD
    A[用户进入会员中心] --> B[查看会员套餐]
    B --> C[选择套餐]
    C --> D[创建会员订单]
    D --> E[支付订单]
    E --> F{支付结果}
    F -->|成功| G[开通会员]
    F -->|失败| H[返回重新支付]
    G --> I[会员生效]
    I --> J[享受会员权益]
    J --> K{购买商品}
    K --> L[自动应用会员折扣]
    L --> M[免运费判断]
    M --> N[订单完成]
    N --> O[积分返利]
    O --> P{会员到期}
    P -->|未到期| J
    P -->|已到期| Q[会员失效]
    Q --> R[续费提醒]
    R --> C

4. 订单状态流转图

stateDiagram-v2
    [*] --> 待付款 : 创建订单
    [*] --> 待发货 : 余额全额抵扣
    待付款 --> 已关闭 : 用户取消/超时30分钟
    待付款 --> 待发货 : 支付成功(快递)
    待付款 --> 待核销 : 支付成功(自提)
    待发货 --> 待收货 : 商家发货
    待发货 --> 退款中 : 申请退款
    待核销 --> 待评价 : 扫码核销
    待收货 --> 待评价 : 确认收货
    待收货 --> 退款中 : 申请退货退款
    退款中 --> 已退款 : 退款成功
    退款中 --> 待收货 : 退款拒绝
    待评价 --> 已完成 : 评价完成
    待评价 --> 已完成 : 超时自动完成
    已完成 --> [*]
    已关闭 --> [*]
    已退款 --> [*]

功能关联图

系统模块关联关系

graph TB
    subgraph 用户端
        A[首页模块] --> B[商品模块]
        A --> C[分类模块]
        A --> D[购物车模块]
        A --> E[用户中心]

        B --> F[商品详情]
        B --> G[商品搜索]
        F --> D
        F --> H[订单模块]

        D --> H
        H --> I[支付模块]
        I --> J[物流模块]

        E --> K[订单管理]
        E --> L[资产管理]
        E --> M[地址管理]
        E --> N[收藏/足迹]

        K --> H
        L --> O[VIP会员]
        L --> P[钱包充值]
        L --> Q[优惠券]

        E --> R[分销中心]
        R --> S[团队管理]
        R --> T[佣金管理]
        R --> U[提现管理]

        E --> V[任务系统]
        V --> W[签到]
        V --> X[任务奖励]
    end

    subgraph 营销系统
        Y[秒杀活动] --> B
        Z[新品首发] --> B
        AA[每日福利] --> B
        Q --> H
    end

    subgraph 支付系统
        I --> AB[微信支付]
        I --> AD[余额抵扣]
    end

数据库设计

核心数据表

用户相关

• uni-id-users：用户表（扩展字段：vip_info、inviter_uid、account_balance、account_integral）
• ysjl-address：收货地址表

商品相关

• ysjl-goods：商品表
• ysjl-goods-sku：商品SKU规格表
• ysjl-category：分类表
• ysjl-brand：品牌表

订单相关

• ysjl-order：订单表（含goods_list商品列表）

VIP会员相关

• ysjl-vip-config：会员权益配置表
• ysjl-vip-plan：会员套餐表
• ysjl-vip-order：会员订单表

分销相关（二级分销）

• ysjl-distribution-config：分销配置表
• ysjl-commission-log：佣金明细表
• ysjl-withdraw-log：提现记录表

营销相关

• ysjl-coupon：优惠券模板表
• ysjl-user-coupon：用户优惠券表
• ysjl-coupon-share：优惠券分享表
• ysjl-banner：Banner配置表
• ysjl-quick-entry：快捷入口配置表

任务相关

• ysjl-task-config：任务配置表
• ysjl-task-progress：用户任务进度表
• ysjl-checkin-config：签到配置表
• ysjl-checkin-log：签到记录表

其他

• ysjl-cart：购物车表
• ysjl-collect：收藏表
• ysjl-footprint：浏览足迹表
• ysjl-review：商品评价表
• ysjl-review-reply：评价回复表
• ysjl-feedback：意见反馈表
• ysjl-balance-log：余额明细表
• ysjl-score-log：积分明细表
• ysjl-recharge-plan：充值套餐表
• ysjl-recharge-order：充值订单表
• ysjl-search-log：搜索记录表
• ysjl-subscribe-template：订阅消息模板表
• ysjl-subscribe-auth：订阅消息授权表
• ysjl-subscribe-log：订阅消息发送记录表

数据表命名规范

• 所有自定义表使用 ysjl- 前缀（版权保护）
• 金额字段统一使用分为单位（整数）
• 时间字段统一使用时间戳（毫秒）
• 自动添加 _add_time（创建时间）和 _add_time_str（格式化时间）

部署说明

环境要求

• Node.js >= 14.x
• HBuilderX（推荐最新版）
• 微信开发者工具
• uniCloud 支付宝云空间

部署步骤

一、uniCloud 服务空间

涉及文件：

• 聚云优选用户端/uni_modules/uni-config-center/uniCloud/cloudfunctions/common/uni-config-center/uni-pay/config.js → notifyUrl 对象中的 key 和 value 都要改为新空间 ID 和新 URL 化地址

二、微信小程序配置

涉及文件（共 3 处，需保持一致）：

1. 用户端 manifest.json

   • 聚云优选用户端/manifest.json → mp-weixin.appid

2. uni-id 配置

   • 聚云优选用户端/uni_modules/uni-config-center/uniCloud/cloudfunctions/common/uni-config-center/uni-id/config.json
   • → mp-weixin.oauth.weixin.appid 和 mp-weixin.oauth.weixin.appsecret

3. uni-pay 支付配置

   • 聚云优选用户端/uni_modules/uni-config-center/uniCloud/cloudfunctions/common/uni-config-center/uni-pay/config.js
   • → wxpay.mp.appId 和 wxpay.mp.secret

三、微信支付配置

涉及文件：

• 聚云优选用户端/uni_modules/uni-config-center/uniCloud/cloudfunctions/common/uni-config-center/uni-pay/config.js → wxpay.mp 节点

证书文件（需替换为新商户的证书）：

• uni-pay/wxpay/apiclient_cert.p12
• uni-pay/wxpay/apiclient_cert.pem
• uni-pay/wxpay/apiclient_key.pem
• uni-pay/wxpay/pub_key.pem（微信支付公钥，如有）

以上证书目录：聚云优选用户端/uni_modules/uni-config-center/uniCloud/cloudfunctions/common/uni-config-center/uni-pay/wxpay/

四、支付宝支付配置（当前为空，如需启用需填写）

证书目录：

• uni-pay/alipay/appCertPublicKey.crt
• uni-pay/alipay/alipayCertPublicKey_RSA2.crt
• uni-pay/alipay/alipayRootCert.crt

涉及文件：

• uni-pay/config.js → alipay 节点
• uni-id/config.json → mp-alipay.oauth.alipay

五、支付回调通信密钥

涉及文件：

• uni-pay/config.js → notifyKey
• 当前值：``

六、uni-id 安全密钥

涉及文件：

• uni-id/config.json 根级字段

⚠️ 重要：如果是带用户数据迁移，passwordSecret 不能改，否则所有用户密码失效。如果是全新项目，建议生成新的随机密钥。

七、vk-unicloud 服务端配置

涉及文件： 聚云优选用户端/uni_modules/uni-config-center/uniCloud/cloudfunctions/common/uni-config-center/vk-unicloud/index.js

7.1 加密密钥

7.2 扩展存储（七牛云）

绑定扩展存储并更换域名。页面中大量图片引用了 https://cdn.juleai.cn/static-all/...，如果更换 CDN 域名需要全局替换。

7.3 默认 context

八、uni-id 第三方登录（当前大部分为空，按需配置）

涉及文件： uni-id/config.json

九、DCloud 应用标识

在 HBuilderX 中重新获取 AppID 或填入已有的 AppID。

十、管理端特有配置

10.1 app.config.js

十一、应用名称与品牌

十二、第三方 API 密钥

12.1 快递 100 物流查询

这两个值存在数据库配置表中，通过管理端"系统配置"页面修改，迁移数据库后自动带过去。

十三、数据库配置表（运行时配置）

数据库 ysjl-config 表存储以下运行时配置，迁移数据库后需检查：

十四、CDN 静态资源域名

当前大量页面硬编码了 https://cdn.juleai.cn/static-all/... 的图片资源 URL。

影响范围： 约 20+ 个 .vue 源文件（不含编译产物）

迁移方案（二选一）：

1. 保留域名：将新空间的扩展存储绑定到 cdn.juleai.cn，确保资源可访问
2. 更换域名：全局搜索替换 cdn.juleai.cn 为新域名，并将 static-all 目录下的资源迁移到新存储

十五、定时任务

定时任务通过 uniCloud 控制台配置触发器，迁移后需在新空间重新配置：

需在 uniCloud 控制台为 router 云函数重新配置定时触发器。

十六、数据库

迁移时需导出/导入以下数据库集合：

系统表

• uni-id-users、uni-id-roles、uni-id-permissions、uni-id-log
• opendb-admin-menus、opendb-admin-log
• opendb-app-list、opendb-app-versions
• opendb-verify-codes、opendb-tempdata、opendb-open-data
• opendb-city-china
• uni-pay-orders

vk 框架表

• vk-global-data、vk-error-log、vk-files、vk-files-categories
• vk-components-dynamic、vk-pay-orders、vk-pay-config
• vk-ws-connection、vk-lucky-draw-activity

业务表（ysjl- 前缀，共35张）

• ysjl-config（系统配置）
• ysjl-goods、ysjl-goods-sku、ysjl-category、ysjl-brand（商品/SKU/分类/品牌）
• ysjl-order（订单，商品列表内嵌在 goods_list 字段中）
• ysjl-cart、ysjl-collect、ysjl-footprint（购物车/收藏/足迹）
• ysjl-address（收货地址）
• ysjl-banner、ysjl-quick-entry（轮播/快捷入口）
• ysjl-coupon、ysjl-user-coupon、ysjl-coupon-share（优惠券模板/用户优惠券/分享）
• ysjl-distribution-config、ysjl-commission-log、ysjl-withdraw-log（分销配置/佣金/提现）
• ysjl-vip-config、ysjl-vip-plan、ysjl-vip-order（会员）
• ysjl-recharge-plan、ysjl-recharge-order（充值）
• ysjl-balance-log、ysjl-score-log（余额明细/积分明细）
• ysjl-task-config、ysjl-task-progress（任务系统）
• ysjl-checkin-config、ysjl-checkin-log（签到配置/签到记录）
• ysjl-review、ysjl-review-reply（评价/评价回复）
• ysjl-feedback（反馈）
• ysjl-search-log（搜索记录）
• ysjl-subscribe-template、ysjl-subscribe-auth、ysjl-subscribe-log（订阅消息）

迁移后需上传 database/ 目录下的 .schema.json 和 .index.json 文件以创建索引和校验规则。

十七、迁移操作检查清单

• [ ] 创建新 uniCloud 服务空间并关联项目
• [ ] 修改微信小程序 AppID + AppSecret（3 处）
• [ ] 修改微信支付商户号 + 密钥 + 替换证书
• [ ] 修改支付回调 URL（notifyUrl）
• [ ] 修改 uni-id 密钥（passwordSecret / tokenSecret）
• [ ] 修改 vk-unicloud 加密密钥（crypto.aes）
• [ ] 修改支付通信密钥（notifyKey）
• [ ] 配置扩展存储域名（cdn.juleai.cn 或新域名）
• [ ] 配置邮箱/短信服务密钥（如需）
• [ ] 修改 DCloud AppID（用户端 + 管理端）
• [ ] 修改应用名称和品牌信息
• [ ] 导出/导入数据库集合
• [ ] 上传数据库 schema 和索引
• [ ] 上传云函数并配置定时触发器
• [ ] 配置数据库 ysjl-config 表中的运行时参数
• [ ] 清理 unpackage/ 编译产物，重新编译
• [ ] 配置快递 100 Key（数据库 ysjl-config 表）
• [ ] 测试支付流程、登录流程、物流查询

编译运行

• 使用 HBuilderX 编译到微信小程序
• 使用微信开发者工具预览

注意事项

• 部分自定义内容使用 ysjl- 前缀（版权保护）
• 云函数配置通过 uni-config-center 统一管理（非环境变量）
• 支付功能需要配置微信支付密钥和证书
• 生产环境需关闭调试模式和测试账号

开发规范

命名规范

• SCSS变量：$ysjl-xxx
• 组件名：ysjl-xxx（kebab-case）
• JS函数：ysjl_xxx
• CSS类名：ysjl-xxx

代码规范

• 使用 vk 框架 API，不直接使用 uni.xxx
• 提示统一使用 vk.toast()
• 请求统一设置 needAlert: false
• 云函数统一使用 vk.callFunction()

版权保护

项目所有自定义内容（组件、函数、样式、数据表）均使用 ysjl- 前缀，用于版权保护和代码混淆。

项目特色

1. 完整的电商功能：涵盖商品、订单、支付、物流、评价等完整流程
2. 二级分销系统：支持用户推广赚取佣金，自动结算+提现
3. VIP会员体系：商品折扣、免运费、积分返利、极速退款
4. 钱包充值系统：充值赠送、余额抵扣、消费/收入统计
5. 任务系统：签到、任务奖励、提升用户活跃度
6. 营销活动：秒杀、新品、福利、优惠券分享
7. 多配送方式：快递配送 + 到店自提核销
8. 订阅消息：支持微信订阅消息推送（签到提醒等）
9. Serverless架构：基于 uniCloud，无需服务器运维
10. 版权保护：所有自定义内容使用 ysjl- 统一前缀

技术支持

如有问题，请通过以下方式联系：

• 项目文档：查看项目内文档
• 技术支持：联系开发团队
• WX：wx83695
• ***(不常在线)

海口美兰云上聚乐科技中心 © 2026 版权所有