yidun-midend-dashboard — 易盾统一运营后台（qiankun 微前端）

分层：表现层 ｜ 部署单元：20 个前端应用 + 1 个共享库（全部非容器化）｜ 数据库：无（纯前端）｜ base image：无（无 Dockerfile，静态目录 + 外部 nginx）

一、模块定位与架构

把内容安全、业务安全、应用安全、AI 等数十条产品线的运营/管理界面，用 qiankun 微前端聚合到同一个登录态、同一套权限与导航下的统一运营门户（union-admin）；运营、策略、审核、交付人员在一个入口里完成所有日常操作。它不做业务逻辑，只是各后端产品线的“入口闸门”——微应用注册错会白屏、权限 key 配错会菜单不显示、网关地址错会全站 401/403。

架构分层

• 主应用/壳：packages/platform（Vue3 + Vite，负责登录、权限、导航与 qiankun 注册表 mircoAppConfig）
• 微应用群：18 个 Vite 子应用（system/product/meta/strategy-center/package-center/supplier/portrait/risk-manage/app-reinforce/app-detect/fingerprint/consult-console/censor-platform/export-center/antispam-admin/image-recognition/ai-intelligent-assistant/ai-evaluation）+ yidun-console（Vue2.7 + vue-cli，历史大仓）
• 共享库：packages/union-admin-shared（fetchUtils、v-auth、<Permission>、SuperTable 等）

关键数据流

1. 浏览器访问 union-admin.nis.netease.com → platform 经认证网关 /auth（VITE_LOGIN_URL）完成登录
2. common_getCurrentUser()（/union-user/...）拉用户与权限点 → 写入 qiankunStore，通过 #childContainer 挂载子应用
3. qiankun 按 activeRule 匹配并加载子应用 entry（https://union-admin.nis.netease.com/<pkg>/index.html）
4. 子应用内 axios fetcher 经 /gateway（VITE_API_BASE_URL，shenyu 网关）调后端 → code!==200 判错、401 跳登录、HTTP 403 提示“暂无权限”
5. 生产构建可由 --useCdn 把静态资源上传 NOS bucket yidunfe（CDN https://yidunfe.nosdn.127.net/<pkg>/）

二、可部署服务清单

部署单元目录	npm 包名	镜像名	端口（dev）	服务类型	独立 Dockerfile	是否进 kubernetes.yml
packages/platform	platform	无（不构建）	7000	主应用/壳（qiankun 容器）	无	否
packages/system	system	无（不构建）	7001	微应用（系统设置）	无	否
packages/package-center	package-center	无（不构建）	7002	微应用（套餐中心）	无	否
packages/product	product	无（不构建）	7003	微应用（产品业务中台）	无	否
packages/strategy-center	strategy-center	无（不构建）	7003 ⚠️冲突	微应用（策略中心）	无	否
packages/meta	meta	无（不构建）	7004	微应用（元数据中心）	无	否
packages/censor-platform	censor-platform	无（不构建）	7004 ⚠️冲突	微应用（人审运营平台）	无	否
packages/supplier	supplier	无（不构建）	7005	微应用（供应商中台）	无	否
packages/portrait	portrait	无（不构建）	7101	微应用（风险画像）	无	否
packages/risk-manage	risk-manage	无（不构建）	7102	微应用（智能风控）	无	否
packages/app-reinforce	app-reinforce	无（不构建）	7103	微应用（应用加固）	无	否
packages/yidun-console	yidun-console	无（不构建）	7104	微应用（易盾控制台，Vue2.7）	无	否
packages/fingerprint	fingerprint	无（不构建）	7105	微应用（设备指纹）	无	否
packages/consult-console	consult-console	无（不构建）	7106	微应用（蓝军自动化巡检）	无	否
packages/export-center	export-center	无（不构建）	7107	微应用（通用导出中心）	无	否
packages/antispam-admin	antispam-admin	无（不构建）	7108	微应用（内容安全管理后台）	无	否
packages/image-recognition	image-recognition	无（不构建）	7109	微应用（图像识别管理）	无	否
packages/app-detect	app-detect	无（不构建）	7110	微应用（应用检测）	无	否
packages/ai-intelligent-assistant	ai-intelligent-assistant	无（不构建）	7110 ⚠️冲突	微应用（AI 智能助手）	无	否
packages/ai-evaluation	ai-evaluation	无（不构建）	7112	微应用（大模型测评）	无	否
packages/union-admin-shared	union-admin-shared	— 类库，不部署	—	共享库（产物 lib/）	无	否

