Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/bsit-3-1-appdev/pupsrc-automatedelectionsystem

PUPSRC Online Election System is an under-development project that aims to digitalized the process of vote casting, counting, and result generation for PUP Santa Rosa student organizations.
https://github.com/bsit-3-1-appdev/pupsrc-automatedelectionsystem

bootstrap5 css github-actions-workflow html javascript mysqli-database oop-php php semantic-versioning voting-system web-application-development

Last synced: about 2 months ago
JSON representation

PUPSRC Online Election System is an under-development project that aims to digitalized the process of vote casting, counting, and result generation for PUP Santa Rosa student organizations.

Host: GitHub
URL: https://github.com/bsit-3-1-appdev/pupsrc-automatedelectionsystem
Owner: BSIT-3-1-APPDEV
Created: 2024-03-26T00:49:29.000Z (9 months ago)
Default Branch: main
Last Pushed: 2024-04-17T06:10:27.000Z (9 months ago)
Last Synced: 2024-04-17T09:27:56.110Z (9 months ago)
Topics: bootstrap5, css, github-actions-workflow, html, javascript, mysqli-database, oop-php, php, semantic-versioning, voting-system, web-application-development
Language: JavaScript
Homepage:
Size: 68 MB
Stars: 1
Watchers: 1
Forks: 3
Open Issues: 1
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

        



  iVOTE: PUPSRC Online Election System :ballot_box: :bar_chart:



[![Contributors][contributors-shield]][contributors-url]

[![Forks][forks-shield]][forks-url]

[![Stargazers][stars-shield]][stars-url]

[![Issues][issues-shield]][issues-url]

[![Pull requests][pull-requests-shield]][pull-requests-url]

[![GitHub Release][release-shield]][release-url]






  

    

  

  


      About

      

        iVOTE is an under-development online voting web application for Polytechnic University of the Philippines Santa Rosa Campus Student Academic Organizations.

        This project is for partial fulfillment of the subject COMP 20133: Applications Development and Emerging Technologies.

      

  



Table of Contents



  Tech Stack

  Features

  

    Installation

    

      Prerequisites

      Steps

    

  

  Role Access

  For Collaborators

  Acknowledgments

  Contributors

  UI Snippets

  Recommendation



## Tech Stack

Tech stack and frameworks used to build iVOTE web-application

* [![Bootstrap][Bootstrap.com]][Bootstrap-url]

