微信小程序商城 Ushopun（优社云 V2）开发规范

> 本 Skill 定位：微信小程序商城前端开发工具，基于 Ushopun 官方 miniProgramV2 真实项目提炼，聚焦「首页 → 分类 → 详情 → 购物车 → 结算 → 订单 → 个人中心」完整交易闭环，并原生对接 Ushopun 后端 OpenAPI。
>
> 后端数据源：dev.ushopun.com（优社云 OpenAPI，openapi.json 为接口权威文档）。接口前缀统一为 /api/v2，返回体统一为 { code, content, data, success }，鉴权通过请求头 guid（用户 GUID）+ authorization（JWT Token）+ shopId（店铺/自提点）完成。
>
> 示例站点：正式对接前，请先在 https://dev.ushopun.com 示例站点 / 后台开通对应模块并确认接口可达（域名、鉴权、模块开关）。本 Skill 不负责引导付款，付款与账号开通请直接联系优社云AI官方。
>
> 连接器 ApiToken（Agent 前置授权）：本 Skill 被 workbuddy / trae 等 AI Agent 使用时，Agent 需先引导用户到 ushopun.com 登录账号 → 在后台/控制台创建连接器并复制「连接器 ApiToken」→ 提供给 Agent，用于读取接口文档、验证字段或联调。该凭证为租户级敏感凭证，禁止写死进生成的小程序源码，仅通过配置占位符/环境变量承载。

技术栈

• 框架：原生微信小程序（不使用 Taro / uni-app）
• API 层：自封装请求模块（api/api.js + api/conf.js）
• 鉴权：Header 携带 guid（用户标识）+ authorization（JWT Token）+ shopId（店铺/自提点）
• 样式：WXSS，尺寸单位 rpx（750rpx = 屏幕宽度），图标用 iconfont
• 富文本：wxParse 组件（商品详情 full 字段 HTML 渲染）
• 主题色：#950000（Ushopun 品牌深红），导航栏白字标题「Ushopun商城」

项目目录结构（miniProgramV2）

miniProgramV2/
├── api/
│   ├── conf.js          # 所有 API 端点常量（统一管理，禁止硬编码 URL）
│   └── api.js           # HTTP 请求封装（自动注入 guid/token/shopId）
├── pages/               # 业务页面（每页 .js/.wxml/.wxss/.json 四件套）
│   ├── index/           # 首页（轮播、分类入口、热卖推荐、优惠券弹窗）
│   ├── category/        # 一级分类 + 二级分类
│   ├── subcategory/     # 分类商品列表（触底加载）
│   ├── detail/          # 商品详情（SKU 联动、收藏、加购、立即购买）
│   ├── search/          # 搜索
│   ├── cart/            # 购物车（全选/单选、数量加减、结算）
│   ├── checkout/        # 结算/提交订单（地址、优惠券、支付方式）
│   ├── checkoutdetail/  # 订单详情
│   ├── order/           # 订单（分状态）
│   ├── orderList/       # 订单列表（Tab 切换）
│   ├── payFinish/       # 支付成功
│   ├── my/              # 个人中心
│   ├── login/           # 账号密码登录
│   ├── souquan/         # 微信授权登录引导
│   ├── address/         # 地址管理
│   ├── address-edit/    # 地址编辑
│   ├── collect/         # 收藏夹
│   ├── comment/         # 商品评价
│   ├── commentDetail/   # 评价详情
│   ├── mycomment/       # 我的评价
│   ├── available_coupon/  # 可用优惠券
│   ├── youhuijuan/      # 优惠券中心
│   ├── usedcunpond/     # 优惠券（已使用）
│   ├── point/           # 积分
│   ├── recharge/        # 充值
│   ├── rechargeList/    # 充值记录
│   ├── cashout/         # 提现
│   ├── distribution/    # 分销中心
│   ├── dividend/        # 分红明细
│   ├── bonusDetail/     # 奖金明细
│   ├── myCustomer/      # 我的客户
│   ├── myinvitre/       # 我的邀请
│   ├── partner/         # 合伙人
│   ├── saleOrder/       # 销售订单
│   ├── salePage/        # 销售页
│   ├── returnrequests/  # 退换货申请
│   ├── returndetail/    # 退货详情
│   ├── wuliuxinxi/      # 物流信息
│   ├── platform/        # 平台页
│   ├── supplier/        # 供应商
│   ├── options/         # 分店/自提点选择
│   ├── sharepage/       # 分享推广页
│   ├── question/        # 常见问题
│   ├── questionList/    # 问题列表
│   ├── welcome/         # 欢迎页
│   ├── warrant/         # 授权/售后
│   ├── idcar/           # 身份证
│   ├── pwdset/          # 密码设置
│   └── logs/            # 日志/调试
├── templates/           # 可复用 WXML 模板（swiper/product-view/order-state/my-view 等）
├── style/               # 公共样式（color/template/iconfont/weui/empower）
├── utils/util.js        # 工具函数
├── libs/                # 第三方库（qqmap-wx-jssdk.min.js）
├── wxParse/             # 富文本解析
├── data/                # 静态数据（省市区等）
├── images/              # 图片资源
├── app.js               # 应用入口（globalData + onLaunch）
├── app.json             # 应用配置（页面路由、TabBar、窗口样式）
└── app.wxss             # 全局样式入口

