{"id":22460404,"url":"https://github.com/tcnj-acm/halo","last_synced_at":"2025-08-02T05:31:05.089Z","repository":{"id":40267231,"uuid":"388500518","full_name":"tcnj-acm/halo","owner":"tcnj-acm","description":"Hackathon Management System built on Django","archived":false,"fork":false,"pushed_at":"2024-09-11T20:48:20.000Z","size":15943,"stargazers_count":5,"open_issues_count":3,"forks_count":4,"subscribers_count":0,"default_branch":"main-dev","last_synced_at":"2024-09-12T07:05:46.861Z","etag":null,"topics":["aws-s3","django","hackathon","heroku","postgres"],"latest_commit_sha":null,"homepage":"","language":"HTML","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/tcnj-acm.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":".github/CODE_OF_CONDUCT.md","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":"2021-07-22T14:56:52.000Z","updated_at":"2024-09-11T20:48:23.000Z","dependencies_parsed_at":"2024-05-30T21:34:52.896Z","dependency_job_id":"852459f7-6ed0-44ea-b6cf-0d728ab090e5","html_url":"https://github.com/tcnj-acm/halo","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tcnj-acm%2Fhalo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tcnj-acm%2Fhalo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tcnj-acm%2Fhalo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tcnj-acm%2Fhalo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tcnj-acm","download_url":"https://codeload.github.com/tcnj-acm/halo/tar.gz/refs/heads/main-dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228439523,"owners_count":17920023,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["aws-s3","django","hackathon","heroku","postgres"],"created_at":"2024-12-06T09:02:22.745Z","updated_at":"2024-12-06T09:06:07.487Z","avatar_url":"https://github.com/tcnj-acm.png","language":"HTML","funding_links":[],"categories":["Platforms"],"sub_categories":["Open Source 🌳"],"readme":" \u003cbr/\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/tcnj-acm/aslan\"\u003e\n    \u003cimg src=\"logo.png\" alt=\"Logo\" width=\"500\"\u003e\n  \u003c/a\u003e\n\n  \u003ch3 align=\"center\"\u003eHALO\u003c/h3\u003e\n  \n  \u003ch4 align=\"center\"\u003eHackathons with Awesome Logistics Organization\u003c/h4\u003e\n\n  \u003cp align=\"center\"\u003e\n    A Hackathon Management System built on Django\n    \u003cbr/\u003e\n    \u003cbr/\u003e\n    \u003ca href=\"https://github.com/tcnj-acm/aslan\"\u003eView Demo\u003c/a\u003e\n    .\n    \u003ca href=\"https://github.com/tcnj-acm/aslan/issues\"\u003eReport Bug\u003c/a\u003e\n    .\n    \u003ca href=\"https://github.com/tcnj-acm/aslan/issues\"\u003eRequest Feature\u003c/a\u003e\n  \u003c/p\u003e\n\n\n\u003c/p\u003e\n\n\n\n## About The Project\n\n\nHALO is a web application that gives alleviates hackathon operations. From handling registration to hacker and organizer management, HALO works as a resource management tool for all organizers. This is what it can do:\n\n1. Seamless Registration and Check-in module from the platform\n2. Check-in hackers via QR Code\n3. Website Waiting List mode\n4. Hacker team building functionality with invitation integration via email\n5. Exclusive sponsor booth pages on your website\n6. Quick Deployment to Heroku\n7. Integrated Email Module with Sendgrid\n8. Resume Drop storage with AWS S3\n\n\n\n## Built With\n\n|  dependencies |\n| ------------ |\n| django  |\n| mysqlclient  |\n| python-dotenv  |\n| django-qr-code  |\n| django-storages  |\n| boto3  |\n| gunicorn  |\n| dj-database-url  |\n| whitenoise  |\n| psycopg2-binary  |\n| django-heroku  |\n| sendgrid  |\n\nPython 3.9.10\n\n\n\n## Getting Started\n\n### Prerequisites\n\nYou need a Unix-based Machine. If you only have a Windows Machine please refer to the [WSL Guide.](https://github.com/tcnj-acm/halo/blob/main-dev/.github/WSL_SETUP.md)\n\nYou can also find the required packages you NEED to have to run the application locally within that link.\n\n### Deployment Reqs\n\nHeroku with Postgres used. Used Postgres add-on with heroku. Be sure to add all your envs to your secret variables on linkedin\n\n### Environmental Variables\n\nThe project uses multiple .env variables and unfortunately couldn't be compiled to one file. Please read the Environmental Variables [doc](https://github.com/tcnj-acm/aslan/blob/main-dev/.github/ENVIRONMENTAL_VARIABLES.md) to properly set this up. \n\n### Installation\n\n\n1. Clone the repo\n\n   ```shell\n   git clone git@github.com:tcnj-acm/halo.git\n   ```\n\n   \n\n   Note: If you don't have ssh keys setup to clone git repos, then replace the ssh link with `https://github.com/tcnj-acm/.git`\n\n2. `cd` to repo\n\n3. Create the `pipenv` environment\n\n   ```shell\n   pipenv install\n   ```\n\n   Once you install the pipenv environment, you can activate it by doing:\n   \n   ```shell\n   pipenv shell\n   ```\n\n4. Set up your [environmental variables](https://github.com/tcnj-acm/aslan/blob/main-dev/.github/ENVIRONMENTAL_VARIABLES.md) \n5. `python manage.py migrate`\n6. `cd setup/`\n7. `sh run_create_db.sh`\n8. `cd ..`\n9. `python manage.py runserver`\n\n\n## Usage\n\nWe built this project because we wanted all hackathons to have a powerful application that can tackle on the big things. \n\nIf you are organizing a hackathon and want a smooth process to manage your hackers and team, to operate registration and check-in, and to impress your sponsors with an exclusive website \"booth\" -- this project is for you!\n\n## Resources\n\nHere are some resources we believe will help you to navigate and understand the repo's codebase:\n- Free Resources\n  - [\\[Article\\] Frontend vs Backend](https://www.geeksforgeeks.org/frontend-vs-backend/)\n  - [\\[Article\\] Web Application Framework – A Comprehensive Guide](https://www.sencha.com/blog/a-comprehensive-guide-to-web-application-frameworks/)\n  - [\\[Article\\] model-view-controller (MVC)](https://www.techtarget.com/whatis/definition/model-view-controller-MVC)\n  - [\\[Article\\] Django Project MVT Structure](https://www.geeksforgeeks.org/django-project-mvt-structure/)\n  - [\\[Article\\] An easy guide to understanding databases](https://dev.to/efkumah/an-easy-guide-to-understanding-databases-2hcf)\n  - [\\[Article\\] Understanding databases: A comprehensive guide to different types for beginners](https://datasciencedojo.com/blog/understanding-databases/)\n  - [\\[Blog\\] SQL Tutorial](https://www.sqltutorial.org/)\n  - [\\[Video\\] How To Make A Portfolio Website Using HTML CSS JS | Complete Responsive Website Design (Project to follow along to.)](https://www.youtube.com/watch?v=0YFrGy_mzjY)\n  - [\\[Video\\] Django Project - Simple Blog App (Project to follow along to.)](https://www.youtube.com/watch?v=AF4ji8bb1M8)\n  - [\\[Blog\\] Getting started with Django](https://www.djangoproject.com/start/)\n  - [\\[Tutorial Course\\] Cloud Computing Tutorial for Beginners](https://www.simplilearn.com/tutorials/cloud-computing-tutorial)\n  - [\\[Tutorial Course\\] AWS Tutorial: A Step-by-Step Tutorial for Beginners](https://www.simplilearn.com/tutorials/aws-tutorial)\n  - [\\[Blog\\] Getting Started on Heroku with Python](https://devcenter.heroku.com/articles/getting-started-with-python)\n- Paid Resources\n  - [\\[Course\\] Meta Front-End Developer Professional Certificate](https://www.coursera.org/professional-certificates/meta-front-end-developer)\n  - [\\[Course\\] Meta Back-End Developer Professional Certificate (I used this personally to learn Django)](https://www.coursera.org/professional-certificates/meta-back-end-developer)\n  - [\\[Course\\] Python \u0026 Django REST API Bootcamp - Build A Python Web API](https://www.udemy.com/course/the-complete-python-django-rest-api-development-bootcamp/)\n  - [\\[Course\\] Ultimate AWS Certified Cloud Practitioner CLF-C02](https://www.udemy.com/course/aws-certified-cloud-practitioner-new/)\n\n## Contributing\n\nPlease read our [Contributing](https://github.com/tcnj-acm/aslan/blob/main/.github/CONTRIBUTING.md) guide and [Code Of Conduct](https://github.com/tcnj-acm/aslan/blob/main/.github/CODE_OF_CONDUCT.md).\n\n## License\n\nDistributed under the MIT License. See [LICENSE](https://github.com/tcnj-acm/aslan/blob/main/LICENSE.md) for more information.\n\n\n## Contributors\n\nWe'd like to thank everyone who has contributed to the project:\n\n[Abhi Vempati](https://github.com/abhivemp) - *Believes chocolate is the only superior ice cream flavor*\n\n[Kevin Williams](https://github.com/kvnwill) - *Who the heck likes chocolate frosted flakes anyway??* \n\n[Sterly Deracy](https://github.com/sderacy) - *Maestro of finesse, hustler extraordinaire* \n\n[JM Tameta](https://github.com/JmTameta) - *unofficial bachelors in the arts*\n\n[Simon Blamo](https://github.com/Simon-Blamo) - *I go by Sam sometimes*","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftcnj-acm%2Fhalo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftcnj-acm%2Fhalo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftcnj-acm%2Fhalo/lists"}