Pharmacies on Duty Attica

Pharmacies on duty attica is a Java / Spring Boot web application where it gets the pharmacies on duty from the official Pharmacists Association of Attica Website: https://fsa-efimeries.gr and provides them as a REST API in JSON format. You can get the pharmacies on duty for any number of days you want, e.g., for the whole next week, as long as Pharmacists Association of Attica provides them.

It uses HtmlUnit to interact and crawl the "fsa.gr" website and jsoup to scrape the data (the available pharmacies per day, pharmacies' information and the different working hours available). It also uses MySQL to save the data on the server and Spring Boot to provide the Rest API.

Tests using JUnit, Mockito and Testcontainers have been implemented.

Here is an example of how it returns the pharmacies on duty:

{
  "content": [
    {
      "id": 251,
      "pharmacy": {
        "id": 564,
        "name": "ΓΙΩΡΓΟΣ ΠΑΠΑΔΟΠΟΥΛΟΣ",
        "address": "ΠΛΑΤ.ΑΕΡΟΠΟΡΙΑΣ 153",
        "region": "ΗΛΙΟΥΠΟΛΗ",
        "phoneNumber": "210-1234567"
      },
      "workingHour": {
        "id": 1,
        "workingHourText": "ΑΝΟΙΧΤΑ 8 ΠΡΩΙ ΕΩΣ 8 ΒΡΑΔΥ"
      },
      "date": "2021-01-06T00:00:00Z",
      "pulledVersion": 2
    }
  ],
  "page": {
    "size": 30,
    "number": 0,
    "totalElements": 78,
    "totalPages": 3
  }
}

It also contains a scheduler where it refreshes the available pharmacies for the given day when the application is started, and it also uses cron expressions to refresh the available pharmacies list many times per day. This can also be customized. The application also uses Ehcache for In-Memory Caching.

To clone the project, just run:

git clone https://github.com/DsTyM/PharmaciesOnDutyAttica.git
cd PharmaciesOnDutyAttica

To start the project using docker, just run:

docker compose up --build

The application can be accessed on:

http://localhost:8080

This page will redirect you to the API Documentation of the application. It uses Swagger UI to generate the API Documentation.

Of course, when you finish, don't forget to run:

docker compose down

The application uses Flyway for Database Versioning, and the initial changelog was generated using JPA Buddy. If you need to generate a new (diff) changelog, you can do that easily with JPA Buddy.

If you are using Docker and Git on Windows, then the following error may occur:

/bin/sh not found

To fix this error, just run the following command on Git Bash:

git config --global core.autocrlf false

and clone the project again.

In case you messed with the database, and the application won't start with Docker, try to remove the database volume. To remove it, run:

docker volume rm pharmaciesondutyattica_db-data