Góra dobra

Oficjalny serwis internetowy prezentujący wolontariuszy i ich pracę w przygotowaniach do Światowych Dni Młodzieży w Krakowie w 2016 roku, tworzony na zlecenie sekcji wolontariatu ŚDM.

Masz pytanie? Nie wiesz jak się zaangażować? Zapraszamy do dyskusji na:

Wizja

Naszym celem jest budowa narzędzia, które pomaga pomagać. Serwis będzie pełnił 3 funkcje:

• Administracyjną - jako narzędzie dla koordynatorów dające im wgląd w bazę danych wolontariuszy oraz jako warstwa autoryzacji dla aplikacji mobilnej dla wolontariuszy.
• Promocyjną - jako platforma promująca wolontariuszy jako ludzi aktywnych.
• Organizacyjną - jako baza zadań do wykonania przez wolontariuszy w ramach wolontariatu.

Aby to osiągnąć potrzebujemy dwóch stref: publicznej i o ograniczonej dostępności. Widoczne dla wszystkich będą profile najbardziej aktywnych wolontariuszy mających realny wpływ na przebieg przygotowań do ŚDM w Krakowie. Z drugiej strony, po zalogowaniu, użytkownicy z odpowiednimi przywilejami (koordynatorzy i wolontariusze) otrzymają dostęp do poufnych danych, które będą im niezbędne przy wykonywaniu swoich zadań.

Kontrybucje

Ponieważ kod jest otwarty, nie ma ograniczeń co do tego kto może zaproponować zmiany w kodzie. Aby to zrobić należy przestrzegać prostych zasad.

Proponowanie zmian

• Dokonaj zmian na gałęzi tematycznej na swojej kopii repozytorium.
• Otwórz Pull Request w projekcie organizacji Krakow2016.
• Poczekaj na przegląd Twoich zmian przez jednego z członków zespołu.
• W zależności od oceny zmian, Twoja propozycja może wymagać dalszych zmian lub od razu zostać zaakceptowana lub odrzucona.

Zgłaszanie błędów

Zgłaszanie, dyskusja i rozwiązywanie błędów w aplikacji odbywa się przez stronę Issues.

Uruchomienie (zalecane)

Jedyne wymaganie to zainstalowany Docker i Docker Compose. Następnie należy pobrać plik konfiguracyjny docker-compose.yml. Uruchomienie (i wcześniejsze pobranie w przypadku gdy ich brak w systemie) wszystkich serwisów (kontenerów Dockera) odbywa się za pomocą komendy:

docker-compose -f docker-compose.yml up

Po wykonaniu wszystkich czynności strona www będzie dostępna na hoście localhost na porcie 8000.

Uruchomienie (zaawansowane)

Pierwszy raz

Aby pobrać kod aplikacji wykonaj komendę git, która skopiuje cały kod wraz z całą historią zmian na Twój lokalny komputer:

$ git clone https://github.com/Krakow2016/wolontariusze.git && cd wolontariusze/

Kod aplikacji jest w całości pisany w języku JavaScript i uruchamiany w środowisku Node.js. Aby zainstalować to środowisko w najnowszej wersji podążaj za wskazówkami na stronie iojs.org. Upewnij się, że instalacja przebiegła poprawnie wykonując polecenie:

$ node --version
v5.3.0

Wraz z poleceniem node zainstalowane zostanie narzędzie do zarządzania zależnościami npm.

$ npm --version
3.5.3

Baza danych

Zainstaluj bazę danych RethinkDB według instrukcji.

Serwer www

Przed uruchomieniem serwera www, upewnij się że masz zainstalowane wszystkie zależności. Aby to zrobić wykonaj polecenie:

$ npm install

W kolejnym kroku musisz utworzyć plik konfiguracyjny config.json. Wykorzystaj plik config.json.example jako szablon, który zawiera wcześniej zdefiniowane ustawienia dla naszego projektu.

W pliku konfiguracyjnym możesz zdefiniować m.in. adres do bazy danych i port na którym ma zostać uruchomiony serwer www.

Następnie wykonaj komendę:

$ node dev.js

i skieruj się pod adres http://127.0.0.1:7000. Powinieneś teraz zobacz stronę główną naszego serwisu. A teraz czas na programowanie :)

Testy

Testy wykonywane są standardową komendą $ npm test, kóra uruchamia narzędzie Jasmine. Wszyskie testy znajdują się w katalogu spec/.

Licencja MIT

Niniejszym gwarantuje się, bez opłat, że każda osoba, która wejdzie w posiadanie kopii tego oprogramowania i związanych z nim plików dokumentacji (dalej "Oprogramowanie") może wprowadzać do obrotu Oprogramowanie bez żadnych ograniczeń, w tym bez ograniczeń prawa do użytkowania, kopiowania, modyfikowania, łączenia, publikowania, dystrybuowania, sublicencjonowania i/lub sprzedaży kopii Oprogramowania a także zezwalania osobie, której Oprogramowanie zostało dostarczone czynienia tego samego, z zastrzeżeniem następujących warunków:

Powyższa nota zastrzegająca prawa autorskie oraz niniejsza nota zezwalająca muszą zostać włączone do wszystkich kopii lub istotnych części Oprogramowania.

OPROGRAMOWANIE JEST DOSTARCZONE TAKIM, JAKIE JEST, BEZ JAKIEJKOLWIEK GWARANCJI, WYRAŹNEJ LUB DOROZUMIANEJ, NIE WYŁĄCZAJĄC GWARANCJI PRZYDATNOŚCI HANDLOWEJ LUB PRZYDATNOŚCI DO OKREŚLONYCH CELÓW A TAKŻE BRAKU WAD PRAWNYCH. W ŻADNYM PRZYPADKU TWÓRCA LUB POSIADACZ PRAW AUTORSKICH NIE MOŻE PONOSIĆ ODPOWIEDZIALNOŚCI Z TYTUŁU ROSZCZEŃ LUB WYRZĄDZONEJ SZKODY A TAKŻE ŻADNEJ INNEJ ODPOWIEDZIALNOŚCI CZY TO WYNIKAJĄCEJ Z UMOWY, DELIKTU, CZY JAKIEJKOLWIEK INNEJ PODSTAWY POWSTAŁEJ W ZWIĄZKU Z OPROGRAMOWANIEM LUB UŻYTKOWANIEM GO LUB WPROWADZANIEM GO DO OBROTU.