一、API 对接规范

1.1 基础配置

// app.js globalData
globalData: {
  host: 'https://dev.ushopun.com/api',   // 后端 API 基础地址（已含 /api，生产可替换租户域名）
  // 本地调试：http://localhost:5136/api
  token: '',                              // 登录后写入的 JWT Token
  guid: '',                               // 登录后写入的用户 GUID
  customer: null                          // 当前用户信息
}

> conf.js 中的端点以 /v2/... 开头，api.js 通过 host + url 拼接出完整地址 https://dev.ushopun.com/api/v2/...。

1.2 统一返回结构（camelCase）

{ "code": 200, "content": "请求成功！", "data": { }, "success": true }

> 特殊：/account/checkaccount 接口 code 为 1（可用）/0（已存在），非标准码，需单独处理。

1.3 鉴权机制

鉴权标记（对应后端控制器标注）：

1.4 api.js — 请求封装（核心）

// api/api.js
const app = getApp()

const request = (url, options) => {
  return new Promise((resolve, reject) => {
    const fullUrl = `${app.globalData.host}${url}`  // host 已含 /api，url 以 /v2 开头

    let shopId = 0
    if (wx.getStorageSync('adress')) {
      shopId = wx.getStorageSync('adress').id
    }

    wx.request({
      url: fullUrl,
      method: options.method,
      data: options.method === 'GET' ? options.data : JSON.stringify(options.data),
      header: {
        'Content-Type': 'application/json; charset=UTF-8',
        guid: wx.getStorageSync('guid') || '',
        authorization: wx.getStorageSync('token') || '',
        shopId
      },
      success(request) {
        const res = request.data || {}
        if (res.code === 200) {
          resolve(res)          // 成功，调用方取 res.data
        } else if (res.code === 401) {
          wx.removeStorageSync('token')
          wx.removeStorageSync('guid')
          wx.navigateTo({ url: '/pages/login/login' })
          reject(res)
        } else {
          reject(res)           // 250 业务警告 / 404 等，调用方用 content 提示
        }
      },
      fail(error) {
        wx.showToast({ title: '网络异常，请稍后重试', icon: 'none' })
        reject(error)
      }
    })
  })
}

const get    = (url, options = {}) => request(url, { method: 'GET',    data: options })
const post   = (url, options)      => request(url, { method: 'POST',   data: options })
const put    = (url, options)      => request(url, { method: 'PUT',    data: options })
const remove = (url, options)      => request(url, { method: 'DELETE', data: options })

module.exports = { get, post, put, remove }

1.5 页面调用模式

import api from '../../api/api'
import { productId, orderList } from '../../api/conf'

Page({
  data: { model: {}, list: [] },
  onLoad(options) {
    // GET 调用
    api.get(productId, { id: options.id })
      .then(res => this.setData({ model: res.data }))
      .catch(err => wx.showToast({ title: err.content || '加载失败', icon: 'none' }))

    // POST 调用
    api.post(orderList, { orderstatus: 0, page: 1 })
      .then(res => this.setData({ list: res.data.items }))
      .catch(err => wx.showToast({ title: err.content || '加载失败', icon: 'none' }))
  }
})

二、完整接口清单（按业务模块，含每个方法的调用方式）

> 下表均来自 openapi.json（dev.ushopun.com 真实后端 V2），路径前缀统一 /api/v2。「鉴权」列：✔ = 必须登录（[ApiAuthorize]），○ = 匿名可访问（[ApiAuthorize(false)]），- = 公开。所有接口统一用 api.get(conf.xxx, params) / api.post(conf.xxx, data) 调用。

2.1 账号 Account（前缀 /api/v2/account）

调用示例：

// 账号密码登录
api.post(login, { name: '13800138000', password: '123456' })
  .then(res => {
    // res.data = { guid, token, nickname }
    wx.setStorageSync('guid', res.data.guid)
    wx.setStorageSync('token', res.data.token)
  })

