{"id":20489332,"url":"https://github.com/bsit-3-1-appdev/pupsrc-automatedelectionsystem","last_synced_at":"2025-04-13T16:32:43.317Z","repository":{"id":229739281,"uuid":"777499795","full_name":"BSIT-3-1-APPDEV/PUPSRC-AutomatedElectionSystem","owner":"BSIT-3-1-APPDEV","description":"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.","archived":false,"fork":false,"pushed_at":"2024-04-17T06:10:27.000Z","size":71258,"stargazers_count":1,"open_issues_count":1,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-04-17T09:27:56.110Z","etag":null,"topics":["bootstrap5","css","github-actions-workflow","html","javascript","mysqli-database","oop-php","php","semantic-versioning","voting-system","web-application-development"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/BSIT-3-1-APPDEV.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2024-03-26T00:49:29.000Z","updated_at":"2024-07-18T05:42:09.482Z","dependencies_parsed_at":"2024-03-26T03:28:56.443Z","dependency_job_id":"33497954-599a-4bfc-9aa8-f7c6866f0126","html_url":"https://github.com/BSIT-3-1-APPDEV/PUPSRC-AutomatedElectionSystem","commit_stats":null,"previous_names":["bsit-3-1-appdev/pupsrc-automatedelectionsystem"],"tags_count":128,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BSIT-3-1-APPDEV%2FPUPSRC-AutomatedElectionSystem","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BSIT-3-1-APPDEV%2FPUPSRC-AutomatedElectionSystem/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BSIT-3-1-APPDEV%2FPUPSRC-AutomatedElectionSystem/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BSIT-3-1-APPDEV%2FPUPSRC-AutomatedElectionSystem/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BSIT-3-1-APPDEV","download_url":"https://codeload.github.com/BSIT-3-1-APPDEV/PUPSRC-AutomatedElectionSystem/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248744020,"owners_count":21154791,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bootstrap5","css","github-actions-workflow","html","javascript","mysqli-database","oop-php","php","semantic-versioning","voting-system","web-application-development"],"created_at":"2024-11-15T17:12:28.769Z","updated_at":"2025-04-13T16:32:43.291Z","avatar_url":"https://github.com/BSIT-3-1-APPDEV.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ca name=\"readme-top\"\u003e\u003c/a\u003e\n\n\u003cdiv align=\"start\"\u003e\n  \u003ch1\u003eiVOTE: PUPSRC Online Election System :ballot_box: :bar_chart:\u003c/h1\u003e\n\u003c/div\u003e\n\n[![Contributors][contributors-shield]][contributors-url]\n[![Forks][forks-shield]][forks-url]\n[![Stargazers][stars-shield]][stars-url]\n[![Issues][issues-shield]][issues-url]\n[![Pull requests][pull-requests-shield]][pull-requests-url]\n[![GitHub Release][release-shield]][release-url]\n\n\n\u003c!-- PROJECT LOGO --\u003e\n\u003cbr /\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://github.com/BSIT-3-1-APPDEV/PUPSRC-AutomatedElectionSystem\"\u003e\n    \u003cimg src=\"src/images/resc/iVOTE4.png\" alt=\"Logo\" width=\"300\" height=\"120\"\u003e\n  \u003c/a\u003e\n\n  \u003cdiv align=\"start\"\u003e\n      \u003ch2\u003eAbout\u003c/h2\u003e\n      \u003cul\u003e\n        \u003cli\u003eiVOTE is an under-development online voting web application for Polytechnic University of the Philippines Santa Rosa Campus Student Academic Organizations.\u003c/li\u003e\n        \u003cli\u003eThis project is for partial fulfillment of the subject COMP 20133: Applications Development and Emerging Technologies.\u003c/li\u003e\n      \u003c/ul\u003e\n  \u003c/div\u003e\n\u003c/div\u003e\n\n\n\n\u003c!-- TABLE OF CONTENTS --\u003e\n\u003ch2\u003eTable of Contents\u003c/h2\u003e\n\u003col\u003e\n  \u003cli\u003e\u003ca href=\"#tech-stack\"\u003eTech Stack\u003c/a\u003e\u003c/li\u003e\n  \u003cli\u003e\u003ca href=\"#features\"\u003eFeatures\u003c/a\u003e\u003c/li\u003e\n  \u003cli\u003e\n    \u003ca href=\"#installation\"\u003eInstallation\u003c/a\u003e\n    \u003cul\u003e\n      \u003cli\u003e\u003ca href=\"#prerequisites\"\u003ePrerequisites\u003c/a\u003e\u003c/li\u003e\n      \u003cli\u003e\u003ca href=\"#steps\"\u003eSteps\u003c/a\u003e\u003c/li\u003e\n    \u003c/ul\u003e\n  \u003c/li\u003e\n  \u003cli\u003e\u003ca href=\"#role-access\"\u003eRole Access\u003c/a\u003e\u003c/li\u003e\n  \u003cli\u003e\u003ca href=\"#for-collaborators\"\u003eFor Collaborators\u003c/a\u003e\u003c/li\u003e\n  \u003cli\u003e\u003ca href=\"#acknowledgments\"\u003eAcknowledgments\u003c/a\u003e\u003c/li\u003e\n  \u003cli\u003e\u003ca href=\"#contributors\"\u003eContributors\u003c/a\u003e\u003c/li\u003e\n  \u003cli\u003e\u003ca href=\"#ui-snippets\"\u003eUI Snippets\u003c/a\u003e\u003c/li\u003e\n  \u003cli\u003e\u003ca href=\"#recommendation\"\u003eRecommendation\u003c/a\u003e\u003c/li\u003e\n\u003c/ol\u003e\n\n\n## Tech Stack\nTech stack and frameworks used to build iVOTE web-application\n\n* [![Bootstrap][Bootstrap.com]][Bootstrap-url]\n* [![PHP](https://img.shields.io/badge/PHP-777BB4?style=for-the-badge\u0026logo=php\u0026logoColor=white)][PHP-url]\n* [![CSS](https://img.shields.io/badge/CSS-1572B6?style=for-the-badge\u0026logo=css3\u0026logoColor=white)][CSS-url]\n* [![HTML](https://img.shields.io/badge/HTML-E34F26?style=for-the-badge\u0026logo=html5\u0026logoColor=white)][HTML-url]\n* [![JavaScript](https://img.shields.io/badge/JavaScript-F7DF1E?style=for-the-badge\u0026logo=javascript\u0026logoColor=black)][JavaScript-url]\n* [![SCSS](https://img.shields.io/badge/SCSS-CC6699?style=for-the-badge\u0026logo=sass\u0026logoColor=white)][SCSS-url]\n* [![JQuery][JQuery.com]][JQuery-url]\n\n\n\n\u003c!-- GETTING STARTED --\u003e\n## Features\n\n\u003cdetails\u003e\u003csummary\u003eFeatures Offered:\u003c/summary\u003e\n\u003col\u003e\n  \u003cli\u003eElectronic Ballot Form\u003c/li\u003e\n  \u003cli\u003eLive Counting of Results\u003c/li\u003e\n  \u003cli\u003e\n    Election configuration\n    \u003cul\u003e\n      \u003cli\u003eAdd Ballot Form Input Field\u003c/li\u003e\n      \u003cli\u003eVote Scheduling\u003c/li\u003e\n      \u003cli\u003eDynamic Voting Guidelines\u003c/li\u003e\n      \u003cli\u003eCandidates Sequence on Ballot Form\u003c/li\u003e\n    \u003c/ul\u003e\n  \u003c/li\u003e\n  \u003cli\u003eArchive of Election Results\u003c/li\u003e\n  \u003cli\u003eExportable Reports (pdf, xlsx, csv, and docx)\u003c/li\u003e\n  \u003cli\u003eCandidates Information Management\u003c/li\u003e\n  \u003cli\u003eVoters Account Mangagement\u003c/li\u003e\n  \u003cli\u003ePassword Recovery\u003c/li\u003e\n  \u003cli\u003eLogin Attempts Lockout\u003c/li\u003e\n\u003c/ol\u003e\u003c/details\u003e\n\n\u003cdetails\u003e\u003csummary\u003eOther Features:\u003c/summary\u003e\n\u003col\u003e  \n  \u003cli\u003eMobile Responsive\u003c/li\u003e\n  \u003cli\u003eFull Screen Toggle of Live Results\u003c/li\u003e\n  \u003cli\u003eAnonymous Toggle of Live Results\u003c/li\u003e\n  \u003cli\u003eEmail Notification about Account Approval or Rejection\u003c/li\u003e\n\u003c/ol\u003e\u003c/details\u003e\n\n\n\n\u003c!-- INSTALLATION --\u003e\n## Installation\n\n### Prerequisites\n- You must have installed PHP and [Git](https://git-scm.com/downloads) on your machine.\n- To access the [phpMyAdmin](http://localhost/phpmyadmin/index.php), you need [XAMPP](https://www.apachefriends.org/download.html) installed also.\n\n### Steps:\n1. Clone this repository by running this git command.\n\n  ```sh\n  git clone https://github.com/BSIT-3-1-APPDEV/PUPSRC-AutomatedElectionSystem\n  ```\nor if you need to checkout a specific branch only\n\n```sh\ngit clone --single-branch --branch main https://github.com/BSIT-3-1-APPDEV/PUPSRC-AutomatedElectionSystem\n```\n_Note: Change the branch name as you see fit. In this case, the name of the checked out branch is main._\n\n2. Download the necessary files on your root folder to create the databases of 9 orgs. \nThese are the only files needed.\n* `create-db.php`\n* `env.php`\n* `create-org-tbl.sql`\n#### Access them [here.](https://drive.google.com/drive/u/1/folders/1Ke1F_vxh0vj1zzWkpMjmeKA96uUizTsT)\n\n3. Run the PHP script on your terminal\n   \n  ```sh\n  php create-db.php\n  ```\n\n  or thru directory listing\n  \n   ```sh\n  localhost/path_to_file/create-db.php\n  ```\n\n4. Open the website locally on your machine. The URL may look something like this:\n  ```sh\n  http://localhost/PUPSRC-AutomatedElectionSystem/src/landing-page.php\n  ```\n\n\n\u003c!-- ROLE ACCESS --\u003e\n## Role Access\n\n| Account Type | Features |\n|--------|--------|\n| Student-Voter | Account registration, password recovery, and vote casting. | \n| Admin | Validation of voter account, and access to live counting of results | \n| Head Admin | Similar to admin, with only the additional privilege of adding new admin accounts |\n\n\n\n\n\u003c!-- CONTRIBUTE --\u003e\n## For Collaborators\n1. Clone this repository and checkout the `development` branch on your computer\n ```sh\n  git clone --single-branch --branch development https://github.com/BSIT-3-1-APPDEV/PUPSRC-AutomatedElectionSystem\n  ```\n2. Create a local branch on your computer\n  ```sh\n  git checkout -b your_branch\n  ```\n3. Commit your changes\n```sh\n  git add .\n  git commit -m \"type: issue-key-your_commit_message\"\n```\n4. If finished, push/publish your local branch to this repository\n  ```sh\n  git push origin your_branch\n```\n5. Open a pull request from your published branch to merge it into the `development` branch\n6. Await the review and approval of at least one collaborator on your pull request\n7. After approval, ensure that you pull the latest changes from the `development` branch on your computer.\n  ```sh\n  git pull origin development\n```\n\n_Important Note: Keep in mind the issue key of your Team's Project in Jira and proper conventional commit message._\n\n\n\n\n\u003c!-- ACKNOWLEDGMENTS --\u003e\n## Acknowledgments\nThe 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:\n* [Student Council Organization](https://www.facebook.com/thepupsrcstudentcouncil)\n* [Association of Competent and Aspiring Psychologists](https://www.facebook.com/ACAPpage)\n* [Association of Electronics and Communications Engineering](https://www.facebook.com/OfficialAECES)\n* [Eligible League of Information Technology Enthusiasts](https://www.facebook.com/ELITE.PUPSRC)\n* [Guild of Imporous and Valuable Educators](https://www.facebook.com/educgive)\n* [Junior Executives of Human Resource Association](https://www.facebook.com/PUPSRCJEHRA)\n* [Junior Marketing Association of the Philippines](https://www.facebook.com/JMAPPUPSRCOfficial)\n* [Junior Philippine Institute of Accountants](https://www.facebook.com/JPIA.PUPSRC)\n* [Philippine Institute of Industrial Engineers](https://www.facebook.com/piiepup)\n\n\u003c!-- CONTRIBUTORS --\u003e\n## Contributors\n\nMade with [contrib.rocks](https://contrib.rocks).\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://github.com/BSIT-3-1-APPDEV/PUPSRC-AutomatedElectionSystem/graphs/contributors\"\u003e\n    \u003cimg src=\"https://contrib.rocks/image?repo=BSIT-3-1-APPDEV/PUPSRC-AutomatedElectionSystem\" /\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\n\n\n## UI Snippets\n- To follow\n\n\n\u003c!-- RECOMMENDATIONS --\u003e\n## Recommendation\nYou can read more about:\n\n[Conventional Commits](www.conventionalcommits.org/en/v1.0.0/#summary)\u003cbr/\u003e\n[Semantic Versioning](https://semver.org/)\n\n\u003cp align=\"right\"\u003e\u003ca href=\"#readme-top\"\u003eBack to Top\u003c/a\u003e\u003c/p\u003e\n\n\u003c!-- MARKDOWN LINKS \u0026 IMAGES --\u003e\n\u003c!-- https://www.markdownguide.org/basic-syntax/#reference-style-links --\u003e\n[contributors-shield]: https://img.shields.io/github/contributors/BSIT-3-1-APPDEV/PUPSRC-AutomatedElectionSystem.svg?style=for-the-badge\n[contributors-url]: https://github.com/BSIT-3-1-APPDEV/PUPSRC-AutomatedElectionSystem/graphs/contributors\n[forks-shield]: https://img.shields.io/github/forks/BSIT-3-1-APPDEV/PUPSRC-AutomatedElectionSystem.svg?style=for-the-badge\n[forks-url]: https://github.com/BSIT-3-1-APPDEV/PUPSRC-AutomatedElectionSystem/network/members\n[stars-shield]: https://img.shields.io/github/stars/BSIT-3-1-APPDEV/PUPSRC-AutomatedElectionSystem.svg?style=for-the-badge\n[stars-url]: https://github.com/BSIT-3-1-APPDEV/PUPSRC-AutomatedElectionSystem/stargazers\n[issues-shield]: https://img.shields.io/github/issues/BSIT-3-1-APPDEV/PUPSRC-AutomatedElectionSystem.svg?style=for-the-badge\n[issues-url]: https://github.com/BSIT-3-1-APPDEV/PUPSRC-AutomatedElectionSystem/issues\n[pull-requests-shield]: https://img.shields.io/github/issues-pr/BSIT-3-1-APPDEV/PUPSRC-AutomatedElectionSystem.svg?style=for-the-badge\n[pull-requests-url]: https://github.com/BSIT-3-1-APPDEV/PUPSRC-AutomatedElectionSystem/pulls\n[release-shield]: https://img.shields.io/github/release/BSIT-3-1-APPDEV/PUPSRC-AutomatedElectionSystem.svg?style=for-the-badge\n[release-url]: https://github.com/BSIT-3-1-APPDEV/PUPSRC-AutomatedElectionSystem/releases\n[Bootstrap.com]: https://img.shields.io/badge/Bootstrap-563D7C?style=for-the-badge\u0026logo=bootstrap\u0026logoColor=white\n[Bootstrap-url]: https://getbootstrap.com\n[PHP-url]: https://www.php.net\n[CSS-url]: https://developer.mozilla.org/en-US/docs/Web/CSS\n[HTML-url]: https://developer.mozilla.org/en-US/docs/Web/HTML\n[JavaScript-url]: https://developer.mozilla.org/en-US/docs/Web/JavaScript\n[SCSS-url]: https://sass-lang.com/documentation/syntax\n[JQuery.com]: https://img.shields.io/badge/jQuery-0769AD?style=for-the-badge\u0026logo=jquery\u0026logoColor=white\n[JQuery-url]: https://jquery.com \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbsit-3-1-appdev%2Fpupsrc-automatedelectionsystem","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbsit-3-1-appdev%2Fpupsrc-automatedelectionsystem","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbsit-3-1-appdev%2Fpupsrc-automatedelectionsystem/lists"}