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

package/skills/meritdata-platform-2nd-dev-check/references/fix-guide.md

@@ -0,0 +1,433 @@
+# 修复指南（Fix Guide）
+
+> **通用性说明**：本指南基于美林微服务应用开发平台 6.13.2 总结。修复代码片段与具体项目名解耦，适用于所有基于该平台的二开项目。
+
+---
+
+## 1. 5 个包路径偏差（高频错误）
+
+### 1.1 `ILogPostService` 路径偏差
+
+**dev-docs 写**：`com.meritdata.cloud.log.service.ILogPostService`
+**实际 6.13.2 路径**：`com.meritdata.cloud.log.service.ILogPostService`
+
+**修复**：
+```java
+// ❌ 错
+import com.meritdata.cloud.log.service.ILogPostService;
+
+// ✅ 对
+import com.meritdata.cloud.log.service.ILogPostService;
+```
+
+---
+
+### 1.2 `BpmEngine` 路径偏差
+
+**dev-docs 写**：`com.meritdata.cloud.bpm.core.BpmEngine`
+**实际 6.13.2 路径**：`com.meritdata.cloud.bpm.core.BpmEngine`
+
+**修复**：
+```java
+// ❌ 错
+import com.meritdata.cloud.bpm.core.BpmEngine;
+
+// ✅ 对
+import com.meritdata.cloud.bpm.core.BpmEngine;
+```
+
+**13 个核心方法**：startProcess / ruleEngineInit / ruleEngineRun / complete / processRetfirnode / processRetprenode / deleteProcInsts / queryMainForms / getPage / getGraphTrack / getOpinions / addOrUpdate / getUndoPage
+
+---
+
+### 1.3 `LogDesc` / `AddDesc` / `DelDesc` 路径偏差
+
+**dev-docs 写**：`com.meritdata.cloud.log.annotation.*`
+**实际 6.13.2 路径**：`com.meritdata.cloud.base.*`
+
+**修复**：
+```java
+// ❌ 错
+import com.meritdata.cloud.base.LogDesc;
+import com.meritdata.cloud.base.AddDesc;
+import com.meritdata.cloud.base.DelDesc;
+
+// ✅ 对
+import com.meritdata.cloud.base.LogDesc;
+import com.meritdata.cloud.base.AddDesc;
+import com.meritdata.cloud.base.DelDesc;
+```
+
+---
+
+### 1.4 `EnableDataSecretFilter` 路径偏差
+
+**dev-docs 写**：`com.meritdata.cloud.base.tenancy.EnableDataSecretFilter`
+**实际 6.13.2 路径**：`com.meritdata.cloud.base.tenancy.EnableDataSecretFilter`
+
+**修复**：
+```java
+// ❌ 错
+import com.meritdata.cloud.base.tenancy.EnableDataSecretFilter;
+
+// ✅ 对
+import com.meritdata.cloud.base.tenancy.EnableDataSecretFilter;
+```
+
+---
+
+### 1.5 `SessionUtils` 路径（正确但调用方式错）
+
+**dev-docs 路径**：`com.meritdata.cloud.utils.SessionUtils`（**正确**）
+
+**调用方式错误**：
+```java
+// ❌ 错（dev-docs 暗示静态调用）
+String userId = SessionUtils.getUserId();
+
+// ✅ 对（6.13.2 实际是实例方法）
+@Autowired
+private SessionUtils sessionUtils;
+
+public void someMethod() {
+    String userId = sessionUtils.getUserId();
+    String userName = sessionUtils.getUserName();
+}
+```
+
+---
+
+## 2. 6 个方法名修正
+
+### 2.1 NacosUtils 5 个方法名偏差
+
+| dev-docs 写法 | 实际写法 | 用途 |
+|--------------|---------|------|
+| `NacosUtils.getConfig(...)` | `NacosUtils.getConfigFile(...)` | 获取配置 |
+| `NacosUtils.getAllConfig(...)` | `NacosUtils.getAllConfigFile()` | 获取所有配置 |
+| `NacosUtils.updateFile(...)` | `NacosUtils.updateConfigFile(...)` | 更新配置文件 |
+| `NacosUtils.resetFile(...)` | `NacosUtils.reSetConfigFile(...)` | 重置配置 |
+| `NacosUtils.clearFile(...)` | `NacosUtils.clearConfigFile(...)` | 清除配置 |
+
+---
+
+### 2.2 Sm2Utils.getKey() 偏差
+
+**dev-docs 写**：`Sm2Utils.getKey()`
+**实际**：`Sm2Utils.createSM2Key()`
+
+**修复**：
+```java
+// ❌ 错
+MutablePair<String, String> key = Sm2Utils.getKey();
+
+// ✅ 对
+MutablePair<String, String> key = Sm2Utils.createSM2Key();
+// 返回 (公钥, 私钥)
+```
+
+---
+
+## 3. 3 个调用方式修正
+
+### 3.1 实例方法类（必须 `@Autowired`）
+
+- `com.meritdata.cloud.utils.NacosUtils`（10 方法）
+- `com.meritdata.cloud.utils.SessionUtils`（21 方法）
+- `com.meritdata.cloud.utils.SM3Encoder.encode()` / `matches()`
+
+### 静态方法类（可直接类名调用）
+
+- `com.meritdata.tempo.syscache.service.SysCacheServiceFacade`（23 方法）
+- `com.meritdata.tempo.syscache.service.StringCacheFacade`
+- `com.meritdata.cloud.utils.Sm2Utils` / `Sm4Utils`
+- `com.meritdata.cloud.utils.LogPattenUtils`
+- `com.meritdata.cloud.log.compare.CompareUtils`
+- `com.meritdata.cloud.utils.SM3Encoder.encryptWithHMacMD5()`（静态部分）
+
+**正确用法**：
+```java
+@Service
+public class <Xxx>ServiceImpl implements <IXxxService> {
+
+    @Autowired
+    private SessionUtils sessionUtils;  // 实例
+
+    @Autowired
+    private NacosUtils nacosUtils;  // 实例
+
+    @Override
+    public PageInfo<Xxx> list(XxxParam param) {
+        // 静态调用
+        SysCacheServiceFacade.put("xxx:list:" + param.getPage(), result);
+
+        // 实例调用
+        String userId = sessionUtils.getUserId();
+        String tenantId = sessionUtils.getTenantId();
+
+        return repository.findAll(...);
+    }
+}
+```
+
+---
+
+## 4. 5 个 jar 中确实不存在的组件（需要替代方案）
+
+> ⚠️ **2026-09-10 修正**：本节之前列了 7 个组件，其中 2 个（`IJobApi` 和 `CloudFeignMessageClient`）**实测存在**，已从本节移除。修正后仅 **5 个组件**：
+> 1. `Page` / `PageQuery`（不存在，用 `Pageable` 或 `GridView`）
+> 2. `Undo`（不存在，用 `UndoDTO`）
+> 3. `IBpmUndoServiceClient`（不存在，用 `BpmEngine.getUndoPage`）
+> 4. `IUserTaskListener`（不存在，自实现 `TaskListener`）
+> 5. `IBpmFormService`（不存在，用 `BpmEngine.queryMainForms`）
+>
+> **本节原"4.1 `IJobApi`"和"4.2 `CloudFeignMessageClient`"两小节已删除**——以下为更新后的 5 个替代方案。
+
+### 4.1 `Page` / `PageQuery`（不存在）
+
+**替代方案**：用 `Pageable`（Spring Data）或 `GridView`（平台）替代。
+
+### 4.2 `Undo`（不存在）
+
+**替代方案**：用 `BpmEngine.getUndoPage` 返回的 `UndoDTO` 类型。
+
+### 4.3 `IBpmUndoServiceClient`（不存在）
+
+**替代方案**：用 `BpmEngine.getUndoPage`（已在 `meritdata-platform-bpm` skill 中）。
+
+### 4.4 `IUserTaskListener`（不存在）
+
+**替代方案**：自实现 Camunda 原生 `TaskListener` 接口。
+
+### 4.5 `IBpmFormService`（不存在）
+
+**替代方案**：用 `BpmEngine.queryMainForms` / `BpmEngine.queryMainFormsByBusinessId`（已在 `meritdata-platform-bpm` skill 中）。
+
+---
+
+> 📌 **历史修正记录（2026-09-10）**：
+> - 原 4.1 `IJobApi`（已删除）→ 实测：`com.meritdata.cloud.job.api.IJobApi` 存在，可 `@Autowired` 注入。详见 15.7 节
+> - 原 4.2 `CloudFeignMessageClient`（已删除）→ 实测：可通过 `FeignMessageSenderService` 接口调用，但**默认不提供**——需通过 `meritdata-platform-messaging` skill 的 `CloudFeignMessageClient` 注入。详见 15.8 节
+    @PostMapping("/api/message/send-role")
+    R sendRoleMessage(MessageDTO msg);
+    // ... 5 个方法
+}
+```
+
+---
+
+## 5. HTTP 方法修正
+
+dev-docs 5.1 章节默认写出 `GET` 方法，但实际 4 个匿名接口**都是 POST**：
+
+```bash
+# ❌ 错
+curl -X GET "http://localhost:8080/certificate/get-secret-info"
+
+# ✅ 对
+curl -X POST "http://localhost:8080/certificate/get-secret-info"
+```
+
+**4 个匿名接口都是 POST**：
+- `/certificate/get-secret-info`
+- `/api/ou/user/allow-items-custom-menus`
+- `/api/basic/home-frame-config/find`
+- `/certificate/update-platform-info`
+
+---
+
+## 6. 实际端口修正
+
+| 服务 | dev-docs 假设 | 实际 |
+|------|--------------|------|
+| cloud-system-bpm-engine | 8087 | **8089** |
+| cloud-system-job | 8088 | **8086** |
+| cloud-system-gateway | 8081 | 8081 |
+| cloud-system-manage | 8085 | 8085 |
+
+> **实际端口以你本机 Nacos 注册为准**。用以下命令查实际端口：
+> ```bash
+> curl -u $NACOS_USER:$NACOS_PASSWORD \
+>   "http://$NACOS_HOST:$NACOS_PORT/nacos/v1/ns/instance/list?serviceName=cloud-system-bpm-engine"
+> ```
+
+---
+
+## 7. CLOUD_HOME 路径
+
+**关键**：必须指向真实平台证书目录（含 `key.tmp` / `public.pem` / `skey.dat`）
+
+**bootstrap.properties**：
+```properties
+# 用环境变量 ${MERIT_HOME} 替换（由脚本注入）
+CLOUD_HOME=${MERIT_HOME}
+meritdata.cloud.authentication-server-url=${CLOUD_HOME}/key
+```
+
+**验证 3 个证书文件**：
+```bash
+ls ${MERIT_HOME}/key/
+# 期望输出：key.tmp / public.pem / skey.dat
+```
+
+---
+
+## 8. NPM 仓库地址
+
+**默认公开镜像**（推荐，可装包）：
+```
+registry=https://registry.npmmirror.com
+```
+
+**如公司有私有 npm 仓库**（nexus.hub.com 等）：
+```
+registry=http://your-company-nexus:8082/repository/npm-group/
+```
+
+**重要**：**191.168.7.39:8088/nexus 是 Maven 仓库，不是 npm 仓库**（常见误解）。
+
+---
+
+## 9. Node 18+ OpenSSL 兼容问题
+
+**错误**：`error:0308010C:digital envelope routines::unsupported`
+
+**原因**：Node 17+ OpenSSL 3 + 老 `compression-webpack-plugin 5.0.1` 不兼容
+
+**修复**：package.json scripts 加 `cross-env`：
+```json
+{
+  "scripts": {
+    "serve": "cross-env NODE_OPTIONS=--openssl-legacy-provider vue-cli-service serve",
+    "build": "cross-env NODE_OPTIONS=--openssl-legacy-provider vue-cli-service build"
+  }
+}
+```
+
+---
+
+## 10. ID 生成策略
+
+**推荐 UUID**（微服务架构友好）：
+
+```java
+@Id
+@GeneratedValue(generator = "uuid")
+@GenericGenerator(name = "uuid", strategy = "uuid")
+@Column(name = "ID", length = 32)
+private String id;
+```
+
+---
+
+## 11. 加密 / 编码字段
+
+```java
+@Column(name = "SECRET_LEVEL", length = 16)
+private String secretLevel;  // secret10/secret20/secret30/secret40
+
+// 启用数据密级过滤
+@EnableDataSecretFilter
+@Service
+public class <Xxx>ServiceImpl { ... }
+```
+
+**注意**：`@EnableDataSecretFilter` 在 `com.meritdata.cloud.base.tenancy` 包，不是 `.security` 包。
+
+---
+
+## 12. 业务开发模板（Controller）
+
+```java
+package com.meritdata.cloud.<业务模块>.controller;
+
+import com.meritdata.cloud.utils.SessionUtils;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.web.bind.annotation.*;
+
+@RestController
+@RequestMapping("/api/<业务模块>")
+public class <Xxx>Controller {
+
+    @Autowired
+    private I<Xxx>Service service;
+
+    @Autowired
+    private SessionUtils sessionUtils;
+
+    @PostMapping("/list")
+    public Map<String, Object> list(@RequestBody XxxParam param) {
+        return service.pageList(param);
+    }
+
+    @PostMapping("/detail")
+    public Map<String, Object> detail(@RequestParam String id) {
+        return service.getById(id);
+    }
+
+    @PostMapping("/save")
+    public Map<String, Object> save(@RequestBody XxxEntity entity) {
+        entity.setCreateBy(sessionUtils.getUserId());
+        entity.setCreateTime(new Date());
+        entity.setVersion(0);
+        entity.setIsDeleted("0");
+        return service.save(entity);
+    }
+
+    @PostMapping("/update")
+    public Map<String, Object> update(@RequestBody XxxEntity entity) {
+        entity.setUpdateBy(sessionUtils.getUserId());
+        entity.setUpdateTime(new Date());
+        return service.update(entity);
+    }
+
+    @PostMapping("/delete")
+    public Map<String, Object> delete(@RequestParam String id) {
+        return service.logicDelete(id);
+    }
+}
+```
+
+---
+
+## 13. 常见启动错误速查
+
+| 错误 | 原因 | 修复 |
+|------|------|------|
+| `CloudApplicationRunListener: 请提供正确格式的序列号!` | `${MERIT_HOME}` 路径错或证书缺失 | 设置 `MERIT_HOME` 指向真实证书目录 |
+| `Could not find artifact cloud-module-bpm:jar:6.13.2` | 6.13.2 没有 `cloud-module-bpm` 这个 artifactId | 改用 `cloud-system-bpm-module-core:6.13.2` |
+| `NacosException: failed to req API` | Nacos 地址错或不可达 | 检查 `nacos-addr` |
+| `Cannot resolve cloud-module-base` | npm 私有 registry 错 | 改用 `https://registry.npmmirror.com` |
+| `error:0308010C:digital envelope routines::unsupported` | Node 17+ OpenSSL 3 兼容 | 加 `cross-env NODE_OPTIONS=--openssl-legacy-provider` |
+| `port 8080 was already in use` | 平台服务占用 | 改用其他端口 |
+| `Field sessionUtils required a bean` | `SessionUtils` 未注入 | 在 Controller 加 `@Autowired` |
+| `Cannot find method getConfig in NacosUtils` | 方法名错 | 改为 `getConfigFile` |
+| `login-success=false` | 凭证无效 | 联系平台 admin 重置密码 |
+| `环境变量 APP_NAME 未设置` | skill 未加载 .env | 设置后 `source .env` |
+
+---
+
+## 14. 性能优化清单
+
+| 项 | 默认 | 优化方向 |
+|------|------|----------|
+| Redis 缓存 | 14 个 key | 业务表加 `@Cacheable` |
+| 数据库连接池 | max=20 | 视并发调整 |
+| Tomcat 线程 | 默认 200 | Undertow 可替换 |
+| JVM 堆 | 1GB | -Xmx4g -Xms4g |
+| 日志 | 文本 | 转 JSON 格式便于 ELK |
+
+---
+
+## 15. 已知遗留问题
+
+| # | 问题 | 等级 | 备注 |
+|---|------|------|------|
+| 1 | 平台默认凭证无效 | 🔴 P0 | 联系平台 admin 重置 |
+| 2 | 3 个 Controller 全部 TODO | 🔴 P0 | 业务开发时填充 |
+| 3 | 业务主表未建 | 🔴 P0 | 业务开发时建表 |
+| 4 | 业务 BPMN 流程未建 | 🔴 P0 | BPM 设计器创建 |
+| 5 | 菜单权限未录入 | 🟡 P1 | cloud-system-manage 录入 |
+| 6 | 真实 Nacos 上 platform-version 与本地不一致 | 🟡 P1 | 远程 Nacos 同步 |
+| 7 | `IJobApi` 实测可用（`com.meritdata.cloud.job.api.IJobApi`）| ✅ 已验证 | `@Autowired` 注入即可 |
+| 8 | `CloudFeignMessageClient` 实测可用（`com.meritdata.cloud.feignclient.CloudFeignMessageClient`）| ✅ 已验证 | `@Autowired` 注入即可 |

