Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ahmedukamel/warehouse-management-system

The system manages all FCAI-BSU warehouse operations
https://github.com/ahmedukamel/warehouse-management-system

boostrap4 css3 docker hibernate html5 java-8 javascript maven postgresql spring-boot spring-data-jpa spring-mvc spring-security sql thymeleaf

Last synced: about 1 month ago
JSON representation

The system manages all FCAI-BSU warehouse operations

Awesome Lists containing this project

README

        

# Warehouse Management System

> The warehouse management system was developed efficiently based on real requirements for the Faculty of Computers and Artificial Intelligence at Beni Suef University. It was operated and used by employees, and I was also honored for it. You can find the certificate [_here_](https://drive.google.com/file/d/1hOsa_Oldt_3F0dqRW2heht0HDU-Zij_W/view?usp=drivesdk) here. You can find live demo [_here_](https://warehouse-management-system-demo.onrender.com).

## Table of Contents

- [Warehouse Management System](#warehouse-management-system)
- [Table of Contents](#table-of-contents)
- [General Information](#general-information)
- [Technologies Used](#technologies-used)
- [Features](#features)
- [Screenshots](#screenshots)
- [Setup](#setup)
- [Usage](#usage)
- [Project Status](#project-status)
- [Contact](#contact)

## General Information

- Project is based on real requirements.
- One of challenges was how to store the data (DB Design).
- Complexity of Input/Output operations.
- Reports for all the transactions.
- Control user authorities in efficient manner.
- The purpose was computing all inventories operations.

## Technologies Used

- Java (JDK) - version 20
- Spring Boot - version 3.1.0
- Spring Security - version 6.1.2
- Spring Data JPA - version 3.1.3
- Thymeleaf - version 3.2.0
- Bootstrap - version 4.6
- PostgreSQL - version 15

## Features

List the ready features here:

- Awesome feature 1
- Awesome feature 2
- Awesome feature 3

## Screenshots

**Add (import/input) items page**
![Example screenshot](/images/1.png)
**Products page**
![Example screenshot](/images/2.png)
**Take (export/output) items page**
![Example screenshot](/images/3.png)
**Personal usage history page**
![Example screenshot](/images/4.png)
**Edit personal profile page**
![Example screenshot](/images/5.png)

## Setup

To run the project on your local machine instead od using deployed demo, follow there following steps:

`Please note that the project is connected to a specific PostgreSQl data source over the Internet, and even while running on your machine it will connect you to that data source.`

**Requirements:**

- JDK 20. [Download](https://www.oracle.com/java/technologies/downloads/)

**Clone repo:**

- Using _Git bash_. [Download](https://git-scm.com/downloads)

```bash
git clone https://github.com/AhmedUKamel/Warehouse-Management-System
```

- Using GitHu, click **_Download ZIP_** in code section
![Screen-Shot](/images/6.png)

then unzip (extract) file

**Run executable file:**

- Open project repo by terminal (Cmd) on your machine
- Run the following command:
```bash
java -jar Warehouse-Management-System.jar
```
- Wait until you see: **Tomcat started on port(s): 8080 (http)**
![Screen-Shot](/images/7.png)

- Open browser and enter link: http://localhost:8080
![Screen-Shot](/images/8.png)

## Usage

You need to sign up if you don't have accounts registered yet, then a super administrator will review, verify and activate your account before you can sign in and use the system service.

## Project Status

The project is currently being used in college by staff in different database and this is just a demo version for review deployed by me. The project is being updated and maintained at the request of college staff.

## Contact

Created by [@Ahmed Kamel](mailto:[email protected]) - feel free to contact me!