n20-common-lib 3.3.21 → 3.3.24

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "n20-common-lib",
-  "version": "3.3.21",
+  "version": "3.3.24",
   "private": false,
   "scripts": {
     "serve": "vue-cli-service serve",

package/src/utils/axios.js

@@ -2,6 +2,7 @@ import _axios from 'axios'
 import ElementUI from 'element-ui'
 import auth from './auth'
 import { $lc } from './i18n/index'
+import { isRiskPause, processRiskPause, buildRiskHeaders } from './risk'
 const _Loading = ElementUI.Loading
 const _Message = ElementUI.Message
 
@@ -124,7 +125,8 @@ function errorFn(status, msg, noMsg, res) {
 axios.interceptors.response.use(
   (res) => {
     let status = (res.data && res.data.code) || res.status
-    if (Number(status) === 200) {
+    // 风控暂停包(902/903)放行到 request()，由其弹框确认后重发；其余非200走错误提示
+    if (Number(status) === 200 || isRiskPause(res.data)) {
       return res
     } else {
       let msg = (res.data && (res.data.msg || res.data.message)) || ''
@@ -197,6 +199,9 @@ function request(opt) {
     return debounceObj[opt.method + opt.url]
   }
 
+  // 风控确认流程接管 promise：暂停包到达时赋值；resPro 本身照常落定以释放 loading/防抖
+  let riskChain = null
+
   let resPro = new Promise((resolve, reject) => {
     axios
       .request(opt)
@@ -223,6 +228,25 @@ function request(opt) {
             resolve(res.data)
           }
         } else {
+          if (isRiskPause(res.data) && !opt.__riskRetry) {
+            // 风控暂停包：弹框→确认后原参数重发（risk 拼 body 主通道 + 请求头兜底）→返回最终业务包；取消/超限 reject
+            riskChain = processRiskPause(res.data, (risk) =>
+              request(
+                Object.assign({}, opt, {
+                  // v3.4：risk 对象原样拼进 body（仅普通对象拼；数组/FormData/GET 不拼，走头兜底）
+                  data:
+                    opt.data && typeof opt.data === 'object' && !Array.isArray(opt.data) && typeof opt.data.append !== 'function'
+                      ? Object.assign({}, opt.data, { risk })
+                      : opt.data,
+                  headers: Object.assign({}, opt.headers, buildRiskHeaders(risk)),
+                  __riskRetry: true
+                })
+              )
+            )
+            // resPro 先落定：finally 释放 loading 与防抖；页面拿到的最终结果由 riskChain 决定
+            resolve(res.data)
+            return
+          }
           if (typeof res.data === 'object' && res.data.data === undefined) {
             res.data.data = {}
           }
@@ -239,8 +263,13 @@ function request(opt) {
 
     closeLoading({ loading })
   }).catch(() => {}) // 防止 finally 返回的丢弃 Promise 产生未处理的 rejection
-  debounceObj[opt.method + opt.url] = resPro
-  return resPro
+
+  // 对外结果：resPro 落定时若风险流程已接管（riskChain 已赋值），转发其终态
+  let outPro = resPro.then(function (v) {
+    return riskChain ? riskChain : v
+  })
+  debounceObj[opt.method + opt.url] = outPro
+  return outPro
 }
 
 function getFilename(cd = '') {

package/src/utils/risk.js

@@ -0,0 +1,91 @@
+/**
+ * 事中风控暂停包处理（协议2.0，前端公共支持）
+ *
+ * 约定：后端原业务接口命中风险或风控技术异常时，业务不执行，统一返回 code=902 暂停包：
+ *   { code: 902, msg, data: null, risk: {...} }
+ * 其中 risk.action 区分两类：
+ *   RISK_CONFIRM      风险确认框，确认后按 RISK_CONFIRM 重发（回传风控事件编号）
+ *   其他（DEGRADED_*）异常知悉框，确认后按 DEGRADED_CONFIRM 重发（不带事件编号，后端不调风控直接执行）
+ * 重发 = 原 URL/方法/参数 + 风控阶段请求头，由 axios.js 的 request() 内部完成，业务页面零改造。
+ */
+import Vue from 'vue'
+import ElementUI from 'element-ui'
+
+/** 风控暂停包统一返回码 */
+const RISK_PAUSE_CODE = 902
+/** 单次提交任务原接口最大请求次数：首次 + 正常确认 + 确认又异常的降级确认 */
+const MAX_REQUESTS = 3
+
+const MessageBox = ElementUI.MessageBox
+
+/** 是否风控暂停包：码值 + 顶层 risk 元数据双条件，防止误伤普通响应 */
+export function isRiskPause(data) {
+  return !!(data && data.code === RISK_PAUSE_CODE && data.risk)
+}
+
+/**
+ * 暂停包主流程：弹框 → 确认则原参数重发（risk 拼进 body，头兜底） → 直到业务包或终态。
+ * @param {Object} firstData 首次请求返回的暂停包（res.data）
+ * @param {Function} send (risk) => Promise<data> 用原参数重发，risk 为后端下发的确认上下文
+ * @returns {Promise<Object>} 最终业务包（code=200）；取消/超限 reject
+ */
+export async function processRiskPause(firstData, send) {
+  let data = firstData
+  let count = 1
+  while (isRiskPause(data) && count < MAX_REQUESTS) {
+    const confirmed = await openRiskDialog(data)
+    if (!confirmed) {
+      throw { code: data.code, msg: data.msg || '已取消提交', risk: data.risk, riskCancelled: true }
+    }
+    count++
+    data = await send((data.risk || {}))
+  }
+  if (isRiskPause(data)) {
+    throw { code: data.code, msg: '风险确认次数超限，请检查数据后重新提交', risk: data.risk, riskExhausted: true }
+  }
+  return data
+}
+
+/**
+ * 确认重发的请求头兜底（GET 等无 body 场景）。
+ * POST 主通道是把 risk 对象原样拼进 body（axios.js 内处理），此处仅保留头兜底。
+ */
+export function buildRiskHeaders(risk) {
+  const action = risk.action === 'RISK_CONFIRM' ? 'RISK_CONFIRM' : 'DEGRADED_CONFIRM'
+  const headers = {
+    'X-Biz-Request-Id': risk.requestId,
+    'X-Risk-Action': action
+  }
+  if (action === 'RISK_CONFIRM' && risk.confirmEventId) {
+    headers['X-Risk-Event-Id'] = risk.confirmEventId
+  }
+  return headers
+}
+
+/**
+ * 标准风控弹窗：展示后端 msg（含真实原因）。resolve(true)=确认继续，resolve(false)=取消。
+ * 文本转义渲染，不注入 HTML。
+ */
+function openRiskDialog(data) {
+  const degraded = !data.risk || data.risk.action !== 'RISK_CONFIRM'
+  const h = new Vue().$createElement
+  const fallback = degraded ? '风控校验未完成，是否知悉并继续提交？' : '请确认风险提示后继续提交'
+  const message = h(
+    'div',
+    { style: { fontSize: '14px', color: '#303133', lineHeight: '22px', maxWidth: '440px' } },
+    String(data.msg || fallback)
+  )
+  return MessageBox({
+    title: degraded ? '风控服务异常' : '风险提示',
+    type: degraded ? 'info' : 'warning',
+    message,
+    customClass: 'n20-risk-msgbox',
+    showCancelButton: true,
+    confirmButtonText: degraded ? '知悉并继续' : '确认继续',
+    cancelButtonText: '取消',
+    closeOnClickModal: false,
+    closeOnPressEscape: false
+  })
+    .then(() => true)
+    .catch(() => false)
+}