This repository contains the backend codebase for a web-based electronic voting system specifically designed for village head elections. Built with Laravel 11, this backend ensures scalability, security, and efficiency to support the voting process.
Note: This project serves as the backend counterpart for the village-election-voting-system-frontend. Ensure the frontend is configured properly for full functionality.
- Secure voter authentication and authorization.
- Real-time vote counting and monitoring.
- Role-based access control for administrators and voters.
- Candidate and voter management system.
- RESTful API for seamless integration with the frontend.
- Scalable database architecture using PostgreSQL.
- PHP 8.2 or higher
- Composer
- PostgreSQL 13 or higher
Follow these steps to set up the project locally:
-
Clone the repository:
git clone https://github.com/bagusvalentinoo/voting-system-for-village-head-elections-backend.git
-
Navigate to the project directory:
cd village-election-voting-system-backend -
Install dependencies:
composer install
-
Configure environment variables:
- Copy the example environment file:
cp .env.example .env
- Update
.envwith your database and other environment settings.
- Copy the example environment file:
-
Generate an application key:
php artisan key:generate
-
Run database migrations:
php artisan migrate
-
Start the development server:
php artisan serve
-
Access the application: Open your browser and navigate to
http://localhost:8000.
The API documentation is available on Postman. Access it here:
Postman API Documentation
This project is licensed under the MIT License.
If you encounter any issues or need assistance, feel free to open an issue or contact the maintainers.