← 多端发布中心

DWZ · v0.8.1 · 2026-10-16

一个后台，四个生效端。

微信小程序、官网、Android App、iOS App 共用商品主档、订单、会员、库存、客服及吉客云连接服务。官网同时适配电脑和手机浏览器，不需要再维护两套内容。

当前已完成：响应式官网、四端发布版本、商品与活动价格隔离、手机号统一会员、Android/iOS 工程和前端构建。尚未完成：原生安装包编译与签名、App 微信支付插件及真机支付、真实短信、微信支付与吉客云实单验收。请勿将本地演示当作可正式收款的商城。

1. 日常更新怎么操作

  1. 后台商品管理修改商品信息、价格或定制选项，或在品牌与会员页面更新文字、图片和会员卡。
  2. 点击保存后，会弹出“确认调整的生效端”。默认勾选全部，可以只保留官网或其中几个端。
  3. 点击“确认生效”才会写入。未勾选端保留各自原先的版本；点“继续编辑”或按 Esc，不会发布。
  4. 首页装修仍先保存草稿。点击“发布首页与合集”时选择生效端；仅保存草稿不对顾客生效。
  5. 到“多端发布中心”查看各端内容更新时间和发布记录。Android/iOS 的“渠道网页预览”仅检查对应端内容，不等同于真机 App。

商品按端发布包含标题、图片、规格名称、售价、上下架状态、定制功能和定制门槛。活动价随活动发布到勾选端，到期恢复该端已发布的日常售价。改单价后，结算会重新核对；金额变化需要顾客再次确认。

调整内容生效规则
品牌页面、卡面、首页、活动、商品与定制配置选择端后生效，其他端保留旧版本。
库存、安全库存、SKU 编码、ERP 映射同一库存账本，统一生效；若商品保存包含这些变更，弹窗将固定全选。
运费、配送范围、会员等级、积分规则、隐私与交易政策全端统一规则，弹窗固定全选。
订单、退款、发货、会员积分流水、客服回复同一业务记录，不按端复制。顾客可在不同端查看自己的同一份订单。
App 新增程序功能、权限、支付 SDK需重新编译、签名并通过应用商店发布；内容发布弹窗不能代替安装包更新。

2. 现在如何预览

启动本地服务后打开 官网 /shop；窗口变窄后显示手机导航和双列商品。原来的 小程序流程预览继续保留。后台入口仍是 /admin。正式部署后域名根路径 / 显示官网。

字体继续使用阿里巴巴普惠体和阿里妈妈数黑体；界面使用紫色、淡紫、近黑和白色。电脑官网最上方的图文模块由PC 官网首屏单独管理，可换图、编辑文案、关联商品或活动、设置按钮和显隐。首次升级保留现有内容，之后不再自动引用通用首页第一张图。此模块仅在宽度大于800px的官网显示；手机浏览器及小程序/App仍使用通用首页板块。保存时只确认PC官网生效。

3. 会员如何跨端通用

官网、App 和小程序均可使用手机号验证码直接注册/登录，不要求设置密码。会员可以自愿在“账号与密码”设置密码，此后两种方式均可登录；小程序保留微信授权登录。同一已验证手机号对应同一会员，订单、等级、积分不会按端重建。已有微信会员可先授权绑定手机号，再在官网和 App 用该手机号登录。

先在官网注册的会员，在小程序使用手机号登录后，点击“绑定当前微信”再使用小程序支付。若一个手机号或微信已经对应多个历史会员，系统会阻止自动合并，交给客服核对订单和积分；不能仅凭昵称或未经验证的手机号合并账本。App/网页的独立微信快捷登录还未接入，当前微信绑定入口在小程序。

演示环境显示随机演示验证码，不实际发送短信。正式环境必须接入阿里云短信，且不会返回验证码。验证码5分钟有效、一次使用、最多5次错误，每个手机号60秒内最多申请一次，每日最多10次，另有IP限流。小程序绑定微信与手机号仍需真实平台授权验证。

4. 官网部署补充步骤

  1. 按原服务器部署说明配置阿里云服务器、域名、HTTPS、数据库目录、备份与管理端IP范围；官网直接使用现有服务，无需再租一台服务器。
  2. 在阿里云短信控制台申请企业短信签名与验证码模板，使用仅允许发送短信的 RAM 权限；将 AccessKey 放服务器私密 .env 中，不放网页或 App，不发到聊天里。
  3. 在 .env 填写以下新增项，修改后重新启动服务。前四项用于短信；支付开关仅在真实小额联调通过后开启。
