https://github.com/andrzejszelag/fms

IT System for Managing Control System Faults on the Mining Railways | 🔶🔶🔶 Facade Design Pattern 🔶🔶🔶
https://github.com/andrzejszelag/fms

cdi ejb javaee8 jpa jsf maven oracle-21c payara-server

Last synced: about 2 months ago
JSON representation

IT System for Managing Control System Faults on the Mining Railways | 🔶🔶🔶 Facade Design Pattern 🔶🔶🔶

• Host: GitHub
• URL: https://github.com/andrzejszelag/fms
• Owner: AndrzejSzelag
• Created: 2023-05-13T10:25:12.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-09-11T12:59:01.000Z (4 months ago)
• Last Synced: 2024-09-11T19:41:54.686Z (4 months ago)
• Topics: cdi, ejb, javaee8, jpa, jsf, maven, oracle-21c, payara-server
• Language: Java
• Homepage: https://github.com/AndrzejSzelag/fms
• Size: 1.1 MB
• Stars: 1
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# FMS (Fault Management System)

### IT System for Managing Control System Faults on the Mining Railways

🔶🔶🔶 Inside this project you find: __Facade Design Pattern__ 🔶🔶🔶 

![url3.java](url3.png "Fault Management System")

### Tech Stack

* 🔶 Java 17.0.6 LTS

* 🔶 Java Persistence API 2.2

* 🔶 Java Transaction API 1.2

* 🔶 Context and Dependency Injection 2.0

* 🔶 Enterprise JavaBeans 3.2

* 🔶 JavaServer Faces 2.3

* 🔶 Lombok 1.18.26

* 🔶 BootsFaces 1.5.0

* 🔶 PrimeFaces 10.0.0 (icons)

### Environment

* 🔶 Java EE 8.0.1

* 🔶 Apache Maven 3.8.6

* 🔶 Payara Server 5.2021.10

* 🔶 Oracle Database 21c Express Edition

* 🔶 IntelliJ IDEA 2023.1.1

### Video

🚀 [Management of user accounts by Administrator](https://youtu.be/eArxW2pi3XQ)

🚀 [Fault management by Supervision and Electrician](https://youtu.be/tnAVQGW4tXk)

### Requirements & How to run

1. Log into __Windows 11 Pro__ with a user that is a direct member of the Administrators group.

2. Download the __Java 17.0.6 LTS__ (_x64 MSI Installer_) and install to a local directory.

3. Download the __Apache Maven 3.8.6__ (_Binary zip archive_) and extract zip file to a local directory.

4. Download the __Oracle Database 21c Express Edition__ (_.zip_), extract zip file to a local directory and run __setup.exe__. After installation:

    * verify if __Oracle Database 21c Express Edition__ runs,

    * create a new __database user__ (e.g. __system__) and __database password__ (e.g. __pa$$w0rd__) - you will need this data in __DataSource.java__ before starting to use the __FMS__ application:

   

            // DataSource.java 

            package pl.szelag.config;

    

            import javax.annotation.sql.DataSourceDefinition;

            import javax.ejb.Singleton;

            import java.sql.Connection;

    

            @Singleton

            @DataSourceDefinition(

                     name = "java:app/jdbc/FMSDescriptorDS",

                     className = "oracle.jdbc.OracleDriver",

                     url = "jdbc:oracle:thin:@localhost:1521:XE",

                     user = "system",

                     password = "pa$$w0rd",

                     isolationLevel = Connection.TRANSACTION_READ_COMMITTED)

            public class DataSource {

            }

6. Download the __Payara Server 5.2021.10__ (_.zip_) and extract zip file to a local directory.

7. In command line Windows, copy file __ojdbc11.jar__ from the __Oracle Database 21c Express Edition__ to the __Payara Server 5.2021.10__:

       copy %ORACLE_HOME%\jdbc\lib\ojdbc11.jar %PAYARA_HOME%\glassfish\domains\domain1\lib

8. In command line Windows, start default domain on the __Payara Server 5.2021.10__:

        %PAYARA_HOME%\bin\asadmin start-domain

10. Clone a Github Repository:

    * From Github Repository, click on __Clone__

    * Copy the clone URL

    * In command line Windows, go to partition __D:__ 

    * Use the __git clone__ command along with the copied URL:

          git clone https://github.com/AndrzejSzelag/fms.git

        

    

11. In command line Windows, go to folder __D:\fms__, and run command: 

        mvn clean install

        

12. In command line Windows, go to folder __D:\fms\target__ and deploy file __FMS-1.0.war__ to the __Payara Server 5.2021.10__.

        %PAYARA_HOME%\bin\asadmin deploy FMS-1.0.war

13. Load test data from the script __D:\fms\src\main\resources\data.sql__ to the __Oracle Database 21c Express Edition__ with usining __Oracle SQL Developer__, __SQL Plus__ etc.

14. In your Web browser,

    * paste a URL:

          https://localhost:8181/FMS

            

    * click on __Advanced__

    * click on __Continue to localhost (unsafe)__

#### You should see the home page of the FMS application (hint: first photo) and log in with using the following logins and password.

> Logins for confirmed and activated test users: 

> 

>   * __AndrzejSzelag__ (administrator)

>   * __TomaszDominiak__ (supervision)

>   * __ArekStolecki__ (electrician)

> 

> Default __password__ for all test users: __12345678__

### Description

👉 The Fault Management System (FMS) is my first business application in Java programming language, summarizing the knowledge I gained in the postgraduate degree __Modern business applications Java/Jakarta EE__ at __Lodz University of Technology__.

👉 This application was created with using [__Apache Maven__](https://maven.apache.org/) and [__Java EE__](https://www.oracle.com/java/technologies/java-ee-glance.html) technology with many different standards, such as __JPA__, __JTA__, __EJB__, __CDI__, __JSF__ etc. It also uses the advanced tools, such as [__Oracle Database XE__](https://www.oracle.com/pl/database/technologies/appdev/xe.html) and [__Payara Server__](https://www.payara.fish/downloads/payara-platform-community-edition/).