// 注册（先发验证码）
api.post(sendsmsforregister, { phone: '13800138000' })
api.post(register, { phone: '13800138000', password: '123456', token: '短信码', inviteCode: '邀请码' })

2.2 微信授权登录 / 注册（前缀 /api/v2/weixinopen）

微信登录流程：

// 1. wx.login 获取 code → 微信授权登录
api.get(weixinminilogin, { code, state, encryptedData, iv })
  .then(res => {
    wx.setStorageSync('guid', res.data.guid)
    wx.setStorageSync('token', res.data.token)
    wx.setStorageSync('openId', res.data.openId)
  })

// 2. 绑定手机号（open-type="getPhoneNumber"）
api.get(weixinminiphone, { code, encryptedData, iv })
  .then(res => wx.setStorageSync('phone', res.data.phone))

2.3 用户 Customer（前缀 /api/v2/customer，类级 ✔）

2.4 地址 Address（前缀 /api/v2/address，类级 ✔）

2.5 商品 Product（前缀 /api/v2/product）

调用示例：

api.get(productId, { id: 123 }).then(res => this.setData({ product: res.data }))
api.get(homePro, { picsize: 200 }).then(res => this.setData({ products: res.data }))
api.get(getproductattr, { pId: 123 }).then(res => this.setData({ attrs: res.data.attrs, tables: res.data.tables }))

2.6 分类 / 品牌 / 搜索

Category（/api/v2/category）

Brand（/api/v2/brand）

Search（/api/v2/search）

2.7 购物车 ShoppingCart（前缀 /api/v2/shoppingcart，类级 ✔）

调用示例：

api.get(getShoppingcart).then(res => this.setData({ cart: res.data }))
api.post(producttocart, { pId: 123, qty: 1, attrValue: 'combination_1_2' })
api.post(updatecartitem, { id: 1, quantity: 2, selected: true })
api.get(cartCount).then(res => this.setData({ count: res.data }))

2.8 结算 Checkout（前缀 /api/v2/checkout，类级 ✔）

2.9 订单 Order（前缀 /api/v2/order，类级 ✔）

2.10 支付（Plugin / WeixinOpenPayment）

Plugin（/api/v2/plugin）

WeixinOpenPayment（/api/v2/weixinopenpayment）

支付对接流程：

api.get(weixinopenpaymenturl, { orderId: 123, paytype: 'Order' }).then(res => {
  const p = res.data  // MoPayment 含支付参数
  wx.requestPayment({
    timeStamp: p.timeStamp, nonceStr: p.nonceStr,
    package: p.package, signType: p.signType, paySign: p.paySign,
    success() { /* 支付成功 */ },
    fail() { /* 支付失败 */ }
  })
})

2.11 优惠券 / 积分 / 钱包 / 充值卡

Coupon（/api/v2/coupon）

PointsExchange（/api/v2/pointsexchange，类级 ✔）

Wallet（/api/v2/wallet，类级 ✔）

RechargeCard（/api/v2/rechargecard）

RechargeCardItem（/api/v2/rechargecarditem）

2.12 分销代理 Agents（前缀 /api/v2/agents，类级 ✔）

2.13 评价 Review（前缀 /api/v2/productreview）

2.14 收藏 Favorites（前缀 /api/v2/favorites，类级 ✔）

2.15 通用 Common（前缀 /api/v2/common）

2.16 内容资讯（Topic / News / Blog）

Topic（/api/v2/topic）

News（/api/v2/news）

Blog（/api/v2/blog）

2.17 消息 / 物流 / 其他营销

PM（/api/v2/pm，类级 ✔）

Shipping（/api/v2/shipping）

Kdniao（/api/v2/kdniao）

Seckill（/api/v2/seckill）

PinTuan（/api/v2/pintuan）

SignIn（/api/v2/signin，类级 ✔）

Task（/api/v2/task，类级 ✔）

Share（/api/v2/share，类级 ✔）

PreOrder（/api/v2/preorder，类级 ✔）

TierPrice（/api/v2/tierprice，类级 ✔）

Bundle（/api/v2/bundle）

Page（/api/v2/page）

AuthWeixinMini（/api/v2/authweixinmini）

三、完整 conf.js 端点常量清单

> 所有端点均不含 /api 前缀（由 api.js 拼接，host 已含 /api），端点以 /v2/... 开头，直接复制即可对接全部后端接口。

// ============ 账号 Account ============
const login               = '/v2/account/login'
const online              = '/v2/account/online'
const logout              = '/v2/account/logout'
const register            = '/v2/account/register'
const sendsmsforregister  = '/v2/account/sendsmsforregister'
const chanagepwd          = '/v2/account/chanagepwd'
const sendsmsforfindpwd   = '/v2/account/sendsmsforfindpwd'
const pwdset              = '/v2/account/pwdset'
const checkaccount        = '/v2/account/checkaccount'

