{"id":15994150,"url":"https://github.com/style77/volunteering","last_synced_at":"2025-04-05T00:15:44.812Z","repository":{"id":144684266,"uuid":"547900790","full_name":"style77/volunteering","owner":"style77","description":"Website made for volunteers that wants to help even more! Project made for HackHeroes 2022 hackathon. ","archived":false,"fork":false,"pushed_at":"2022-10-22T15:22:00.000Z","size":1012,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-10T08:31:10.875Z","etag":null,"topics":["competition","eslint","firebase","hackathon","hackheroes","jest","nextjs","prettier"],"latest_commit_sha":null,"homepage":"https://volunteering.pl/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/style77.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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-10-08T14:22:49.000Z","updated_at":"2023-03-14T15:09:22.000Z","dependencies_parsed_at":"2023-07-04T15:36:50.507Z","dependency_job_id":null,"html_url":"https://github.com/style77/volunteering","commit_stats":{"total_commits":120,"total_committers":3,"mean_commits":40.0,"dds":"0.22499999999999998","last_synced_commit":"8310a38e89eecbfccd67dbb2f34c7492baf11f1e"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/style77%2Fvolunteering","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/style77%2Fvolunteering/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/style77%2Fvolunteering/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/style77%2Fvolunteering/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/style77","download_url":"https://codeload.github.com/style77/volunteering/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247266570,"owners_count":20910837,"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":["competition","eslint","firebase","hackathon","hackheroes","jest","nextjs","prettier"],"created_at":"2024-10-08T07:06:31.987Z","updated_at":"2025-04-05T00:15:44.797Z","avatar_url":"https://github.com/style77.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Volunteering\n![CodeFactor](https://www.codefactor.io/repository/github/style77/volunteering/badge) ![ChecksStatus](https://img.shields.io/github/checks-status/style77/volunteering/main) ![Vercel](https://vercelbadge.vercel.app/api/style77/volunteering)\n\nStrona stworzona na konkurs [Hack Heroes](https://hackheroes.pl/) organizowany przez Fundacje Media 3.0 i SAP SE z partnerami - firmą HP Inc. i programem Nowa Akademia.\n\nGłówną ideą strony jest promocja wolontariatu wśród młodych ludzi. Strona ma na celu ułatwienie znalezienia wolontariatu dla osób, które chcą się zaangażować w działania społeczne. Strona ma również na celu promocję wolontariatu wśród firm, które chcą wspierać społeczność. Konkretnym celem są młodzi ludzie, którzy chcą się zaangażować w działania społeczne, ale nie wiedzą jak i gdzie. \nNasza aplikacja po każdym wolontariacie dodaje statystyki do profilu - przy określonej ilości punktów, do profilu wolontariusza jest dodawana odznaka. Odznaki są widoczne na profilu użytkownika. \n\nStrona jest dostępna na https://volunteering.pl/\n\n## Zastrzeżenia\n\nVolunteering nie potrzebuje API - wszystko działa w oparciu o Firebase, a więc nie ma żadnych dodatkowych kosztów (do czasu, aż nie osiągniemy [limitów](https://cloud.google.com/firestore/quotas) 😁).\n\nProblematyczne może być logowanie się użytkownika, który zweryfikował swoje konto numerem telefonu - wtedy musi on zawsze logować się przy pomocy weryfikacji dwuetapowej, gdzie mamy wrażenie, że aplikacja nie wymaga, aż takich zabezpieczeń.\nNiestety nie jest to możliwe do zrobienia inaczej przy użyciu firebase, w Volunteering weryfikacja działa na zasadzie właczenia weryfikacji dwuetapowej (MFA) z numerem telefonu, a przy okazji użytkownik jest zmieniany na zweryfikowanego.\nAlternatywą do tego rozwiązania mogłoby być użycie Twillio/verify, aczkolwiek to też nie jest idealne rozwiązanie, gdyż wymagałoby to dodatkowych kosztów.\n\n## Przyszłość\n\nMamy mnóstwo pomysłow na kolejne funkcjonalności strony, ale ze względu na ograniczony czas, nie jesteśmy w stanie wszystkich dodać - aczkolwiek dołożyliśmy wszelkich starań, aby strona była jak najlepsza i miała jak najwięcej funkcji urozmaicających jej działanie!\n\nW przyszłości można by dodać np.:\n- możliwość zbierania punktów za każdy wolontariat (np. 1 punkt za każdą godzinę wolontariatu)\n- możliwość wymiany punktów na nagrody\n- możliwość zdobywania poziomów\n\n## Instalacja\n\nAby uruchomić stronę lokalnie (używając yarna) należy:\n\n1. Pobrać repozytorium `git clone https://github.com/Style77/volunteering.git`\n2. Zainstalować wszystkie moduły `yarn install`\n3. Stworzyć plik `.env.local` i wkleić do niego:\n\n```env\n# Firebase\napiKey=\nauthDomain=\nprojectId=\nstorageBucket=\nmessagingSenderId=\nappId=\nmeasurementId=\n\n# Email.js\nemailJsServiceId=\nemailJsTemplateId=\nemailJsPublicKey=\n```\n\n4. Uruchomić stronę `yarn dev`\n\n## Technologie\n\n- [Next.js](https://nextjs.org/)\n- [React](https://reactjs.org/)\n- [Tailwind CSS](https://tailwindcss.com/)\n- [Firebase](https://firebase.google.com/) (Firestore, Authentication, Storage)\n- [Email.js](https://www.emailjs.com/)\n- [Vivid Studio](https://vivid.lol/)\n- [Luxon](https://moment.github.io/luxon/)\n- [Fuse.js](https://fusejs.io/)\n\n##### LINT\n- [Yarn](https://yarnpkg.com/)\n- [CodeFactor](https://www.codefactor.io/)\n- [ESLint](https://eslint.org/)\n- [Prettier](https://prettier.io/)\n\ni wiele innych pomniejszych technologi!\n\n## System odznak\n\nPo wolontariacie, organizator może zaznaczyć w panelu dla [organizatorów](https://volunteering.pl/dashboard), że wolontariusz wziął udział w wolontariacie. Wolontariusze przez branie udziału w różnorakich wolontariatach zdobywają odznaki, które są widoczne na stronie [organizatorów](https://volunteering.pl/profile).\n\n**Lista odznak:**\n\n**Dla wolontariuszy**\n\n\u003cdetails\u003e\n\u003csummary\u003e\"Pierwszy krok\"\u003c/summary\u003e \n- za pierwszy udział w wolontariacie\n\u003c/details\u003e\n\u003cdetails\u003e\n\u003csummary\u003e\"Wolontariusz\"\u003c/summary\u003e\n- za udział w 5 wolontariatach\n\u003c/details\u003e\n\u003cdetails\u003e\n\u003csummary\u003e\"Wolontariusz doświadczony\"\u003c/summary\u003e\n- za udział w 10 wolontariatach\n\u003c/details\u003e\n\u003cdetails\u003e\n\u003csummary\u003e\"Wolontariusz profesjonalny\"\u003c/summary\u003e\n- za udział w 20 wolontariatach\n\u003c/details\u003e\n\u003cdetails\u003e\n\u003csummary\u003e\"Wolontariusz ekspert\"\u003c/summary\u003e\n- za udział w 50 wolontariatach\n\u003c/details\u003e\n\u003cdetails\u003e\n\u003csummary\u003e\"Wolontariusz mistrz\"\u003c/summary\u003e\n- za udział w 100 wolontariatach\n\u003c/details\u003e\n\n**Dla organizatorów**\n\n\u003cdetails\u003e\n\u003csummary\u003e\"Organizator\"\u003c/summary\u003e\n- za utworzenie pierwszego wolontariatu\n\u003c/details\u003e\n\u003cdetails\u003e\n\u003csummary\u003e\"Organizator doświadczony\"\u003c/summary\u003e\n- za utworzenie 5 wolontariatów\n\u003c/details\u003e\n\n## Autorzy\n\n- [Joachim Hodana](https://github.com/Style77)\n- [Bartek Kluska](https://github.com/kluczi)\n\n## Licencja\n\n[MIT](https://choosealicense.com/licenses/mit/)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstyle77%2Fvolunteering","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstyle77%2Fvolunteering","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstyle77%2Fvolunteering/lists"}