{"id":13529566,"url":"https://github.com/ScientificClubofESI/LaraHack","last_synced_at":"2025-04-01T16:31:41.157Z","repository":{"id":45119640,"uuid":"176176384","full_name":"ScientificClubofESI/LaraHack","owner":"ScientificClubofESI","description":"Administration system for Hackathons :chart_with_upwards_trend: ! ","archived":false,"fork":false,"pushed_at":"2023-02-02T05:38:24.000Z","size":2148,"stargazers_count":120,"open_issues_count":3,"forks_count":36,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-11-02T16:35:00.758Z","etag":null,"topics":["admin-dashboard","administration","checkin","competition","hackathon","hackathon-application","registration"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ScientificClubofESI.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-03-18T00:13:45.000Z","updated_at":"2024-10-28T18:14:08.000Z","dependencies_parsed_at":"2023-02-17T14:46:01.288Z","dependency_job_id":null,"html_url":"https://github.com/ScientificClubofESI/LaraHack","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/ScientificClubofESI%2FLaraHack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ScientificClubofESI%2FLaraHack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ScientificClubofESI%2FLaraHack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ScientificClubofESI%2FLaraHack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ScientificClubofESI","download_url":"https://codeload.github.com/ScientificClubofESI/LaraHack/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246670549,"owners_count":20815003,"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":["admin-dashboard","administration","checkin","competition","hackathon","hackathon-application","registration"],"created_at":"2024-08-01T07:00:37.479Z","updated_at":"2025-04-01T16:31:40.016Z","avatar_url":"https://github.com/ScientificClubofESI.png","language":"PHP","readme":"\n## We are looking for maintainers!\nIn order to ensure active development going forward, we are looking for maintainers to join the project. [Please contact the project owner if you are interested.](mailto:ha_zellat@esi.dz) and see [CONTRIBUTING.md][contribute] for information on what you can do about that.\n\n\n\u003cimg src=\"https://raw.githubusercontent.com/ScientificClubofESI/LaraHack/master/Screenshots/LaraHackLogo.png\" alt=\"LaraHack banner\"\u003e\n\n**LaraHack** is a complete administration systems designed especially for hackathons and similar competitions .\n\nFor participants , it's a clean and simple to submit application with or without team and confirm attendance .\n\nFor Organizers , it's an easy way to create your hackathon website , view registrations , analyze statistics , Check-In and much more ! \n\n# Features \n\n- **WebSite Template** : LaraHack has a website template that contains all necessary sections ( About,Challenges,Sponsors.. ) with a clean code so you can modify and customize it . \n\n- **Registration** : With LaraHack hackers can register easily with or without a team through a register view that is similar to TypeForm and also.\n\n- **Statistics** : The admin has access to a lot of statistics about registration such us registrations rate per day , decisions about hackers ... and muc more ! \n\n- **Dashboard** : Admin can view all applications to the hackathon , take a decision and export data to Excel or CSV .\n\n- **Mailing** : LaraHack is able to send emails such as : \n    - Successful application: which is sent to every hacker who apply , informing him that his application is done successfully and providing him with his team's name and team's code if he choosed to register with a team .\n    - Decision : Waiting list , Rejected Or Accepted with confirm attendance link .\n- **Check-In** : Allows organizers to check the participants present at the event day . \n\n- **Settings** : Configure some essential settings ( at the moment it contains only the possibility to close or open registrations ) . \n\n# Screenshots \n\n![Statistics Page](/Screenshots/Statistics.png)\n![Registration Page](/Screenshots/Register.PNG)\n![Hackers Table](/Screenshots/Hackers.png)\n![Check-In Page](/Screenshots/Checkin.png)\n\n# Setup \n\n### Quick deploy with Heroku \n[![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy?template=https://github.com/ScientificClubofESI/LaraHack)\n\n\n### Requirements \n| Requirement                                 | Version |\n| ------------------------------------------- | ------- |\n| [PHP](https://www.php.net)                | `7.1+`  |\n| [Composer](https://getcomposer.org) | `1.8+`  |\n| [MySQL](https://www.mysql.com) | `8.0+`  |\n\nRun the following commands to check the current installed versions:\n\n```bash\nphp --version\n```\n\nFor MySQL You can run this command in MySQL Commande Line Client : \n```bash\nselect version() ;\n```\n\n### Deploy locally \n\nGetting a local instance of LaraHack up and running is very quickly ! Start By Creating A Database on MySQL and go with these steps : \n\n1 - Clone the repository and cd to the project folder:\n```bash\ngit clone https://github.com/ScientificClubofESI/LaraHack \ncd LaraHack \n```\n\n2 - Install the necessary dependencies:\n```bash\ncomposer install\n```\n\n3 - Create your `.env` file from `.env.example` and generate an app key ( Don't forget to configure it with the database, and your email , if the host is googlemail so let mail driver , host and port as it was in env.example ) :\n```bash\ncp .env .env.example\nphp artisan key:generate  \n```\n\n4 - Migrate the database and start listening a queue in different terminal :\n```bash\nphp artisan migrate \nphp artisan queue:listen database \n```\n\n5 - Finally run the server :\n```bash\nphp artisan serve\n```\n\n### Deploy Using Docker \n\nGetting a local instance of LaraHack up and running is very quickly using docker-compose\n\n1 - Clone the repository and cd to the app folder:\n```bash\n$ git clone https://github.com/ScientificClubofESI/LaraHack \ncd LaraHack \n```\n\n2 - Change the ownership of the app:\n```bash\n$ sudo chown -R www-data:www-data 'LocalAppPath'\n'LocalAppPath' ex: ~/LaraHack\n```\n\n3 - copy the config file:\n```bash\n$ cp .env.example.docker .env\n```\n\n4 - Mount the app directory and install the dependencies:\n```bash\n$ docker run --rm -v $(pwd):/app composer install --no-dev\n```\n\n5 - Build the app image and run the services:\n```bash\n$ docker-compose up -d\n```\n\n# Customizing for your event \n\n### Hackathon name \n\nDon't forget to put your hackathon name in environment variable `APP_NAME` ( `.env` file )\n\n### Hackathon Logo \n\nPut your hackathon logo in the folder `/public/images` with the name of `LOGO.png`\n\n### Hackathon Landing Page  \n\nYou find the hackathon landing page section in the folder `/resources/views/sections` with a clean and simple code \n\n### Mail Content \n\nTo customize the decision and confirmation emails for your event, edit email templates in \n`/resources/views/emails` \n\n## Notes : \n\n- Access to the admin dashboard via the link `/admin` \n- The default mail and password are : `admin@cse.dz` and `cse` you can change them in the migrations folder `database/migrations`\n\n# Contributing \n\nDo you have a feature request, bug report, or patch? Great! See\n[CONTRIBUTING.md][contribute] for information on what you can do about that.\nContributions to LaraHack are welcome and appreciated !\n\n# Feedback / Questions \n\nIf you have any questions about this software, please contact ha_zellat@esi.dz or ga_namani@esi.dz .\n\n# License \n\nCopyright (c) 2019 Scientific Club Of ESI (https://github.com/ScientificClubofESI). Released under AGPLv3. See [`LICENSE`][license] for details.\n\n[contribute]: https://github.com/ScientificClubofESI/LaraHack/blob/master/CONTRIBUTING.md\n[license]: https://github.com/ScientificClubofESI/LaraHack/blob/master/LICENSE\n\n\t\n","funding_links":[],"categories":["Platforms"],"sub_categories":["Inactive 🧊"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FScientificClubofESI%2FLaraHack","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FScientificClubofESI%2FLaraHack","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FScientificClubofESI%2FLaraHack/lists"}