// ============ 微信授权 WeixinOpen ============
const weixinminilogin     = '/v2/weixinopen/login'
const weixinminiphone     = '/v2/weixinopen/phonenumber'
const weixininfosubmit    = '/v2/weixinopen/customer_nextstep'

// ============ 用户 Customer ============
const getcustomer         = '/v2/customer/get'
const customerinfo        = '/v2/customer/info'
const customersubmit      = '/v2/customer/submit'
const customerpoints      = '/v2/customer/points'
const uploadavatar        = '/v2/customer/uploadavatar'
const checkshop           = '/v2/customer/checkshop'
const myinvitecode        = '/v2/customer/myinvitecode'
const myinvitees          = '/v2/customer/myinvitees'

// ============ 地址 Address ============
const addressList         = '/v2/address/list'
const addressdelete       = '/v2/address/delete'
const addressadd          = '/v2/address/add'
const addressdefault      = '/v2/address/default'
const addressedit         = '/v2/address/edit'

// ============ 商品 Product ============
const featuredbycid       = '/v2/product/featuredbycid'
const homePro             = '/v2/product/homeproducts'
const specialproducts     = '/v2/product/specialproducts'
const alsopurchased       = '/v2/product/alsopurchased'
const taglist             = '/v2/product/taglist'
const productbytag        = '/v2/product/getbytag'
const getproductattr      = '/v2/product/getproductattr'
const getproductspec      = '/v2/product/getproductspec'
const productId           = '/v2/product/getbyid'
const productbysku        = '/v2/product/getbysku'
const productpost         = '/v2/product/post'

// ============ 分类 / 品牌 / 搜索 ============
const homecategories      = '/v2/category/homecategories'
const categoryget         = '/v2/category/get'
const category            = '/v2/category/sublist'
const brandlist           = '/v2/brand/list'
const brandfeaturelist    = '/v2/brand/featurelist'
const brandget            = '/v2/brand/get'
const brandfeaturedproducts = '/v2/brand/featuredproducts'
const search              = '/v2/search/find'
const searCate            = '/v2/search/findbycid'
const findbymid           = '/v2/search/findbymid'
const findbyoid           = '/v2/search/findbyoid'
const hotcategory         = '/v2/search/hotcategory'
const hotsearch           = '/v2/search/hot'
const searchhistory       = '/v2/search/history'

// ============ 购物车 ShoppingCart ============
const getShoppingcart     = '/v2/shoppingcart/get'
const cartCount           = '/v2/shoppingcart/count'
const producttocart       = '/v2/shoppingcart/producttocart'
const productstocart      = '/v2/shoppingcart/productstocart'
const producttocheckout   = '/v2/shoppingcart/producttocheckout'
const cartallselected     = '/v2/shoppingcart/cartallselected'
const updatecartitem      = '/v2/shoppingcart/updatecartitem'
const removecartitem      = '/v2/shoppingcart/removecartitem'
const removecart          = '/v2/shoppingcart/removecart'
const wishlist            = '/v2/shoppingcart/wishlist'
const removewishlistitem  = '/v2/shoppingcart/removewishlistitem'
const iscollect           = '/v2/shoppingcart/iscollect'
const towishlist          = '/v2/shoppingcart/towishlist'
const tocheckout          = '/v2/shoppingcart/tocheckout'

// ============ 结算 Checkout ============
const checkminsubtotal    = '/v2/checkout/checkminsubtotal'
const getcheckout         = '/v2/checkout/get'
const getpaymentmethod    = '/v2/checkout/getpaymentmethod'
const getshippingmethod   = '/v2/checkout/getshippingmethod'
const submitcheckout      = '/v2/checkout/submit'
const quicksubmit         = '/v2/checkout/quicksubmit'

// ============ 订单 Order ============
const returnrequests      = '/v2/order/returnrequests'
const returnpost          = '/v2/order/returnpost'
const orderList           = '/v2/order/list'
const orderDetail         = '/v2/order/detail'
const orderconfirm        = '/v2/order/complete'
const orderdeliver        = '/v2/order/deliver'
const ordercancel         = '/v2/order/cancel'

