平台初始化
本指南面向平台管理员，用于首次部署完成后，配置商城的基础信息、文件上传、登录验证、支付和物流等功能。完成后，应能让商家发布商品，并由买家完成一次下单、支付和收货流程。
服务器、数据库和应用安装请先参考部署指南。本文从管理端已经能够登录开始。
哪些项目需要先完成
“上线前检查”表示必须确认可用，已有正确配置时不需要重新填写；“按需配置”表示使用对应功能前完成；“后续运营”表示可以在商城运行后继续维护。
| 菜单或功能 | 优先级 | 完成要求 |
|---|---|---|
| 系统设置 | 上线前检查 | 核对站点信息、站点开启状态、商品审核规则、订单和安全参数；积分及新人优惠券按需设置 |
| 储存方案 | 上线前检查 | 确认已开启可用方案，图片能上传并在买家端显示 |
| 验证平台 | 上线前检查 | 确认当前验证方式可用；选择第三方验证时才需要准备其参数 |
| 短信网关、短信 | 按需配置 | 使用手机验证码或短信通知前，完成网关、签名、模板配置并验证发送 |
| 收款方式 | 按需配置 | 开放在线支付前，配置实际使用的支付渠道和终端，并验证支付结果 |
| 区域管理、物流公司 | 配送商品上线前检查 | 地址能选择经营所需地区；平台和商家已开启使用的物流公司 |
| 商品分类、店铺审核 | 上线前检查 | 分类可供商家选择，测试商家能够完成入驻、发布和审核流程 |
| 商品索引 | 首次部署或重建数据后完成 | 有测试商品后生成索引，买家能搜索到已上架且审核通过的商品 |
| PC端微页面、移动端微页面 | 对应终端上线前检查 | 对计划开放的终端，确认已有已发布并设为商城首页的页面；已有可用首页时无需重建 |
| PC端导航菜单 | PC端上线前检查 | 确认导航展示及链接正确；需要新增入口时再配置 |
| SMTP设置、邮件 | 按需配置 | 使用邮件通知前，配置发信服务、启用模板并验证接收 |
| 信任登录 | 按需配置 | 开放微信等第三方登录前，按终端完成配置并验证授权登录 |
| 微信消息、站内信 | 按需检查或配置 | 使用对应通知时，核对模板状态和接收条件；站内信不依赖 SMTP 或短信网关 |
| 快递平台 | 按需配置 | 需要显示物流轨迹时，完成查询服务配置；与物流公司和运费模板分开检查 |
| 电子面单 | 按需配置 | 使用面单生成与打印时，完成平台服务、商家授权、模板和打印环境配置 |
| 搜索分词、搜索提示词、热门关键字 | 后续运营 | 根据搜索效果补充；不要求首次上线时逐项新增 |
| 搜索概览、搜索历史 | 后续运营 | 用于查看搜索表现和记录，不作为初始化填报项 |
| 敏感词 | 上线前检查，后续维护 | 确认内容过滤效果；有业务补充词时再维护，不要求初始化时另建一整套词库 |
| 菜单管理 | 开发定制时使用 | 用于后台功能菜单维护，不是商城首页导航设置，日常初始化不需要增删 |
| 三方客户端 | 接口对接时配置 | 对接外部系统、调用开放接口时使用，与买家第三方登录分开配置 |
配图说明
文中黄色“待补图”框是本轮补图标记，补齐图片后删除。菜单名称按本轮后台截图调整，表单字段和操作按钮参考已有操作文档，补图时核对当前页面。每组先截操作位置，需要验证展示效果时再补买家端结果图；保留左侧选中菜单、页面标题和相关操作区，避免只截一条菜单。
所有截图统一保存到本文同级的 assets/ 文件夹，文件名按下面各补图框中的表格填写，保持大小写和 .png 扩展名一致。例如：assets/P02-site-settings.png。标明“使用时才截”的图片只在启用该功能时准备；P10 中也只准备实际开通的服务。
同一张图只突出当前步骤的关键字段和按钮，用红框或编号箭头标注。参数配置图保留字段名称，遮住密钥、令牌、证书内容、真实手机号和交易信息。
开始前准备
请准备管理端账号，以及已部署的买家端、商家端和 API 访问地址。涉及第三方服务的配置，需要相应账号的管理人员协助准备资料。
| 资料 | 用途 | 何时需要 |
|---|---|---|
| 网站名称、网站标题、描述、Logo 和平台端图标等站点素材 | 完善站点设置中的基础信息 | 初始化时准备 |
| 存储服务账号与参数 | 上传商品图片、店铺图片等文件 | 使用文件上传前准备 |
| 短信服务参数、签名与模板 | 手机验证码和短信通知 | 使用短信功能前准备 |
| 支付商户及应用参数、证书 | 买家在线支付 | 开通在线支付前准备 |
| 常用物流公司信息 | 商家选择物流公司发货 | 销售快递配送商品前准备 |
| 快递查询服务参数 | 查看物流轨迹 | 使用物流查询前准备 |
| 首页轮播图、分类或商品入口、导航链接 | 配置计划开放终端的商城首页 | 发布商城首页前准备 |
| SMTP、第三方登录、微信消息、电子面单相关资料 | 邮件通知、授权登录、微信通知和面单打印 | 使用对应功能时准备 |
先完成下面的基础配置，再根据实际业务开启可选功能。只销售虚拟商品、不使用快递配送的平台，可以跳过快递配送相关配置。
1. 配置文件存储
操作人：平台管理员。使用图片、视频或附件上传前完成。
操作路径：【平台】→【设置】→【系统参数】→【储存方案】。
- 选择本次使用的存储方案，填写相应参数。
- 保存配置并开启该方案，同一时间只开启一个存储方案。
- 在商家端【设置】→【素材中心】→【图片】上传一张测试图片。
- 复制上传后的图片地址，在浏览器中打开，确认图片可以正常显示。
使用小程序时，文件访问地址需要使用 HTTPS。修改存储方案不会自动迁移历史文件，应在批量上传正式素材前确定存储方案。
详细参数和各方案的验证方法见存储方案。
2. 完善平台信息和业务规则
操作人：平台管理员。开放商家和买家使用前完成。
操作路径：【平台】→【设置】→【系统参数】→【系统设置】。
| 配置项 | 需要确认的内容 | 完成后怎么检查 |
|---|---|---|
| 站点设置 | 核对网站名称、标题、描述、站点开启状态、Logo 及各端图标；正式上线前确认测试模式已关闭 | 打开买家端，核对站点可访问、标题和图片展示正确 |
| 商品设置 | 核对是否开启商品审核、商品评论及咨询审核，PC 和移动商城商品列表展示维度，以及图片尺寸 | 发布一件测试商品，检查审核状态和买家端列表展示是否符合设置 |
| 订单设置 | 核对自动取消、确认收货、完成订单、售后及投诉失效、自动好评、自动确认收款等时限 | 后续试单时核对订单状态和处理流程；确认各字段的天、小时、分钟单位 |
| 安全设置 | 检查平台使用的安全参数 | 使用测试账号验证相应操作 |
| 积分与新人优惠券 | 计划使用时再配置对应规则 | 通过测试账号核对积分或领券结果 |
开启商品审核后，商家新增、编辑或上架商品需要平台审核。初始化时应同时确认平台审核人员能够处理测试商品。商品图片尺寸设置使用阿里云 OSS 缩略图时，需要与 OSS 图片处理规则一致。
详细操作见系统设置。
站点设置
商品设置
订单设置
图中的名称、素材和时限是演示配置，正式上线时按实际运营要求填写，不能直接将截图中的时限作为推荐值。
如需多人协作，可在【平台】→【运营】→【权限】中配置角色和管理员，并使用新账号登录，检查其可访问的菜单。详见角色和管理员。
3. 配置登录验证和短信
操作人：平台管理员；第三方服务账号管理人员提供参数。
登录验证
操作路径：【平台】→【设置】→【系统参数】→【验证平台】。
验证平台提供行为验证码、图片验证码和腾讯云验证方式。先确认当前启用的方式；本例使用行为验证码，选择【滑块拼图】。行为验证码还可选择【旋转图片】，使用腾讯云验证时再配置对应的第三方参数。
配置后，在 PC 和移动端 H5 的登录场景中触发验证，确认组件能正常显示，并能完成验证。小程序的一键登录流程另行验证，不用 H5 截图代替。其他验证方式的参数说明见验证平台。
选择验证方式
在验证平台列表中确认启用状态。本例已开启行为验证码。
配置行为验证码
点击行为验证码对应的【修改】，选择验证码类型并配置背景图片，点击【确定】保存。背景图片支持 jpg、jpeg、png、webp 格式，每张不超过 5MB，最多 20 张。
PC 端验证效果
本例展示账号登录时触发的滑块拼图验证。拖动滑块完成拼图后，继续登录流程。
移动端 H5 验证效果
移动端 H5 展示安全验证弹窗，拖动滑块完成拼图；需要更换验证图片时，可点击【换一张】。
手机验证码与短信通知
使用手机验证码登录、注册或找回密码前，应完成短信配置。
- 在【平台】→【设置】→【系统参数】→【短信网关】填写服务参数。
- 按短信教程完成第三方服务授权和回调地址配置。
- 在【平台】→【设置】→【消息设置】→【短信】配置签名和所需模板，确认已审核通过并开启。
- 使用测试手机号，在实际登录或注册页面获取验证码，确认能够收到并完成后续操作。
只保存短信网关参数，不代表短信已经可用。 签名、模板和发送服务也需要准备完成。验证码类、通知类、营销类模板按实际用途配置，不需要一次开启全部模板。
配置短信网关
在【短信网关】中修改阿里云短信网关参数，填写【密钥id（AccessKey ID）】和【密钥（AccessKey Secret）】，点击【确定】保存，并确认网关处于【已开启】状态。
确认短信签名
进入【短信】→【短信签名】，确认准备使用的签名为【审核通过】。审核状态未及时更新时，可点击【同步签名状态】；第三方平台已有签名时，可通过【同步已有签名】获取。
启用对应场景的模板
进入【短信模板】→【验证码类】，按实际使用的功能检查模板的签名名称、审核状态和启用状态。只有签名与模板审核通过，且模板已开启，才能正常发送。
图中【用户登录】【注册】模板已审核通过并开启；【找回密码】等部分模板仍为【待初始化】、【已关闭】，不代表所有场景都已配置完成。需要使用这些功能时，先关联签名并通过【新增审核】提交模板审核，审核通过后再开启。配置完成后，到实际页面获取验证码，并在【发送记录】中检查发送结果。
4. 配置支付方式
操作人：平台管理员；支付商户账号管理人员提供参数。开放在线支付前完成。
操作路径：【平台】→【设置】→【支付与物流】→【收款方式】。
- 确认计划开放的支付方式，以及买家使用的终端。
- 按对应支付方式填写商户、应用和证书等参数。
- 使用微信支付时，分别检查公共参数和已开放终端的子应用参数。
- 配置完成后，使用测试商品创建小额订单，在实际开放的终端完成支付。
支付验证需要同时检查：买家付款结果、平台和商家端订单的支付状态、第三方支付渠道的交易记录。不能只凭买家看到支付成功页面判断配置完成。
详细参数说明见收款方式。
待补图 P05｜收款方式与终端配置
开放在线支付时补图：截【收款方式】列表和实际使用渠道的编辑页。微信支付分别截公共参数、子应用配置区，框出所选终端、字段名称、证书上传入口和保存按钮；密钥、商户信息和证书内容脱敏。支付结果放到最后的试单图中验证。
| 图片文件名 | 截图内容 |
|---|---|
P05-payment-list.png | 收款方式列表与使用的渠道 |
P05-payment-settings.png | 所用支付渠道的参数配置；使用微信支付时截公共参数 |
P05-wechat-app-settings.png | 微信支付子应用及终端配置（使用时才截） |
5. 配置配送与物流查询
操作人：平台管理员配置公共服务，商家配置店铺物流。销售快递配送商品时完成。
| 步骤 | 操作人 | 操作路径与内容 |
|---|---|---|
| 检查地区数据 | 平台管理员 | 【运营】→【维护】→【区域管理】，确认收货地址所需地区存在且层级可选；已有完整数据时不用重新添加 |
| 准备物流公司 | 平台管理员 | 【设置】→【支付与物流】→【物流公司】，添加或启用计划使用的物流公司 |
| 开通店铺物流 | 商家 | 【设置】→【物流管理】，开启店铺使用的物流公司，并设置运费模板 |
| 配置物流查询 | 平台管理员 | 需要查询物流轨迹时，在【设置】→【系统参数】→【快递平台】填写服务参数 |
验证时，先让商家确认发货页面能选择物流公司，再用测试收货地址下单，核对配送范围和运费。需要验证物流轨迹时，使用有效运单检查查询结果；随意填写的单号不能用于验证查询服务是否正常。
地区数据的维护见区域管理。地区数据决定地址能否选择，运费模板决定配送范围和费用，两项都要验证。
待补图 P06｜地区、物流公司与运费
销售配送商品时补图：截【区域管理】展开一组实际配送地区的层级，再截【物流公司】列表，框出公司名称和开启状态；商家端截【物流管理】中的物流公司及一个已配置的运费模板。用示例地址验证地区选择和运费，避免使用真实买家地址。
| 图片文件名 | 截图内容 |
|---|---|
P06-region-list.png | 区域管理：展开后的地区层级 |
P06-logistics-list.png | 平台物流公司列表与开启状态 |
P06-merchant-logistics.png | 商家物流管理：店铺启用的物流公司 |
P06-shipping-template.png | 商家已配置的运费模板与配送范围 |
6. 准备商品分类和入驻流程
操作人：平台管理员。商家发布商品前完成。
- 在【平台】→【商品】→【商品设置】→【分类列表】建立本次经营需要的商品分类。
- 根据商品需要维护品牌，详见品牌列表。
- 使用一个测试商家账号提交入驻申请，由平台按店铺审核流程处理。
- 商家进入后台发布测试商品，检查是否能选择正确的分类，并按前面设置的审核规则完成上架。
分类会用于商家发布商品和买家端展示。分类的层级、显示和关联设置详见分类列表。
待补图 P07｜分类与商品审核规则
截【分类列表】展开后的分类层级，框出末级分类、显示状态，以及实际使用的品牌或参数关联入口。再截测试商品在商家提交后、平台审核后的状态，说明审核开关如何影响商品展示；商家名称等信息可用演示数据。
| 图片文件名 | 截图内容 |
|---|---|
P07-category-list.png | 分类列表：分类层级、显示状态与关联入口 |
P07-product-pending.png | 商家提交后的测试商品状态 |
P07-product-approved.png | 平台审核后的同一件测试商品状态 |
生成商品索引
首次部署环境或清除数据后，需要生成商品索引。
操作位置：管理端【搜索】菜单组中的【商品索引】，与【搜索概览】【搜索分词】【搜索历史】【搜索提示词】同组。
有可展示的测试商品后，点击【生成】，等待生成完成，再到买家端搜索该商品名称，确认能够找到商品。详见商品索引。
待补图 P08｜生成索引与搜索结果
截当前版本【商品索引】完整操作区，保留左侧所属菜单，框出【生成】按钮和实际显示的进度或完成状态。再截买家端输入测试商品名称后的搜索结果，框出搜索词与对应商品。
| 图片文件名 | 截图内容 |
|---|---|
P08-product-index.png | 商品索引：生成按钮与进度或完成状态 |
P08-search-result.png | 买家端搜索词与对应商品结果 |
7. 发布商城首页并检查导航
对计划开放的终端分别检查：PC 使用【PC端微页面】，移动端使用【移动端微页面】。若已有可用首页，核对状态和访问结果即可；需要重新装修时，再新建或编辑页面。
- 在【运营】→【装修】中打开对应终端的微页面列表。
- 编辑页面，设置必要的图片、分类或商品入口，并预览页面。
- 确认页面已发布，再选择该页面执行【设为商城首页】。未发布的页面不能设置为商城首页。
- 打开对应终端的商城首页，确认展示的是刚设置的页面，图片、商品入口和跳转链接均可用。
- 开放 PC 端时，检查【PC端导航菜单】的文字、顺序和链接，逐个点击计划展示的导航入口。
待补图 P09｜首页发布、设为首页与导航
按本次开放的终端补图：截微页面列表，框出目标页面、发布状态、首页标识和【设为商城首页】按钮，再补对应买家端首页效果。PC 端另截【PC端导航菜单】及一个导航的编辑区，框出文字、跳转链接、顺序操作；补图后要能对应后台配置与前台效果。
| 图片文件名 | 截图内容 |
|---|---|
P09-pc-home-settings.png | PC 微页面列表：发布状态、首页标识与设为首页按钮 |
P09-pc-home-result.png | PC 买家端首页展示效果 |
P09-mobile-home-settings.png | 移动端微页面列表：发布状态、首页标识与设为首页按钮 |
P09-mobile-home-result.png | 移动端买家端首页展示效果 |
P09-pc-navigation.png | PC 导航列表和编辑区：文字、跳转链接与顺序 |
8. 按需开启其他服务
下面的功能按业务需要配置。暂不使用时，可以留待后续开通。
| 功能 | 配置顺序 | 完成后怎么检查 |
|---|---|---|
| 第三方登录 | 在【设置】→【支付与物流】→【信任登录】配置对应应用及终端参数 | 在对应终端完成授权并登录，详见信任登录 |
| 邮件通知 | 先配置【系统参数】→【SMTP设置】，再开启【消息设置】→【邮件】中的所需模板 | 先用 SMTP 测试功能发送邮件，再用已绑定邮箱的测试账号触发相应业务通知，详见SMTP设置和邮件模板 |
| 站内消息 | 检查【设置】→【消息设置】→【站内信】中的所需模板 | 触发相应业务后，在接收账号的消息列表中检查，详见站内信 |
| 微信消息 | 完成公众号相关配置，在【设置】→【消息设置】→【微信消息】中同步并检查所需模板 | 使用已绑定公众号、满足消息接收条件的账号触发通知，详见微信消息 |
| 电子面单 | 平台配置电子面单服务，商家完成授权、物流与面单模板配置，并安装打印组件和驱动 | 在正式环境的待发货订单中验证生成和打印，详见电子面单 |
电子面单需要平台和商家共同配置。订单详情页生成面单后，还需完成发货操作，才能确认订单已进入已发货状态。
待补图 P10｜实际开通的可选服务
只补本次开通的功能，不必为未使用的服务准备截图。SMTP 截参数与测试区、邮件截模板开启状态；微信消息和站内信截所用模板及状态；信任登录截渠道和终端配置；快递平台截查询参数字段名；电子面单截平台配置、商家授权和模板设置。各图标注实际操作入口，凭证、令牌和通知接收人信息脱敏。
| 图片文件名 | 截图内容 |
|---|---|
P10-smtp-settings.png | SMTP 参数与测试区 |
P10-email-template.png | 邮件模板及开启状态 |
P10-wechat-message.png | 微信消息模板及状态 |
P10-site-message.png | 站内信模板及状态 |
P10-trust-login.png | 信任登录的渠道与终端配置 |
P10-express-platform.png | 快递平台参数配置 |
P10-waybill-platform.png | 平台电子面单服务配置 |
P10-waybill-merchant.png | 商家电子面单授权及模板配置 |
9. 上线前完成一次试单
使用测试商家和测试买家，从头走完以下流程。正式上线前，应在实际计划开放的终端分别验证登录、下单和支付。
- 商家能够完成入驻，平台能够查看并处理申请。
- 对应终端的首页已发布并设为商城首页，导航和首页入口可以正常跳转。
- 商家可以上传图片、发布商品；需要审核的商品由平台审核后展示。
- 买家能够搜索到商品，商品详情和图片显示正常。
- 买家可以填写收货地址，配送范围和运费符合商家设置。
- 买家完成支付后，平台和商家端订单支付状态正确。
- 实物商品订单能够发货，买家能够查看订单并确认收货；使用物流查询时，能查询有效运单。
- 销售虚拟商品时，商家能够按业务流程完成核销。
- 使用符合售后条件的测试订单，验证申请、审核、退款处理及买家到账结果。
- 已开启的短信、邮件或微信通知，能够在对应业务触发后送达测试账号。
- 使用演示内容检查敏感词过滤效果，确认表现符合运营预期。
试单可参考商家订单处理、售后服务单和平台退款单。涉及实际支付时，使用小额测试订单，并在测试结束后核对退款和交易记录。
待补图 P11｜试单验证结果
截同一笔演示订单在买家端、商家端的支付与发货状态，框出状态文字和相关操作。退款测试另截退款处理结果及买家到账结果，交易号、支付账号、姓名、手机号和地址脱敏。虚拟商品业务则补核销结果，不需要补实物发货图。
| 图片文件名 | 截图内容 |
|---|---|
P11-buyer-order.png | 买家端演示订单的支付与发货状态 |
P11-merchant-order.png | 商家端同一订单的支付与发货状态 |
P11-refund-result.png | 退款处理结果 |
P11-refund-received.png | 买家退款到账结果 |
P11-verification-result.png | 虚拟商品核销结果（销售虚拟商品时才截） |
后续运营与接口对接
下列菜单需要保留，但无需为完成初始化逐项新增数据。
| 菜单 | 什么时候使用 | 注意事项 |
|---|---|---|
| 搜索概览、搜索历史 | 商城产生搜索行为后，查看搜索表现与用户记录 | 没有业务数据时不要求出现完整统计结果 |
| 搜索分词 | 商品名称中有专有词，需要改善搜索匹配时 | 使用自定义分词时，配置须与部署一致；要使新增分词作用于已有商品，需要重新生成索引 |
| 搜索提示词、热门关键字 | 需要输入提示或推荐搜索入口时 | 提示词、热门关键字不代替商品索引 |
| 敏感词 | 上线前检查过滤效果，后续补充业务词汇 | 对新增内容测试过滤效果；新增词不会自动重新过滤已有内容 |
| 菜单管理 | 开发人员定制后台功能菜单时 | 与商城 PC 导航不同；涉及新增页面或路由时，需要配合前端开发 |
| 三方客户端 | 对接外部系统调用开放接口时 | 由对接人员配置客户端凭证并验证接口调用，不作为微信等第三方登录的配置入口 |
首次上线先检查敏感词的实际过滤效果；其他项目随运营需求和接口对接进度逐步完善。
常见检查项
| 现象 | 优先检查 |
|---|---|
| 图片上传成功，但买家端打不开 | 文件访问地址是否可公开读取，HTTPS 和访问域名是否配置正确；先在浏览器直接打开图片地址 |
| 手机收不到验证码 | 短信网关参数、签名和模板的审核及开启状态、服务可用状态，并查看短信发送记录 |
| 商家已提交商品，买家看不到 | 是否等待平台审核、是否已经上架；搜索不到时再检查商品索引 |
| 买家付款成功，订单仍未支付 | 支付商户与应用参数是否匹配，服务回调是否正常；保留订单号和渠道交易号交由技术人员排查 |
| 发货时找不到物流公司 | 平台是否启用了该公司，商家是否在店铺物流管理中开启 |
| 地址选不到某个地区 | 检查区域管理中的地区数据和层级，再检查商家运费模板的配送范围 |
| 微页面编辑完成，首页仍未变化 | 检查对应终端页面是否已发布，并已设为商城首页；仅预览不代表首页已切换 |
| 配好了 SMTP，仍收不到业务邮件 | 先发送 SMTP 测试邮件，再检查对应消息模板是否开启，以及接收账号是否绑定正确邮箱 |
| 电子面单生成后订单仍待发货 | 检查是否已执行订单发货操作，生成或打印面单不能代替检查订单发货状态 |