Pharmacy Warehouse Management Application

Course

Software Engineering

Team

• Michail Marakis
• Prodromos-Aris Makarounas

---

Introduction

This android application simplifies the medicine ordering process from the perspective of pharmacists who are registered and use the platform.
At the same time, it significantly supports pharmacy warehouse administrators by allowing them to serve their clients (pharmacists) efficiently and quickly, offering rich functionality through a centralized system.

The goal of the application is to automate ordering, inventory management, and backorder handling in a reliable and structured way. It is also translated in Greek, English and French.

---

Stakeholders

• Customers (Pharmacists)
• Pharmacy Warehouse Administrator

---

Pharmacy Warehouse Features

• The warehouse administrator can view a list of pending orders.
• Any order can be selected for execution, automatically changing its status from “Pending” to “Completed”, while updating warehouse inventory.
• After completion, orders are packed and shipped to the corresponding pharmacy.
• Orders can be cancelled if it is client's wish to be cancelled.
• When new product batches are received, the administrator updates inventory and relevant backorders are activated automatically.
• The administrator can withdraw defective or dangerous medicines from the market and notify all pharmacies that received them (traceability support).
• The system provides sales statistics, including:
  • Order history
  • Revenue per customer
  • Product sales per time period

---

Pharmacist Features

• Pharmacists can register by providing:
  • First and last name
  • Phone number
  • Email
  • Password
  • Address, region, postal code
  • Pharmacists can register multiple pharmacies under their name
• They can browse products, which include:
  • Product name
  • Price (without and with VAT)
  • Stock availability
  • Medicine category
  • EOF product code
• Products can be added to a shopping cart, allowing:
  • Immediate order submission
  • Temporary saving for later submission
• When an order includes unavailable products:
  • Available items are shipped
  • Unavailable items are placed in backorder
• Backorders remain pending and reserve products until stock is replenished.
• Backorders are processed using First-Come First-Serve (FCFS) priority.
• When stock becomes available again, pharmacists are notified via email.
• Emails received can be seen.
• Loging info can be seen.
• Pending, Draft, Completed orders can be seen.

---

JUNIT TESTS

There is 100% lines and branch coverage through out the project in order to verify correct logic

---

Project Structure

This repository is organized into the following directories:

docs

Contains the project's UML documentation, including:

• Use Case Diagrams
• Class Diagrams
• Sequence Diagrams
• Activity Diagrams

These diagrams document the system's architecture, workflows, and functional requirements.

ApplicationProject

Contains the complete implementation of the application along with its documentation and testing artifacts.

Source Code

ApplicationProject/app/src/main/java/gr/softeng/team09

Contains the full implementation of the application.

Unit Tests

ApplicationProject/app/src/test/java/gr/softeng/team09

Includes the JUnit test suite used to verify the application's functionality.

UML Documentation

ApplicationProject/docs/uml/requirements

Contains the project's software design documentation, including:

• Domain Model
• Class Diagrams
• Sequence Diagrams
• Activity Diagrams

Application Diagrams

ApplicationProject/docs/uml/requirements/app_diagrams

Contains additional UML diagrams illustrating key application functionalities and user interaction flows.

Test Coverage Report

ApplicationProject/htmlreport

Provides the generated code coverage report, including coverage statistics for the project's JUnit test suite.

Summary

The application improves the ordering and fulfillment process between pharmacies and pharmacy warehouses by offering automation, transparency, and efficient inventory management.