> 本文整理自平台文档 docs/wujies/5.x/frontends/pc/structure.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-850d3981789d-cover.svg)
wujies-web/
├── index.html system 入口
├── sites/mall/ mall 入口(index.html + main.ts)
├── vite.config.ts 端口 4230、/dev-api 与 /site 代理、多入口 build.input
├── .env.development
├── .env.production
├── public/ 静态资源
├── dist/ 构建产物(多入口共用一份 assets/)
└── src/
├── api/ 接口,按业务域分(mall / member / social / im / exam / gallery / portal / openapi)
├── assets/
├── bootstrap.ts ★ 站点入口的唯一启动路径(先 setCurrentSite,再动态 import 其余模块)
├── components/
├── config/sites.ts ★ 站点定义:code / mount 前缀 / home / 入口 HTML
├── hooks/
├── layout/ 顶部导航 / 页脚 / 用户菜单
├── main.ts system 入口的启动脚本
├── plugins/ 全局插件(auth / cache / modal / download)
├── router/ 按站点生成路由表与守卫
├── store/ Pinia
├── types/
├── utils/ request / auth / 格式化 / mallCart
└── views/ 页面(home / mall / member / im / exam / gallery / quote / enterprise / auth …)
目前拆出来的站点只有 system(挂在 /)和 mall(挂在 /mall),其余业务路径仍归 system。
> 这一侧只是 SPA 的骨架。面向匿名访客与搜索引擎的公开页不在这里,它们由各应用在后端直出到 /site/**,见 [PC 用户端 · 现在这一侧的分工](/docs/wujies/5.x/frontends/pc/)。
路由
- 路由是前端静态路由,与后台的菜单驱动不同;
- 路由表按站点生成:
src/router/会读getCurrentSite(),system持有全部路由,mall只拿自己那一段; - 需要登录的页面在
permission.ts的守卫里校验 token:匿名可访问的路径写死在两份清单里——whiteList走精确相等(/、/guide、/login、/register、/mall、/quote、/exam、/im、/member、/gallery/home、/gallery/square等),whitePrefixList只放了/mall/product(带路径参数的开放详情页)。/site/不在这里**:那段路径由后端直出,请求根本进不到 SPA 守卫。 - 页面标题、是否需要登录等元信息写在路由
meta上。
新增页面时:
1. src/views/<模块>/<页面>.vue; 2. src/router/ 里登记路由; 3. src/api/ 里补接口; 4. 如果是新业务,确认后端已安装对应应用(接口由应用提供)。
接口层
src/api/ 按业务域拆开,最终都走 src/utils/request。C 端接口主要有三类:
| 前缀 | 用途 | 提供方 |
|---|---|---|
/open/** | 开放接口(商品、内容等) | 对应应用(宿主只留 /open/system/message、/open/{code}/config) |
/portal/** | 门户 / 用户侧接口 | 对应应用(宿主只留 /portal/user) |
/auth/、/system/ | 登录、字典等平台能力 | 平台宿主 |
公开页的整页 HTML 不在这张表里:/site/** 是各应用直出的,不走 src/api。
src="/images/docs/pc-structure.png" caption="PC 用户端目录与接口关系(示意图占位)" hint="可画:views → api → request → /open、/portal;并标出「应用未安装则 404」。" />
与后台端的共享
- 登录 token 的存储与请求头格式一致(两边都用
VITE_APP_CLIENT_ID走/auth/login,localStorage 键同为Admin-Token,同域部署时登录态是共用的); - 字典、地区、上传等基础能力复用平台接口;
- 但不要把后台端的页面或 store 直接复制过来:两边的权限模型、菜单来源、路由守卫都不一样。
部署
- 纯静态站,Nginx 托管
dist/; - 多入口要各写一条,且前缀站点排在
/前面:location /mall { try_files $uri /sites/mall/index.html; },否则/mall/xxx会被根入口吃掉,页面空白或 404; - 需要
try_files $uri $uri/ /index.html支持 history 路由; /site/**单独反代到后端(那段不在dist/里);- 如果与后台端同域,注意
VITE_APP_CONTEXT_PATH与 Nginx location 的对应关系。
本文导览
(https://console.wujies.cn/remote-apps/cms-assets/doc-850d3981789d-guide.svg)


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