Qmai 国际前端系统地图与仓库职责

这一页回答一个最容易出错的问题：一个需求到底应该改哪个前端仓库？

Qmai 国际前端不是单个项目，而是一组系统协作。需求来了以后，不能只靠关键词猜仓库，要先看系统地图和职责边界。

先看整体地图#

1
Qmai 国际前端
2
  ├─ qiankun 基座
3
  │   └─ console-vue-international
4
  ├─ 业务子应用
5
  │   └─ 多个 *-vue-international 仓库
6
  ├─ 公共业务页和公共打印模板
7
  │   └─ common-vue-international
8
  ├─ 共享组件库
9
  │   └─ vue-kylin-international
10
  ├─ 打印运行时
11
  │   └─ operation
12
  ├─ 装修平台
13
  │   ├─ design-vue-3-international
14
  │   └─ design-v0-international
15
  └─ 可选发布流程
16
      └─ OPMS pre 发布脚本与配置

判断顺序#

先读需求原文，不先猜仓库。
提取业务词、页面词、接口词、路由词。
先判断系统类型：基座、业务子应用、公共页、组件库、打印、装修平台。
如果目标可能是 *-vue-international，查完整仓库职责清单。
判断是否需要联查基座、组件库、公共业务页或打印项目。
再进入对应 playbook。

系统角色表#

系统角色	仓库或项目	主要职责
qiankun 基座	`console-vue-international`	登录、菜单、头部、侧栏、容器、微应用注册、跨应用状态、全局主题
公共业务页	`common-vue-international`	`/commonCenter/`、公共能力页、公共配置、公共打印模板、票据模板
共享组件库	`vue-kylin-international`	选择器、表格、上传、业务弹窗、跨仓共享组件和组件包发布
打印运行时	`operation`	打印插件、桥接、国际打印代码、打印通用入口、本地调试
装修平台主工程	`design-vue-3-international`	点餐小程序、SOK、KDS、智慧屏、叫号屏等装修能力
装修组件库	`design-v0-international`	装修平台复用组件能力

`*-vue-international` 仓库职责清单#

下面是业务子应用仓库的简化职责表。真实任务中仍要结合当前仓库源码、路由和页面确认。

仓库	一句话职责	典型需求关键词
`console-vue-international`	国际后台 qiankun 基座和壳层	登录、菜单、头部、侧栏、主页、账号中心、微应用挂载
`common-vue-international`	公共业务能力页、公共打印模板和多业务复用页面	公共配置、收款、配送中心、硬件、KDS、桌台、打印模板、消息中心
`org-vue-international`	组织、企业、账号、员工、门店、权限和品牌基础资料	企业信息、品牌、组织架构、角色权限、员工、账号、门店、语言
`goods-vue-international`	商品中心、菜单商品、分类、门店商品、库存和配方资料	商品、SKU、套餐、商品分组、分类、门店商品、库存、配方、税率
`catering-vue-international`	餐饮业务订单、门店经营设置、堂食、外卖、排队、桌台	餐饮订单、售后、外卖、买单、取餐、预约、排队、KDS、桌台
`std-vue-international`	标准商城订单和售后轻量项目	商城订单、商城售后、商城设置
`coupon-vue-international`	优惠券、卡券、券活动、券核销和第三方券	券模板、券规则、卡券、实体卡、第三方券、团购券、券分析
`marketing-vue-international`	营销活动中心、广告、促销玩法和营销配置	满减、促销、广告、会员价、推广员、帖子、营销管控
`cmk-vue-international`	CMK 营销画布、营销流程和活动编排	营销画布、营销工作流、流程统计、活动编排、专属分享
`member-vue-international`	会员中心、会员资料、等级积分、会员营销和第三方会员渠道	会员列表、标签、画像、RFM、积分、等级、付费会员、精准营销
`payment-vue-international`	支付、商户、台账、终端、钱包和会员资产	支付配置、商户、交易订单、终端、台账、钱包、会员资产
`message-vue-international`	消息中心、消息渠道、订阅消息和消息推送	短信、微信渠道、消息推送、推送记录、订阅消息
`connector-vue-international`	连接器事件中心和审批运营平台	事件中心、事件详情、审批管理、创建审批
`operating-vue-international`	运营平台、应用中心、业务中心、帮助中心和平台能力	应用市场、业务中心、连接器、数据标准、帮助中心、工单、SDK
`scm-vue-international`	供应链、采购、仓储、配送、生产、分拣和库存流转	供应商、仓库、采购、调拨、入库、出库、配送、生产、分拣
`bi-vue-international`	传统 BI、经营报表、数据分析、大屏和指标看板	数据中心、经营报表、商品分析、会员分析、热力图、财务报表
`qmbi-vue-international`	新版自助 BI、报表设计、数据集、数据源和工作空间	分析设计器、报表、数据立方体、数据源、数据集、工作空间

常见混淆边界#

容易混淆	判断方式
`bi-vue-international` 和 `qmbi-vue-international`	传统经营报表看 `bi`；自助 BI、报表设计器、数据集、工作空间看 `qmbi`
`marketing-vue-international` 和 `cmk-vue-international`	常规活动、广告、促销看 `marketing`；营销画布和工作流看 `cmk`
`catering-vue-international` 和 `std-vue-international`	餐饮完整订单链路看 `catering`；标准商城订单和售后轻量项目看 `std`
`connector-vue-international` 和 `operating-vue-international`	事件中心和审批看 `connector`；平台运营、应用、业务中心看 `operating`
`common-vue-international` 和业务子应用	多业务复用、公共配置、公共模板看 `common`；单业务页面看对应业务仓
打印模板和打印运行时	模板和纸面内容看 `common`；插件、桥接、运行时代码看 `operation`

样式和组件归属#

问题	优先归属
菜单、头部、壳层、容器、全局主题	`console-vue-international`
当前业务页面布局和局部样式	当前业务子应用
多仓重复出现的组件视觉或行为	`vue-kylin-international`
公共业务页或打印模板视觉	`common-vue-international`
打印插件、桥接、国际打印代码	`operation`

涉及 UI、UX、页面布局、组件视觉、长文本或 RTL 时，必须先读 UI 详细设计规范。

给新人记住的口诀#

先问系统，再问仓库；先看职责，再看代码。

共享问题回组件库，壳层问题看基座，公共页看 common，打印运行时看 operation。