// ============ 支付 Plugin / WeixinOpenPayment ============
const weixinwaploginenabled    = '/v2/plugin/weixinwaploginenabled'
const weixinwaploginurl        = '/v2/plugin/weixinwaploginurl'
const weixinopenloginenabled   = '/v2/plugin/weixinopenloginenabled'
const weixinopenlogin          = '/v2/plugin/weixinopenlogin'
const weixinopenphonenumber    = '/v2/plugin/weixinopenphonenumber'
const weixinwappaymentenabled  = '/v2/plugin/weixinwappaymentenabled'
const weixinwapaymenturl       = '/v2/plugin/weixinwapaymenturl'
const weixinopenpaymentenabled = '/v2/plugin/weixinopenpaymentenabled'
const weixinopenpaymenturl     = '/v2/plugin/weixinopenpaymenturl'
const alipaywappaymentenabled  = '/v2/plugin/alipaywappaymentenabled'
const alipaywappaymenturl      = '/v2/plugin/alipaywappaymenturl'
const weixinminipay            = '/v2/weixinopenpayment/paying'

// ============ 优惠券 Coupon ============
const couponshow          = '/v2/coupon/show'
const couponlist          = '/v2/coupon/couponlist'
const coupon_center       = '/v2/coupon/center'
const getcoupon           = '/v2/coupon/getcoupon'
const usablecoupon        = '/v2/coupon/usablecoupon'

// ============ 积分 / 钱包 / 充值卡 ============
const pointsexchangelist  = '/v2/pointsexchange/list'
const pointsexchange      = '/v2/pointsexchange/exchange'
const wallet              = '/v2/wallet/get'
const walletrecharge      = '/v2/wallet/recharge'
const walletrechargelist  = '/v2/wallet/rechargelist'
const walletexchange      = '/v2/wallet/exchange'
const walletexchangelist  = '/v2/wallet/exchangelist'
const walletcardexchange  = '/v2/wallet/cardexchange'
const walletrecordlist    = '/v2/wallet/recordlist'
const rechargecardlist    = '/v2/rechargecard/list'
const rechargecarditem    = '/v2/rechargecard/item'
const rechargecarditemlist = '/v2/rechargecarditem/list'
const rechargecarditemget = '/v2/rechargecarditem/item'

// ============ 分销代理 Agents ============
const agentupgrade        = '/v2/agents/upgrade'
const agentmyinfo         = '/v2/agents/myinfo'
const agentspostinfo      = '/v2/agents/postinfo'
const agentmysummary      = '/v2/agents/mysummary'
const agentmyusers        = '/v2/agents/myusers'
const agentmyorders       = '/v2/agents/myorders'
const agentmybonus        = '/v2/agents/mybonus'

// ============ 评价 Review ============
const commentlist         = '/v2/productreview/list'
const myreviews           = '/v2/productreview/myreviews'
const productreviewing    = '/v2/productreview/productreviewing'
const commentsubmit       = '/v2/productreview/submit'

// ============ 收藏 Favorites ============
const favoriteslist       = '/v2/favorites/list'
const favoritessubmit     = '/v2/favorites/submit'
const favoritesremove     = '/v2/favorites/remove'
const recentproductlist   = '/v2/favorites/list-recentproduct'
const recentproductsubmit = '/v2/favorites/submit-recentproduct'
const recentproductremove = '/v2/favorites/remove-recentproduct'

// ============ 通用 Common ============
const referrerinfo        = '/v2/common/referrerinfo'
const referrerauto        = '/v2/common/referrerauto'
const banner              = '/v2/common/banner'
const forminfo            = '/v2/common/forminfo'
const formsubmit          = '/v2/common/formsubmit'
const getform             = '/v2/common/getform'
const levels              = '/v2/common/levels'
const allprovinces        = '/v2/common/allprovinces'
const uploadpicture       = '/v2/common/uploadpicture'
const picturepost         = '/v2/common/picturepost'
const producttype         = '/v2/common/producttype'
const orderstatus         = '/v2/common/orderstatus'
const ordertype           = '/v2/common/ordertype'
const returnreasons       = '/v2/common/returnreasons'
const returnactions       = '/v2/common/returnactions'
const requesttypes        = '/v2/common/requesttypes'
const paymentstatus       = '/v2/common/paymentstatus'
const shippingstatus      = '/v2/common/shippingstatus'
const pluginscenes        = '/v2/common/pluginscenes'
const customattrtype      = '/v2/common/customattrtype'
const messagetype         = '/v2/common/messagetype'

// ============ 内容资讯 Topic / News / Blog ============
const topiclist           = '/v2/topic/list'
const topicdetail         = '/v2/topic/detail'
const newslist            = '/v2/news/list'
const newsitem            = '/v2/news/item'
const bloglist            = '/v2/blog/list'
const blogitem            = '/v2/blog/item'
const blogpost            = '/v2/blog/post'
const blogcategories      = '/v2/blog/categories'
const blogpapers          = '/v2/blog/papers'

