Patient Management

Simple Java-based patient management application built with Maven and SQL for persistence. Intended to be run and developed on Windows using IntelliJ IDEA 2025.2.4.

Tech stack

1. Java (21)
2. Maven
3. Relational SQL database (MySQL, PostgreSQL, or H2 for local dev)
4. IntelliJ IDEA 2025.2.4
5. Docker desktop (optional, for containerized DB)

Prerequisites

1. JDK installed and JAVA_HOME configured
2. Maven installed or use the IntelliJ Maven support
3. Database server accessible (or use an embedded DB for tests)

Build and test

Run from project root:

mvn clean package
mvn test

Run

1. From IntelliJ: run the main application class located under src/main/java.

2. Or build a jar and run from a terminal:

   java -jar target/patient-management-*.jar

Configuration

Application and datasource settings are in src/main/resources/application.properties or src/main/resources/application.yml.

Example application.properties:

spring.datasource.url=jdbc:postgresql://localhost:5432/patientdb
spring.datasource.username=your_user
spring.datasource.password=your_password
server.port=8080

Adjust values to match your environment.

Database setup

1. Create the database (example for PostgreSQL):

   createdb patientdb

2. Run schema/migration SQL if present. Check src/main/resources/db or src/main/resources/schema.sql for migration files.

Troubleshooting

1. If the app fails to start, check logs in the IDE run console for stack traces.

2. Common issues:

   1. Wrong DB URL / credentials — verify src/main/resources/application.properties.
   2. Port already in use — change server.port.
   3. Missing migrations — ensure schema is applied.

3. For more verbose Maven output:

   mvn -X clean package

Tests

1. Unit tests are under src/test/java.

2. Run with:

   mvn test

Contributing

1. Fork and create a feature branch.
2. Open pull requests against master on origin. Remote URL: https://github.com/akki-pesit/patient-management.git.

License

Check repository for a LICENSE file.