@bct/mom

本包承载 MOM（制造运营管理） 相关的前端页面（views/mom）与 页面级国际化（i18n/pages/mom），与宿主工程通过 pnpm workspace 链接；也可复制目录或发布后给其他 Vue 3 工程复用。

在本仓库中的用法

1. 根目录已配置 pnpm-workspace.yaml，将 packages/* 纳入 workspace。
2. 根 package.json 依赖 "@bct/mom": "workspace:*"，pnpm install 时会自动链接到 packages/mom，无需再手动拷贝源码。
3. 宿主工程需保留以下约定（本仓库已写好）：
   • Vite resolve.alias：/@/views/mom → packages/mom/views/mom（保证原有 /@/views/mom/... 引用与后端菜单 component 路径不变）。
   • 动态路由（src/router/backEnd.ts）：除 ../views/**/* 外，增加对 ../../packages/mom/views/**/* 的 import.meta.glob，并用 normalizeViewsModuleKey 将 key 规范为与原先一致的 mom/... 后缀，以便 dynamicImport 匹配后端返回的组件路径。
   • i18n（src/i18n/index.ts）：合并 import.meta.glob('../../packages/mom/i18n/**/*.ts')，与 src/i18n 下其它页面语言包一起进入 messages。
   • TypeScript：tsconfig.json 的 include 包含 packages/mom/**/*.vue 与 **/*.ts，以便类型检查与 IDE 跳转。

在其它项目中复用

宿主需与本项目一样使用 /@/ 指向自身 src（axios、api、stores、utils 等仍从宿主解析）。MOM 页面内的业务代码大量依赖该别名。

方式 A：pnpm workspace（推荐，同 monorepo）

在宿主仓库根目录：

# pnpm-workspace.yaml
packages:
  - 'packages/*'

将本包目录放入宿主 packages/mom（或子模块 / git subtree 同步同路径），在宿主 package.json 中增加：

{
  "dependencies": {
    "@bct/mom": "workspace:*"
  }
}

然后在宿主 Vite、backEnd 动态 glob、i18n 合并、tsconfig include 四处按上文「在本仓库中的用法」对齐配置即可。

方式 B：发布到 npm / 私有 registry

1. 将 packages/mom/package.json 中 name、version 调整为你的 scope（例如 @your-org/mom），按需设置 "private": false 后执行发布流程。
2. 在宿主中 pnpm add @your-org/mom，并把 Vite 中 /@/views/mom 别名指向 node_modules/@your-org/mom/views/mom（或该包 exports 所暴露的目录）。
3. 动态路由 glob 改为指向 node_modules/@your-org/mom/views/**/*，并在 normalizeViewsModuleKey 中增加对路径片段 packages/mom/views/ 的识别（与本仓库一致；注意不要用前导 /packages/，否则匹配不到 Vite 返回的 ../../packages/... 形式 key）。

方式 C：file / link 本地路径

"@bct/mom": "file:../01-Client-QY/packages/mom"

别名仍指向该包内 views/mom 物理路径即可。

目录说明

| 路径 | 说明 | |------|------| | views/mom/** | 原 src/views/mom，组件路径仍以 mom/... 为后缀供后端路由匹配 | | i18n/pages/mom/** | 原 src/i18n/pages/mom，随宿主 i18n 初始化合并 |

维护注意

• 新增仅 MOM 使用的页面级文案时，请在本包 i18n 下维护，避免与宿主 src/i18n/pages 键名冲突。
• 若后端菜单 component 字段规则变更，需同步检查 dynamicImport 的匹配逻辑。