Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/geekelo/oilchem-certificate_portal_admin
A react CMS application that handles adminstrative roles of a certficate portal
https://github.com/geekelo/oilchem-certificate_portal_admin
reactjs redux redux-thunk redux-toolkit restful-api
Last synced: 3 months ago
JSON representation
A react CMS application that handles adminstrative roles of a certficate portal
- Host: GitHub
- URL: https://github.com/geekelo/oilchem-certificate_portal_admin
- Owner: geekelo
- License: mit
- Created: 2023-12-18T14:28:51.000Z (about 1 year ago)
- Default Branch: dev
- Last Pushed: 2024-01-13T04:12:04.000Z (about 1 year ago)
- Last Synced: 2024-10-06T03:48:05.911Z (4 months ago)
- Topics: reactjs, redux, redux-thunk, redux-toolkit, restful-api
- Language: JavaScript
- Homepage: https://oilchem-certificate-portal-admin.vercel.app
- Size: 1.52 MB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 22
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 📗 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-)
📖 CMS - OILCHEM MUD SCHOOL CERTIFICATE PORTAL
The `CMS - OILCHEM MUD SCHOOL CERTIFICATE PORTAL` project is a web application developed using the React JavaScript library. It serves as the content management system for a certificate portal web application. It provides an admin interface and interacts with the Rails Backend API-only app to display content and manage data. This CMS is functional, easy to use, and navigate. Admins can create students, certificates, training personnel etc.
This project aims to provide an effective solution to enable the Oilchem Mud School to digitally create, manage, and verify certificates for their graduated students 📚
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 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)
- React
- Redux
- CSS
- [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
To get a local copy up and running, follow these steps.
### Prerequisites
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_admin.git
```
To run the project, execute the following command:
```
npm start
```
👤 **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/)
- [ ] **Edit Admin Profile**
- [ ] **Super Admin management**
Contributions, issues, and feature requests are welcome!
Feel free to check the [issues page](../../issues/).
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.
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
- **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.
This project is [MIT](./LICENCE) licensed.