update file pdf thiết kế

2026-06-20 16:32:47 +07:00
parent 9439662328
commit 6eff207bbc
449 changed files with 670186 additions and 2 deletions
@@ -0,0 +1,38 @@
+# 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
+```bash
+npm install
+```
+
+### 2. Start the development server
+```bash
+./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`.