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

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

@@ -0,0 +1,171 @@
+#!/bin/bash
+# =============================================================================
+# 检查后端工程：pom.xml / bootstrap.properties / Java 包结构 / 编译
+# 通用化：从环境变量读取所有项目特定配置
+# =============================================================================
+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
+BACKEND_DIR="$PROJECT_ROOT/back-end"
+cd "$BACKEND_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 APP_PORT MAVEN_SETTINGS MERIT_HOME; do
+    if [ -z "${!v}" ]; then
+        print_result FAIL "环境变量 $v" "未设置"
+        echo "请设置：export $v=<value>"
+        exit 1
+    fi
+done
+
+echo "=== 1. pom.xml 检查 ==="
+
+# artifactId（修复 2026-07-27：原写法取第一个 <artifactId>，但 Maven 父子 POM 结构中
+# 第一个通常是父 POM 的 artifactId（如 cloud-starter-parent），不是本工程的。
+# 正确做法：跳过 <parent>...</parent> 块，再取第一个 <artifactId>）
+ARTIFACT=$(awk '
+    /<parent>/   { in_parent = 1 }
+    /<\/parent>/ { in_parent = 0; next }
+    in_parent    { next }
+    /<artifactId>/ {
+        gsub(/.*<artifactId>/, "")
+        gsub(/<\/artifactId>.*/, "")
+        print
+        exit
+    }
+' pom.xml)
+if [ "$ARTIFACT" = "$APP_NAME" ]; then
+    print_result PASS "artifactId" "$ARTIFACT"
+else
+    print_result FAIL "artifactId" "$ARTIFACT（应为 $APP_NAME）"
+fi
+
+# 关键依赖
+for dep in "cloud-starter-core" "cloud-module-base" "cloud-system-bpm-module-core"; do
+    if grep -q "<artifactId>$dep</artifactId>" pom.xml; then
+        print_result PASS "依赖 $dep" "存在"
+    else
+        print_result FAIL "依赖 $dep" "缺失"
+    fi
+done
+
+# 错误依赖（不应存在）
+if grep -q "<artifactId>cloud-module-bpm</artifactId>" pom.xml; then
+    print_result FAIL "依赖 cloud-module-bpm" "存在（应改用 cloud-system-bpm-module-core）"
+fi
+
+echo ""
+echo "=== 2. bootstrap.properties 检查 ==="
+
+CONFIG_FILE="src/main/resources/bootstrap.properties"
+
+# 关键配置
+declare -A REQUIRED_CONFIG=(
+    ["server.port"]="$APP_PORT"
+    ["spring.cloud.nacos.config.server-addr"]="${NACOS_HOST}:${NACOS_PORT}"
+    ["spring.cloud.nacos.config.namespace"]="public"
+)
+
+for key in "${!REQUIRED_CONFIG[@]}"; do
+    expected="${REQUIRED_CONFIG[$key]}"
+    actual=$(grep -oP "^$key=\K[^[:space:]]*" "$CONFIG_FILE" 2>/dev/null || echo "")
+    if [ "$actual" = "$expected" ]; then
+        print_result PASS "$key" "$actual"
+    else
+        print_result FAIL "$key" "$actual（应为 $expected）"
+    fi
+done
+
+# CLOUD_HOME 路径
+CLOUD_HOME=$(grep -oP "^CLOUD_HOME=\K.*" "$CONFIG_FILE" | tr -d '\\\\' | sed 's|\\|/|g')
+if [ -d "$CLOUD_HOME" ]; then
+    print_result PASS "CLOUD_HOME" "$CLOUD_HOME"
+    for f in key.tmp public.pem skey.dat; do
+        if [ -f "$CLOUD_HOME/key/$f" ]; then
+            print_result PASS "证书 $f" "存在"
+        else
+            print_result FAIL "证书 $f" "缺失"
+        fi
+    done
+else
+    print_result FAIL "CLOUD_HOME" "$CLOUD_HOME 不存在"
+fi
+
+echo ""
+echo "=== 3. Java 包结构 ==="
+
+# 包名按 APP_NAME 推算（合同类比）
+declare -A REQUIRED_PACKAGES=(
+    ["com.meritdata.cloud.${APP_NAME^}Application.java"]="启动类"
+    ["com.meritdata.cloud.common.entity.ProcTrackDTOApproval.java"]="BPM DTO"
+    ["com.meritdata.cloud.$(echo $APP_NAME | tr 'A-Z' 'a-z' | sed 's/-//g')/controller/$(echo $APP_NAME | sed 's/-//g' | awk '{for(i=1;i<=length($0);i++) if(i==1||$0~/[A-Z]/) printf toupper(substr($0,i,1)); else printf substr($0,i,1)}')Controller.java"]="业务 Controller"
+)
+
+for path in "${!REQUIRED_PACKAGES[@]}"; do
+    if [ -f "src/main/java/$(echo $path | tr '.' '/').java" ]; then
+        print_result PASS "$path" "存在"
+    fi
+done
+
+# 平台公共代码统计
+COMMON_COUNT=$(find src/main/java/com/meritdata/cloud/common -name "*.java" 2>/dev/null | wc -l)
+if [ "$COMMON_COUNT" -ge 20 ]; then
+    print_result PASS "common 公共代码" "$COMMON_COUNT 个文件"
+else
+    print_result WARN "common 公共代码" "$COMMON_COUNT 个文件（期望 ≥ 20）"
+fi
+
+echo ""
+echo "=== 4. Maven 编译 ==="
+if mvn -s "$MAVEN_SETTINGS" clean compile -DskipTests -q 2>&1 | tail -5; then
+    if [ -d "target/classes" ]; then
+        CLASS_COUNT=$(find target/classes -name "*.class" 2>/dev/null | wc -l)
+        print_result PASS "mvn compile" "$CLASS_COUNT 个 class"
+    else
+        print_result FAIL "mvn compile" "编译失败"
+    fi
+else
+    print_result FAIL "mvn compile" "执行失败"
+fi
+
+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-conventions.sh

@@ -0,0 +1,188 @@
+#!/bin/bash
+# =============================================================================
+# 检查代码规范：包路径 / 命名 / 审计字段 / 注解
+# 通用化：与具体项目名解耦（无 hardcoded 路径）
+# =============================================================================
+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
+BACKEND_DIR="$PROJECT_ROOT/back-end"
+cd "$BACKEND_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
+}
+
+echo "=== 1. 包路径偏差检查（dev-docs 5 错误修正）==="
+
+# 1.1 ILogPostService 错误路径
+OLD_ILOG="com.meritdata.cloud.log.ILogPostService"
+NEW_ILOG_PATH="com/meritdata/cloud/log/service"
+WRONG=$(grep -rln "$OLD_ILOG" src/main/java/ 2>/dev/null | wc -l)
+if [ "$WRONG" -eq 0 ]; then
+    print_result PASS "ILogPostService 路径" "无错误（$NEW_ILOG_PATH）"
+else
+    print_result FAIL "ILogPostService 路径" "发现 $WRONG 处使用旧路径 $OLD_ILOG"
+    grep -rln "$OLD_ILOG" src/main/java/ 2>/dev/null | head -5
+fi
+
+# 1.2 BpmEngine 错误路径
+OLD_BPM="com.meritdata.cloud.bpm.BpmEngine"
+NEW_BPM_PATH="com/meritdata/cloud/bpm/core"
+WRONG=$(grep -rln "$OLD_BPM" src/main/java/ 2>/dev/null | wc -l)
+if [ "$WRONG" -eq 0 ]; then
+    print_result PASS "BpmEngine 路径" "无错误（$NEW_BPM_PATH）"
+else
+    print_result FAIL "BpmEngine 路径" "发现 $WRONG 处使用旧路径 $OLD_BPM"
+fi
+
+# 1.3 LogDesc 错误路径
+OLD_LOGDESC="com.meritdata.cloud.log.annotation.LogDesc"
+NEW_LOGDESC_PATH="com/meritdata/cloud/base"
+WRONG=$(grep -rln "$OLD_LOGDESC" src/main/java/ 2>/dev/null | wc -l)
+if [ "$WRONG" -eq 0 ]; then
+    print_result PASS "LogDesc 路径" "无错误（$NEW_LOGDESC_PATH）"
+else
+    print_result FAIL "LogDesc 路径" "发现 $WRONG 处使用旧路径 $OLD_LOGDESC"
+fi
+
+# 1.4 EnableDataSecretFilter 错误路径
+OLD_DSF="com.meritdata.cloud.security.EnableDataSecretFilter"
+NEW_DSF_PATH="com/meritdata/cloud/base/tenancy"
+WRONG=$(grep -rln "$OLD_DSF" src/main/java/ 2>/dev/null | wc -l)
+if [ "$WRONG" -eq 0 ]; then
+    print_result PASS "EnableDataSecretFilter 路径" "无错误（$NEW_DSF_PATH）"
+else
+    print_result FAIL "EnableDataSecretFilter 路径" "发现 $WRONG 处使用旧路径 $OLD_DSF"
+fi
+
+echo ""
+echo "=== 2. 命名规范检查 ==="
+
+# Controller 命名
+CONTROLLER_FILES=$(find src/main/java -name "*Controller.java" 2>/dev/null)
+if [ -n "$CONTROLLER_FILES" ]; then
+    for f in $CONTROLLER_FILES; do
+        basename=$(basename "$f" .java)
+        if [[ "$basename" == *Controller ]]; then
+            print_result PASS "命名 $basename" "符合 XxxController 规范"
+        else
+            print_result FAIL "命名 $basename" "不符合 Controller 规范"
+        fi
+    done
+fi
+
+# Service 接口
+SERVICE_INTERFACES=$(find src/main/java -name "I*Service.java" 2>/dev/null)
+if [ -n "$SERVICE_INTERFACES" ]; then
+    for f in $SERVICE_INTERFACES; do
+        basename=$(basename "$f" .java)
+        if [[ "$basename" == I*Service ]]; then
+            print_result PASS "服务接口 $basename" "符合 IxxxService 规范"
+        fi
+    done
+fi
+
+# Service 实现
+SERVICE_IMPLS=$(find src/main/java -name "*ServiceImpl.java" 2>/dev/null)
+if [ -n "$SERVICE_IMPLS" ]; then
+    for f in $SERVICE_IMPLS; do
+        basename=$(basename "$f" .java)
+        if [[ "$basename" == *ServiceImpl ]]; then
+            print_result PASS "服务实现 $basename" "符合 XxxServiceImpl 规范"
+        fi
+    done
+fi
+
+# Repository
+REPOS=$(find src/main/java -name "*Repository.java" 2>/dev/null)
+if [ -n "$REPOS" ]; then
+    for f in $REPOS; do
+        basename=$(basename "$f" .java)
+        if [[ "$basename" == *Repository ]]; then
+            print_result PASS "Repository $basename" "符合 XxxRepository 规范"
+        fi
+    done
+fi
+
+echo ""
+echo "=== 3. Controller 注解检查 ==="
+
+CONTROLLERS=$(find src/main/java -name "*Controller.java" 2>/dev/null)
+for f in $CONTROLLERS; do
+    if grep -q "@RestController" "$f"; then
+        print_result PASS "$(basename $f) @RestController" "存在"
+    else
+        print_result FAIL "$(basename $f) @RestController" "缺失"
+    fi
+
+    if grep -q "@RequestMapping" "$f"; then
+        print_result PASS "$(basename $f) @RequestMapping" "存在"
+    else
+        print_result FAIL "$(basename $f) @RequestMapping" "缺失"
+    fi
+done
+
+# 业务注解使用
+echo ""
+echo "=== 4. 业务注解使用情况 ==="
+
+# @LogDesc / @EnableDataSecretFilter / @Autowired SessionUtils
+LOG_DESC=$(grep -rln "import com.meritdata.cloud.base.LogDesc" src/main/java/ 2>/dev/null | wc -l)
+if [ "$LOG_DESC" -gt 0 ]; then
+    print_result PASS "@LogDesc 使用" "$LOG_DESC 处"
+else
+    print_result WARN "@LogDesc 使用" "0 处（业务开发时会用到）"
+fi
+
+DSF=$(grep -rln "@EnableDataSecretFilter" src/main/java/ 2>/dev/null | wc -l)
+if [ "$DSF" -gt 0 ]; then
+    print_result PASS "@EnableDataSecretFilter 使用" "$DSF 处"
+else
+    print_result WARN "@EnableDataSecretFilter 使用" "0 处（业务开发时会用到）"
+fi
+
+SESSION=$(grep -rln "import com.meritdata.cloud.utils.SessionUtils" src/main/java/ 2>/dev/null | wc -l)
+if [ "$SESSION" -gt 0 ]; then
+    print_result PASS "SessionUtils 引用" "$SESSION 处"
+else
+    print_result WARN "SessionUtils 引用" "0 处（业务开发时会用到）"
+fi
+
+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-database.sh

