cloud-web-corejs 1.0.54-dev.788 → 1.0.54-dev.789

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "cloud-web-corejs",
   "private": false,
-  "version": "1.0.54-dev.788",
+  "version": "1.0.54-dev.789",
   "scripts": {
     "dev": "vue-cli-service serve",
     "dev:micro": "vue-cli-service serve --port 17527",

package/src/components/xform/docs/2026-08 /345/210/227/350/241/250/345/257/274/345/207/272/350/204/261/346/225/217/345/210/227/345/211/224/351/231/244/350/220/275/345/234/260/346/226/207/346/241/243.md"

@@ -69,7 +69,6 @@
 | `compareToList(list1, list2)` | 编码列表匹配，空列表表示不限 |
 | `hasTextMaskRule(widgetOptions)` | 是否配了有效规则（不代表当前用户命中） |
 | `buildTextMaskContext(formRef, companyCode)` | 组装 `{ bdService, companyCode, roleCodeList }` |
-| `isTextMaskContextReady(ctx)` | 上下文是否就绪 |
 | `markMaskedExportColumns($grid, ctx)` | 给命中列打 `params.exportDisabled`，并同步到明细导出列 |
 
 判定逻辑逐行照搬原 `initShowType`，包括两个易被"优化"掉的细节：
@@ -108,11 +107,11 @@ H5 列表容器有独立 `exportData`，同样处理。这是编码阶段才发
 **决策 1 —— 判定放在导出触发时，不放在建列时。**
 `bdService` / `userRoleDTOs` 由异步接口填充（`form-render/indexMixin.js:458、479、498`），建列时可能尚未就绪。
 
-**决策 2 —— 上下文未就绪时 fail-closed。**
-`compareToList` 在角色列表为空时返回 false → 被判成"角色不匹配"：对 `type=1` 规则偏保守（判为脱敏，安全），但对 `type=2` 规则会判成**不脱敏**，正好是危险方向。故上下文未就绪时，凡 `hasTextMaskRule` 为真的列一律剔除。
+**决策 2 —— 不做"上下文未就绪"的收紧判断（踩过坑，见第十节）。**
+判定结论与渲染层严格一致即可：同一个 `resolveTextMaskFlag`、同一份用户上下文，且导出必然发生在单元格渲染之后（用户已经看到明文或密文）。**不要再引入任何"上下文是否就绪"的启发式**。
 
 **决策 3 —— `mounted` 也标记一次。**
-vxe 原生导出不走 `exportData()`，若只在导出入口标记，`columnFilterMethod` 会拿到一张没标记的列表，等于没堵。建列后立刻按 fail-closed 打标，之后每次 `exportData` 自愈修正。用户先点 $excelExport 再点原生导出的顺序也天然安全。
+vxe 原生导出不走 `exportData()`，若只在导出入口标记，`columnFilterMethod` 会拿到一张没标记的列表，等于没堵。故建列后先按当时的上下文标记一次；此刻结论未必准，但只会"少防护"不会误伤，之后每次 `exportData` 会按最新上下文自愈修正。
 
 **决策 4 —— 标记幂等且可自愈，用私有键区分归属。**
 `exportDisabled` 也可能是 `isNonDataExportColumn`（`data-table-mixin.js:1710`）打的。若无差别地 `delete`，自愈会误放行操作列。故引入 `MASK_MARK_KEY = "exportDisabledByTextMask"`（`textMaskUtil.js:19`）：
@@ -146,7 +145,7 @@ vxe 原生导出不走 `exportData()`，若只在导出入口标记，`columnFil
 
 已验证：
 
-- `npx jest`：13 套 156 个用例全过（新增 17 个）
+- `npx jest`：13 套 157 个用例全过（新增 18 个）
 - ESLint：新增文件 0 error；改动文件只剩改动前就存在的既有错误（全库 132 个，`npm run lint` 本就不通过）
 
 **未做真机联调**，以下回归项待验：
@@ -155,11 +154,20 @@ vxe 原生导出不走 `exportData()`，若只在导出入口标记，`columnFil
 2. 两种规则方向：`type=2 + 角色匹配`、`type=1 + 角色不匹配`；
 3. 未配脱敏的列完全不受影响；
 4. **分组表头 2 层 / 3 层下剔除叶子列后表头不错位**（`loopDo` 会重算 `colSpan/rowSpan`，本轮风险最高的一处）；
-5. 用户信息接口未返回时立即点导出 → 走 fail-closed 而非明文导出；
-6. 页面遮罩显示效果与改造前一致（验证 `initShowType` 重构无回归）；
-7. vxe 工具栏导出（若宿主开启了该按钮）。
+5. 页面遮罩显示效果与改造前一致（验证 `initShowType` 重构无回归）；
+6. vxe 工具栏导出（若宿主开启了该按钮）。
 
-## 九、同步提示
+## 九、联调发现的问题（2026-08-04，已修）
+
+**现象**：配了规则后，部分用户看明文、部分看密文（符合预期），但**所有用户导出时该列都消失**。
+
+**根因**：首版实现有一个 `isTextMaskContextReady(ctx)`，用 `ctx.bdService` 非空 + 角色列表非空当作"用户上下文已就绪"的判据，未就绪时 fail-closed 剔除整列。但 `bdService` 来自 `/form_develop/getBdService`（`indexMixin.js:489`），`res.objx` 在大量环境本就是空值 —— 于是 `contextReady` 恒为 false，凡配了规则的列对所有用户一律被剔除。
+
+**修复**：删除 `isTextMaskContextReady`，`markMaskedExportColumns` 直接采用 `resolveTextMaskFlag` 的结论。
+
+**教训**：fail-closed 本身没错，错在"就绪"判据是拿业务值反推运行状态的启发式。这里根本不需要它 —— 渲染层用同一函数、同一上下文，且导出必然晚于渲染，结论天然一致；页面显示什么，导出就该按什么处理。回归用例见 spec 中「bdService 为空时结论仍只由规则决定」。
+
+## 十、同步提示
 
 - `textMaskUtil.js` 属包内新增文件，海尔分支（stdxx）整体覆盖时需一并带上，否则 `form-item-wrapper.vue` 与两个容器的 import 会解析失败；
 - 改动 5 落在 `components/table/index.js`（通用表格默认配置），影响面超出 xform，同步时注意与分支上的本地修改合并。

package/src/components/xform/form-render/container-item/data-table-mixin.js

@@ -247,8 +247,8 @@ modules = {
     this.bootstrapDynamicColumnsBeforeInit().then(() => {
       this.initColumnWidgetConfig(() => {
         this.initTableList();
-        // 让不走 $excelExport 的旁路（vxe 工具栏自带导出）也受控：此刻用户上下文
-        // 多半尚未就绪，按 fail-closed 先剔除，之后每次 exportData 会自愈修正
+        // 让不走 $excelExport 的旁路（vxe 工具栏自带导出）也受控。此刻用户上下文
+        // 可能尚未就绪，结论未必准，之后每次 exportData 会按最新上下文自愈修正
         this.$nextTick(() => {
           this.markMaskedColumnsForExport();
         });

package/src/components/xform/utils/textMaskUtil.js

@@ -62,14 +62,6 @@ export function buildTextMaskContext(formRef, companyCode) {
   };
 }
 
-/**
- * @param {Object} ctx 判定上下文。
- * @returns {Boolean} 用户上下文是否已就绪（bdService / 角色均由异步接口填充）。
- */
-export function isTextMaskContextReady(ctx) {
-  return !!ctx?.bdService && !!(ctx?.roleCodeList || []).length;
-}
-
 /**
  * @param {Object} widgetOptions 组件 options。
  * @param {Object} ctx 用户上下文 { bdService, companyCode, roleCodeList }。
@@ -122,10 +114,13 @@ export function resolveTextMaskFlag(widgetOptions, ctx) {
  * 之所以要按列剔除：命中脱敏规则的字段在界面上只渲染掩码文本，但导出取值走
  * filterVal / 原始字段快路径，不经过渲染层，会把明文写进文件。
  *
- * bdService / userRoleDTOs 由异步接口填充，上下文缺失时按 fail-closed 处理——配了
- * 规则的列一律剔除，因为角色列表为空会被判成"角色不匹配"，type=2 的规则会误判为
- * 不脱敏。本函数幂等且可自愈：上下文就绪后重复调用会撤销自己此前多打的标记
- * （靠私有键区分，不碰 isNonDataExportColumn 打的标记）。
+ * 判定结论与渲染层严格一致：同一个 resolveTextMaskFlag、同一份用户上下文，且导出
+ * 必然发生在单元格渲染之后（用户已看到明文或密文），所以不做"上下文未就绪"的收紧。
+ * 曾用 bdService 非空当就绪判据并 fail-closed，但该字段来自 getBdService 接口、
+ * 大量环境本就返回空，导致所有用户的脱敏列被一律剔除——不要再加这类启发式。
+ *
+ * 本函数幂等且可自愈：结论变化时会撤销自己此前打的标记（靠私有键区分，不碰
+ * isNonDataExportColumn 打的标记）。
  *
  * @param {Object} $grid vxe-grid 实例。
  * @param {Object} ctx 判定上下文，由 buildTextMaskContext 生成。
@@ -133,15 +128,13 @@ export function resolveTextMaskFlag(widgetOptions, ctx) {
 export function markMaskedExportColumns($grid, ctx) {
   if (!$grid || typeof $grid.getTableColumn !== "function") return;
 
-  let contextReady = isTextMaskContextReady(ctx);
-
   /** 打标记。列本就被其它规则（isNonDataExportColumn）剔除时不接管，避免撤销时误删。 */
   let disable = (params) => {
     if (params.exportDisabled && !params[MASK_MARK_KEY]) return;
     params.exportDisabled = true;
     params[MASK_MARK_KEY] = true;
   };
-  /** 撤销本函数此前打的标记（上下文未就绪时的 fail-closed 结论）。 */
+  /** 撤销本函数此前打的标记（判定结论变化时）。 */
   let restore = (params) => {
     if (!params[MASK_MARK_KEY]) return;
     delete params[MASK_MARK_KEY];
@@ -156,7 +149,7 @@ export function markMaskedExportColumns($grid, ctx) {
     }
     let widgetOptions = column.params?.widget?.options;
     if (!hasTextMaskRule(widgetOptions)) return;
-    if (contextReady && !resolveTextMaskFlag(widgetOptions, ctx).masked) {
+    if (!resolveTextMaskFlag(widgetOptions, ctx).masked) {
       restore(column.params);
       return;
     }