================================================================
  JDE Atina Panel Manager v1.0.0
  Installation and Usage Guide
================================================================

REQUIREMENTS
----------------------------------------------------------------
- Java 8 or higher (JRE or JDK)
- Docker running with container "jd-atina-microserver" active
- Network access to the JDE Atina Microservice (gRPC)


CONTENTS
----------------------------------------------------------------
  JDEAtinaPanelManager.jar   - Application (executable)
  start.sh                   - Linux/Mac startup script
  start.bat                  - Windows startup script
  README.txt                 - This file


QUICK START
----------------------------------------------------------------

1. Copy all files to a folder on the target machine.

2. Run the application:

   Linux/Mac:
     chmod +x start.sh
     ./start.sh

   Windows:
     start.bat

3. The browser will open automatically at http://localhost:8080


COMMAND LINE PARAMETERS
----------------------------------------------------------------
All parameters are optional:

  --panel-port <port>        Panel web port (default: 8080)
  --host <hostname>          Microservice host (default: localhost)
  --port <port>              Microservice gRPC port (default: 8077)
  --tlsEnable <true|false>   Enable TLS for gRPC (default: false)
  --user <user>              JDE user for auto-login
  --password <password>      JDE password for auto-login
  --environment <env>        JDE environment for auto-login
  --role <role>              JDE role for auto-login
  --wsConnection <true|false> WS connection mode (default: false)
  --open-browser <true|false> Open Panel in browser on startup (default: true)

Examples:

  # Basic startup (manual login via UI)
  java -jar JDEAtinaPanelManager.jar --host 192.168.1.100 --port 8077

  # Full auto-login (BSFN mode)
  java -jar JDEAtinaPanelManager.jar \
    --host 192.168.1.100 --port 8077 \
    --user JDE --password MyPass123 \
    --environment JDV920 --role "*ALL"

  # Full auto-login (Web Services mode)
  java -jar JDEAtinaPanelManager.jar \
    --host 192.168.1.100 --port 8077 \
    --user JDE --password MyPass123 \
    --environment JDV920 --role "*ALL" \
    --wsConnection true

  # Custom panel port
  java -jar JDEAtinaPanelManager.jar --panel-port 9090


FEATURES
----------------------------------------------------------------

Connections
  View all active JDE connections in real time.
  Auto-refreshes every 30 seconds.

Report Incident
  Generate a diagnostic ZIP containing:
  - Incident description and attachments
  - Container files: /tmp/jde, /tmp/jdelog, extra-hosts.txt
  - File listing of /var/jdeatinaserver

Validate Operations
  - Validate BSFN: Executes a test BSFN operation (Non-WS login)
  - Validate Web Service: Executes a test WS operation (WS login)
  - View and download transaction logs


LOGS
----------------------------------------------------------------
Application logs are written to:
  ./logs/panel-manager.log

Logs rotate daily, max 10MB per file, 30 days retention.


TROUBLESHOOTING
----------------------------------------------------------------

"Connection failed" on startup:
  - Verify the microservice host and port are correct
  - Verify the Docker container "jd-atina-microserver" is running
  - Check if TLS should be enabled (--tlsEnable true)

OutOfMemoryError:
  - Increase heap: java -Xmx1g -jar JDEAtinaPanelManager.jar ...

Port already in use:
  - Use a different port: --panel-port 9090

Auto-login not working:
  - All 4 credential parameters are required:
    --user, --password, --environment, --role
  - Check logs/panel-manager.log for "Auto-login failed" errors
================================================================