全模块无 Dockerfile、无 nginx.conf；只有两处 nginx 片段 location.conf（仓库根 + packages/yidun-console/）。部署方式为 dist/<pkg> 静态目录交给外部 nginx，访问路径 https://union-admin.nis.netease.com/<pkg>/index.html。

三、同模块启动顺序

1. packages/union-admin-shared —— 所有子应用以 workspace 依赖引用它，必须先构建出其 lib/。
2. packages/platform —— 主应用/壳，负责登录与 qiankun 注册表，是唯一入口。
3. 各微应用（可并行） —— 依赖共享库与主应用注册的 entry 地址；构建顺序由 lerna 拓扑自动决定（lerna run build）。

理由：npm run install（lerna bootstrap）会按 workspace 依赖建立软链；共享库未构建时子应用无法解析 union-admin-shared。

四、逐服务启动逻辑

根构建 / 部署（package.json + deploy.sh）

• package.json scripts：install=lerna bootstrap、build=lerna run build、build:test=lerna run build:test、build:private=lerna run build:private（lerna ^4）；volta.node=18.16.0
• deploy.sh：export PATH=/home/appops/ndp-soft/node-v18.16.0-linux-x64/bin:./node_modules/.bin:$PATH → npm install → npm run install → 有参数则 npm run build:$1，否则 npm run build
• 产物：各包统一 build.outDir=../../dist/<pkg.name>（platform 例外，输出到 dist/ 根）；union-admin-shared 产物在 packages/union-admin-shared/lib/

packages/platform（主应用/壳）

• 构建脚本与产物：vite build --mode production -- --useCdn（另有 build:private→--mode private、build:test→--mode tests）；packages/platform/vite.config.ts 的 base = useCdn ? https://yidunfe.nosdn.127.net/platform/ : '/'、build.outDir=../../dist/（输出到 dist 根，非 dist/platform）
• 无 vite-plugin-qiankun（不注册为子应用）；src/main.ts 直接 createApp(App).mount('#app')
• qiankun 装配：src/microService/index.ts 用 registerMicroApps(microApps) + start()，microApps 来自 src/microService/mircoAppConfig.ts（19 个微应用，含 activeRule/entry/authority/hideByPrivate，容器统一 #childContainer）
• dev：server.host='local-med.nistest.netease.com'、port=7000、proxy ^/gateway/ → http://union-admin.nistest.netease.com；WSL 下 watch.usePolling=true

packages/yidun-console（Vue2.7 + vue-cli 微应用）

• 构建脚本与产物：vue-cli-service build --mode production|test|private|offline；vue.config.js 的 outputDir=../../dist/yidun-console、publicPath='/yidun-console/'、libraryTarget='umd'、jsonpFunction=webpackJsonp_yidun-console（按 qiankun 微应用要求打成 umd）
• 入口 src/main.js 导出 qiankun 生命周期 bootstrap/mount/unmount，并用 window.__POWERED_BY_QIANKUN__ 区分独立运行与被子应用加载
• dev：devServer.host='local-med.nistest.netease.com'、port=7104，proxy /api//api/ac///logout → http://union-admin.nistest.netease.com/gateway

各 Vite 微应用

• 构建脚本与产物：vue-tsc --noEmit && vite build --mode production -- --useCdn；vite.config.ts 中 base = useCdn ? https://yidunfe.nosdn.127.net/<pkg.name>/ : /<pkg.name>/、build.outDir=../../dist/<pkg.name>
• 插件：vite-plugin-qiankun(pkg.name, { useDevMode: true })；--useCdn 时启用 CdnUploadVitePlugin（bucket yidunfe、NOS nos-jd.163yun.com）
• dev：server.host='local-med.nistest.netease.com'、各自 port、watch.usePolling=isWsl（os.release().toLowerCase().includes('microsoft')）

五、启动前置依赖

