Add jpa & hibernate on backend-java

Author: ganatan

backend-java/.gitignore

@@ -1,33 +1,80 @@
-HELP.md
+# ================================================
+# ✅ Sensitive files / Local config
+# ================================================
+
+# Do not commit real configuration or secrets
+.env
+.env.local
+.env.development
+.env.test
+.env.production
+src/main/resources/application.properties
+
+# Keep templates for sharing example configs
+!.env.template
+!src/main/resources/application.template.properties
+
+# ================================================
+# ☕ Maven / Java build artifacts
+# ================================================
+
 target/
+build/
 !.mvn/wrapper/maven-wrapper.jar
 !**/src/main/**/target/
 !**/src/test/**/target/
+!**/src/main/**/build/
+!**/src/test/**/build/
+
+# Logs
+*.log
+hs_err_pid*.log
+
+# ================================================
+# 🧪 IDE: Eclipse / Spring Tools Suite (STS)
+# ================================================
 
-### STS ###
 .apt_generated
 .classpath
 .factorypath
 .project
-.settings
+.settings/
 .springBeans
-.sts4-cache
+.sts4-cache/
 
-### IntelliJ IDEA ###
-.idea
+# ================================================
+# 💡 IDE: IntelliJ IDEA
+# ================================================
+
+.idea/
 *.iws
 *.iml
 *.ipr
+out/
+
+# ================================================
+# 🧰 IDE: NetBeans
+# ================================================
 
-### NetBeans ###
 /nbproject/private/
 /nbbuild/
 /dist/
 /nbdist/
 /.nb-gradle/
-build/
-!**/src/main/**/build/
-!**/src/test/**/build/
 
-### VS Code ###
+# ================================================
+# 🖥️ IDE: Visual Studio Code
+# ================================================
+
 .vscode/
+
+# ================================================
+# 🗂️ OS files / Backup / Temp
+# ================================================
+
+.DS_Store
+Thumbs.db
+*.swp
+*.swo
+*.bak
+*.tmp

backend-java/.mvn/wrapper/maven-wrapper.properties

@@ -16,4 +16,4 @@
 # under the License.
 wrapperVersion=3.3.2
 distributionType=only-script
-distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.9.9/apache-maven-3.9.9-bin.zip
+distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.9.10/apache-maven-3.9.10-bin.zip

backend-java/HELP.md

@@ -0,0 +1,29 @@
+# Read Me First
+The following was discovered as part of building this project:
+
+* The original package name 'com.ganatan.backend-java' is invalid and this project uses 'com.ganatan.starter_app' instead.
+
+# Getting Started
+
+### Reference Documentation
+For further reference, please consider the following sections:
+
+* [Official Apache Maven documentation](https://maven.apache.org/guides/index.html)
+* [Spring Boot Maven Plugin Reference Guide](https://docs.spring.io/spring-boot/3.5.3/maven-plugin)
+* [Create an OCI image](https://docs.spring.io/spring-boot/3.5.3/maven-plugin/build-image.html)
+* [Spring Web](https://docs.spring.io/spring-boot/3.5.3/reference/web/servlet.html)
+
+### Guides
+The following guides illustrate how to use some features concretely:
+
+* [Building a RESTful Web Service](https://spring.io/guides/gs/rest-service/)
+* [Serving Web Content with Spring MVC](https://spring.io/guides/gs/serving-web-content/)
+* [Building REST services with Spring](https://spring.io/guides/tutorials/rest/)
+
+### Maven Parent overrides
+
+Due to Maven's design, elements are inherited from the parent POM to the project POM.
+While most of the inheritance is fine, it also inherits unwanted elements like `<license>` and `<developers>` from the parent.
+To prevent this, the project POM contains empty overrides for these elements.
+If you manually switch to a different parent and actually want the inheritance, you need to remove those overrides.
+