// ============ 消息 PM ============
const pmmarkRead          = '/v2/pm/markRead'
const pmsend              = '/v2/pm/send'
const pmlist              = '/v2/pm/list'
const pmdelpm             = '/v2/pm/delpm'

// ============ 物流 Shipping / Kdniao ============
const pickuplist          = '/v2/shipping/pickuplist'
const shopsearch          = '/v2/shipping/shopsearch'
const shipments           = '/v2/shipping/shipments'
const expresskdniaoapiurl = '/v2/kdniao/expresskdniaoapiurl'

// ============ 营销 Seckill / PinTuan / SignIn / Task / Share / PreOrder / TierPrice / Bundle / Page ============
const seckillstatus       = '/v2/seckill/status'
const seckilllist         = '/v2/seckill/list'
const pintuanproduct      = '/v2/pintuan/product'
const pintuangroup        = '/v2/pintuan/group'
const pintuankaituan      = '/v2/pintuan/kaituan'
const signinstatus        = '/v2/signin/status'
const signin              = '/v2/signin/signin'
const signinrecords       = '/v2/signin/records'
const signincalendar      = '/v2/signin/calendar'
const tasklist            = '/v2/task/list'
const taskclaim           = '/v2/task/claim'
const taskunclaimed       = '/v2/task/unclaimed'
const sharereward         = '/v2/share/reward'
const preorderpayrest     = '/v2/preorder/pay-rest'
const preorderrestinfo    = '/v2/preorder/rest-info'
const tierprices          = '/v2/tierprice/tierprices'
const bundlelist          = '/v2/bundle/list'
const pageindex           = '/v2/page/index'
const pagefeaturelist     = '/v2/page/featurelist'
const pageget             = '/v2/page/get'
const pagefeaturedproducts = '/v2/page/featuredproducts'
const nicknameupdate      = '/v2/authweixinmini/update'

module.exports = {
  // Account
  login, online, logout, register, sendsmsforregister, chanagepwd,
  sendsmsforfindpwd, pwdset, checkaccount,
  // WeixinOpen
  weixinminilogin, weixinminiphone, weixininfosubmit,
  // Customer
  getcustomer, customerinfo, customersubmit, customerpoints, uploadavatar,
  checkshop, myinvitecode, myinvitees,
  // Address
  addressList, addressdelete, addressadd, addressdefault, addressedit,
  // Product
  featuredbycid, homePro, specialproducts, alsopurchased, taglist, productbytag,
  getproductattr, getproductspec, productId, productbysku, productpost,
  // Category/Brand/Search
  homecategories, categoryget, category, brandlist, brandfeaturelist, brandget,
  brandfeaturedproducts, search, searCate, findbymid, findbyoid, hotcategory,
  hotsearch, searchhistory,
  // ShoppingCart
  getShoppingcart, cartCount, producttocart, productstocart, producttocheckout,
  cartallselected, updatecartitem, removecartitem, removecart, wishlist,
  removewishlistitem, iscollect, towishlist, tocheckout,
  // Checkout
  checkminsubtotal, getcheckout, getpaymentmethod, getshippingmethod,
  submitcheckout, quicksubmit,
  // Order
  returnrequests, returnpost, orderList, orderDetail, orderconfirm, orderdeliver,
  ordercancel,
  // Plugin/Payment
  weixinwaploginenabled, weixinwaploginurl, weixinopenloginenabled,
  weixinopenlogin, weixinopenphonenumber, weixinwappaymentenabled,
  weixinwapaymenturl, weixinopenpaymentenabled, weixinopenpaymenturl,
  alipaywappaymentenabled, alipaywappaymenturl, weixinminipay,
  // Coupon
  couponshow, couponlist, coupon_center, getcoupon, usablecoupon,
  // Points/Wallet/RechargeCard
  pointsexchangelist, pointsexchange, wallet, walletrecharge, walletrechargelist,
  walletexchange, walletexchangelist, walletcardexchange, walletrecordlist,
  rechargecardlist, rechargecarditem, rechargecarditemlist, rechargecarditemget,
  // Agents
  agentupgrade, agentmyinfo, agentspostinfo, agentmysummary, agentmyusers,
  agentmyorders, agentmybonus,
  // Review
  commentlist, myreviews, productreviewing, commentsubmit,
  // Favorites
  favoriteslist, favoritessubmit, favoritesremove, recentproductlist,
  recentproductsubmit, recentproductremove,
  // Common
  referrerinfo, referrerauto, banner, forminfo, formsubmit, getform, levels,
  allprovinces, uploadpicture, picturepost, producttype, orderstatus, ordertype,
  returnreasons, returnactions, requesttypes, paymentstatus, shippingstatus,
  pluginscenes, customattrtype, messagetype,
  // Topic/News/Blog
  topiclist, topicdetail, newslist, newsitem, bloglist, blogitem, blogpost,
  blogcategories, blogpapers,
  // PM
  pmmarkRead, pmsend, pmlist, pmdelpm,
  // Shipping/Kdniao
  pickuplist, shopsearch, shipments, expresskdniaoapiurl,
  // Marketing
  seckillstatus, seckilllist, pintuanproduct, pintuangroup, pintuankaituan,
  signinstatus, signin, signinrecords, signincalendar, tasklist, taskclaim,
  taskunclaimed, sharereward, preorderpayrest, preorderrestinfo, tierprices,
  bundlelist, pageindex, pagefeaturelist, pageget, pagefeaturedproducts,
  nicknameupdate
}

