sisvietnamvn_01/sisvietnamvn_main/ENVIRONMENT_TRANSFER_GUIDE.md

Environment Transfer Guide

To transfer the development environment for this application to another PC, you need to install a few key technologies based on the project's configuration (JHipster 9.1.0, Spring Boot monolith).

Here is the complete list of tools and dependencies you need to install on the new PC:

1. Required Technologies

• Java Development Kit (JDK): Version 21 (The project is configured with sourceCompatibility=21 in build.gradle).
• Node.js: Version >= 24.16.0 (Required for JHipster frontend tooling and code formatting, as specified in package.json).
• NPM: Comes bundled with Node.js.
• Git: To clone and transfer your source code.

2. Automatically Managed Dependencies (No installation required)

• Gradle: You do not need to install Gradle manually. The project uses the Gradle Wrapper (gradlew). Running it will automatically download the correct version for you.
• Database (Development): The dev profile uses an H2 in-memory/file-based database. You do not need to install an external database to run the project locally.
  • (Note: The prod profile uses an Oracle Database, which is only necessary if you are running it in production mode).

3. Recommended Tools (Optional)

• IDE: IntelliJ IDEA, Eclipse, or Visual Studio Code with the Java Extension Pack.
• Docker Desktop: Useful if you want to run additional services (like SonarQube or JHipster Control Center) via the docker-compose files located in src/main/docker/.

---

How to start the project on the new PC

Once you've installed Java 21 and Node.js >= 24.16.0, you can transfer your code to the new PC and run the following commands in your project's root folder:

1. Install Node dependencies

npm install

2. Start the development server

./gradlew

(On Windows Command Prompt or PowerShell, use .\gradlew instead).

This will download all necessary Java dependencies via Gradle and start the application on http://localhost:8080.