imeik-bizui 2.8.3 → 2.8.5

package/dist/bizui/src/FieldPersonBudgetBoard/README.md

@@ -59,7 +59,7 @@ bizui：  scene 选接口 → Dashboard 拉数 → Overview / Detail
 | 类型 | 内容 |
 | --- | --- |
 | Props | `scene`、`requestPayload`、`showDetailLink`、`narrowDetailMode`、`useMock`、`emptyText`、`debounceMs` |
-| Events | `submit-blocked`：`{ blocked, warn }`（禁止提交 / 预警） |
+| Events | `submit-blocked`：`{ blocked, warn }`（禁止提交 / 预警）；`board-visible`：`{ visible, status }`（`status=免于管控` 时 `visible=false`，宿主应隐藏含标题的整块） |
 | 明细形态 | 宽屏始终弹窗；窄屏（≤768px）由 `narrowDetailMode`：`inline`（默认）或 `dialog` |
 | 物资 · 查看 | `{ applyNumber }`（真实申请单号，不是 objectCode） |
 | 物资 · 实时 | `{ costBearEmployeeNo, costType, materialList[] }`；`materialList` **允许 `[]`**；可选 `budgetDate` |

package/dist/bizui/src/FieldPersonBudgetBoard/core/PersonBudgetDashboard.vue

@@ -5,7 +5,8 @@
   不负责：各业务域字段映射、拼请求体 —— 由业务系统组装后经 FieldPersonBudgetBoard 传入。
 -->
 <template>
-  <div class="person-budget-dashboard">
+  <!-- 免于管控时不渲染看板 UI；组件保持挂载以便表单变化后重查 -->
+  <div v-if="!isExempt" class="person-budget-dashboard">
     <PersonBudgetOverview
       :overview="overview"
       :loading="loading"
