合并账户库为单表

docs/plans/backend/2026-04-14-nas-tongweb-deploy-script-implementation.md

@@ -0,0 +1,62 @@
+# 2026-04-14 NAS TongWeb 部署脚本实施记录
+
+## 1. 目标
+
+- 新增一套独立于 Docker 的 NAS 部署脚本
+- 部署链路固定使用 `ruoyi-admin.war`
+- 远端通过 `TongWeb` 自动部署目录发布应用，并使用 `stopserver.sh` / `startservernohup.sh` 重启服务
+
+## 2. 实施内容
+
+### 2.1 新增 TongWeb NAS 部署入口
+
+涉及文件：
+
+- `deploy/deploy-to-nas-tongweb.sh`
+
+实施内容：
+
+- 提供与现有 NAS 脚本一致的 SSH 连接参数风格
+- 默认执行 `mvn -pl ruoyi-admin -am package -DskipTests`
+- 本地仅校验并上传 `ruoyi-admin/target/ruoyi-admin.war`
+- 支持 `--dry-run` 预览参数
+
+### 2.2 新增 TongWeb 远端执行器
+
+涉及文件：
+
+- `deploy/remote-deploy-tongweb.py`
+
+实施内容：
+
+- 通过 SFTP 将 `war` 上传到 NAS 临时目录 `${remoteRoot}/backend/`
+- 远端复制 `war` 到 `${TONGWEB_HOME}/autodeploy/${appName}.war`
+- 清理 `${TONGWEB_HOME}/autodeploy/${appName}` 旧解压目录
+- 依次执行 `stopserver.sh`、`startservernohup.sh`
+
+### 2.3 新增脚本回归测试
+
+涉及文件：
+
+- `tests/deploy/test_deploy_to_nas_tongweb.py`
+
+实施内容：
+
+- 覆盖默认参数 `dry-run`
+- 覆盖自定义参数 `dry-run`
+- 校验部署入口已调用 `remote-deploy-tongweb.py`
+- 校验远端执行器包含 `autodeploy`、`stopserver.sh`、`startservernohup.sh`
+
+## 3. 验证命令
+
+```bash
+python3 -m pytest tests/deploy/test_deploy_to_nas_tongweb.py -q
+bash -n deploy/deploy-to-nas-tongweb.sh
+bash deploy/deploy-to-nas-tongweb.sh --dry-run
+```
+
+## 4. 说明
+
+- 默认 `TongWebHome` 取 `/opt/TongWeb`，可通过第 6 个位置参数或环境变量 `TONGWEB_HOME` 覆盖
+- 默认应用名为 `ruoyi-admin`，可通过第 7 个位置参数或环境变量 `APP_NAME` 覆盖
+- 本次只新增 `TongWeb` 后端部署链路，不改动现有 Docker NAS 部署脚本