tarzann419/ccms

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
4. Roadmap
5. Contributing
6. License
7. Contact
8. Acknowledgments

About The Project

The Unified Citizen Management System (UCMS) is an innovative and integrated platform that streamlines citizen information and services across various parastatals, including the Federal Road Safety Corps (FRSC), National Identity Management Commission (NIMC), and Independent National Electoral Commission (INEC).

This system enhances efficiency and accessibility by enabling citizens and authorized agents to perform registration, view information, and make adjustments to citizen details using a unique identifier known as the National Identity Number (NIN).

Here's why:

• Unmatched Convenience: UCMS consolidates services from various government parastatals into a single platform, enabling citizens and agents to efficiently manage registrations, updates, and inquiries.

• Efficiency Redefined: Experience streamlined operations as authorized agents process tasks like vehicle registration and identity management swiftly, while the National Identity Number (NIN) ensures accurate data integration.

• Error-Proof Data: With the NIN as a unique identifier, UCMS minimizes errors, creating a reliable database that reduces inconsistencies and enhances accessibility.

• Robust Security: UCMS employs advanced security measures to safeguard private data, ensuring that only authorized personnel can access specific information.

(back to top)

Built With

• 
• 
• 
• 
• 

(back to top)

Getting Started

To access this project locally, you will have to clone and get a copy. To get it up and running, follow these simple example steps.

Prerequisites

This is an example of how to list things you need to use the software and how to install them.

• npm

  npm install && npm run dev

Installation

1. Clone or download the repo from https://github.com/tarzann419/ccms

2. Clone the repo

   git clone https://github.com/tarzann419/ccms.git

3. Open the project in your terminal and install composer

   composer install

   • Make sure this is in the root of the folder 'ccms'!

4. Install NPM packages

   npm install

5. Run NPM packages

   npm run dev

6. In the root of your project directory, make a copy of .env.example

   cp .env.example .env

7. Customize the .env with your database name and features. Should look something like this:

   DB_CONNECTION=mysql
   DB_HOST=127.0.0.1
   DB_PORT=3306
   DB_DATABASE=ccms
   DB_USERNAME=root
   DB_PASSWORD=root

8. Generate a new key for your project

   php artisan key:generate

9. Migrate all tables to the database

   php artisan migrate

10. Seed all the "dummy" data that we've extracted

    php artisan db:seed

11. Finally, run the project!

    php artisan serve

(back to top)

Usage

Project should be available to you locally at http://127.0.0.1:8000

(back to top)

A demo of this project is live at: https://shorturl.at/dwxHO https://shorturl.at/dwxHO

• Default INEC login email: inec@admin.com
• Default INEC login password: password

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch
3. Commit your Changes
4. Push to the Branch
5. Open a Pull Request

(back to top)

License

Distributed under the MIT License. See LICENSE.txt for more information.

(back to top)

Contact me at:

Your Name - @iammrdann - danogbo0@gmail.com

Project Link: https://github.com/tarzann419/ccms

(back to top)

Acknowledgments

(back to top)