四、核心业务流程

4.1 登录授权流

① 账号密码登录：
   api.post(login, { name, password })
   → res.data = { guid, token, nickname }
   → wx.setStorageSync('guid', guid); wx.setStorageSync('token', token)

② 微信授权登录：
   wx.login() → code
   → api.get(weixinminilogin, { code, state, encryptedData, iv })
   → res.data = { guid, token, openId }（TokenEntity）
   → 存储 guid + token

③ 绑定手机号：
   <button open-type="getPhoneNumber">
   → api.get(weixinminiphone, { code, encryptedData, iv })
   → res.data = { phone }

4.2 购买流

详情选 SKU → 加入购物车(producttocart) / 立即购买(producttocheckout)
  → 购物车列表勾选(getShoppingcart + cartallselected)
  → 结算页(getcheckout)选地址/优惠券/支付方式
  → api.post(submitcheckout, { request: {...} }) → 创建订单
  → api.get(weixinopenpaymenturl, { orderId, paytype }) → 支付参数
  → wx.requestPayment → 支付成功 → 跳转支付成功页

4.3 分销流

用户分享（path 携带 code）→ 新用户进入存储 code
  → api.get(referrerauto) → 自动绑定推荐关系
  → 新用户下单 → 推荐人获佣金/分红
  → 代理中心(agentmyinfo/mysummary/mybonus)查看收益

五、场景化界面规划（按业务场景）

> 同一套 miniProgramV2 页面 + openapi.json 接口，可按业务场景裁剪组合。生成前先确认目标场景，再决定启用哪些页面与接口模块；未指定时默认生成「标准 B2C 商城」核心链路。场景可叠加（如「分销 + 社区团购」）。

5.1 标准 B2C 商城（核心交易闭环）

• 定位：通用商品交易，最快上线
• 页面：index / category / subcategory / detail / search / cart / checkout / checkoutdetail / order / orderList / payFinish / my / login / address / address-edit / collect / comment
• 接口模块：account、product、category、brand、search、shoppingcart、checkout、order、payment、address、favorites、review、common(banner)
• TabBar：首页 / 分类 / 购物车 / 我的
• 首页结构：轮播 banner + 公告 topic + 金刚区分类入口 homecategories + 热卖/新品商品卡 homePro/productbytag + 优惠券弹窗 couponshow

5.2 社区团购 / O2O 门店自提

• 定位：社区团长、就近自提、门店/提货点
• 页面：index（顶部自提点入口）+ options（自提点/分店选择）+ category + detail + cart + checkout + order + wuliuxinxi + shopsearch 相关
• 接口模块：shipping（pickuplist/shopsearch）+ customer（checkshop）+ 标准交易模块
• TabBar：首页 / 分类 / 购物车 / 我的
• 关键差异：下单前先选 shopId（自提点，adress.id 注入 header）；checkout 展示自提点而非收货地址；配送方式走 getshippingmethod

5.3 分销裂变商城

• 定位：代理/合伙人、佣金分红、邀请拉新
• 页面：index + distribution + dividend + bonusDetail + myCustomer + myinvitre + partner + saleOrder + salePage + sharepage + warrant + idcar + 核心交易页
• 接口模块：agents + customer（myinvitecode/myinvitees）+ common（referrerinfo/referrerauto）+ 交易模块
• TabBar：首页 / 分类 / 购物车 / 我的（我的页顶部强化「分销中心」入口）
• 关键差异：登录后引导绑定推荐关系 referrerauto；分享 path 携带 code；我的页突出「收益/我的客户/邀请」

5.4 会员积分 / 钱包商城

• 定位：会员资产、积分兑换、充值、签到留存
• 页面：point + recharge + rechargeList + cashout + youhuijuan + available_coupon + usedcunpond + 核心交易页
• 接口模块：wallet + pointsexchange + rechargecard + coupon + signin + task
• TabBar：首页 / 分类 / 购物车 / 我的（我的页顶部资产卡片）
• 关键差异：我的页顶部资产卡片（余额/积分/优惠券）；签到 signin / 任务 task 引导每日活跃；积分商城 pointsexchange 兑换商品

