@alanwang-merit/meritdata-platform-skill-package 1.0.0

package/skills/meritdata-dev-docs-file-finder/references/dev-docs/16_/344/272/224/345/211/215/347/253/257/350/265/204/344/272/247-5.1UI/347/273/204/344/273/266/345/272/223-/344/270/213/345/215/212.md

@@ -0,0 +1,302 @@
+---
+name: 前端 UI 组件库（下半）
+source-file: 公共资产清单
+source-section: 5.1.8 - 5.1.12 前端 UI 组件库（ResourceCodeAuth / ThreeMemberAuth / TableHeadSearch / VerifiyPassword / CommonHeader）
+keywords: [ResourceCodeAuth, ThreeMemberAuth, TableHeadSearch, VerifiyPassword, CommonHeader, 资源授权, 三员授权, 二级鉴别, 通用头部, 表格头部搜索, Vue组件]
+use-cases: [资源授权, 三员授权, 二级鉴别, 通用头部面包屑, 表格头部筛选]
+related: [15, 12]
+---
+
+# 前端 UI 组件库（下半）
+
+> **原文章节**：`公共资产清单 → 5.1 UI 组件库（5.1.8–5.1.12）`
+> **行号范围**：L2784–L3054
+
+## 🎯 一句话
+涵盖 cloud-module-base 提供的 5 个权限/安全/通用组件：ResourceCodeAuth（资源代码授权）、ThreeMemberAuth（三员授权）、TableHeadSearch（表格头部搜索）、VerifiyPassword（二级鉴别密码验证）、CommonHeader（通用头部）。
+
+## 📋 接口/方法清单
+
+##### 5.1.8 资源代码授权组件 (ResourceCodeAuth)
+
+**文件路径**: `cloud-module/cloud-module-base/packages/resource-code-auth/resource-code-auth.vue`
+
+**功能说明**: 基于资源代码的权限控制组件。
+
+**导入方式**:
+```javascript
+import resourceCodeAuth from 'cloud-module-base/packages/resource-code-auth';
+Vue.component(resourceCodeAuth.name, resourceCodeAuth);
+```
+
+**Props 属性**:
+| 属性名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| resourceCode | String | true | 资源代码 |
+| url | String | true | 请求授权验证的URL |
+
+**使用示例**:
+```vue
+<resource-code-auth
+  resourceCode="emp_export"
+  url="/api/authority/resource/resource-code-auth">
+  <el-button>导出</el-button>
+</resource-code-auth>
+```
+
+**工作原理**: 组件会调用 `/api/authority/resource/resource-code-auth` 接口进行权限验证，只有授权通过才显示插槽内容。
+
+---
+
+##### 5.1.9 三员授权组件 (ThreeMemberAuth)
+
+**文件路径**: `cloud-module/cloud-module-base/packages/three-member-auth/three-member-auth.vue`
+
+**功能说明**: 三员权限控制组件，用于判断角色是否具有三员授权。
+
+**导入方式**:
+```javascript
+import threeMemberAuth from 'cloud-module-base/packages/three-member-auth';
+Vue.component(threeMemberAuth.name, threeMemberAuth);
+```
+
+**Props 属性**:
+| 属性名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| roleCode | String | true | 角色代码 |
+
+**使用示例**:
+```vue
+<three-member-auth roleCode="security_admin">
+  <el-button>安全管理</el-button>
+</three-member-auth>
+```
+
+**实际使用示例**:
+```vue
+<!-- 来源: cloud-system-manage/src/pages/authority/system/view/role-grid.vue -->
+<!-- 多角色逗号分隔，只要满足任一角色即可显示 -->
+<three-member-auth role-code="XTGLY,AQGLY">
+  <el-button
+    :disabled="addDisabled"
+    type="primary"
+    @click="addBtnClick"
+  >{{ $t('base.button.add') }}</el-button>
+  <el-button
+    :disabled="isdisabled"
+    @click="deleteBtnClick"
+  >
+    {{ $t('base.button.delete') }}
+  </el-button>
+</three-member-auth>
+```
+
+---
+
+##### 5.1.10 表格头部搜索组件 (TableHeadSearch)
+
+**文件路径**: `cloud-module/cloud-module-base/packages/components/tableHeadSearch.vue`
+
+**功能说明**: 表格列筛选组件，用于表头的筛选操作。
+
+**导入方式**:
+```javascript
+import tableHeadSearch from 'cloud-module-base/packages/components/tableHeadSearch';
+Vue.component(tableHeadSearch.name, tableHeadSearch);
+```
+
+**Props 属性**:
+| 属性名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| filedSearchName | String | - | 表头显示名称 |
+| showSelectFlag | Boolean | - | 是否显示选中标识 |
+| value / v-model | Boolean | false | popover显示状态 |
+| checkList.sync | Array | - | 选中列表 |
+| filterList | Array | - | 筛选数据列表 |
+
+**Events 事件**:
+- `findTypeList` - 确认筛选时触发
+- `resetTypeList` - 重置筛选时触发
+- `showList` - 显示列表时触发
+
+**实际使用示例**:
+```vue
+<!-- 来源: cloud-system-manage/src/pages/ou/org/view/Grid.vue -->
+<template slot="header" slot-scope="scope">
+  <div v-if="field.code == 'dLevel'">
+    <table-head-search
+      ref="resetDLevelSearch"
+      filedSearchName="组织类型"
+      :showSelectFlag="dLevelSelectFlag"
+      v-model="showDLevelPopover"
+      :checkList.sync="dLevelLists"
+      :filterList="filterDLevelList"
+      @findTypeList="findDLevel"
+      @resetTypeList="resetDLevel"
+      @showList="resetDLevelModule"
+    ></table-head-search>
+  </div>
+  <div v-else-if="field.code == 'isAble'">
+    <table-head-search
+      ref="resetStatusSearch"
+      filedSearchName="状态"
+      :showSelectFlag="statusSelectFlag"
+      v-model="showStatusPopover"
+      :checkList.sync="statusLists"
+      :filterList="filterStatusList"
+      @findTypeList="findStatusList"
+      @resetTypeList="resetStatus"
+      @showList="resetStatusModule"
+    ></table-head-search>
+  </div>
+</template>
+
+<script>
+import TableHeadSearch from '@/components/tableHeadSearch';
+export default {
+  components: { TableHeadSearch },
+  data() {
+    return {
+      dLevelLists: [],
+      filterDLevelList: [
+        { code: '0', name: '机构' },
+        { code: '1', name: '部门' }
+      ]
+    };
+  }
+}
+</script>
+```
+
+---
+
+##### 5.1.11 二级鉴别密码验证弹窗 (VerifiyPassword)
+
+**文件路径**: `cloud-module/cloud-module-base/packages/components/verifiy-password.vue`
+
+**功能说明**: 二级密码鉴别组件，用于安全验证。
+
+**导入方式**:
+```javascript
+import verifiyPassword from 'cloud-module-base/packages/components/verifiy-password';
+Vue.component(verifiyPassword.name, verifiyPassword);
+```
+
+**Props 属性**:
+| 属性名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| dialogFormVisible | Boolean | false | 对话框显示状态 |
+| title | String | '' | 对话框标题 |
+
+**Events 事件**:
+- `close` - 关闭对话框时触发
+- `define` - 验证通过确认时触发
+
+**实际使用示例**:
+```vue
+<!-- 来源: cloud-system-manage/src/pages/ou/user/view/Grid.vue -->
+<template>
+  <verifiy-password
+    :title="title1"
+    :dialogFormVisible="jianquanVisible"
+    @close="dialogClose"
+    @define="handelConfirm"
+  ></verifiy-password>
+</template>
+
+<script>
+import verifiyPassword from '@/components/verifiy-password';
+export default {
+  components: { verifiyPassword },
+  data() {
+    return {
+      title1: '安全验证',
+      jianquanVisible: false,
+      buttonCode: ''
+    };
+  },
+  methods: {
+    handelConfirmJianquan() {
+      // 打开验证弹窗
+      this.jianquanVisible = true;
+    },
+    dialogClose() {
+      // 关闭验证弹窗
+      this.jianquanVisible = false;
+    },
+    handelConfirm() {
+      // 验证通过后的回调
+      this.jianquanVisible = false;
+      if (this.buttonCode === 'user_delete') {
+        this.handleDeletes();
+      } else if (this.buttonCode === 'user_enable') {
+        this.enableDept();
+      }
+      // ... 其他操作
+    },
+    triggerVerify(code) {
+      // 触发验证前记录操作码
+      this.buttonCode = code;
+      this.jianquanVisible = true;
+    }
+  }
+}
+</script>
+```
+
+---
+
+##### 5.1.12 通用头部组件 (CommonHeader)
+
+**文件路径**: `cloud-module/cloud-module-base/packages/components/common-header.vue`
+
+**功能说明**: 通用页面头部组件，包含面包屑导航和密级标签显示。
+
+**导入方式**:
+```javascript
+import commonHeader from 'cloud-module-base/packages/components/common-header';
+Vue.component(commonHeader.name, commonHeader);
+```
+
+**实际使用示例**:
+```vue
+<!-- 来源: cloud-system-manage/src/pages/ou/tenancy/view/Dialog.vue -->
+<template>
+  <el-container>
+    <el-header height="50px">
+      <el-row>
+        <el-col :span="12">
+          <v-header></v-header>
+        </el-col>
+        <el-col :span="12" style="text-align:right;line-height:50px;">
+          <el-button type="primary" size="medium" @click="submitForm">
+            {{ $t('base.button.save') }}
+          </el-button>
+        </el-col>
+      </el-row>
+    </el-header>
+    <el-main>
+      <!-- 表单内容 -->
+    </el-main>
+  </el-container>
+</template>
+
+<script>
+import header from 'cloud-module-base/packages/components/common-header';
+export default {
+  components: { 'v-header': header }
+}
+</script>
+```
+
+## 💡 使用建议
+
+1. **资源授权 vs 菜单授权**：粒度区分——`MenuAuth` 控制整个页面可见，`ResourceCodeAuth` 控制页面内具体按钮（如导入/导出）可见。
+2. **三员角色配置**：`<three-member-auth role-code="XTGLY,AQGLY">` 支持多角色逗号分隔（任一命中即可）。
+3. **二级鉴别前置**：删除/启用等高危操作务必先 `VerifiyPassword` 二次验证，避免误操作。
+4. **面包屑复用**：所有列表/表单页统一使用 `CommonHeader`（alias `v-header`），保持页面骨架一致。
+
+## 🔗 相关章节
+
+- `15_五前端资产-5.1UI组件库-上半.md`（CloudDialog / UserSelect / DeptSelect / RoleSelect / ImportButton / MenuAuth）
+- `12_四业务组件-4.1工作流BpmEngine.md`（BPM 流程协同）

