# 本地 Tomcat 与 TongWeb 双产物实施记录

## 本次改动

- 将 `ruoyi-admin` 的主打包方式从 `war` 恢复为 `jar`
- 恢复 `spring-boot-maven-plugin` 的 `repackage`，保证本地可直接运行 `ruoyi-admin.jar`
- 在 `ruoyi-admin` 中增加附加 `war` 打包步骤，使 `mvn package` 同时产出：
  - `ruoyi-admin.jar`
  - `ruoyi-admin.war`
- 在 `war` 打包中排除内嵌 Tomcat 相关 jar，避免 TongWeb 部署时容器冲突
- 将 `bin/restart_java_backend.sh` 恢复为本地 `java -jar` 启动链路
- 保持 `bin/prod/restart_java.sh`、`bin/prod/deploy_from_package.sh` 继续消费 `ruoyi-admin.war`
- 更新 `bin/run.bat`，恢复为本地 `jar` 启动入口
- 新增设计文档 `doc/2026-04-13-local-tomcat-remote-tongweb-design.md`
- 新增实施计划 `doc/2026-04-13-local-tomcat-remote-tongweb-backend-plan.md`

## 验证结果

- 已执行 `sh bin/restart_java_backend_test.sh`
- 已执行 `sh bin/prod/restart_java_test.sh`
- 已执行 `sh bin/prod/deploy_from_package_test.sh`
- 已执行 `sh -n bin/restart_java_backend.sh`
- 已执行 `sh -n bin/prod/restart_java.sh`
- 已执行 `sh -n bin/prod/deploy_from_package.sh`
- 已执行 `mvn -pl ruoyi-admin -am clean package -DskipTests`
- 已确认产物：
  - `ruoyi-admin/target/ruoyi-admin.jar`
  - `ruoyi-admin/target/ruoyi-admin.war`

## 结果说明

- 本地开发运行继续使用内嵌 Tomcat，不要求本机安装 TongWeb
- 服务器部署继续使用 TongWeb，只消费 `war`
- 一次打包即可同时得到本地运行产物和 TongWeb 部署产物