依赖	配置键 / 地址	阻塞 or 弱依赖	配置文件
Node 运行时	volta.node=18.16.0；deploy.sh 写死 /home/appops/ndp-soft/node-v18.16.0-linux-x64/bin	阻塞（构建）	package.json、deploy.sh
本机 hosts	local-med.nistest.netease.com 指向本机	阻塞（dev 启动）	系统 hosts（README 明确要求）
统一网关	VITE_API_BASE_URL=/gateway、http://union-admin.nistest.netease.com/gateway（shenyu）	弱（运行时）	.env.development / vite.config.ts proxy
认证网关	VITE_LOGIN_URL=/auth（online）或 https://union-admin.nistest.netease.com/auth	弱	.env.*
账号服务	/union-user/v2/user/info、私有化登录 /union-user/v1/api/login	弱	.env.*
NOS 桶 yidunfe	CDN https://yidunfe.nosdn.127.net/<pkg>/，NOS nos-jd.163yun.com	弱（仅 --useCdn 构建时）	各 vite.config.ts
Redis / DB / Kafka	无	—	—

六、启动参数与 Profile

• Node 版本：全仓库 volta.node=18.16.0；deploy.sh 把 node-v18.16.0-linux-x64/bin 放在 PATH 最前
• 构建模式：production / test / private / offline（主应用 vue-cli 四模式齐备；Vite 子应用为 --mode production|tests|private）
• 环境文件：.env.development / .env.production / .env.test（VUE_APP_* / VITE_*），如 .env.production 的 VUE_APP_MODE=production、VUE_APP_API_BASE_URL=/gateway、VUE_APP_LOGIN_URL=/auth；platform/.env.production 里 VITE_ENTERY_* 一律指向 https://union-admin.nis.netease.com/<pkg>/index.html
• 容器化：无（无 Dockerfile / base image / JAVA_OPTS / kubernetes.yml）

七、启动期踩坑

1. 必须配 hosts：README 明确“记得配置 host: [your ip] local-med.nistest.netease.com”，未配则所有子应用 dev server 起不来。
2. dev 端口有冲突：仓库要求“每个子项目单独端口”，但实际 product 与 strategy-center 都是 7003、meta 与 censor-platform 都是 7004、app-detect 与 ai-intelligent-assistant 都是 7110——同时跑会互相抢占端口。
3. useDevMode: true 与热更新互斥：vite-plugin-qiankun 注释写明“useDevMode=true 则不使用热更新插件，useDevMode=false 则能使用热更新，但无法作为子应用加载”。
4. WSL 必须开 usePolling：各 vite.config.ts 以 os.release().toLowerCase().includes('microsoft') 判定，WSL 下文件监听依赖轮询，否则改动不触发 HMR。
5. 构建链不统一：主应用 platform 是 Vue3 + Vite，而 yidun-console 是 Vue2.7 + vue-cli（umd），同一仓库两套构建与依赖体系，排障需先看清包用的是哪套。
6. nginx 只是片段：location.conf 仅 try_files $uri $uri.html $uri/ /index.html（SPA 回退），仓库无完整 nginx.conf、无 Dockerfile，部署需外部 nginx 手工接入并按 /gateway 反代后端。
7. yidun-console 在注册表中 hidden: true：mircoAppConfig 里它被隐藏（入口 /yidun-console/m/risk-manage/data/statics），改导航时要留意“隐藏但仍注册”。
8. --useCdn 把 AK/SK 写进构建配置：CdnUploadVitePlugin 的 accessId/secretKey 硬编码在各 vite.config.ts，且 CDN 模式下 base 变为绝对 CDN 域名——本地/离线环境误带 --useCdn 会加载不到资源。

八、跨模块前置

• 上游：认证网关 /auth（登录、登出、验证码，VITE_LOGIN_URL）、yidun-account（用户信息 /union-user/v2/user/info、私有化登录）——二者均为运行时 HTTP 契约，非代码依赖。
• 下游：各子应用经 /gateway（shenyu）调用 antispam-* / yidun-* 后端；前端是这些后端产品线的运营入口，后端未起时对应子应用只有接口报错、整站仍可用。
• 构建期前置：Node 18.16.0 必须可用，且 union-admin-shared 要先能构建；npm install / lerna bootstrap 需可访问内网 npm 源（.npmrc）。
• 无服务端启动顺序约束：本模块是全栈最顶层的静态资源，不阻塞任何后端；反之建议各后端 /gateway 路由就绪后再验收微应用功能。

相关：全局启动顺序 · 部署单元矩阵 · 踩坑速查

与既有描述差异：既有描述称 packages/yidun-console 为主应用/壳；实际主应用是 packages/platform（src/microService/index.ts 的 registerMicroApps + start()，mircoAppConfig 注册 19 个微应用），yidun-console 是注册表中 hidden: true 的 Vue2.7 微应用。