* [![PHP](https://img.shields.io/badge/PHP-777BB4?style=for-the-badge&logo=php&logoColor=white)][PHP-url]

* [![CSS](https://img.shields.io/badge/CSS-1572B6?style=for-the-badge&logo=css3&logoColor=white)][CSS-url]

* [![HTML](https://img.shields.io/badge/HTML-E34F26?style=for-the-badge&logo=html5&logoColor=white)][HTML-url]

* [![JavaScript](https://img.shields.io/badge/JavaScript-F7DF1E?style=for-the-badge&logo=javascript&logoColor=black)][JavaScript-url]

* [![SCSS](https://img.shields.io/badge/SCSS-CC6699?style=for-the-badge&logo=sass&logoColor=white)][SCSS-url]

* [![JQuery][JQuery.com]][JQuery-url]

## Features

Features Offered:



  Electronic Ballot Form

  Live Counting of Results

  

    Election configuration

    

      Add Ballot Form Input Field

      Vote Scheduling

      Dynamic Voting Guidelines

      Candidates Sequence on Ballot Form

    

  

  Archive of Election Results

  Exportable Reports (pdf, xlsx, csv, and docx)

  Candidates Information Management

  Voters Account Mangagement

  Password Recovery

  Login Attempts Lockout



Other Features:

  

  Mobile Responsive

  Full Screen Toggle of Live Results

  Anonymous Toggle of Live Results

  Email Notification about Account Approval or Rejection



## Installation

### Prerequisites

- You must have installed PHP and [Git](https://git-scm.com/downloads) on your machine.

- To access the [phpMyAdmin](http://localhost/phpmyadmin/index.php), you need [XAMPP](https://www.apachefriends.org/download.html) installed also.

### Steps:

1. Clone this repository by running this git command.

  ```sh

  git clone https://github.com/BSIT-3-1-APPDEV/PUPSRC-AutomatedElectionSystem

  ```

or if you need to checkout a specific branch only

```sh

git clone --single-branch --branch main https://github.com/BSIT-3-1-APPDEV/PUPSRC-AutomatedElectionSystem

```

_Note: Change the branch name as you see fit. In this case, the name of the checked out branch is main._

2. Download the necessary files on your root folder to create the databases of 9 orgs. 

These are the only files needed.

* `create-db.php`

* `env.php`

* `create-org-tbl.sql`

#### Access them [here.](https://drive.google.com/drive/u/1/folders/1Ke1F_vxh0vj1zzWkpMjmeKA96uUizTsT)

3. Run the PHP script on your terminal

   

  ```sh

  php create-db.php

  ```

  or thru directory listing

  

   ```sh

  localhost/path_to_file/create-db.php

  ```

4. Open the website locally on your machine. The URL may look something like this:

  ```sh

  http://localhost/PUPSRC-AutomatedElectionSystem/src/landing-page.php

  ```

## Role Access

| Account Type | Features |

|--------|--------|

| Student-Voter | Account registration, password recovery, and vote casting. | 

| Admin | Validation of voter account, and access to live counting of results | 

| Head Admin | Similar to admin, with only the additional privilege of adding new admin accounts |

## For Collaborators

1. Clone this repository and checkout the `development` branch on your computer

 ```sh

  git clone --single-branch --branch development https://github.com/BSIT-3-1-APPDEV/PUPSRC-AutomatedElectionSystem

  ```

2. Create a local branch on your computer

  ```sh

  git checkout -b your_branch

  ```

3. Commit your changes

```sh

  git add .

  git commit -m "type: issue-key-your_commit_message"

```

4. If finished, push/publish your local branch to this repository

  ```sh

  git push origin your_branch

```

5. Open a pull request from your published branch to merge it into the `development` branch

6. Await the review and approval of at least one collaborator on your pull request

7. After approval, ensure that you pull the latest changes from the `development` branch on your computer.

  ```sh

  git pull origin development

```

_Important Note: Keep in mind the issue key of your Team's Project in Jira and proper conventional commit message._

## Acknowledgments

The project team would like to thank the student academic organizations of PUPSRC below for their unwavering and continuous support and guidance for the success of this endeavor:

* [Student Council Organization](https://www.facebook.com/thepupsrcstudentcouncil)

* [Association of Competent and Aspiring Psychologists](https://www.facebook.com/ACAPpage)

* [Association of Electronics and Communications Engineering](https://www.facebook.com/OfficialAECES)

* [Eligible League of Information Technology Enthusiasts](https://www.facebook.com/ELITE.PUPSRC)

* [Guild of Imporous and Valuable Educators](https://www.facebook.com/educgive)

* [Junior Executives of Human Resource Association](https://www.facebook.com/PUPSRCJEHRA)

* [Junior Marketing Association of the Philippines](https://www.facebook.com/JMAPPUPSRCOfficial)

* [Junior Philippine Institute of Accountants](https://www.facebook.com/JPIA.PUPSRC)

* [Philippine Institute of Industrial Engineers](https://www.facebook.com/piiepup)

## Contributors

Made with [contrib.rocks](https://contrib.rocks).



  

    

  



## UI Snippets

- To follow

## Recommendation

You can read more about:

[Conventional Commits](www.conventionalcommits.org/en/v1.0.0/#summary)


[Semantic Versioning](https://semver.org/)

Back to Top


[contributors-shield]: https://img.shields.io/github/contributors/BSIT-3-1-APPDEV/PUPSRC-AutomatedElectionSystem.svg?style=for-the-badge

[contributors-url]: https://github.com/BSIT-3-1-APPDEV/PUPSRC-AutomatedElectionSystem/graphs/contributors

[forks-shield]: https://img.shields.io/github/forks/BSIT-3-1-APPDEV/PUPSRC-AutomatedElectionSystem.svg?style=for-the-badge

[forks-url]: https://github.com/BSIT-3-1-APPDEV/PUPSRC-AutomatedElectionSystem/network/members

[stars-shield]: https://img.shields.io/github/stars/BSIT-3-1-APPDEV/PUPSRC-AutomatedElectionSystem.svg?style=for-the-badge

[stars-url]: https://github.com/BSIT-3-1-APPDEV/PUPSRC-AutomatedElectionSystem/stargazers

[issues-shield]: https://img.shields.io/github/issues/BSIT-3-1-APPDEV/PUPSRC-AutomatedElectionSystem.svg?style=for-the-badge

[issues-url]: https://github.com/BSIT-3-1-APPDEV/PUPSRC-AutomatedElectionSystem/issues

[pull-requests-shield]: https://img.shields.io/github/issues-pr/BSIT-3-1-APPDEV/PUPSRC-AutomatedElectionSystem.svg?style=for-the-badge

[pull-requests-url]: https://github.com/BSIT-3-1-APPDEV/PUPSRC-AutomatedElectionSystem/pulls

[release-shield]: https://img.shields.io/github/release/BSIT-3-1-APPDEV/PUPSRC-AutomatedElectionSystem.svg?style=for-the-badge

[release-url]: https://github.com/BSIT-3-1-APPDEV/PUPSRC-AutomatedElectionSystem/releases

[Bootstrap.com]: https://img.shields.io/badge/Bootstrap-563D7C?style=for-the-badge&logo=bootstrap&logoColor=white

[Bootstrap-url]: https://getbootstrap.com

[PHP-url]: https://www.php.net

[CSS-url]: https://developer.mozilla.org/en-US/docs/Web/CSS

[HTML-url]: https://developer.mozilla.org/en-US/docs/Web/HTML

[JavaScript-url]: https://developer.mozilla.org/en-US/docs/Web/JavaScript

[SCSS-url]: https://sass-lang.com/documentation/syntax

[JQuery.com]: https://img.shields.io/badge/jQuery-0769AD?style=for-the-badge&logo=jquery&logoColor=white

[JQuery-url]: https://jquery.com