> 本文整理自平台文档 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)


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