- 产品中心统一运营入口（Plan A）：订单/运费/券/退款/发票/报表全部归入「产品中心」tab 合并菜单，配套 `PvModuleOpsHeader` + `module-shell.css` 共享壳
- 价格/库存合并到品项列表规格行：下架独立「SKU 管理」页（`/admin/shop/skus`）；保存规格时通过 `ShopSkuService::syncFromDocumentVariants` 增量同步到 `weapp_shop_skus`
- `weapp_shop_skus` 新增 `original_price` 划线价字段（已并入 `database/install.sql`）；前端 `formatPublic` 透出
- 退款列表新增 `status_label`（待审核/已通过/已驳回/已退款）
- 经营报表新增 `week_amount` / `week_orders`，7 日曲线增加 `orders` 字段与 `amount_text` 文本
- 后台菜单 SSOT：`weapp/shop/service/ShopProductCenterNav.php`（按档位动态挂接 `/admin/item/index` 锚点）
- 新增 `check_admin_shell_ssot` 门禁：校验产品中心 SPA 壳统一性
- 商城总开关：插件启停即 `ShopConfigService::isOpen()`（不再读 `shop_open`/`shop_open_stash`）
独立应用
在线商城
在线商城与直购：商品报价下单，含购物车、地址、运费、优惠券、发货与退款。
商品属性
品牌官方插件
语言PHP 8.1+
数据库MySQL 5.7+ / MariaDB
环境PivArk 1.5+ · weapp 标装
类型独立应用
版本v1.4.0
编码UTF-8
交付方式官方插件 · 授权安装
商品介绍
在线商城是做什么的？
为站点上的品项设置售价与库存，访客可在产品页或商城页下单购买；支持会员余额、微信、支付宝等支付方式（在「系统管理 → 在线支付」统一配置）。
商品的主图、参数、列表展示在产品中心维护；本插件负责报价、下单、订单与发货。
典型场景
与产品中心的分工
| 模块 | 管什么 |
|---|---|
| 产品中心 | 品项资料、参数、分类与前台展示 |
| 在线商城 | 报价、库存、购物车、下单、支付、订单、发货、退款 |
站长上手：四步上线
- 在插件中心购买并启用「在线商城」。
- 打开产品中心 → 商城设置，选择运营模式并保存。
- 在「报价管理」为品项设置价格、库存（-1 表示不限）。
- 在「系统管理 → 在线支付」配置支付通道。
- 确认前台页面已放置购买入口（详见「前台调用说明」）。
订单与库存
- 余额支付：下单即扣款，订单状态为「已支付」。
- 微信/支付宝：先「待支付」，回调成功后变「已支付」；30 分钟未付自动取消并回库存。
- 会员可在「我的订单」继续支付或取消待支付单；后台可查看详情并取消订单。
常见问题
前台看不到购买按钮？ 检查插件已授权、商城已开启、该品项有上架报价且品项状态为「在售」。
只能余额不能微信？ 请到系统「在线支付」开启对应通道，演示环境可用演示模式自动入账。
价格与库存：在哪里维护？
2026-06-27 起，价格与库存统一在产品中心 → 品项列表维护（按规格行展开）。保存规格时自动同步到商城 SKU（按 variant_id 挂接），无需再到独立「SKU 管理」页操作。
- 若某规格行不填商城价，则不创建商城 SKU；填写后再次保存会按
variant_id增量清理已被移除的 SKU 行。 - 支持 划线价
original_price（展示用）；若original_price < price，系统自动抬到price，避免前端显示「划线价低于售价」的负向体验。
营销与运费
- 优惠券：产品中心 → 优惠券，创建满减或折扣码。
- 满减送：商城设置 → 营销，配置「满 X 减 Y」阶梯，结算时自动抵扣。
- 运费模板：产品中心 → 运费模板，按省份设置运费或满额包邮。
- 限时秒杀 / 搭配购：开关已在商城设置预留，正式能力将陆续开放。
物流与售后
- 后台「订单」可录入快递公司与运单号；开启快递100 后，会员可在订单详情查看物流轨迹。
- 「退款售后」处理会员退货退款；「发票申请」处理开票需求（需已启用相关能力）。
使用说明
功能简介（前端向）
报价数据按 item_id 关联品项。推荐在文档详情使用 （自动取文档关联的首个品项），在品项详情使用 。
模板标签
前台脚本
在页面底部引入（需站点 CSRF token，footer 已含）：
页脚保留 ； 激活时自动加载 weapp/shop/assets/js/doc-checkout.js。B2C 商城页在 footer 前加 。
脚本会读取 /api/v1/plugins/shop/meta，按配置展示「余额 / 微信 / 支付宝」按钮。
REST API
| 接口 | 说明 |
|---|---|
GET /api/v1/plugins/shop/meta | 商城开关、余额开关、在线支付通道 |
GET /api/v1/plugins/shop/offers?item_id= | 某品项的上架报价列表 |
POST /api/v1/plugins/shop/checkout | 下单：offer_id, qty, channel（balance/wechat/alipay） |
POST /api/v1/plugins/shop/repay | 待支付订单继续支付 |
POST /api/v1/plugins/shop/cancel | 会员取消待支付订单（需登录+CSRF） |
GET /api/v1/plugins/shop/orders | 会员订单列表 |
GET /api/v1/plugins/shop/order?order_no= | 会员订单详情（含行明细） |
会员中心
路由 /member/shop_orders；插件 manifest 已注册侧栏「我的订单」。
完整商城支持购物车与多 SKU；文档页直购模式适合单次购买一个报价。
升级日志
- 商城设置：满减送、运费分区、物流轨迹查询
- 产品中心统一运营入口：订单、运费、优惠券、发票等
- 历史：曾试验 shop 内多商户路径（**2026-07 已迁至 platform**，见 AD-029）
- **B2C 纯化**：`/shop` 去多商户筛选；`ShopTierService` 恒 b2c
- 多商户 / listing / 结算 SSOT → `weapp/platform/`（与 shop 独立，非升档）
- 完整商城：购物车、收货地址、运费、优惠券
- 退款、发货与会员订单中心
- 文档页直购与商城首页两种模式
- 品项报价与在线下单初版
购买与安装
- 登录官网会员，在本页右侧选择试用或付费套餐完成开通。
- 在 用户中心 → 我的授权 查看授权并绑定站点域名。
- 客户站后台 → 系统 / 授权 同步官网授权。
- 安装前确认站点已启用 品项内核 等依赖能力，否则插件核心功能不可用。
- 客户站 → 应用市场 搜索
shop在线安装 并启用。
交易须知
- 交付形式官方插件 · 授权安装；通过应用市场安装，不提供独立源码包下载。
- 授权范围插件授权绑定单个站点域名；小程序类 SKU 规则以套餐说明为准。
- 退款规则请确认功能需求后再购买；非功能缺陷恕不退款。
- 官方保障官方插件由元舟提供安装指导与技术支持。