{"id":18585659,"url":"https://github.com/boyscout99/vaccine-distribution-project","last_synced_at":"2026-04-20T10:32:25.121Z","repository":{"id":174442266,"uuid":"561678206","full_name":"boyscout99/vaccine-distribution-project","owner":"boyscout99","description":"Modelling Vaccine Distribution in Finland with PostgreSQL database","archived":false,"fork":false,"pushed_at":"2023-09-20T20:07:09.000Z","size":699,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-16T06:11:23.385Z","etag":null,"topics":["database","postgresql","python","sql"],"latest_commit_sha":null,"homepage":"","language":"Python","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/boyscout99.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,"publiccode":null,"codemeta":null}},"created_at":"2022-11-04T08:34:48.000Z","updated_at":"2023-09-20T19:56:17.000Z","dependencies_parsed_at":"2024-11-07T00:47:48.300Z","dependency_job_id":null,"html_url":"https://github.com/boyscout99/vaccine-distribution-project","commit_stats":null,"previous_names":["boyscout99/vaccine-distribution-project"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/boyscout99/vaccine-distribution-project","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boyscout99%2Fvaccine-distribution-project","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boyscout99%2Fvaccine-distribution-project/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boyscout99%2Fvaccine-distribution-project/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boyscout99%2Fvaccine-distribution-project/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/boyscout99","download_url":"https://codeload.github.com/boyscout99/vaccine-distribution-project/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boyscout99%2Fvaccine-distribution-project/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32043020,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-20T00:18:06.643Z","status":"online","status_checked_at":"2026-04-20T02:00:06.527Z","response_time":94,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["database","postgresql","python","sql"],"created_at":"2024-11-07T00:35:01.778Z","updated_at":"2026-04-20T10:32:25.103Z","avatar_url":"https://github.com/boyscout99.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Modelling Vaccine Distribution in Finland with PostgreSQL database\nAuthors:  Bin Choi, Karina Mina, Phuong Hoang, Tommaso Praturlon\n\nIn this group project, we modelled a vaccine distribution system in Finland with the use of a relational database implemented in PostgreSQL. We used Python to connect to the database with SQLAlchemy, manipulate dataframes with pandas and queried the database to obtain information.\nYou can find [here](report/vaccine_distribution_databases_g9.pdf) the full report of our work with the relational database.\n\n![schema](report/final_db_schema.PNG)\n\n## How to work with virtual environment\n**MacOS/Linux - Method 1**\n```\nsudo apt-get install python3-venv           # Note: this cannot be used in Aalto VM due to the lack of sudo right. \ncd project-vaccine-distribution             # Move to the project root folder\npython3 -m venv venv                        # Create a virtual environment \nsource venv/bin/activate                    # Activate the virtual environment\n(venv) $                                    # You see the name of the virtual environment in the parenthesis.\n```\n\n**MacOS/Linux - Method 2**\n```\npython3 -m pip install --user virtualenv    # You can use virtualenv instead, if you are using Aalto VM.\ncd project-vaccine-distribution             # Move to the project root folder\nvirtualenv venv                             # Create a virtual environment \nsource venv/bin/activate                    # Activate the virtual environment\n(venv) $                                    # You see the name of the virtual environment in the parenthesis.\n\n```\n**Windows**\n\nYou can install and create a virtual environment similar to the above. However, it should be noted that you activate the environment differently, as shown below. \n```\nvenv\\Scripts\\Activate.ps1\n```\n**Deactivate**  \n\nYou can deactivate the virtual environment with this command.\n```\ndeactivate\n```\n    \n### Connecting to the database server\n\nIn order to connect to the course PostgreSQL server, you must be inside the Aalto's network. You can choose either one of these options:\n\n1. Establishing a remote connection (VPN) to an Aalto network. Instruction for installing the client software and establishing a connection is be found [here](https://www.aalto.fi/en/services/establishing-a-remote-connection-vpn-to-an-aalto-network?check_logged_in=1#6-remote-connection-to-students--and-employees--own-devices). This option allows you to use your own device. \n\n2. Connect to an Aalto Virtual Desktop Infrastructure (vdi.aalto.fi). Instruction for using vdi can be found [here](https://www.aalto.fi/en/services/vdiaaltofi-how-to-use-aalto-virtual-desktop-infrastructure). You can choose your prefer operating system. Please note that you don't have the ```sudo``` right for these machines (e.g. you can't install a software). Therefore, this option is less preferred. \n\nOnce you are inside an Aalto's network (either though VPN or vdi) and have cloned the project to (either to your machine or an Aalto virtual machine), you will need to ```activate``` the virtual environment [see here](#how-to-work-with-virtual-environment), and install the required library (e.g. from the project root folder, run ```pip install -r ./code/requirements.txt```)\n\nFinally, you can test the connection with the test_db by running ```python ./code/test_postgresql_conn.py``` from the project root folder. For your group database, we will share the \"database\" name, \"user\" and \"password\" information when Project Part 2 opens. \n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fboyscout99%2Fvaccine-distribution-project","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fboyscout99%2Fvaccine-distribution-project","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fboyscout99%2Fvaccine-distribution-project/lists"}