==========================================
  NPQS9100 Java 后端服务说明
==========================================

一、目录结构
----------------------------------------
entrance.jar            - Spring Boot 应用程序
application.yml         - 应用配置文件（自动生成）
application.yml.template - 配置模板
kill-java-port.bat      - 智能清理Java端口占用（紧急用）
.running-port           - 运行时端口记录（自动生成，勿删除）


二、自动管理
----------------------------------------
正常情况下，Java 后端服务由主应用自动管理：
- 应用启动时自动启动 Java 服务
- 应用关闭时自动停止 Java 服务
- 无需手动操作


三、端口智能管理
----------------------------------------
- Java 服务默认使用端口：18092
- 如果 18092 被占用，自动尝试：18093, 18094, ...
- 启动成功后会记录实际端口到 .running-port 文件
- kill-java-port.bat 会自动识别正确的端口进行清理


四、手动清理工具
----------------------------------------
如果应用异常退出，Java 进程可能残留，导致：
- 端口被占用，无法再次启动
- 可以运行 kill-java-port.bat 清理残留进程

使用方法：
1. 双击运行：kill-java-port.bat
2. 脚本会自动识别实际使用的端口
3. 清理完成后即可重新启动应用


五、安全说明
----------------------------------------
⚠️ 进程停止安全性：
- 应用自动停止时，只会停止应用自己启动的 Java 进程
- 通过进程引用精确停止，不会影响其他 Java 应用
- kill-java-port.bat 只清理占用特定端口的进程
- 完全不会影响您电脑上的其他 Java 程序

⭐ 端口冲突处理：
- 如果您的电脑上有其他应用占用了 18092 端口
- 本应用会自动切换到其他端口（18093, 18094...）
- kill-java-port.bat 会自动识别实际端口，精确清理


六、常见问题
----------------------------------------
Q: Java 服务无法启动？
A: 运行 kill-java-port.bat 清理残留进程

Q: 端口被占用怎么办？
A: 应用会自动切换端口，无需手动处理

Q: 如何查看 Java 日志？
A: 启动应用后，日志窗口会实时显示 Java 输出

Q: 配置文件在哪里？
A: application.yml 由应用自动生成，请勿手动修改


==========================================
南京灿能电气自动化有限公司
2025
==========================================