SMS_MODE=aliyun
ALIYUN_SMS_ACCESS_KEY_ID=在服务器填写
ALIYUN_SMS_ACCESS_KEY_SECRET=在服务器填写
ALIYUN_SMS_SIGN_NAME=审核通过的签名
ALIYUN_SMS_TEMPLATE_CODE=SMS_审核通过的模板
WECHAT_WEB_APP_ID=已关联商户的网页支付应用ID
WECHAT_WEB_PAY_ENABLED=false
WECHAT_NATIVE_APP_ID=微信开放平台移动应用ID
WECHAT_APP_PAY_ENABLED=false
TRUSTED_PROXY=true

TRUSTED_PROXY 只用于随项目提供的 Caddy 代理：它覆盖 X-Real-IP，后端端口必须仅在内部网络可达。手机 H5 支付必须提供真实客户端 IP。不要把信任代理的后端直接暴露到公网。

电脑官网采用微信 Native 扫码；手机外部浏览器采用 H5 支付，需要在微信商户平台分别开通产品并配置支付域名。微信内置浏览器的公众号 JSAPI 网页支付未接入，目前应使用外部浏览器或原生小程序。App 需要微信开放平台移动应用和 App 支付产品，不能复用小程序 AppID。后台始终以微信签名通知和查单为准，客户端返回成功不直接改成已付款。

5. Android 与 iOS 工程

源码位于 mobile/，已生成 mobile/android 与 mobile/ios。App 打包本地界面，通过 HTTPS 读取同一后台；没有把后台页面或密钥打包进去。当前包含页面导航、定制交互、分享、Android 返回键、回到前台刷新和首次离线提示。构建时使用的 shop.example.invalid 是故意不可用的占位地址，交付的 App 资源不是可直接上线版本。

  1. 安装 Node.js 24、Android Studio 和 Android SDK。iOS 需要 Mac 与完整 Xcode 26 或以上；仅安装命令行工具不够。
  2. 在项目目录进入 mobile，执行下面命令。替换为已经部署并可访问的正式 HTTPS 域名。
cd mobile
npm ci
DWZ_API_ORIGIN=https://你的已备案商城域名 npm run build
npx cap sync
npm run android
# 在 Mac 上也可执行
npm run ios

在 Android Studio 配置 SDK，选择设备或模拟器，先运行 Debug；正式发布生成独立 keystore 并备份，再生成签名安装包。iOS 在 Xcode 中选企业开发者团队和真实 Bundle ID，配置签名后先上 TestFlight。com.dwz.commerce 是初始工程标识，正式应用应使用你们确认且唯一的包名。

App 支付代码已补齐，仍需真机验收：DWZWeChat 新增支付与回调，DWZAlipay 接入官方 SDK。微信／支付宝的 AppID、包名／签名和回调必须与商户后台一致。真实收款开关及 VERIFIED 开关保持关闭，完成小额支付、取消、退款、断网查单后再开启。银行卡与手机钱包待收单机构开通和接口对接。逐项开通说明 →

上架前还需准备正式图标、商店截图、App 备案信息、隐私与 SDK 数据收集声明、注销流程、审核测试账号，并在真实设备测试登录、分享、定制、支付、退款、网络恢复和无障碍。实物商品不使用 Apple 应用内购买；应用也需满足最低功能要求。采用跨端技术并不保证商店审核通过。

本次新增登录与卡片分享的操作、正式配置和验证边界，见登录与分享说明。

6. 上线验收顺序

  1. 先在测试环境分别发布只对官网、只对 Android、全端的内容，核对其他端未改变。
  2. 同一测试会员依次登录各端，核对会员编号、等级、积分和订单相同。
  3. 两端同时购买同一低库存 SKU，核对没有超卖；活动到期前后重新报价并确认金额。
  4. 开通真实短信后验证过期、错误次数、限流与验证码不回传；核对隐私政策。
  5. 分别完成小程序、电脑扫码、手机H5、原生App的小额支付、查单、取消、退款、发货与收货。每端至少一笔吉客云实单及会员积分对账。
  6. 以上全部通过再开放对应端下单、提交应用审核。若某端未完成验收，保持它的支付和下单关闭。

官方资料

Capacitor 编译环境 · 微信 Native 下单 · 微信 App 调起支付 · 阿里云短信 API · Apple 审核规则。资料核对日期：2026-10-16。