5.5 秒杀 / 拼团 / 预售营销商城

• 定位：限时秒杀、拼团、预售、阶梯价等营销玩法
• 页面：index（活动楼层）+ seckill / pintuan / preorder 相关活动页 + 核心交易页
• 接口模块：seckill + pintuan + preorder + tierprice + bundle + 交易模块
• TabBar：首页 / 分类 / 购物车 / 我的
• 关键差异：首页增加活动楼层入口；活动商品卡带倒计时 seckill / 进度条 pintuan；拼团需「开团/参团」交互

5.6 内容电商 / 品牌资讯

• 定位：资讯种草 + 商品转化
• 页面：blog（列表/详情）+ news + topic + detail（商品）+ search + 核心交易页
• 接口模块：blog + news + topic + product + search
• TabBar：首页 / 分类 / 购物车 / 我的（首页信息流）
• 关键差异：首页以内容信息流为主，文章内嵌商品卡片跳转商品详情

5.7 场景选择与生成规则

1. 生成前先询问/确认目标场景，按上表确定启用页面与接口模块
2. 未指定时默认生成「标准 B2C 商城」核心链路：account / index / category / detail / cart / checkout / order / my / address
3. TabBar 保持 2~5 个，超出部分下沉到「我的」页入口或首页金刚区

六、页面展示规范

6.1 页面四件套

6.2 JS 页面结构模板

import api from '../../api/api'
import { /* 需要的端点 */ } from '../../api/conf'

Page({
  data: { /* 响应式变量 */ },
  onLoad(options) { /* 页面加载，处理路由参数 */ },
  onShow() { /* 页面显示/切回前台 */ },
  onReady() { /* 初次渲染完成 */ },
  getData() { /* 业务方法，驼峰命名，动词开头 */ },
  onPullDownRefresh() { this.onShow(); wx.stopPullDownRefresh() },
  onReachBottom() { /* 触底分页 page++ */ },
  onShareAppMessage() { return { title: '分享标题', path: '/pages/xxx/xxx?id=' + this.data.id } }
})

6.3 核心页面结构

6.4 状态覆盖

所有列表/详情页必须覆盖四种状态：加载中 / 空数据 / 错误 / 正常；按钮需覆盖业务状态（如商品：正常、售罄、下架、即将开卖）。

七、交互与反馈规范

八、部署上线

1. 修改 app.js 中 globalData.host 为后端 API 地址（开发用 https://dev.ushopun.com/api，正式替换为租户域名 https://{tenant}.ushopun.com/api）
2. 在 project.config.json 填写小程序 AppID
3. 后端管理后台配置微信支付商户信息
4. 替换腾讯地图 SDK key（如使用定位）
5. 配置合法域名（request/uploadFile 域名，含 dev.ushopun.com 与正式租户域名）
6. 微信开发者工具上传代码、提交审核

> 对接前必读：先在 https://dev.ushopun.com 示例站点确认目标模块已开通、接口可达（域名白名单、鉴权、模块开关）。若模块返回 code: 403（module not open）或 code: 220（需升级），说明需在后台开通对应功能，具体开通与付费请直接联系优社云AI官方。

九、开发硬性要求

1. API 端点必须在 conf.js 定义常量，禁止在页面中硬编码 URL
2. 所有请求通过 api.js 封装方法调用，禁止直接 wx.request
3. 请求头自动携带 guid（用户标识）、authorization（JWT Token）、shopId（店铺/自提点）
4. 使用 this.setData() 更新数据，数组项更新用字符串 key：['arr[' + i + '].field']
5. 图片必须设置 mode 属性（推荐 widthFix）
6. 列表渲染必须指定 wx:key
7. 覆盖所有状态：加载中 / 空数据 / 错误 / 正常
8. 响应码：code === 200 成功（取 data），code === 250 业务警告（提示 content），code === 401 未授权（跳登录），code === 220 需审核，code === 404 找不到
9. 错误提示优先取 err.content，成功数据统一从 res.data 读取；checkaccount 接口特殊：code === 1 可用、code === 0 已存在
10. 金额字段统一 Number(x).toFixed(2) 保留两位小数；分页默认每页 12 条（个别接口按后端默认值），触底加载 page++
11. 尺寸单位统一使用 rpx（750rpx = 屏幕宽度）；图片必须设置 mode
12. 代码遵循微信小程序最新基础库规范，纯原生 wx，无第三方框架依赖，可直接导入微信开发者工具运行