PollVot

How to run app with Docker

1. Build and start the containers:

   docker compose up --build

   If your Docker installation uses the legacy Compose binary, run docker-compose up --build instead.

2. Open http://localhost:8000

3. The MySQL dump from database/dump-pollvot-202212251211.sql is imported automatically the first time the db_data volume is created.

4. Administrator user credentials are email: administrator@pollvot.app and password: 12345678

Useful commands:

docker compose down
docker compose down -v
docker compose exec app php artisan cache:clear
docker compose exec db mysql -upollvot -ppollvot votems

Use docker compose down -v only when you want to delete the database volume and re-import the SQL dump on the next start.

The Python prediction scripts are not installed in the container image.

How to run app without Docker

1. Import database dump located at /database directory.
2. Create .env file with MySQL credentials
3. Install Python and Python packages: sklearn, keras, tensorflow, pandas
4. Make sure Python is globally accessible by setting environment variable
5. Run composer install
6. Run php artisan serve
7. Administrator user credentials are email: administrator@pollvot.app and password: 12345678

Screenshots

• Home page

• Register form

• Waiting for the prediction script computation

• Applying prediction script answer

• Administrator dashboard

• Administrator generating stats and graphs

• Administrator dashboard showing last votes