@alanwang-merit/meritdata-platform-skill-package 1.0.9 → 1.0.11

package/skills/meritdata-platform-2nd-dev-check/scripts/check-frontend.sh

@@ -0,0 +1,225 @@
+#!/bin/bash
+# =============================================================================
+# 检查前端工程：package.json / .npmrc / vue.config.js / 页面结构 / 构建
+# 通用化：从环境变量读取所有项目特定配置
+# =============================================================================
+set -e
+
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m'
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../../../.." && pwd)"
+
+# 自动从 Nacos 导出目录加载真实配置
+if [ -f "$SCRIPT_DIR/load-config.sh" ]; then
+    source "$SCRIPT_DIR/load-config.sh"
+fi
+
+# 加载项目根 .env
+if [ -f "$PROJECT_ROOT/.env" ]; then
+    source "$PROJECT_ROOT/.env"
+fi
+FRONTEND_DIR="$PROJECT_ROOT/front-end"
+cd "$FRONTEND_DIR"
+
+PASS=0
+FAIL=0
+WARN=0
+
+print_result() {
+    local status=$1
+    local name=$2
+    local detail=$3
+    case $status in
+        PASS) echo -e "${GREEN}✅${NC} $name: $detail"; PASS=$((PASS+1));;
+        FAIL) echo -e "${RED}❌${NC} $name: $detail"; FAIL=$((FAIL+1));;
+        WARN) echo -e "${YELLOW}⚠️${NC} $name: $detail"; WARN=$((WARN+1));;
+    esac
+}
+
+# 必需环境变量
+for v in APP_NAME PLATFORM_VERSION FRONTEND_PAGES; do
+    if [ -z "${!v}" ]; then
+        print_result FAIL "环境变量 $v" "未设置"
+        exit 1
+    fi
+done
+
+echo "=== 1. package.json 检查 ==="
+
+# name
+NAME=$(grep -oP '"name":\s*"\K[^"]+' package.json)
+if [ "$NAME" = "$APP_NAME" ]; then
+    print_result PASS "name" "$NAME"
+else
+    print_result FAIL "name" "$NAME（应为 $APP_NAME）"
+fi
+
+# version（可选验证）
+# VERSION=$(grep -oP '"version":\s*"\K[^"]+' package.json)
+# if [ "$VERSION" = "$PLATFORM_VERSION" ]; then ... fi
+
+# 关键依赖
+for dep in "cloud-module-base" "cloud-module-bpm"; do
+    if grep -q "\"$dep\": \"$PLATFORM_VERSION\"" package.json; then
+        print_result PASS "依赖 $dep" "$PLATFORM_VERSION"
+    else
+        ACTUAL=$(grep -oP "\"$dep\":\s*\"\K[^\"]+" package.json)
+        print_result FAIL "依赖 $dep" "版本 $ACTUAL（应为 $PLATFORM_VERSION）"
+    fi
+done
+
+# cross-env
+if grep -q "cross-env" package.json; then
+    print_result PASS "cross-env" "已装"
+else
+    print_result FAIL "cross-env" "缺失"
+fi
+
+# scripts
+for script in "serve" "build"; do
+    if grep -qE "\"$script\":\s*\"cross-env" package.json; then
+        print_result PASS "script $script" "含 cross-env"
+    else
+        print_result FAIL "script $script" "未含 cross-env"
+    fi
+done
+
+echo ""
+echo "=== 2. .npmrc 检查 ==="
+
+if [ -f ".npmrc" ]; then
+    REGISTRY=$(grep -oP "^registry=\K.*" .npmrc | head -1)
+    if [ -n "$REGISTRY" ]; then
+        print_result PASS "registry" "$REGISTRY"
+    else
+        print_result FAIL "registry" "未设置"
+    fi
+else
+    print_result FAIL ".npmrc" "缺失"
+fi
+
+echo ""
+echo "=== 3. vue.config.js 检查 ==="
+
+# pages 来自 FRONTEND_PAGES（逗号分隔）
+IFS=',' read -ra PAGES <<< "$FRONTEND_PAGES"
+for page in "${PAGES[@]}"; do
+    page=$(echo "$page" | tr -d ' ')  # 去空格
+    if grep -q "$page:" vue.config.js; then
+        print_result PASS "pages $page" "配置存在"
+    else
+        print_result FAIL "pages $page" "缺失"
+    fi
+done
+
+# proxy
+if grep -q "proxy" vue.config.js && grep -q "localhost:8081" vue.config.js; then
+    print_result PASS "proxy gateway" "localhost:8081"
+else
+    print_result FAIL "proxy gateway" "配置错"
+fi
+
+# publicPath
+PUBLIC_PATH=$(grep -oP "publicPath:\s*process\.env\.NODE_ENV\s*===\s*'production'\s*\?\s*'\K[^']+" vue.config.js)
+if [ -n "$PUBLIC_PATH" ]; then
+    print_result PASS "publicPath" "$PUBLIC_PATH"
+fi
+
+# chainWebpack cloud-module-base
+if grep -q "cloud-module-base" vue.config.js; then
+    print_result PASS "chainWebpack" "含 cloud-module-base 编译规则"
+else
+    print_result FAIL "chainWebpack" "不含 cloud-module-base"
+fi
+
+echo ""
+echo "=== 4. http.js 检查 ==="
+
+if [ -f "src/http-config/http.js" ]; then
+    if grep -q "'/contract'" src/http-config/http.js; then
+        print_result PASS "appPath" "/contract"
+    else
+        print_result FAIL "appPath" "未设 /contract"
+    fi
+
+    if grep -q "cloud-module-base/packages/httpConfig/http-plugin" src/http-config/http.js; then
+        print_result PASS "http-plugin import" "正确"
+    else
+        print_result FAIL "http-plugin import" "缺失"
+    fi
+else
+    print_result FAIL "http.js" "缺失"
+fi
+
+echo ""
+echo "=== 5. 业务页面结构 ==="
+
+for page in "${PAGES[@]}"; do
+    page=$(echo "$page" | tr -d ' ')
+    PAGE_DIR="src/pages/$page"
+    if [ -d "$PAGE_DIR" ]; then
+        FILE_COUNT=$(find "$PAGE_DIR" -type f 2>/dev/null | wc -l)
+        if [ "$FILE_COUNT" -ge 9 ]; then
+            print_result PASS "$page" "$FILE_COUNT 个文件"
+        else
+            print_result WARN "$page" "$FILE_COUNT 个文件（建议 ≥ 9）"
+        fi
+    else
+        print_result FAIL "$page" "目录缺失"
+    fi
+done
+
+echo ""
+echo "=== 6. node_modules 验证 ==="
+
+if [ -d "node_modules/cloud-module-base" ]; then
+    CMB_VER=$(grep -oP '"version":\s*"\K[^"]+' node_modules/cloud-module-base/package.json)
+    if [ "$CMB_VER" = "$PLATFORM_VERSION" ]; then
+        print_result PASS "cloud-module-base" "$CMB_VER"
+    else
+        print_result FAIL "cloud-module-base" "版本 $CMB_VER"
+    fi
+else
+    print_result FAIL "cloud-module-base" "未安装"
+fi
+
+if [ -d "node_modules/cloud-module-bpm" ]; then
+    CMB_VER=$(grep -oP '"version":\s*"\K[^"]+' node_modules/cloud-module-bpm/package.json)
+    if [ "$CMB_VER" = "$PLATFORM_VERSION" ]; then
+        print_result PASS "cloud-module-bpm" "$CMB_VER"
+    else
+        print_result FAIL "cloud-module-bpm" "版本 $CMB_VER"
+    fi
+else
+    print_result FAIL "cloud-module-bpm" "未安装"
+fi
+
+# 检查关键组件路径
+for path in "cloud-module-base/packages/httpConfig/http-plugin.js" \
+            "cloud-module-base/packages/user-select/UserSelect.vue" \
+            "cloud-module-base/packages/dept-select" \
+            "cloud-module-base/packages/i18n" \
+            "cloud-module-base/static/js/utils/sm4-utils.js" \
+            "cloud-module-bpm/packages/bpm-form-tools" \
+            "cloud-module-bpm/packages/bpm-grid-buttons-new"; do
+    if [ -f "node_modules/$path" ] || [ -d "node_modules/$path" ]; then
+        print_result PASS "node_modules/$path" "存在"
+    else
+        print_result FAIL "node_modules/$path" "缺失"
+    fi
+done
+
+echo ""
+echo "=== 总结 ==="
+echo -e "通过: ${GREEN}$PASS${NC}"
+echo -e "警告: ${YELLOW}$WARN${NC}"
+echo -e "失败: ${RED}$FAIL${NC}"
+
+if [ $FAIL -gt 0 ]; then
+    exit 1
+fi
+exit 0

