test(fe): 阶段0止血——pre-commit守卫+postSafe+jest.config+CI脚本+otcformat精度修复

2026-07-29 22:33:45 +08:00
parent daaf993126
commit 6b32f254b1
8 changed files with 514 additions and 1 deletions
@@ -0,0 +1,89 @@
+#!/usr/bin/env bash
+# =============================================================================
+# pre-commit — 提交前自动守卫
+# =============================================================================
+# 做两件事（任一失败即阻断提交）：
+#   1. guard_arch.js   — 扫描新增/修改行，禁止在 Vue 组件里内联金额计算
+#   2. jest             — 跑前端单测，确保不引入回归
+#
+# 安装方式（开发者只需执行一次）：
+#   cd <repo-root>
+#   cp YLErpWeb/fe-tests/hooks/pre-commit .git/hooks/pre-commit
+#   chmod +x .git/hooks/pre-commit
+#
+# 跳过方式（紧急情况，不推荐）：
+#   git commit --no-verify
+#
+# CI 也应调用本脚本（或等价的 npm test + node guard_arch.js）。
+# =============================================================================
+set -euo pipefail
+
+# 定位仓库根目录
+REPO_ROOT=$(git rev-parse --show-toplevel)
+FE_TESTS_DIR="$REPO_ROOT/YLErpWeb/fe-tests"
+
+# 自动加载 nvm（非交互 shell 中 nvm 不会自动加载）
+export NVM_DIR="${NVM_DIR:-$HOME/.nvm}"
+if [ -s "$NVM_DIR/nvm.sh" ] && ! command -v node &>/dev/null; then
+    source "$NVM_DIR/nvm.sh" 2>/dev/null || true
+    # 如果有 .nvmrc 就用它，否则用默认版本
+    if [ -f "$REPO_ROOT/.nvmrc" ]; then
+        nvm use --silent 2>/dev/null || true
+    else
+        # 尝试用已安装的最新版本
+        nvm use --silent --lts 2>/dev/null || nvm use --silent node 2>/dev/null || true
+    fi
+fi
+
+# 颜色输出
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+echo -e "${YELLOW}[pre-commit] 开始提交前守卫检查...${NC}"
+
+# -----------------------------------------------------------------------------
+# 1. guard_arch.js — 架构闸门（零依赖，纯 Node）
+# -----------------------------------------------------------------------------
+# 只在存在 node 时运行
+if command -v node &>/dev/null; then
+    echo -e "${YELLOW}[pre-commit] ① 架构闸门 (guard_arch.js)...${NC}"
+    if node "$FE_TESTS_DIR/guard_arch.js"; then
+        echo -e "${GREEN}[pre-commit] ✅ 架构闸门通过${NC}"
+    else
+        echo -e "${RED}[pre-commit] ❌ 架构闸门未通过，提交被阻断${NC}"
+        echo -e "${YELLOW}  请把金额/精度计算抽到 *Calc 模块（参考 swapCalc.js）${NC}"
+        exit 1
+    fi
+else
+    echo -e "${YELLOW}[pre-commit] ⚠️  未找到 node，跳过架构闸门（建议安装 nvm + node 20）${NC}"
+fi
+
+# -----------------------------------------------------------------------------
+# 2. jest — 前端单测（需要先 npm install）
+# -----------------------------------------------------------------------------
+if [ -f "$FE_TESTS_DIR/node_modules/.bin/jest" ]; then
+    echo -e "${YELLOW}[pre-commit] ② 前端单测 (jest)...${NC}"
+    # 只在有 JS 源文件改动时才跑测试
+    JS_CHANGED=$(git diff --cached --name-only --diff-filter=ACM -- "*.js" | grep "wwwroot/Scripts/" || true)
+    if [ -z "$JS_CHANGED" ]; then
+        echo -e "${GREEN}[pre-commit] ⏭️  无前端源文件改动，跳过单测${NC}"
+    else
+        echo -e "${YELLOW}  改动的前端文件：${NC}"
+        echo "$JS_CHANGED" | sed 's/^/    /'
+        if (cd "$FE_TESTS_DIR" && npx jest --no-coverage --silent 2>&1); then
+            echo -e "${GREEN}[pre-commit] ✅ 前端单测通过${NC}"
+        else
+            echo -e "${RED}[pre-commit] ❌ 前端单测未通过，提交被阻断${NC}"
+            echo -e "${YELLOW}  修复测试后重新提交，或用 git commit --no-verify 跳过（不推荐）${NC}"
+            exit 1
+        fi
+    fi
+else
+    echo -e "${YELLOW}[pre-commit] ⚠️  未安装 jest（node_modules 缺失），跳过单测${NC}"
+    echo -e "${YELLOW}  建议：cd YLErpWeb/fe-tests && npm install${NC}"
+fi
+
+echo -e "${GREEN}[pre-commit] ✅ 所有守卫检查通过，继续提交${NC}"
+exit 0