# 东方通替换 Tomcat 后端实施计划

## 目标

- 将后端交付形态从内嵌 Tomcat 的 `jar` 调整为部署到东方通 TongWeb 的 `war`
- 清理当前发布链路中围绕 `java -jar` / `ruoyi-admin.jar` 的脚本约定
- 保持现有前端发布方式和 Nginx 入口不变，后端仍沿用 `63310` 作为反向代理目标端口

## 改动范围

- Maven 构建
  - 调整 `ruoyi-admin` 打包类型为 `war`
  - 去除模块链路中的嵌入式 Tomcat 打包依赖
  - 明确 Servlet API 由外部容器提供
- 部署脚本
  - 将生产部署脚本中的后端产物从 `ruoyi-admin.jar` 切换为 `ruoyi-admin.war`
  - 将生产重启脚本从 Java 进程启停改为 TongWeb 容器启停与 `war` 发布
  - 调整本地后端重启脚本，使其面向 TongWeb 进行构建和部署
- 运行文档
  - 更新本地安装手册中的后端环境说明，改为 TongWeb
  - 新增本次改动实施记录

## 实施步骤

1. 先修改现有脚本测试，明确新的 `war + TongWeb` 约束
2. 调整 Maven 配置，产出 `ruoyi-admin.war`
3. 修改生产部署脚本和本地重启脚本
4. 更新运行文档与实施记录
5. 执行脚本测试、语法校验和 Maven 打包验证

## 验证要求

- `mvn -pl ruoyi-admin -am clean package -DskipTests` 成功，且产物为 `ruoyi-admin.war`
- `sh bin/prod/restart_java_test.sh` 成功
- `sh bin/prod/deploy_from_package_test.sh` 成功
- `sh bin/restart_java_backend_test.sh` 成功
- `sh -n bin/prod/restart_java.sh`
- `sh -n bin/prod/deploy_from_package.sh`
- `sh -n bin/restart_java_backend.sh`