The E-Voting Management System is a web application designed to make voting secure and accessible with minimal election malpractices. The system provides a secure and accessible platform for Nigerian citizens to vote in elections, reducing the risk of election fraud and ensuring that their vote counts.
This project was developed as part of the final project at ALX_Africa in conjunction with Holberton school in partial completion of a degree in Fullstack Software Engineering.
The following technologies were used to develop the E-Voting Management System:
- Programming Languages: Python, JavaScript, HTML, CSS
- Framework: FastAPI, React
- Database: PostgreSQL
- Library: SQLAlchemy
- Tools: Git, Docker, VSCode, Pycharm
To install the E-Voting Management System, follow these steps:
- Clone the repository:
git clone https://github.com/Sanctus-Peter/e-voting_system.git
- Navigate to the project directory:
cd e-voting_system/e_voting_app
- Install the dependencies:
npm install
- Create a
.env
file and set the necessary environment variables. - Start the development server:
npm start
To use the E-Voting Management System, follow these steps:
- Navigate to the application URL:
http://localhost:3000
- Register an account using your valid credentials.
- Log in to your account.
- Cast your vote in the election.
To run tests for the E-Voting Management System, follow these steps:
- Navigate to the project directory:
cd e-voting_system/e-voting_app
- Run tests:
npm test
Contributions to the E-Voting Management System are welcome and appreciated. To contribute, follow these steps:
- Fork the repository.
- Create a new branch:
git checkout -b feature-name
- Make your changes and commit them:
git commit -m 'Add feature'
- Push your changes to the forked repository:
git push origin feature-name
- Open a pull request to the original repository.
The project team consists of three members:
- Mahadi Abuhuraira (Lead Developer)
- Imran Abdulmalik (Frontend Developer)
- Sanctus Ejiofor (Backend Developer & Project Manager)
The E-Voting Management System is licensed under the MIT license. See LICENSE
for more information.