@@ -128,6 +129,8 @@ export default {
       loading: false,
       error: '',
       overview: null,
+      /** 接口判定免于管控后隐藏看板；配置态 mock 不走此逻辑 */
+      isExempt: false,
       detailVisible: false,
       inlineOpen: false,
       isNarrow: false,
@@ -158,7 +161,9 @@ export default {
           this.overview = createDemoOverview()
           this.error = ''
           this.loading = false
+          this.isExempt = false
           this.emitSubmitBlocked(false, false)
+          this.emitBoardVisible(true, '')
           return
         }
         if (this.debouncedFetch) this.debouncedFetch()
@@ -205,19 +210,27 @@ export default {
     emitSubmitBlocked(blocked, warn) {
       this.$emit('submit-blocked', { blocked: !!blocked, warn: !!warn })
     },
+    /** 通知宿主是否展示整块（含标题）；免于管控时 visible=false */
+    emitBoardVisible(visible, status) {
+      this.$emit('board-visible', { visible: !!visible, status: status || '' })
+    },
     clearBoard() {
       this.overview = null
       this.error = ''
       this.loading = false
       this.inlineOpen = false
+      this.isExempt = false
       this.emitSubmitBlocked(false, false)
+      this.emitBoardVisible(true, '')
     },
     async fetchOverviewNow() {
       if (this.useDemo) {
         this.overview = createDemoOverview()
         this.error = ''
         this.loading = false
+        this.isExempt = false
         this.emitSubmitBlocked(false, false)
+        this.emitBoardVisible(true, '')
         return
       }
 
@@ -232,6 +245,9 @@ export default {
 
       this.loading = true
       this.error = ''
+      // 请求中保持可见，避免宿主拆掉组件导致无法重查
+      this.isExempt = false
+      this.emitBoardVisible(true, '')
       try {
         const res = await this.fetchOverview(payload)
         if (seq !== this.reqSeq || sig !== payloadSignature(this.requestPayload)) return
@@ -239,21 +255,40 @@ export default {
         if (!res || res.code !== 200) {
           this.overview = null
           this.error = (res && res.message) || '个人预算概述获取失败'
+          this.isExempt = false
+          this.emitSubmitBlocked(false, false)
+          this.emitBoardVisible(true, '')
+          return
+        }
+
+        const data = res.data || null
+        const status = normalizeBudgetStatus(data && data.status)
+
+        if (status === BUDGET_STATUS.EXEMPT) {
+          this.overview = null
+          this.error = ''
+          this.inlineOpen = false
+          this.detailVisible = false
+          this.isExempt = true
           this.emitSubmitBlocked(false, false)
+          this.emitBoardVisible(false, status)
           return
         }
 
-        this.overview = res.data || null
-        const status = normalizeBudgetStatus(this.overview && this.overview.status)
+        this.overview = data
+        this.isExempt = false
         this.emitSubmitBlocked(
           status === BUDGET_STATUS.FORBID,
           status === BUDGET_STATUS.WARN
         )
+        this.emitBoardVisible(true, status)
       } catch (e) {
         if (seq !== this.reqSeq) return
         this.overview = null
         this.error = (e && e.message) || '个人预算概述获取失败'
+        this.isExempt = false
         this.emitSubmitBlocked(false, false)
+        this.emitBoardVisible(true, '')
       } finally {
         if (seq === this.reqSeq) this.loading = false
       }

package/dist/bizui/src/FieldPersonBudgetBoard/core/PersonBudgetOverview.vue

@@ -141,13 +141,16 @@ export default {
     budgetNum() {
       return parseAmount(this.overview && this.overview.budgetAmount)
     },
+    /** 有有效总预算才算占比；否则不展示假的 100% 剩余 */
+    hasBudgetRatio() {
+      return Number.isFinite(this.usedNum) && Number.isFinite(this.budgetNum) && this.budgetNum > 0
+    },
     usagePercent() {
-      const used = this.usedNum
-      const budget = this.budgetNum
-      if (!Number.isFinite(used) || !Number.isFinite(budget) || budget <= 0) return 0
-      return (used / budget) * 100
+      if (!this.hasBudgetRatio) return NaN
+      return (this.usedNum / this.budgetNum) * 100
     },
     fillWidth() {
+      if (!this.hasBudgetRatio) return '0'
       return Math.min(Math.max(this.usagePercent, 0), 100).toFixed(2)
     },
     warnAmount() {
@@ -171,6 +174,7 @@ export default {
       return 'is-mid'
     },
     barLabel() {
+      if (!this.hasBudgetRatio) return '剩余 —'
       const remain = 100 - this.usagePercent
       if (remain < 0) return `已超 ${formatPercent(this.usagePercent - 100)}`
       return `剩余 ${formatPercent(remain)}`

package/dist/bizui/src/FieldPersonBudgetBoard/core/format.js

@@ -3,15 +3,18 @@
 export const BUDGET_STATUS = {
   PASS: '通过',
   WARN: '预警',
-  FORBID: '禁止'
+  FORBID: '禁止',
+  /** 免于管控：业务宿主应隐藏整块个人预算模块 */
+  EXEMPT: '免于管控'
 }
 
-/** 接口 status → 通过/预警/禁止；「警告」兼容为预警 */
+/** 接口 status → 通过/预警/禁止/免于管控；「警告」兼容为预警 */
 export function normalizeBudgetStatus(status) {
   const s = String(status || '').trim()
   if (s === BUDGET_STATUS.FORBID || s === '禁止提交') return BUDGET_STATUS.FORBID
   if (s === BUDGET_STATUS.WARN || s === '警告') return BUDGET_STATUS.WARN
   if (s === BUDGET_STATUS.PASS || s === '正常') return BUDGET_STATUS.PASS
+  if (s === BUDGET_STATUS.EXEMPT || /免于/.test(s)) return BUDGET_STATUS.EXEMPT
   return s || ''
 }
 

package/dist/bizui/src/FieldPersonBudgetBoard/index.vue

@@ -25,6 +25,7 @@
     :fetch-performance-page="useMock ? null : sceneApi.fetchPerformancePage"
     :use-demo="useMock"
     @submit-blocked="$emit('submit-blocked', $event)"
+    @board-visible="$emit('board-visible', $event)"
   />
 </template>