refactor(首页): 展示模块跟随菜单权限自动隐藏

gaoluyang

20 小时以前 8a2832d02126f33596c125c855d7effe96d69da1

refactor(首页): 展示模块跟随菜单权限自动隐藏

权限少的账号打开首页会挨个弹「没有该操作权限」：卡片不看权限就发请求，
403 被全局拦截器弹成 toast，取不到数的卡片还留着 0 的假数字。

- 新增共享判据 src/utils/use-home-access.ts：canQuery（接口权限码，带超管
  兜底，与后端 @ss.hasPermission 对超管放行的口径一致）、canSeeMenu（菜单
  开着；后端菜单 visible=0 只是 meta.hideInMenu，路由照样注册，所以要连祖先
  一起看，和侧边栏剪枝一个口径）
- /analytics：质量/设备 KPI、经营 KPI 四张卡、金额概览、快捷入口各按自己的
  权限与菜单显隐；没权限的接口直接不发请求，列宽随可见卡片数自适应
- 顺手修正对不上任何菜单的路由名：MesQcRecord→MesQcIqc、
  BpmTaskTodo→BpmTodoTask、WlsMaterialStock→MesWmMaterialStock

同一套写法已在 8151c325（dev_新疆_北方科技）落地，可互相移植。

Co-Authored-By: Claude Code <noreply@anthropic.com>

 src/utils/use-home-access.ts

¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,54 @@
import type { RouteRecordRaw } from 'vue-router';

import { useAccess } from '@vben/access';
import { useAccessStore, useUserStore } from '@vben/stores';

/** é¦–页常驻，业务数据和入口仍需遵循当前用户的菜单权限。 */
export function useHomeAccess() {
  const accessStore = useAccessStore();
  const userStore = useUserStore();
  const { hasAccessByCodes } = useAccess();

  /**
   * æŽ¥å£æƒé™ï¼šæ²¡æœ‰å¯¹åº”权限码就取不到数，请求会直接 403，所以取数前先问一句。
   *
   * åŽç«¯ `@ss.hasPermission` å¯¹è¶…管是直接放行的（不看权限码），前端这里保持一致，
   * å¦åˆ™è¶…管会因为权限码没在菜单里配而少看到卡片。
   */
  function canQuery(permission: string) {
    return (
      userStore.userRoles.includes('super_admin') ||
      hasAccessByCodes([permission, '*:*:*'])
    );
  }

  /**
   * è¯¥èœå•å¯¹å½“前用户是否「开着」—— ç”¨äºŽé¦–页模块开关。
   *
   * åŽç«¯èœå• `visible = 0` ä¼šè¢«å‰ç«¯è½¬æˆè·¯ç”±çš„ `meta.hideInMenu`，这类路由仍然注册在
   * router é‡Œï¼ˆé¡µé¢å¯ä»¥ç›´æŽ¥è®¿é—®ï¼‰ï¼Œåªæ˜¯æ•´æ£µå­æ ‘不会出现在侧边栏。所以判断「这个模块有
   * æ²¡æœ‰å¼€ã€ä¸èƒ½åªçœ‹è·¯ç”±æ˜¯å¦å­˜åœ¨ï¼Œè¿˜è¦çœ‹å®ƒå’Œå®ƒçš„每一级祖先是否可见。
   *
   * @param name è·¯ç”± name，即后端菜单的 component_name
   */
  function canSeeMenu(name: string) {
    function find(
      routes: RouteRecordRaw[],
      ancestorHidden: boolean,
    ): boolean | undefined {
      for (const route of routes) {
        const hidden =
          ancestorHidden ||
          route.meta?.hideInMenu === true ||
          route.meta?.menuVisibleWithForbidden === true;
        if (route.name === name) return !hidden;
        const found = find(route.children ?? [], hidden);
        if (found !== undefined) return found;
      }
      return undefined;
    }
    return find(accessStore.accessRoutes, false) === true;
  }

  return { canQuery, canSeeMenu };
}

 src/views/dashboard/analytics/index.vue

@@ -18,6 +18,8 @@

import SummaryCard from '#/views/erp/home/modules/summary-card.vue';

import { useHomeAccess } from '#/utils/use-home-access';

import { defaultSummary } from './data';
import BizCards from './modules/biz-cards.vue';
import KpiCards from './modules/kpi-cards.vue';
@@ -26,6 +28,26 @@
defineOptions({ name: 'DashboardAnalytics' });

const router = useRouter();

const { canQuery, canSeeMenu } = useHomeAccess();