package/skills/meritdata-dev-docs-file-finder/references/dev-docs/17_/351/231/204/345/275/225-/347/273/237/350/256/241/346/261/207/346/200/273-Maven/344/276/235/350/265/226-/346/263/250/346/204/217/344/272/213/351/241/271.md

@@ -0,0 +1,131 @@
+---
+name: 附录-统计汇总-Maven依赖-注意事项
+source-file: 公共资产清单
+source-section: 附录 - 组件及方法统计 + 统计汇总 + A. Maven依赖坐标 + B. 组件开发注意事项
+keywords: [Maven依赖, 命名规范, 注意事项, 组件统计, cloud-module-base, cloud-module-cache, cloud-starter-core, 6.13.2, EventBus, i18n, Element-UI]
+use-cases: [添加Maven依赖, 了解平台组件统计, 二开组件开发注意事项, 国际化引入, 依赖版本对齐]
+related: [17, 01]
+---
+
+# 附录-统计汇总-Maven依赖-注意事项
+
+> **原文章节**：`公共资产清单 → 组件及方法统计 + 统计汇总 + A. Maven依赖坐标 + B. 组件开发注意事项`
+> **行号范围**：L3416–L3516
+
+## 🎯 一句话
+汇总平台 43 个组件/工具类、111+ 方法的统计信息，以及二开项目接入必须引入的 Maven 依赖坐标与组件开发注意事项。
+
+## 📋 接口/方法清单
+
+## 组件及方法统计
+
+本文档共涵盖 **9个后端工具类**、**7个后端组件**、**7组外部接口**、**14个前端组件**、**6个前端工具方法**，共计 **43个组件/工具类**，包含 **111+个方法**。
+
+---
+
+| 分类 | 序号 | 名称 | 方法数 | 作用说明 |
+|------|------|------|--------|----------|
+| **后端工具类** | 1 | SysCacheServiceFacade | 23 | Redis缓存操作工具类，提供put/get/hget/hset/queue等23种缓存操作方法 |
+| | 2 | StringCacheFacade | 3 | String类型缓存工具类，提供put/get/multiGet方法 |
+| | 3 | NacosUtils | 10 | Nacos配置中心工具类，提供获取/修改/新增配置等10种方法 |
+| | 4 | Sm2Utils | 3 | SM2非对称加密工具类，提供密钥生成/加密/解密3种方法 |
+| | 5 | SM3Encoder | 2 | SM3哈希加密工具类，提供encryptWithHMacMD5/encode方法 |
+| | 6 | Sm4Utils | 2 | SM4对称加密工具类，提供encrypt/decrypt方法 |
+| | 7 | SessionUtils | 21 | 会话信息工具类，提供获取当前用户ID/姓名/部门/角色等21种方法 |
+| | 8 | LogPattenUtils | 1 | 日志模板工具类，提供getProperty获取日志模板配置 |
+| | 9 | CompareUtils | 1 | 日志对比工具类，提供getCompareLog自动生成变更日志 |
+| **后端组件** | 1 | ILogPostService | 2 | 日志服务组件，提供postLog/POST /post（操作日志）、postDiyLog/POST /post-diy（自定义日志）2个接口 |
+| | 2 | BpmEngine | 13 | 工作流引擎组件，提供启动流程/完成任务/退回/删除/查询/追踪等13个接口 |
+| | 3 | IJobApi | 10 | 任务调度组件，提供getJob/pageList/triggerJob/startJob/stopJob/add/update/remove等10个接口 |
+| | 4 | CloudFeignMessageClient | 5 | 服务通知Feign客户端，提供sendRoleMessage/sendResourceMessage/sendUserRoleMessage/sendAssignMessage/sendUserAppMessage 5个消息发送方法 |
+| | 5 | @LogDesc/@AddDesc/@DelDesc | 3 | 日志注解组件，@LogDesc标注字段描述、@AddDesc新增记录、@DelDesc删除记录 |
+| | 6 | EnableDataSecretFilter | 1 | 数据脱敏注解组件，标注后自动启用Hibernate数据密级过滤 |
+| | 7 | DynamicCloudFeignClient | 1 | 动态FeignClient构建组件，提供getFeignClient动态构建Feign客户端 |
+| **外部接口** | 1 | ISecurityAuthService | 7 | 安全认证接口，提供用户认证、权限查询等7个方法 |
+| | 2 | ICloudClient | 4 | 云服务客户端接口，提供服务端注册/心跳等4个方法 |
+| | 3 | IJobApi | 10 | 任务调度API接口，提供任务CRUD/触发/启停等10个方法 |
+| | 4 | IMessageApi | 3 | 消息服务接口，提供消息发送等3个方法 |
+| | 5 | IResourceApi | 4 | 资源管理接口，提供资源查询/分配等4个方法 |
+| | 6 | IUserPortalApi | 3 | 用户门户接口，提供用户信息/Token等3个方法 |
+| | 7 | 其他Feign接口 | - | 包含ISysLogApi、IOrgApi、IEmpApi等若干Feign接口 |
+| **前端组件** | 1 | CloudDialog | - | 通用对话框组件，提供对话框显示/关闭等交互 |
+| | 2 | UserSelect | - | 用户选择组件，通过props控制选择模式，通过events交互 |
+| | 3 | UserSelectMulti | - | 多用户选择组件，通过props控制选择模式，通过events交互 |
+| | 4 | DeptSelect | - | 部门选择组件，通过props控制选择模式，通过events交互 |
+| | 5 | RoleSelect | - | 角色选择组件，通过props控制选择模式，通过events交互 |
+| | 6 | ImportButton | - | 导入按钮组件，支持导入模板下载/数据导入/错误文件下载，通过events交互 |
+| | 7 | MenuAuth | - | 菜单权限组件，通过props控制权限显示 |
+| | 8 | ResourceCodeAuth | - | 资源权限组件，通过props控制资源权限显示 |
+| | 9 | ThreeMemberAuth | - | 三员授权组件，通过props和events与外部交互 |
+| | 10 | TableHeadSearch | - | 表格头部搜索组件 |
+| | 11 | VerifiyPassword | - | 二级鉴别密码验证弹窗组件 |
+| | 12 | CommonHeader | - | 通用头部组件 |
+| | 13 | BpmGridButtonsNew | - | BPM表格按钮组件，提供新建/我的申请/我的审批/所有流程等操作按钮，通过props和events与外部交互 |
+| | 14 | BpmFormTools | - | BPM表单工具组件，集成发送/暂存等流程操作按钮 |
+| **前端工具方法** | 1 | sm4-utils.js | 2 | SM4加密解密工具，提供encrypt/decrypt方法 |
+| | 2 | sm2.js | - | SM2加密工具 |
+| | 3 | accessLogs.js | 1 | 访问日志工具，提供saveAcessLog方法 |
+| | 4 | dataFormat.js | 1 | 日期格式化工具，提供formatter方法 |
+| | 5 | form-rules.js | 12 | 表单校验规则，提供required/nospecial/noSpecialCode/name/cellphone/telephone/email/idcard/url/ip/mac等12种校验规则 |
+| | 6 | globalValitor.js | - | 全局校验器 |
+
+---
+
+### 统计汇总
+
+| 分类 | 数量 | 方法/接口数 |
+|------|------|-------------|
+| 后端工具类 | 9个 | 66个方法 |
+| 后端组件 | 7个 | 25个接口 |
+| 外部接口 | 7组 | 20+个接口 |
+| 前端组件 | 14个 | - |
+| 前端工具方法 | 6个 | - |
+| **合计** | **43个** | **111+个** |
+
+---
+
+### A. Maven依赖坐标
+
+```xml
+<!-- cloud-module-base -->
+<dependency>
+    <groupId>com.meritdata.cloud</groupId>
+    <artifactId>cloud-module-base</artifactId>
+    <version>6.13.2</version>
+</dependency>
+
+<!-- cloud-module-cache -->
+<dependency>
+    <groupId>com.meritdata.cloud</groupId>
+    <artifactId>cloud-module-cache</artifactId>
+    <version>6.13.2</version>
+</dependency>
+
+<!-- cloud-starter-core -->
+<dependency>
+    <groupId>com.meritdata.cloud</groupId>
+    <artifactId>cloud-starter-core</artifactId>
+    <version>6.13.2</version>
+</dependency>
+```
+
+---
+
+### B. 组件开发注意事项
+
+1. **EventBus**: 所有组件通过 `Vue.prototype.EventBus` 进行内部通信
+2. **国际化**: 组件使用 `$t()` 函数进行国际化处理，需要配置 i18n
+3. **依赖**: BPM 组件依赖 Element-UI 和 cloud-module-base
+4. **样式**: CloudDialog 组件需要引入样式文件: `import 'cloud-module-base/static/css/cloud-dialog.css';`
+
+## 💡 使用建议
+
+1. **版本锁定**：所有 `cloud-module-*` 依赖固定 `6.13.2`，与 `pom.xml` 中 `meritdata-cloud.version` 一致，避免序列化错误。
+2. **BPM 组件强依赖**：BPM 相关组件（`BpmFormTools` / `BpmGridButtonsNew`）必须额外引入 `cloud-module-bpm`，否则页面报错。
+3. **国际化必须**：所有 `$t()` 文案必须新增 i18n 词条，否则会渲染 `key` 字符串。
+4. **不要重复造轮子**：优先调用平台服务（如 `SysCacheServiceFacade`），不要直接用 `RedisTemplate`；优先使用 `cloud-module-base` 静态组件，不要自研。
+
+## 🔗 相关章节
+
+- `01_全部章节`（其他所有拆分文件）
+- `公共资产清单 5.3 流程组件与方法`（MeritBPM 前端方法与后端 API 对应）