@@ -0,0 +1,128 @@
+#!/bin/bash
+# =============================================================================
+# 检查数据库：cloud 库表结构 + 业务表
+# 通用化：从环境变量读取所有项目特定配置
+# =============================================================================
+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
+
+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 MYSQL_HOST MYSQL_PORT MYSQL_USER MYSQL_PASSWORD; do
+    if [ -z "${!v}" ]; then
+        print_result FAIL "环境变量 $v" "未设置"
+        exit 1
+    fi
+done
+
+echo "=== 1. cloud 库核心表 ==="
+
+declare -A REQUIRED_TABLES=(
+    ["pf_user_info"]="用户主表"
+    ["pf_org_user"]="组织用户表"
+    ["pf_resource"]="资源表"
+    ["pf_org_role"]="角色表（修复 2026-07-27：原 pf_role 在 6.13.2 实际命名为 pf_org_role，详见 MySQL 验证）"
+    ["act_ru_task"]="BPM 任务"
+    ["act_re_procdef"]="BPM 流程定义"
+    ["pf_job_*"]="定时任务（pf_job_* 系列）"
+)
+
+for table in "${!REQUIRED_TABLES[@]}"; do
+    desc="${REQUIRED_TABLES[$table]}"
+    if [[ "$table" == *"*"* ]]; then
+        prefix="${table%\*}"
+        ACTUAL=$(mysql -h "$MYSQL_HOST" -P "$MYSQL_PORT" -u "$MYSQL_USER" -p"$MYSQL_PASSWORD" -e "SELECT COUNT(*) FROM information_schema.TABLES WHERE TABLE_SCHEMA='cloud' AND TABLE_NAME LIKE '${prefix}%';" -s 2>/dev/null | tail -1)
+        if [ "$ACTUAL" -gt 0 ] 2>/dev/null; then
+            print_result PASS "$table" "存在 $ACTUAL 张表"
+        else
+            print_result FAIL "$table" "不存在"
+        fi
+    else
+        COUNT=$(mysql -h "$MYSQL_HOST" -P "$MYSQL_PORT" -u "$MYSQL_USER" -p"$MYSQL_PASSWORD" -e "SELECT COUNT(*) FROM cloud.${table};" -s 2>/dev/null | tail -1 || echo "0")
+        if [ "$COUNT" -gt 0 ] 2>/dev/null; then
+            print_result PASS "$table" "$desc，$COUNT 行"
+        else
+            EXISTS=$(mysql -h "$MYSQL_HOST" -P "$MYSQL_PORT" -u "$MYSQL_USER" -p"$MYSQL_PASSWORD" -e "SELECT COUNT(*) FROM information_schema.TABLES WHERE TABLE_SCHEMA='cloud' AND TABLE_NAME='$table';" -s 2>/dev/null | tail -1)
+            if [ "$EXISTS" = "1" ]; then
+                print_result WARN "$table" "$desc 存在但无数据"
+            else
+                print_result FAIL "$table" "$desc 不存在"
+            fi
+        fi
+    fi
+done
+
+echo ""
+echo "=== 2. cloud 库表总数 ==="
+
+TOTAL_TABLES=$(mysql -h "$MYSQL_HOST" -P "$MYSQL_PORT" -u "$MYSQL_USER" -p"$MYSQL_PASSWORD" -e "SELECT COUNT(*) FROM information_schema.TABLES WHERE TABLE_SCHEMA='cloud';" -s 2>/dev/null | tail -1)
+if [ "$TOTAL_TABLES" -ge 130 ]; then
+    print_result PASS "cloud 库表总数" "$TOTAL_TABLES"
+else
+    print_result WARN "cloud 库表总数" "$TOTAL_TABLES（期望 ≥ 130）"
+fi
+
+# BPM 表
+ACT_COUNT=$(mysql -h "$MYSQL_HOST" -P "$MYSQL_PORT" -u "$MYSQL_USER" -p"$MYSQL_PASSWORD" -e "SELECT COUNT(*) FROM information_schema.TABLES WHERE TABLE_SCHEMA='cloud' AND TABLE_NAME LIKE 'act_%';" -s 2>/dev/null | tail -1)
+if [ "$ACT_COUNT" -ge 40 ]; then
+    print_result PASS "BPM 表" "$ACT_COUNT 张 act_*"
+else
+    print_result FAIL "BPM 表" "$ACT_COUNT 张（期望 ≥ 40）"
+fi
+
+echo ""
+echo "=== 3. 数据库配置 ==="
+
+# 通过 Nacos 查 ddl-auto
+if [ -n "$NACOS_HOST" ]; then
+    DDL_AUTO=$(curl -sS -u "$NACOS_USER:$NACOS_PASSWORD" "http://$NACOS_HOST:$NACOS_PORT/nacos/v3/console/cs/config?dataId=common-datasource.properties&groupName=DEFAULT_GROUP&namespaceId=public" 2>&1 | grep -oP "spring\.jpa\.hibernate\.ddl-auto\s*=\s*\K[^\r\n,]+" | head -1)
+    if [ "$DDL_AUTO" = "none" ]; then
+        print_result PASS "ddl-auto" "none（需手动建表）"
+    elif [ -n "$DDL_AUTO" ]; then
+        print_result WARN "ddl-auto" "$DDL_AUTO"
+    else
+        print_result WARN "ddl-auto" "未配置或 Nacos 凭据问题"
+    fi
+fi
+
+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