/** MES ç”Ÿäº§ KPI：数据取自首页汇总接口，没有该权限就取不到数 */
const canViewSummary = computed(() => canQuery('mes:home:query'));
const showKpi = computed(
  () =>
    canViewSummary.value &&
    (canSeeMenu('MesQcIqc') || canSeeMenu('MesDvMachinery')),
);
const canViewSale = computed(
  () => canQuery('erp:sale-order:query') && canSeeMenu('ErpSaleOrder'),
);
const canViewPurchase = computed(
  () => canQuery('erp:purchase-order:query') && canSeeMenu('ErpPurchaseOrder'),
);
/** é‡‘额概览是销售/采购的对照口径，只有一边有权限时不成卡片 */
const showAmountSummary = computed(
  () => canViewSale.value && canViewPurchase.value,
);

const greeting = computed(() => {
  const hour = new Date().getHours();
@@ -116,6 +138,7 @@
}

async function loadStatistics() {
  if (canViewSale.value) {
  try {
    const saleOrders = await fetchAllPages<ErpSaleOrderApi.SaleOrder>(
      getSaleOrderPage,
@@ -124,8 +147,11 @@
  } catch {
    /* æŽ¥å£å¼‚常或无权限 */
  }
  }
  if (canViewPurchase.value) {
  try {
    const purchaseOrders = await fetchAllPages<ErpPurchaseOrderApi.PurchaseOrder>(
      const purchaseOrders =
        await fetchAllPages<ErpPurchaseOrderApi.PurchaseOrder>(
      getPurchaseOrderPage,
    );
    purchaseSummary.value = aggregatePrice(purchaseOrders);
@@ -133,8 +159,10 @@
    /* æŽ¥å£å¼‚常或无权限 */
  }
}
}

async function loadHomeSummary() {
  if (!canViewSummary.value) return;
  try {
    homeSummary.value = await getHomeSummary();
  } catch {
@@ -170,13 +198,13 @@
    </div>

    <!-- è´¨é‡ / è®¾å¤‡ KPI -->
    <KpiCards :summary="homeSummary" @navigate="handleNavigate" />
    <KpiCards v-if="showKpi" :summary="homeSummary" @navigate="handleNavigate" />

    <!-- ERP/WMS/BPM ç»è¥ KPI -->
    <BizCards @navigate="handleNavigate" />

    <!-- é”€å”® / é‡‡è´­ é‡‘额概览 -->
    <div class="mb-4">
    <div v-if="showAmountSummary" class="mb-4">
      <SummaryCard
        :purchase-summary="purchaseSummary"
        :sale-summary="saleSummary"

 src/views/dashboard/analytics/modules/biz-cards.vue

@@ -1,5 +1,5 @@
<script lang="ts" setup>
import { onMounted, ref } from 'vue';
import { computed, onMounted, ref } from 'vue';

import { CountTo } from '@vben/common-ui';
import { IconifyIcon } from '@vben/icons';
@@ -11,11 +11,42 @@
import { getMaterialStockPage } from '#/api/mes/wm/materialstock';
import { getTaskTodoPage } from '#/api/bpm/task';

import { useHomeAccess } from '#/utils/use-home-access';

defineOptions({ name: 'DashboardBizCards' });

const emit = defineEmits<{
  navigate: [name: string];
}>();

const { canQuery, canSeeMenu } = useHomeAccess();

const canViewPurchase = computed(
  () => canQuery('erp:purchase-order:query') && canSeeMenu('ErpPurchaseOrder'),
);
const canViewSale = computed(
  () => canQuery('erp:sale-order:query') && canSeeMenu('ErpSaleOrder'),
);
const canViewStock = computed(
  () => canQuery('mes:wm-material-stock:query') && canSeeMenu('MesWmMaterialStock'),
);
const canViewBpmTodo = computed(
  () => canQuery('bpm:task:query') && canSeeMenu('BpmTodoTask'),
);

/** å¯è§å¡ç‰‡æ•°é‡å†³å®šåˆ—宽，避免只剩一两张时挤在左上角 */
const colSpan = computed(() => {
  const count = [
    canViewPurchase.value,
    canViewSale.value,
    canViewStock.value,
    canViewBpmTodo.value,
  ].filter(Boolean).length;
  if (count >= 4) return 6;
  if (count === 3) return 8;
  if (count === 2) return 12;
  return 24;
});

const purchaseCount = ref(0);
const saleCount = ref(0);
@@ -23,6 +54,7 @@
const bpmTodoCount = ref(0);

async function loadPurchase() {
  if (!canViewPurchase.value) return;
  try {
    const result = await getPurchaseOrderPage({ pageNo: 1, pageSize: 1 });
    purchaseCount.value = result.total ?? 0;
@@ -30,6 +62,7 @@
}

async function loadSale() {
  if (!canViewSale.value) return;
  try {
    const result = await getSaleOrderPage({ pageNo: 1, pageSize: 1 });
    saleCount.value = result.total ?? 0;
@@ -37,6 +70,7 @@
}

async function loadStock() {
  if (!canViewStock.value) return;
  try {
    const result = await getMaterialStockPage({ pageNo: 1, pageSize: 1 });
    stockCount.value = result.total ?? 0;
@@ -44,6 +78,7 @@
}

async function loadBpmTodo() {
  if (!canViewBpmTodo.value) return;
  try {
    const result = await getTaskTodoPage({ pageNo: 1, pageSize: 1 });
    bpmTodoCount.value = result.total ?? 0;
@@ -85,7 +120,15 @@
<template>
  <Row :gutter="16">
    <!-- é‡‡è´­è®¢å• -->
    <Col :lg="6" :md="12" :sm="12" :xl="6" :xs="24" class="mb-4">
    <Col
      v-if="canViewPurchase"
      :lg="colSpan"
      :md="colSpan"
      :sm="colSpan"
      :xl="colSpan"
      :xs="24"
      class="mb-4"
    >
      <div
        class="glass-tilt group cursor-pointer overflow-hidden rounded-2xl border-0"
        :style="tiltStyle('purchase')"
@@ -112,7 +155,15 @@
    </Col>

    <!-- é”€å”®è®¢å• -->
    <Col :lg="6" :md="12" :sm="12" :xl="6" :xs="24" class="mb-4">
    <Col
      v-if="canViewSale"
      :lg="colSpan"
      :md="colSpan"
      :sm="colSpan"
      :xl="colSpan"
      :xs="24"
      class="mb-4"
    >
      <div
        class="glass-tilt group cursor-pointer overflow-hidden rounded-2xl border-0"
        :style="tiltStyle('sale')"
@@ -139,7 +190,15 @@
    </Col>

    <!-- ç‰©æ–™åº“å­˜ -->
    <Col :lg="6" :md="12" :sm="12" :xl="6" :xs="24" class="mb-4">
    <Col
      v-if="canViewStock"
      :lg="colSpan"
      :md="colSpan"
      :sm="colSpan"
      :xl="colSpan"
      :xs="24"
      class="mb-4"
    >
      <div
        class="glass-tilt group cursor-pointer overflow-hidden rounded-2xl border-0"
        :style="tiltStyle('stock')"
@@ -166,13 +225,21 @@
    </Col>

    <!-- BPM å¾…办 -->
    <Col :lg="6" :md="12" :sm="12" :xl="6" :xs="24" class="mb-4">
    <Col
      v-if="canViewBpmTodo"
      :lg="colSpan"
      :md="colSpan"
      :sm="colSpan"
      :xl="colSpan"
      :xs="24"
      class="mb-4"
    >
      <div
        class="glass-tilt group cursor-pointer overflow-hidden rounded-2xl border-0"
        :style="tiltStyle('bpm')"
        @mousemove="(e: MouseEvent) => onMouseMove(e, 'bpm')"
        @mouseleave="onMouseLeave('bpm')"
        @click="emit('navigate', 'BpmTaskTodo')"
        @click="emit('navigate', 'BpmTodoTask')"
      >
        <div class="relative z-10 flex items-center gap-4 p-5">
          <div class="flex size-12 flex-shrink-0 items-center justify-center rounded-xl bg-gradient-to-br from-red-500 to-rose-400 shadow-lg shadow-red-500/25 transition-transform duration-300 group-hover:scale-110">

 src/views/dashboard/analytics/modules/kpi-cards.vue

@@ -8,6 +8,8 @@

import { Col, Row } from 'ant-design-vue';

import { useHomeAccess } from '#/utils/use-home-access';

defineOptions({ name: 'DashboardKpiCards' });

const props = defineProps<{
@@ -17,6 +19,18 @@
const emit = defineEmits<{
  navigate: [name: string];
}>();

const { canQuery, canSeeMenu } = useHomeAccess();

/** ä¸¤å¼ å¡çš„数据都来自首页汇总接口，没有该权限时取下的是空值 */
const canViewSummary = computed(() => canQuery('mes:home:query'));
const showQuality = computed(
  () => canViewSummary.value && canSeeMenu('MesQcIqc'),
);
const showEquipment = computed(
  () => canViewSummary.value && canSeeMenu('MesDvMachinery'),
);
const bothVisible = computed(() => showQuality.value && showEquipment.value);

const qualityRate = computed(() => {
  const total =
@@ -59,13 +73,21 @@
<template>
  <Row :gutter="16">
    <!-- è´¨é‡åˆæ ¼çŽ‡ -->
    <Col :lg="12" :md="12" :sm="12" :xl="12" :xs="24" class="mb-4">
    <Col
      v-if="showQuality"
      :lg="bothVisible ? 12 : 24"
      :md="bothVisible ? 12 : 24"
      :sm="bothVisible ? 12 : 24"
      :xl="bothVisible ? 12 : 24"
      :xs="24"
      class="mb-4"
    >
      <div
        class="glass-tilt group cursor-pointer overflow-hidden rounded-2xl border-0"
        :style="tiltStyle('quality')"
        @mousemove="(e: MouseEvent) => onMouseMove(e, 'quality')"
        @mouseleave="onMouseLeave('quality')"
        @click="emit('navigate', 'MesQcRecord')"
        @click="emit('navigate', 'MesQcIqc')"
      >
        <div class="relative z-10 flex items-center gap-4 p-5">
          <div class="flex size-12 flex-shrink-0 items-center justify-center rounded-xl bg-gradient-to-br from-orange-500 to-amber-400 shadow-lg shadow-orange-500/25 transition-transform duration-300 group-hover:scale-110">
@@ -92,7 +114,15 @@
    </Col>

    <!-- è®¾å¤‡è¿è¡ŒçŽ‡ -->
    <Col :lg="12" :md="12" :sm="12" :xl="12" :xs="24" class="mb-4">
    <Col
      v-if="showEquipment"
      :lg="bothVisible ? 12 : 24"
      :md="bothVisible ? 12 : 24"
      :sm="bothVisible ? 12 : 24"
      :xl="bothVisible ? 12 : 24"
      :xs="24"
      class="mb-4"
    >
      <div
        class="glass-tilt group cursor-pointer overflow-hidden rounded-2xl border-0"
        :style="tiltStyle('equip')"

 src/views/dashboard/analytics/modules/quick-actions.vue

@@ -1,5 +1,9 @@
<script lang="ts" setup>
import { computed } from 'vue';

import { IconifyIcon } from '@vben/icons';

import { useHomeAccess } from '#/utils/use-home-access';

defineOptions({ name: 'DashboardQuickActions' });

@@ -15,19 +19,25 @@
  shadow: string;
}

const { canSeeMenu } = useHomeAccess();

const actions: QuickAction[] = [
  { title: '质检管理', icon: 'lucide:clipboard-check', route: 'MesQcRecord', gradient: 'from-orange-500 to-amber-500', shadow: 'shadow-orange-500/15' },
  { title: '质检管理', icon: 'lucide:clipboard-check', route: 'MesQcIqc', gradient: 'from-orange-500 to-amber-500', shadow: 'shadow-orange-500/15' },
  { title: '设备点检', icon: 'lucide:settings', route: 'MesDvMachinery', gradient: 'from-violet-500 to-purple-500', shadow: 'shadow-violet-500/15' },
  { title: '物料库存', icon: 'lucide:package-search', route: 'WlsMaterialStock', gradient: 'from-indigo-500 to-blue-500', shadow: 'shadow-indigo-500/15' },
  { title: '物料库存', icon: 'lucide:package-search', route: 'MesWmMaterialStock', gradient: 'from-indigo-500 to-blue-500', shadow: 'shadow-indigo-500/15' },
];

const accessibleActions = computed(() =>
  actions.filter((action) => canSeeMenu(action.route)),
);
</script>

<template>
  <div class="glass-card rounded-2xl p-5">
  <div v-if="accessibleActions.length > 0" class="glass-card rounded-2xl p-5">
    <h3 class="mb-4 text-sm font-semibold text-gray-800 dark:text-gray-100">快捷操作</h3>
    <div class="grid grid-cols-4 gap-3 sm:grid-cols-8">
      <div
        v-for="action in actions"
        v-for="action in accessibleActions"
        :key="action.route"
        class="group flex cursor-pointer flex-col items-center gap-2 rounded-xl p-3 transition-all duration-300 hover:-translate-y-1"
        @click="emit('navigate', action.route)"