中国 帮助

工程结构

text wujiesweb/ ├── index.html system 入口 ├── sites/mall/ mall 入口(index.html + main.ts) ├── vite

工程结构
封面

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

章节导览
THE END

喜欢就支持以下吧

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

回到内容