中国 帮助

PC 用户端

wujiesweb 是面向终端用户的 C 端 Web,与后台管理端是平行的两个 Vite 工程:各自构建、各自部署,共用同一套后端接口与登录体系。 工程目录:wujiesweb/ 包名:wujiesweb 版本:5.5.12.5.1

PC 用户端
封面

> 本文整理自平台文档 docs/wujies/5.x/frontends/pc/index.mdx,用于站点内容演示。

(https://console.wujies.cn/remote-apps/cms-assets/doc-7e810a69bb51-cover.svg)

wujies-web 是面向终端用户的 C 端 Web,与后台管理端是平行的两个 Vite 工程:各自构建、各自部署,共用同一套后端接口与登录体系。

  • 工程目录:wujies-web/
  • 包名:wujies-web
  • 版本:5.5.1-2.5.1
  • 开发端口:4230
  • 仓库定位:C 端 SPA 工程;公开访问的前台页已改由各应用服务端直出(见下)

现在这一侧的分工

2026-10-31 起,「前台的页面都归站点」:面向搜索引擎与匿名访客的页面不再由这个 SPA 承载,而是由对应应用在后端直出整页 HTML,统一挂在同域路径前缀 /site/** 下(不是二级域名):

页面直出方路径
首页 / 分类 / 文章 / 独立页内容中心 wujies-cms-plugin/site、/site/category/{category}(分类别名)、/site/p/{slug}、/site/{slug}
商城六页(目录、商店首页、商品详情、店铺、活动、领券)商城 wujies-mall-plugin/site/shop、/site/shop/home、/site/product/{id}、/site/store/{id}、/site/activity、/site/coupon
图床图床 wujies-gallery-plugin/site/gallery、/site/gallery/square、/site/gallery/image/{id}
企业企业数据 wujies-enterprise-plugin/site/company、/site/company/{id}
考试考试 wujies-exam-plugin/site/exam、/site/exam/{id}
询价报价 wujies-quote-plugin/site/quote

另外两条现状:

  • 会员中心整套页面已经搬进 wujies-admin(src/views/member/,路由前缀 /member/):确认订单、收银台、支付结果、订单、地址、优惠券、余额、积分、徽章、签到、售后都在后台;直出页上的「立即购买 / 领券中心 / 登录 / 注册」是按 cms.consoleUrl 拼出来的出站绝对地址。
  • IM 不做直出页:公开页只在店铺页 / 详情页挂「联系客服」按钮(先 POST /site/store/{id}/contact 建会话,成功再打开后台会员中心的 IM 页 /member/im)。

和后台端的区别

维度后台管理(wujies-admin)PC 用户端(wujies-web)
用户管理员、运营,以及登录后的会员终端消费者
接口/system/、/app/ 等平台接口/open/、/portal/ 等应用提供的接口
远程应用是宿主,运行期加载 ESM不加载远程应用
登录后台账号,/auth/login + VITE_APP_CLIENT_ID,token 存 localStorage同一套登录体系(两端用同一个 client 标识),token 同样存 localStorage
部署子路径 /admin/(开发端口 80)一次构建多入口,挂在同域 /(system)与 /mall(商城);/site/** 由后端在同域前缀下直出

仓库里现有的视图目录

src/views/ 下目前包含(是否仍被访问,看上一节的分工——公开的那几屏已经由 /site/** 直出):

模块页面
home首页
mall商品列表、详情、购物车、结算、支付、订单、优惠券、店铺、活动
member会员中心、地址、余额、积分、成长值、徽章、签到、优惠券、售后(后台 /member/** 已有同一套)
im会话窗口、工作台
exam考试列表、详情、在线作答、练习、结果
gallery图床首页、广场(图片详情已改由 /site/gallery/image/{id} 直出)
quote报价相关页面
enterprise企业相关页面
auth登录 / 注册(没有找回密码页)
appmarket / myapps / guide / system / setup应用与引导类页面

购物车仍是 SPA 的 localStorage(键 wujies-shop:mall:cart),后端没有 HTTP 购物车端点,所以服务端直出的卡片上不放「加入购物车」。

src="/images/docs/pc-home.png" caption="PC 用户端首页(截图占位)" hint="建议 2560 × 1600,截首页首屏:导航、轮播、商品区。" />

最容易踩的坑:接口取决于「应用装没装」

业务性的 C 端接口交给应用,宿主里只剩少数跨应用的平台能力(/portal/user 个人资料、/open/system/message 消息、/open/{code}/config 站点配置)。因此:

  • 各业务的 /open/、/portal/(商品、内容、订单、评论……)不是平台自带的;
  • 后端必须先安装对应应用(商城、会员、社交、考试、图床……),否则接口 404;
  • 这是刻意的架构:加一个 C 端业务 = 装一个应用,而不是改宿主、重新发版。

排查顺序:① 应用是否安装并启用 → ② 应用版本是否包含该接口 → ③ 最后才查路径拼写。

详见 [C 端接口与应用](/docs/wujies/5.x/frontends/pc/open-api)。

继续读

  • [快速开始](/docs/wujies/5.x/frontends/pc/quickstart)
  • [工程结构](/docs/wujies/5.x/frontends/pc/structure)
  • [C 端接口与应用](/docs/wujies/5.x/frontends/pc/open-api)

本文导览

(https://console.wujies.cn/remote-apps/cms-assets/doc-7e810a69bb51-guide.svg)

章节导览
THE END

喜欢就支持以下吧

评论区需要浏览器启用 JavaScript 才能加载。

回到内容