https://github.com/raflizocky/e-voting
Laravel | A web-based application that manages digital voting.
https://github.com/raflizocky/e-voting
bootstrap docker docker-compose laravel makefile php sql
Last synced: 3 months ago
JSON representation
Laravel | A web-based application that manages digital voting.
- Host: GitHub
- URL: https://github.com/raflizocky/e-voting
- Owner: raflizocky
- License: mit
- Created: 2024-06-20T07:07:45.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-01-06T04:40:20.000Z (5 months ago)
- Last Synced: 2025-01-06T05:25:39.292Z (5 months ago)
- Topics: bootstrap, docker, docker-compose, laravel, makefile, php, sql
- Language: HTML
- Homepage:
- Size: 5.22 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## Demo
## Features
- **Admin Panel**:
- Dashboard: Displays voter data (total voters, voted, not voted) and vote count chart
- Candidates: CRUD functionality for candidate data
- Voters: CRUD functionality for voter data
- Admins: CRUD functionality for admin data
- **Voter Panel**:
- Election Page: Displays all candidates
- Results Page: Displays vote count chart for all candidates
## Prerequisites
- PHP >= 8.1
- Composer
- XAMPP/MAMP/Laragon/Herd/etc
## Installation
### Without Docker
1. Create the database (ex: `e_voting`)
2. Terminal
```shell
git clone https://github.com/raflizocky/e-voting.git
```
```shell
code e-voting
```
3. `.env`
- Terminal:
```shell
cp .env.example .env
```
- Adjust `.env`:
```shell
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=your_mysql_db
DB_USERNAME=your_mysql_username
DB_PASSWORD=your_mysql_password
```
4. Terminal
- ```shell
composer i ; php artisan key:generate ; php artisan mi:f --seed ; php artisan storage:link
```
- ```shell
php artisan serve
```
---
### With Docker
> If it's laggy when running, that's okay/fine.
1. Terminal
```shell
git clone https://github.com/raflizocky/e-voting.git
```
```shell
code e-voting
```
2. Open Docker Desktop (Windows, MacOS)
3. `.env`
- Terminal:
```shell
cp .env.example .env
```
- Adjust `.env`:
```shell
DB_CONNECTION=mysql
DB_HOST=mysql_db
DB_PORT=3306
DB_DATABASE=e_voting
DB_USERNAME=root
DB_PASSWORD=secret
```
4. Terminal (`makefile` is optional, u can use usual docker compose command (see `makefile` file))
- ```shell
winget install ezwinports.make #for windows only
```
- ```shell
make build
```
- ```shell
make up
```
- ```shell
make migrate
```
- ```shell
make db-seed
```
- ```shell
make storage-link
```
- ```shell
make key-generate
```
5. Open project:
- e-voting -> `8000:8000`
- phpmyadmin -> `8080:80`
---
## Usage
- Admin
```shell
email : [email protected]
password: password
```
- Voter
```shell
email : [email protected]
password: password
```
## Contributing
If you encounter any issues or would like to contribute to the project, feel free to:
- Report any [issues](https://github.com/raflizocky/e-voting/issues)
- Submit a [pull request](https://github.com/raflizocky/e-voting/pulls)
- Participate in [discussions](https://github.com/raflizocky/e-voting/discussions) for any questions, feedback, or suggestions
## License
Code released under the [MIT License](https://github.com/raflizocky/e-voting/blob/main/LICENSE).