@alanwang-merit/meritdata-platform-skill-package 1.0.10 → 1.0.12

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

@@ -1,302 +0,0 @@
----
-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

@@ -1,131 +0,0 @@
----
-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 对应）