Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/geekelo/oilchem-certificate_portal_user

The oilchem certificate verification portal that auto-designs and displays ready-to-print and download certificates. It also helps to verify the authenticity of certificate IDs of certificates claimed to have been issues by the institution.
https://github.com/geekelo/oilchem-certificate_portal_user

css react-router reactjs redux-thunk redux-toolkit

Last synced: 2 months ago
JSON representation

The oilchem certificate verification portal that auto-designs and displays ready-to-print and download certificates. It also helps to verify the authenticity of certificate IDs of certificates claimed to have been issues by the institution.

Awesome Lists containing this project

README

        


signature


# 📗 Table of Contents

- [📗 Table of Contents](#-table-of-contents)
- [📖 LMW Webpage ](#-lmw-webpage-)
- [🛠 Built With ](#-built-with-)
- [Tech Stack ](#tech-stack-)
- [Key Features ](#key-features-)
- [🚀 Live Demo ](#-live-demo-)
- [💻 Getting Started ](#-getting-started-)
- [Setup ](#setup-)
- [Prerequisites ](#prerequisites-)

- [Usage ](#usage-)

- [👥 Authors ](#-authors-)
- [🤝 Contributing ](#-contributing-)
- [Future Features ](#future-features-)
- [⭐️ Show your support ](#️-show-your-support-)
- [🙏 Acknowledgments ](#-acknowledgments-)
- [📝 License ](#-license-)

![Screenshot from 2024-01-11 02-53-01](https://github.com/geekelo/oilchem-certificate_portal_user/assets/102464578/3d8a431c-c866-48ab-8c54-181de484c123)


📖 VERIFIER - OILCHEM MUD SCHOOL CERTIFICATE PORTAL


The `CERTIFICATE VERIFIER - OILCHEM MUD SCHOOL CERTIFICATE PORTAL` project is a web application developed using the React JavaScript library. It serves as the certificate verification side for the Oilchem certificate portal web application. It provides a user interface and interacts with the Rails Backend API-only app to convert certificate details to a well-designed and downloadable certificate (with qrcode).

Students can check if their certificate has been issued by entering their unique numbers. If found, a graphically downloadable certificate displays. Students can also copy direct links to their certificates.

Employers can check and verify certificate IDs. If found, a graphically downloadable certificate displays.

This project aims to provide an effective solution to enable the Oilchem Mud School students and potential employers to digitally verify certificates of job applicants from Oilchem Mud School 📚

This project comprises of -
- [Rails Backend API only App](https://github.com/geekelo/oilchem-certificate_portal_api) - manages PostgreSQL database and CRUD methods
- [React CMS](https://github.com/geekelo/oilchem-certificate_portal_admin) - provides user interfaces to admins for effective content management
- [React Certificate Verification Portal](https://github.com/geekelo/oilchem-certificate_portal_user) - provides an interface for students to check the availability of and download their certificates. Also providing employees an interface to authenticate and verify certificate IDs. This application is connected to the backend application and converts the details to a graphically designed and downloadable certificate.

## 🚀 Live Demo
- [Admin/CMS Demo Link](https://oilchem-certificate-portal-admin.geekelo.com.ng)
- [User/portal Demo Link](https://oilchem-certificate-portal-user.geekelo.com.ng)
- [Api Docs Demo Link](https://oilchem-api.onrender.com/api-docs)
- [Video Presentation](https://youtu.be/4pFrIFyQq98)

## 🛠 Built With


  • React

  • Redux

  • CSS

### Key Features

- [x] **React-Based User Interface**
- [x] **Modular Structure**
- [x] **Create, read, update and delete features for certificates, students, personnel and batch**
- [x] **Navigation**

## Kanban Board:
[Kanban-board](https://github.com/users/geekelo/projects/4)

## Team:
This is a solo project

(back to top)

## Getting Started

To get a local copy up and running, follow these steps.

### Prerequisites
In order to run this project you need:
* A basic understanding of React, Redux and Git
### Usage
1. Clone this repo
2. Run npm install
```
git clone https://github.com/geekelo/oilchem-certificate_portal_user.git
```

To run the project, execute the following command:

```
npm start
```

(back to top)

## 👥 Authors

👤 **Eloghene Otiede**

- GitHub: [@geekelo](https://github.com/geekelo)
- LinkedIn: [eloghene-otiede](https://www.linkedin.com/in/eloghene-otiede-b146a3232/)
- Website: [portfolio](https://geekelo.com.ng/)

(back to top)

## 🔭 Future Features

- [ ] **Edit Admin Profile**
- [ ] **Super Admin management**

(back to top)

## 🤝 Contributing

Contributions, issues, and feature requests are welcome!

Feel free to check the [issues page](../../issues/).

(back to top)

## ⭐️ Show your support

Please support this project and be a part of something meaningful and impactful. Your contribution can make a significant difference and help us achieve our goals faster.

(back to top)

## 🙏 Acknowledgments

I would like to express my sincere gratitude to [Eloti Designs](https://elotidesigns.com) for trsting my competence in executing this project for their client OILCHEM MUD SCHOOL

(back to top)

## :question: FAQ

- **Can I fork and reuse this repository?**

Absolutely! Please feel free to fork and reuse this repository for your own projects.

- **Is it okay to improve this repository? Will my changes be accepted?**

Definitely! We welcome any improvements or new ideas you may have. If your changes are good and align with the project's goals, we would be happy to accept them.

(back to top)

## 📝 License

This project is [MIT](./LICENCE) licensed.

(back to top)