package/skills/meritdata-platform-2nd-dev-check/scripts/apply-to-files.sh

@@ -0,0 +1,238 @@
+#!/bin/bash
+# =============================================================================
+# apply-to-files.sh：把 Step 4 收集的 10 个 env vars 应用到项目文件
+# （2026-08-12 新增，配合 meritdata-platform-2nd-dev-check skill Step 6 使用）
+#
+# 行为：
+#   1. 从 stdin 读 JSON（与 write-env.sh 一致）
+#   2. 备份原文件到 .claude/skills/meritdata-platform-2nd-dev-check/backups/<时间戳>/
+#   3. 修改以下文件（如果值与样例不同）：
+#      - 后端项目根目录/pom.xml（artifactId）
+#      - <项目根>/后端/src/main/java/.../Application.java（重命名 + 类名）
+#      - <项目根>/前端/package.json（name）
+#      - <项目根>/后端/src/main/resources/bootstrap.properties（port/CLOUD_HOME/server-addr）
+#      - <项目根>/前端/vue.config.js（pages key）
+#   4. 跑 mvn compile 验证
+#
+# 用法：
+#   echo '{...JSON...}' | bash apply-to-files.sh [project_root]
+# =============================================================================
+
+set -e
+
+PROJECT_ROOT="${1:-$PWD}"
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+SKILL_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+BACKUP_ROOT="$SKILL_DIR/backups"
+TIMESTAMP=$(date '+%Y-%m-%d_%H%M%S')
+BACKUP_DIR="$BACKUP_ROOT/$TIMESTAMP"
+
+# 从 stdin 读 JSON
+JSON_INPUT=$(cat)
+
+# 解析 JSON
+if command -v jq >/dev/null 2>&1; then
+    parse_kv() { echo "$JSON_INPUT" | jq -r ".$1 // empty" 2>/dev/null; }
+else
+    parse_kv() { python3 -c "
+import sys, json
+data = json.loads(sys.argv[1])
+print(data.get('$1', ''))
+" "$JSON_INPUT" 2>/dev/null; }
+fi
+
+# 读 10 个变量
+APP_NAME=$(parse_kv APP_NAME)
+APP_PORT=$(parse_kv APP_PORT)
+MAVEN_SETTINGS=$(parse_kv MAVEN_SETTINGS)
+MERIT_HOME=$(parse_kv MERIT_HOME)
+PLATFORM_VERSION=$(parse_kv PLATFORM_VERSION)
+FRONTEND_PAGES=$(parse_kv FRONTEND_PAGES)
+DATABASE_TYPE=$(parse_kv DATABASE_TYPE)
+MYSQL_HOST=$(parse_kv MYSQL_HOST)
+MYSQL_PORT=$(parse_kv MYSQL_PORT)
+NACOS_HOST=$(parse_kv NACOS_HOST)
+NACOS_PORT=$(parse_kv NACOS_PORT)
+
+# 关键变量校验
+[ -z "$APP_NAME" ] && { echo "❌ APP_NAME 不能为空"; exit 1; }
+[ -z "$MAVEN_SETTINGS" ] && { echo "❌ MAVEN_SETTINGS 不能为空"; exit 1; }
+[ -z "$MERIT_HOME" ] && { echo "❌ MERIT_HOME 不能为空"; exit 1; }
+[ -z "$FRONTEND_PAGES" ] && { echo "❌ FRONTEND_PAGES 不能为空"; exit 1; }
+[ -z "$APP_PORT" ] && APP_PORT=18080
+
+# 路径
+POM="$PROJECT_ROOT/后端/pom.xml"
+APP_JAVA="$PROJECT_ROOT/后端/src/main/java/com/meritdata/cloud/PlatformDemoApplication.java"
+PACKAGE_JSON="$PROJECT_ROOT/前端/package.json"
+BOOTSTRAP="$PROJECT_ROOT/后端/src/main/resources/bootstrap.properties"
+VUE_CONFIG="$PROJECT_ROOT/前端/vue.config.js"
+
+# 检查文件存在
+for f in "$POM" "$APP_JAVA" "$PACKAGE_JSON" "$BOOTSTRAP"; do
+    [ -f "$f" ] || { echo "❌ 缺失: $f"; exit 1; }
+done
+
+# 边界判断：是否需要修改
+NEED_CHANGE=0
+[ "$APP_NAME" != "platform-demo" ] && NEED_CHANGE=1
+[ "$APP_PORT" != "18080" ] && NEED_CHANGE=1
+[ "$FRONTEND_PAGES" != "platform-demo" ] && NEED_CHANGE=1
+[ "$MERIT_HOME" != "D:/A_meritdata/Env_windows_V6.13.2" ] && NEED_CHANGE=1
+[ "$NACOS_HOST:$NACOS_PORT" != "127.0.0.1:8850" ] && [ -n "$NACOS_HOST" ] && NEED_CHANGE=1
+
+if [ $NEED_CHANGE -eq 0 ]; then
+    echo ""
+    echo "✅ APP_NAME/APP_PORT/FRONTEND_PAGES 都保持样例值，跳过文件修改"
+    echo "   用户直接用样例配置，无需 rename"
+    exit 0
+fi
+
+# 备份
+echo "=== 备份原文件 ==="
+mkdir -p "$BACKUP_DIR/后端/src/main/java/com/meritdata/cloud"
+mkdir -p "$BACKUP_DIR/后端/src/main/resources"
+mkdir -p "$BACKUP_DIR/front-end"
+cp "$POM" "$BACKUP_DIR/后端/pom.xml"
+cp "$APP_JAVA" "$BACKUP_DIR/后端/src/main/java/com/meritdata/cloud/PlatformDemoApplication.java"
+cp "$PACKAGE_JSON" "$BACKUP_DIR/前端/package.json"
+cp "$BOOTSTRAP" "$BACKUP_DIR/后端/src/main/resources/bootstrap.properties"
+[ -f "$VUE_CONFIG" ] && cp "$VUE_CONFIG" "$BACKUP_DIR/前端/vue.config.js"
+echo "  ✅ 备份到: $BACKUP_DIR"
+
+# 转换命名
+# kebab-case → PascalCase: my-business-system → MyBusinessSystem
+kebab_to_pascal() {
+    echo "$1" | awk -F'-' '{
+        r=""
+        for(i=1;i<=NF;i++) r=r toupper(substr($i,1,1)) substr($i,2)
+        print r
+    }'
+}
+
+NEW_CLASS=$(kebab_to_pascal "$APP_NAME")Application
+NEW_FILE="${NEW_CLASS}.java"
+NEW_PATH="$PROJECT_ROOT/后端/src/main/java/com/meritdata/cloud/$NEW_FILE"
+
+echo ""
+echo "=== 命名转换 ==="
+echo "  APP_NAME:          $APP_NAME"
+echo "  Java class:        PlatformDemoApplication → $NEW_CLASS"
+echo "  Java file:         PlatformDemoApplication.java → $NEW_FILE"
+
+# === 1. pom.xml ===
+echo ""
+echo "=== 1. 修改 <项目根>/后端/pom.xml ==="
+sed -i "s|<artifactId>platform-demo</artifactId>|<artifactId>$APP_NAME</artifactId>|g" "$POM"
+if grep -q "<artifactId>$APP_NAME</artifactId>" "$POM"; then
+    echo "  ✅ artifactId → $APP_NAME"
+else
+    echo "  ❌ pom.xml 修改失败"
+    exit 1
+fi
+
+# === 2. Application 重命名 ===
+echo ""
+echo "=== 2. 重命名 PlatformDemoApplication → $NEW_CLASS ==="
+# 替换类名（3 处：class 声明 + 2 个 self-reference）
+sed -i "s|PlatformDemoApplication|$NEW_CLASS|g" "$APP_JAVA"
+# 重命名文件
+if [ "$APP_JAVA" != "$NEW_PATH" ]; then
+    mv "$APP_JAVA" "$NEW_PATH"
+    APP_JAVA="$NEW_PATH"
+fi
+if grep -q "class $NEW_CLASS" "$APP_JAVA"; then
+    echo "  ✅ $NEW_FILE 类名替换完成"
+else
+    echo "  ❌ 类名替换失败"
+    exit 1
+fi
+
+# === 3. package.json ===
+echo ""
+echo "=== 3. 修改 <项目根>/前端/package.json ==="
+sed -i "s|\"name\": \"platform-demo\"|\"name\": \"$APP_NAME\"|g" "$PACKAGE_JSON"
+if grep -q "\"name\": \"$APP_NAME\"" "$PACKAGE_JSON"; then
+    echo "  ✅ name → $APP_NAME"
+else
+    echo "  ❌ package.json 修改失败"
+    exit 1
+fi
+
+# === 4. bootstrap.properties ===
+echo ""
+echo "=== 4. 修改 <项目根>/后端/src/main/resources/bootstrap.properties ==="
+# server.port
+if [ "$APP_PORT" != "18080" ]; then
+    sed -i "s|^server.port=.*|server.port=$APP_PORT|" "$BOOTSTRAP"
+    echo "  ✅ server.port → $APP_PORT"
+fi
+# CLOUD_HOME（只改不等于样例值的）
+if [ -n "$MERIT_HOME" ] && [ "$MERIT_HOME" != "D:/A_meritdata/Env_windows_V6.13.2" ]; then
+    # Windows 路径转 properties 格式（可选转 \ 或保持 /）
+    CLOUD_VALUE=$(echo "$MERIT_HOME" | sed 's|\\|/|g')
+    sed -i "s|^CLOUD_HOME=.*|CLOUD_HOME=$CLOUD_VALUE|" "$BOOTSTRAP"
+    echo "  ✅ CLOUD_HOME → $CLOUD_VALUE"
+fi
+# nacos server-addr
+if [ -n "$NACOS_HOST" ] && [ -n "$NACOS_PORT" ]; then
+    NEW_ADDR="$NACOS_HOST:$NACOS_PORT"
+    sed -i "s|^spring.cloud.nacos.config.server-addr=.*|spring.cloud.nacos.config.server-addr=$NEW_ADDR|" "$BOOTSTRAP"
+    sed -i "s|^spring.cloud.nacos.discovery.server-addr=.*|spring.cloud.nacos.discovery.server-addr=$NEW_ADDR|" "$BOOTSTRAP"
+    echo "  ✅ nacos server-addr → $NEW_ADDR"
+fi
+
+# === 5. vue.config.js（如果需要） ===
+if [ -f "$VUE_CONFIG" ] && [ "$FRONTEND_PAGES" != "platform-demo" ]; then
+    echo ""
+    echo "=== 5. 修改 <项目根>/前端/vue.config.js ==="
+    # 仅在用户已有 pages 块时改；否则跳过（让用户手动添加）
+    if grep -q "^    pages:" "$VUE_CONFIG" 2>/dev/null; then
+        # 复杂逻辑：vue.config.js 的 pages 是对象字面量
+        # 此处保守处理：只展示给用户
+        echo "  ⚠️  vue.config.js 的 pages 块需用户手动配置"
+        echo "     当前 pages: { platform-demo: { entry: '...' } }"
+        echo "     建议改为:    pages: { $FRONTEND_PAGES: { entry: 'src/pages/$FRONTEND_PAGES/main.js' } }"
+    else
+        echo "  ℹ️  vue.config.js 无 pages 块，跳过（用户需手动添加）"
+    fi
+fi
+
+# === 6. 验证：mvn compile ===
+echo ""
+echo "=== 6. 验证：mvn compile ==="
+cd "$PROJECT_ROOT/back-end"
+if [ -f "$MAVEN_SETTINGS" ]; then
+    if mvn -s "$MAVEN_SETTINGS" compile -q 2>&1 | tail -20; then
+        echo "  ✅ 后端编译通过"
+    else
+        echo "  ❌ 后端编译失败，请检查"
+        echo "  💡 回退命令: cp -r $BACKUP_DIR/* $PROJECT_ROOT/"
+        exit 1
+    fi
+else
+    echo "  ⚠️  MAVEN_SETTINGS 不存在: $MAVEN_SETTINGS"
+    echo "     跳过编译验证，请用户手动跑: mvn -s $MAVEN_SETTINGS compile"
+fi
+
+echo ""
+echo "=== ✅ 所有修改完成 ==="
+echo ""
+echo "📋 修改摘要："
+echo "  - pom.xml:           artifactId → $APP_NAME"
+echo "  - Java class:        $NEW_CLASS"
+echo "  - Java file:         PlatformDemoApplication.java → $NEW_FILE"
+echo "  - package.json:      name → $APP_NAME"
+[ "$APP_PORT" != "18080" ] && echo "  - bootstrap:         server.port → $APP_PORT"
+[ "$MERIT_HOME" != "D:/A_meritdata/Env_windows_V6.13.2" ] && echo "  - bootstrap:         CLOUD_HOME → $MERIT_HOME"
+[ -n "$NACOS_HOST" ] && [ -n "$NACOS_PORT" ] && [ "$NACOS_HOST:$NACOS_PORT" != "127.0.0.1:8850" ] && echo "  - bootstrap:         nacos → $NACOS_HOST:$NACOS_PORT"
+echo ""
+echo "💾 备份位置: $BACKUP_DIR"
+echo ""
+echo "↩️  完整回退（含删除新生成的文件）："
+echo "   # 1. 删除新生成的 Java 文件（如果存在）"
+echo "   rm -f \"$PROJECT_ROOT/back-end/src/main/java/com/meritdata/cloud/$NEW_FILE\""
+echo "   # 2. 还原所有原文件"
+echo "   cp -r $BACKUP_DIR/* $PROJECT_ROOT/"
+echo ""
+echo "🚀 下一步：mvn spring-boot:run 或 npm run serve 启动开发"