package/skills/meritdata-platform-2nd-dev-check/scripts/check-lib-version.sh

@@ -0,0 +1,289 @@
+#!/bin/bash
+# =============================================================================
+# 关键库版本一致性检查：pom.xml vs apps/common-lib/
+#
+# 背景：美林平台 apps/common-lib/ 目录是平台实际部署的 jar 包目录
+#      工程 pom.xml 引用的 cloud-module-base ${PLATFORM_VERSION} 内部依赖的
+#      Spring Boot / Spring Cloud / Taier / Camunda 等版本可能与 common-lib 不一致
+#      运行时调用平台 API 时可能触发序列化/ClassNotFound/方法签名不匹配等错误
+#
+# 增强：meritdata-platform-2nd-dev-check 之前没检查此项，本脚本独立 + 集成到 run-all.sh
+# =============================================================================
+set -e
+
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../../../.." && pwd)"
+
+# 加载公共配置
+if [ -f "$SCRIPT_DIR/load-config.sh" ]; then
+    source "$SCRIPT_DIR/load-config.sh"
+fi
+if [ -f "$PROJECT_ROOT/.env" ]; then
+    source "$PROJECT_ROOT/.env"
+fi
+
+# ============== 参数校验 ==============
+if [ -z "$MERIT_HOME" ]; then
+    if [ -f "$PROJECT_ROOT/back-end/src/main/resources/bootstrap.properties" ]; then
+        MERIT_HOME=$(grep -E "^CLOUD_HOME=" "$PROJECT_ROOT/back-end/src/main/resources/bootstrap.properties" | head -1 | cut -d= -f2-)
+    fi
+fi
+
+if [ -z "$MERIT_HOME" ] || [ ! -d "$MERIT_HOME" ]; then
+    echo "[ERROR] CLOUD_HOME not set or directory not found"
+    echo "  Set: export MERIT_HOME=/path/to/merit-platform-env"
+    echo "  Or set CLOUD_HOME= in bootstrap.properties"
+    exit 1
+fi
+
+COMMON_LIB_DIR="$MERIT_HOME/apps/common-lib"
+if [ ! -d "$COMMON_LIB_DIR" ]; then
+    echo "[ERROR] apps/common-lib not found: $COMMON_LIB_DIR"
+    exit 1
+fi
+
+POM_FILE="${POM_FILE:-$PROJECT_ROOT/back-end/pom.xml}"
+if [ ! -f "$POM_FILE" ]; then
+    echo "[ERROR] pom.xml not found: $POM_FILE"
+    exit 1
+fi
+
+PASS=0
+FAIL=0
+WARN=0
+MISMATCH_LIST=""
+
+print_result() {
+    local status=$1
+    local name=$2
+    local detail=$3
+    case "$status" in
+        PASS)
+            echo -e "  [PASS] ${GREEN}$name${NC}: $detail"
+            PASS=$((PASS+1))
+            ;;
+        MISMATCH)
+            echo -e "  [MISMATCH] ${RED}$name${NC}: $detail"
+            MISMATCH_LIST="$MISMATCH_LIST|$name:$detail"
+            FAIL=$((FAIL+1))
+            ;;
+        WARN)
+            echo -e "  [WARN] ${YELLOW}$name${NC}: $detail"
+            WARN=$((WARN+1))
+            ;;
+    esac
+}
+
+# ============== 步骤 1：枚举 common-lib 全部 jar ==============
+echo "=== 0. 扫描 apps/common-lib 实际部署的 jar 包 ==="
+COMMON_LIB_JARS=$(find "$COMMON_LIB_DIR" -maxdepth 1 -name "*.jar" -type f 2>/dev/null | wc -l)
+echo "  共发现 $COMMON_LIB_JARS 个 jar 包"
+
+# 构建临时索引 (artifactId|version)
+COMMON_LIB_INDEX=$(mktemp)
+while IFS= read -r jar; do
+    name=$(basename "$jar" .jar)
+    version=$(echo "$name" | sed -E 's/.*-([0-9][^-]*)$/\1/')
+    artifactId=$(echo "$name" | sed -E "s/-${version}\$//")
+    printf '%s|%s\n' "$artifactId" "$version" >> "$COMMON_LIB_INDEX"
+done < <(find "$COMMON_LIB_DIR" -maxdepth 1 -name "*.jar" -type f)
+echo "  索引已生成"
+
+# ============== 步骤 2：解析 pom.xml <dependencies> 块 ==============
+echo ""
+echo "=== 1. 解析 pom.xml 关键依赖 ==="
+
+# 工程 PLATFORM_VERSION
+PLATFORM_VERSION=$(grep -E "<meritdata-cloud\.version>" "$POM_FILE" | head -1 | sed -E 's/.*<meritdata-cloud\.version>([^<]+)<.*/\1/')
+echo "  工程 PLATFORM_VERSION = $PLATFORM_VERSION"
+
+# 解析 <dependencies> 块内的 <dependency> → artifactId|version
+POM_DEPS_FILE=$(mktemp)
+# 提取 <dependencies> 块，再用 grep+sed 配对 artifactId 和 version
+sed -n '/<dependencies>/,/<\/dependencies>/p' "$POM_FILE" | \
+    awk '
+        /<artifactId>/ {
+            gsub(/[ \t]+/, "", $0)
+            match($0, /<artifactId>([^<]+)<\/artifactId>/, a)
+            art = a[1]
+            getline; gsub(/[ \t]+/, "", $0)
+            match($0, /<version>([^<]+)<\/version>/, v)
+            if (art != "" && v[1] != "") {
+                printf("%s|%s\n", art, v[1]) > "/dev/stdout"
+            }
+        }
+    ' > "$POM_DEPS_FILE"
+
+# 解析 <properties> 块（所有 *.version 属性）
+POM_PROPS_FILE=$(mktemp)
+# 用 grep -oE 提取每个 <Xxx.version>value</Xxx.version> 整段
+# 然后用 awk 提取 key=value
+grep -oE '<[a-zA-Z][a-zA-Z0-9.-]+\.version>[^<]+</[a-zA-Z][a-zA-Z0-9.-]+\.version>' "$POM_FILE" | \
+    awk -F'[<>]' '{
+        # 匹配 <key.version>value</key.version>
+        # 字段1=空 字段2=key.version 字段3=value 字段4=/key.version
+        # 先找 version 标记
+        if ($0 ~ /\.version>/) {
+            n = split($2, a, ".")
+            # 提取 key 部分（除最后 .version 段）
+            key = ""
+            for (i=1; i<n; i++) {
+                if (i>1) key = key "."
+                key = key a[i]
+            }
+            print key "|" $3
+        }
+    }' > "$POM_PROPS_FILE"
+
+# 加载到 map
+declare -A POM_DEPS
+declare -A POM_PROPS
+while IFS='|' read -r art ver; do
+    [ -n "$art" ] && POM_DEPS["$art"]="$ver"
+done < "$POM_DEPS_FILE"
+while IFS='|' read -r key ver; do
+    [ -n "$key" ] && POM_PROPS["$key"]="$ver"
+done < "$POM_PROPS_FILE"
+
+# ============== 步骤 3：检查每个关键依赖 ==============
+echo ""
+echo "=== 2. 版本一致性比对 ==="
+echo "  关键风险：序列化错误（不同版本 serialVersionUID 可能不同）"
+echo ""
+
+# 从 common-lib 找版本的函数
+get_lib_version() {
+    local artifactId=$1
+    grep -E "^${artifactId}\|" "$COMMON_LIB_INDEX" | head -1 | cut -d'|' -f2
+}
+
+# 从 pom 找版本（dependency 块 + properties 块 + 解析 ${xxx} 占位符）
+resolve_version() {
+    # 递归解析 ${xxx} 引用（最多 3 层避免死循环）
+    local ver=$1
+    local i=0
+    while echo "$ver" | grep -qE '\$\{.+\}' && [ $i -lt 3 ]; do
+        # 提取 ${xxx} 里的 xxx
+        local ref=$(echo "$ver" | sed -E 's/.*\$\{([^}]+)\}.*/\1/')
+        # 尝试多种 key 形式
+        local ref_val="${POM_PROPS[$ref]:-${POM_DEPS[$ref]:-}}"
+        if [ -z "$ref_val" ]; then
+            # 尝试把 ref 当成 xxx.version 形式 (例: meritdata-cloud.version → meritdata-cloud)
+            local ref_short=$(echo "$ref" | sed -E 's/\.version$//')
+            ref_val="${POM_PROPS[$ref_short]:-${POM_DEPS[$ref_short]:-}}"
+        fi
+        if [ -z "$ref_val" ]; then
+            break
+        fi
+        # 用 bash 内置 string replacement 避免 sed 转义问题
+        local placeholder='${'"$ref"'}'
+        ver="${ver//$placeholder/$ref_val}"
+        i=$((i+1))
+    done
+    echo "$ver"
+}
+
+get_pom_version() {
+    local artifactId=$1
+    local ver="${POM_DEPS[$artifactId]:-}"
+    if [ -z "$ver" ]; then
+        # 尝试 properties 块
+        case "$artifactId" in
+            spring-boot) ver="${POM_PROPS[spring-boot]:-}";;
+            spring-cloud) ver="${POM_PROPS[spring-cloud]:-}";;
+            nacos-client) ver="${POM_PROPS[nacos-client]:-}";;
+            *) ver="${POM_PROPS[$artifactId]:-}";;
+        esac
+    fi
+    # 解析 ${xxx} 占位符
+    ver=$(resolve_version "$ver")
+    echo "$ver"
+}
+
+# ============== 类别 1：平台核心依赖（cloud-*） ==============
+# 这些是 MERIT 平台私有 jar，在本地 Maven 仓库，不在 common-lib
+# 只确认 PLATFORM_VERSION 一致即可
+echo "  --- 平台核心依赖（cloud-*，在本地 Maven 仓库，不在 common-lib）---"
+for dep in cloud-module-base cloud-module-cache cloud-module-bpm \
+           cloud-system-bpm-module-core cloud-system-bpm-module-base \
+           cloud-starter-core cloud-starter-dbinit; do
+    pom_ver=$(get_pom_version "$dep")
+    if [ -z "$pom_ver" ]; then
+        print_result "WARN" "$dep" "pom.xml 未声明（可能间接传递）"
+    elif [ "$pom_ver" = "$PLATFORM_VERSION" ]; then
+        print_result "PASS" "$dep" "version=$pom_ver (与 PLATFORM_VERSION 对齐)"
+    else
+        print_result "MISMATCH" "$dep" "pom=$pom_ver, PLATFORM=$PLATFORM_VERSION"
+    fi
+done
+
+# ============== 类别 2：第三方核心依赖（应在 common-lib） ==============
+echo ""
+echo "  --- 第三方核心依赖（应在 apps/common-lib 实际部署）---"
+for dep in spring-boot spring-cloud nacos-client mybatis \
+           camunda-engine camunda-bpm-spring-boot-starter aspectjweaver lombok hutool-all; do
+    pom_ver=$(get_pom_version "$dep")
+    lib_ver=$(get_lib_version "$dep")
+    if [ -z "$pom_ver" ]; then
+        print_result "WARN" "$dep" "pom.xml 未声明（可能间接传递或 BOM 锁定）"
+    elif [ -z "$lib_ver" ]; then
+        print_result "WARN" "$dep" "pom=$pom_ver, apps/common-lib 未找到"
+    elif [ "$pom_ver" = "$lib_ver" ]; then
+        print_result "PASS" "$dep" "pom=$pom_ver = lib=$lib_ver"
+    else
+        print_result "MISMATCH" "$dep" "pom=$pom_ver, lib=$lib_ver [SERIALIZATION RISK]"
+    fi
+done
+
+# ============== 类别 3：Taier 调度 ==============
+echo ""
+echo "  --- Taier 调度（来自 cloud-module-cache）---"
+for dep in taier-common taier-scheduler taier-dao taier-plugin-api; do
+    pom_ver=$(get_pom_version "$dep")
+    lib_ver=$(get_lib_version "$dep")
+    if [ -z "$pom_ver" ] && [ -z "$lib_ver" ]; then
+        print_result "WARN" "$dep" "pom 和 common-lib 都未声明（间接传递）"
+    elif [ -z "$pom_ver" ]; then
+        # pom 未声明但 lib 有 → 用 lib 版本作为参考
+        print_result "WARN" "$dep" "pom 未声明, common-lib=$lib_ver"
+    elif [ -z "$lib_ver" ]; then
+        print_result "WARN" "$dep" "pom=$pom_ver, common-lib 未找到"
+    elif [ "$pom_ver" = "$lib_ver" ]; then
+        print_result "PASS" "$dep" "pom=$pom_ver = lib=$lib_ver"
+    else
+        print_result "MISMATCH" "$dep" "pom=$pom_ver, lib=$lib_ver [SERIALIZATION RISK]"
+    fi
+done
+
+# ============== 清理 ==============
+rm -f "$COMMON_LIB_INDEX" "$POM_DEPS_FILE" "$POM_PROPS_FILE"
+
+# ============== 总结 ==============
+echo ""
+echo "=== 总结 ==="
+echo "  PASS: $PASS"
+echo "  WARN: $WARN"
+echo "  MISMATCH: $FAIL"
+
+if [ $FAIL -gt 0 ]; then
+    echo ""
+    echo "[WARN] 关键库版本不一致，可能引发:"
+    echo "  - 序列化反序列化失败（不同版本 serialVersionUID）"
+    echo "  - ClassNotFoundException（类路径漂移）"
+    echo "  - NoSuchMethodError（方法签名不一致）"
+    echo ""
+    echo "修复建议:"
+    echo "  1. 同步升级 pom.xml 中的版本到 apps/common-lib 实际版本"
+    echo "  2. 或升级 apps/common-lib 到工程预期的版本"
+    echo "  3. 确认 cloud-starter-parent 父 POM 的 BOM 与 common-lib 对齐"
+    exit 1
+fi
+
+echo "[PASS] 所有关键库版本一致"
+exit 0