Strona projektu thankswithbeer.com (t)

Gabriela Pasek, Leszek Piątek, Michał Paszko

Projekt stanowi podstawę bazodanową dla projektu realizowanego z przedmiotu Technologie i Programowanie WWW.

Celem projektu jest stworzenie serwisu, który umożliwiałby podziękowanie jego użytkownikowi piwem. Wielu internautów poszukuje w sieci pomocy, rozwiązania problemów za pośrednictwem forów czy blogów. Po uzyskaniu przydatnej odpowiedzi nasuwa się często potrzeba odwdzięczenia się danemu użytkownikowi w innej formie niż tekstowa. W życiu codziennym taką formą najczęściej jest postawienie piwa, więc dlaczego nie przenieść tego zwyczaju w sferę Internetu?

Użytkownik zarejestrowany w serwisie będzie posiadał swój profil, zawierający między innymi informacje o ulubionych gatunkach piwa. Podziękowanie będzie miało formę podwyższenia 'stanu zapiwienia', który w wizualnej formie może uatrakcyjniać np. podpis na forum. Dzięki temu dany użytkownik będzie łatwo identyfikowany jako osoba, która chętnie udziela pomocy, posiada wiedzę z pewnej dziedziny, co stanowi oznakę prestiżu w społeczności internetowej.

Wykorzystanie informacji z branży piwnej stwarza potencjalne możliwości zarobku związane z reklamą producentów napojów alkoholowych i ich produktów. Ponadto serwis może być sponsorowany przez firmy z branży zainteresowane współpracą.

Obecnie nie ma podobnych rozwiązań umożliwiających wyrażenie podziękowania za pomoc. Istnieją pluginy do darmowych forów internetowych (phpBB, invisionPowerBoard), które pozwalają na przyznanie tzw. „pomuków” dla użytkownika. Punkty te pokazują ile razy dany użytkownik okazał się pomocny. Funkcjonują jednak tylko w obrębie danego forum i są widoczne jedynie dla zarejestrowanych na nim osób, a więc wąskiej grupy Internautów. Nie ma uniwersalnego systemu punktacji, który pozwalałby na zebranie punktów z wielu serwisów i przedstawienie ich w przystępnej formie. Ponadto punkty nie stanowią atrakcyjnej formy podziękowania i w zasadzie pozostają mało zauważalne.

Serwis thankswithbeer.com będzie działał na zasadzie systemu z obsługą kont użytkowników - 'profilów piwoszy'. Ponadto będzie zawierał bibliotekę gatunków piwa na bieżąco uzupełnianą przez użytkowników.

Główne funkcjonalności (Must have):

• wielojęzyczność - serwis powinien posiadać kilka wersji językowych, na początek polską i angielską
• możliwość dodawania i edycji biblioteki piwa - funkcjonalność powinna pozwalać na dodanie opisu produktu, zdjęcia i ceny oraz edycję tych danych
• sugerowanie wpisów w bibliotece piwa - każdy użytkownik może zasugerować nowe lub uzupełnić opis / zdjęcia istniejącego piwa
• moderacja - specjalne uprawnienie dla użytkownika, które będzie umożliwiało akceptowanie bądź nie sugerowanych wpisów w bibliotece piwa
• zakładanie profilu piwosza - powinno pozwalać na wprowadzenie danych identyfikacyjnych (loginu i hasła, zdjęcia) oraz określenie lubianych i nielubianych gatunków piwa
• możliwość generowania elementu graficznego przedstawiającego aktualny 'stan zapiwienia' do osadzania w podpisach na forach, stopkach blogów itp.
• unikalny link do profilu piwosza, służący do integracji z popularnymi serwisami społecznościowymi - np. facebook, wykop.pl, grono.net, nasza-klasa.pl

Dodatkowe funkcjonalności (Could have):

• polecanie piw - użytkownicy mogą polecać sobie nawzajem produkty znajdujące się w bibliotece piwa na zasadzie wysyłania wiadomości z odnośnikiem do opisu
• sugerowanie piw innych piwoszy - system może generować listę sugerowanych produktów dla użytkownika na podstawie podobieństw z profilami innych użytkowników
• stawianie „mniej wirtualnego” piwa - wpłaty na konto PayPal użytkownika kwot pozwalających na zakup wybranego produktu z biblioteki piwa, % z transakcji dla portalu

Moduły:

1. użytkownicy
   • rejestracja
   • logowanie
     • przypominanie hasła
   • panel ustawień użytkownika
     • możliwość wybrania grafik do podpisów oraz pobrania kodu do podpisu
     • dodawanie/edycja ulubionych piw
     • dodawanie/edycja nielubianych piw
   • moderacja bazy piw
     • akceptacja bądź odrzucenie wpisów
   • profil użytkownika
     • graficzne przedstawienie stanu zapiwienia
     • graficzna prezentacja lubianych piw
     • graficzna prezentacja nielubianych piw
     • graficzny przycisk „podziękuj piwem”
2. administracja
   • zarządzanie użytkownikami
   • zarządzanie grupami i uprawnieniami
   • zarządzanie biblioteką piw
3. biblioteka piw
   • przeglądanie zdjęć i opisów wpisów
   • wyszukiwarka
   • poprawianie i sugerowanie tłumaczeń, dodawanie nowych obrazków do galerii piw

1. Scenariusze dla Użytkownika\Gościa:
   1. Dostęp do serwisu:
      • Rejestracja w systemie
   2. Wyszukiwanie użytkowników:
      • Wyszukanie użytkownika
      • Przeglądnie profilu użytkownika
   3. Przeglądanie treści serwisu:
      • Wyszukanie informacji na temat piwa
   4. Główne funkcjonalności:
      • 'Postawienie' piwa za pozytywny wpis na forum
2. Scenariusze dla Użytkownika:
   1. Dostęp do serwisu:
      • Zalogowanie do systemu
      • Przypomnienie hasła użytkownika
   2. Zarządzanie kontem:
      • Zmiana danych użytkownika
      • Zmiana grafiki do podpisów
      • Pobranie kodu do podpisu
      • Dodawanie/edycja lubianych/nielubianych piw
3. Scenariusze dla Administratora:
   1. Zarządzanie użytkownikami:
      • Zmiana danych (statusu) użytkownika
      • Usuwanie użytkownika
   2. Zarządzanie grupami i uprawnieniami:
      • Zmiana uprawnień grupy
      • Zmiana uprawnień użytkownika
   3. Zarządzanie treścią serwisu:
      • Moderacja biblioteki piw

• Logowanie/wylogowywanie z serwisu
• Dodanie/usunięcie/modyfikacja konta użytkownika
• Dodanie/usunięcie/modyfikacja informacji o piwach oraz browarach
• Wybór preferowanych oraz nie preferowanych piw przez użytkownika
• Modyfikacja stanu zapiwienia użytkownika
• Generowanie elementu graficznego przedstawiającego stan zapiwienia
• Moderacja (uprawnienie dla użytkownika) wpisów w bibliotece piwa
• Stworzenie unikalnego linku do profilu piwosza
• *Polecanie piw innym użytkownikom
• *Sugerowanie piw innych piwoszy na podstawie statystyk użytkowników
• *Stawianie mniej wirtualnego piwa w postaci wpłat na konto PayPal
• Backup bazy danych

* - funkcjonalności o mniejszym priorytecie

BEER

• name (VARCHAR)
• desc* (TEXT)
• status* (boolean, czy piwo zaakceptowane w danym języku czy nie)
• brewery (FK, BREWERY)
• price_eur (Float(10)) - cena za 0,5
• gallery (FK, GALLERY)

LOVEDBEERS

• user (FK, USER)
• beer (FK, BEER)
• rating (FK, LOVEDBEERRATING)

HATEDBEERS

• user (FK, USER)
• beer (FK, BEER)
• rating (FK, HATEDBEERRATING)

LOVEDBEERRATING

• name * (VARCHAR)
• value (int(2))

HATEDBEERRATING

• name * (VARCHAR)
• value (int(2))

BREWERY

• name (VARCHAR 150)
• desc* (TEXT)
• status* (boolean, czy browar zaakceptowane w danym języku czy nie)
• brewery_owner (FK, BREWERY_OWNER)

BREWERY_OWNER

• name (VARCHAR 150)
• desc* (TEXT)
• status* (boolean, czy właściciel zaakceptowany w danym języku czy

nie)

BEERING

• who (FK, USER, null=True)
• whom (FK, USER)
• beer (FK, BEER)
• size (ENUM)
• referrer (VARCHAR 255, NULL=True)
• comment (VARCHAR 160, NULL=True)
• timestamp (datetime lub unix_timestamp)
• ip (VARCHAR)

Uwagi: Tabele USER, GROUP, PERMS, GALLERY i IMAGE wykorzystujemy jako wbudowane modele framework'a Django.

MtM = many to many

FK = Foreign Key

*=pola wielojęzykowe

BEGIN;
CREATE TABLE "beers_breweryownercontent" (
    "id" serial NOT NULL PRIMARY KEY,
    "model_id" INTEGER NOT NULL,
    "language_id" INTEGER NOT NULL REFERENCES "multilanguage_language" ("id") DEFERRABLE INITIALLY DEFERRED,
    "desc" text NOT NULL,
    "status" BOOLEAN NOT NULL
)
;
CREATE TABLE "beers_breweryowner" (
    "id" serial NOT NULL PRIMARY KEY,
    "name" VARCHAR(150) NOT NULL,
    "brewery_owner_id" INTEGER
)
;
ALTER TABLE "beers_breweryownercontent" ADD CONSTRAINT "model_id_refs_id_598fc7fb" FOREIGN KEY ("model_id") REFERENCES "beers_breweryowner" ("id") DEFERRABLE INITIALLY DEFERRED;
ALTER TABLE "beers_breweryowner" ADD CONSTRAINT "brewery_owner_id_refs_id_3d4e3b7b" FOREIGN KEY ("brewery_owner_id") REFERENCES "beers_breweryowner" ("id") DEFERRABLE INITIALLY DEFERRED;
CREATE TABLE "beers_brewerycontent" (
    "id" serial NOT NULL PRIMARY KEY,
    "model_id" INTEGER NOT NULL,
    "language_id" INTEGER NOT NULL REFERENCES "multilanguage_language" ("id") DEFERRABLE INITIALLY DEFERRED,
    "desc" text NOT NULL,
    "status" BOOLEAN NOT NULL
)
;
CREATE TABLE "beers_brewery" (
    "id" serial NOT NULL PRIMARY KEY,
    "name" VARCHAR(150) NOT NULL,
    "brewery_owner_id" INTEGER REFERENCES "beers_breweryowner" ("id") DEFERRABLE INITIALLY DEFERRED
)
;
ALTER TABLE "beers_brewerycontent" ADD CONSTRAINT "model_id_refs_id_2e86a681" FOREIGN KEY ("model_id") REFERENCES "beers_brewery" ("id") DEFERRABLE INITIALLY DEFERRED;
CREATE TABLE "beers_beercontent" (
    "id" serial NOT NULL PRIMARY KEY,
    "model_id" INTEGER NOT NULL,
    "language_id" INTEGER NOT NULL REFERENCES "multilanguage_language" ("id") DEFERRABLE INITIALLY DEFERRED,
    "desc" text NOT NULL,
    "status" BOOLEAN NOT NULL
)
;
CREATE TABLE "beers_beer" (
    "id" serial NOT NULL PRIMARY KEY,
    "name" VARCHAR(150) NOT NULL,
    "brewery_id" INTEGER NOT NULL REFERENCES "beers_brewery" ("id") DEFERRABLE INITIALLY DEFERRED,
    "price_eur" DOUBLE PRECISION NOT NULL,
    "lovers" INTEGER NOT NULL,
    "haters" INTEGER NOT NULL,
    "logo" VARCHAR(100) NOT NULL,
    "bottle" VARCHAR(100),
    "glass" VARCHAR(100)
)
;
ALTER TABLE "beers_beercontent" ADD CONSTRAINT "model_id_refs_id_38ce73d1" FOREIGN KEY ("model_id") REFERENCES "beers_beer" ("id") DEFERRABLE INITIALLY DEFERRED;
CREATE TABLE "beers_hatedbeerratingcontent" (
    "id" serial NOT NULL PRIMARY KEY,
    "model_id" INTEGER NOT NULL,
    "language_id" INTEGER NOT NULL REFERENCES "multilanguage_language" ("id") DEFERRABLE INITIALLY DEFERRED,
    "name" VARCHAR(100) NOT NULL
)
;
CREATE TABLE "beers_hatedbeerrating" (
    "id" serial NOT NULL PRIMARY KEY,
    "value" INTEGER NOT NULL
)
;
ALTER TABLE "beers_hatedbeerratingcontent" ADD CONSTRAINT "model_id_refs_id_110e7a67" FOREIGN KEY ("model_id") REFERENCES "beers_hatedbeerrating" ("id") DEFERRABLE INITIALLY DEFERRED;
CREATE TABLE "beers_hatedbeer" (
    "id" serial NOT NULL PRIMARY KEY,
    "user_id" INTEGER NOT NULL REFERENCES "auth_user" ("id") DEFERRABLE INITIALLY DEFERRED,
    "beer_id" INTEGER NOT NULL REFERENCES "beers_beer" ("id") DEFERRABLE INITIALLY DEFERRED,
    "rating_id" INTEGER NOT NULL REFERENCES "beers_hatedbeerrating" ("id") DEFERRABLE INITIALLY DEFERRED
)
;
CREATE TABLE "beers_lovedbeerratingcontent" (
    "id" serial NOT NULL PRIMARY KEY,
    "model_id" INTEGER NOT NULL,
    "language_id" INTEGER NOT NULL REFERENCES "multilanguage_language" ("id") DEFERRABLE INITIALLY DEFERRED,
    "name" VARCHAR(100) NOT NULL
)
;
CREATE TABLE "beers_lovedbeerrating" (
    "id" serial NOT NULL PRIMARY KEY,
    "value" INTEGER NOT NULL
)
;
ALTER TABLE "beers_lovedbeerratingcontent" ADD CONSTRAINT "model_id_refs_id_4fbf0e87" FOREIGN KEY ("model_id") REFERENCES "beers_lovedbeerrating" ("id") DEFERRABLE INITIALLY DEFERRED;
CREATE TABLE "beers_lovedbeer" (
    "id" serial NOT NULL PRIMARY KEY,
    "user_id" INTEGER NOT NULL REFERENCES "auth_user" ("id") DEFERRABLE INITIALLY DEFERRED,
    "beer_id" INTEGER NOT NULL REFERENCES "beers_beer" ("id") DEFERRABLE INITIALLY DEFERRED,
    "rating_id" INTEGER NOT NULL REFERENCES "beers_lovedbeerrating" ("id") DEFERRABLE INITIALLY DEFERRED
)
;
CREATE TABLE "beers_beersize" (
    "id" serial NOT NULL PRIMARY KEY,
    "size" DOUBLE PRECISION NOT NULL
)
;
CREATE TABLE "beers_beering" (
    "id" serial NOT NULL PRIMARY KEY,
    "who_id" INTEGER REFERENCES "auth_user" ("id") DEFERRABLE INITIALLY DEFERRED,
    "whom_id" INTEGER NOT NULL REFERENCES "auth_user" ("id") DEFERRABLE INITIALLY DEFERRED,
    "beer_id" INTEGER NOT NULL REFERENCES "beers_beer" ("id") DEFERRABLE INITIALLY DEFERRED,
    "beer_size_id" INTEGER NOT NULL REFERENCES "beers_beersize" ("id") DEFERRABLE INITIALLY DEFERRED,
    "referrer" VARCHAR(255) NOT NULL,
    "comment" VARCHAR(160) NOT NULL,
    "timestamp" TIMESTAMP WITH TIME zone NOT NULL,
    "ip" VARCHAR(15) NOT NULL
)
;
CREATE TABLE "auth_permission" (
    "id" serial NOT NULL PRIMARY KEY,
    "name" VARCHAR(50) NOT NULL,
    "content_type_id" INTEGER NOT NULL REFERENCES "django_content_type" ("id") DEFERRABLE INITIALLY DEFERRED,
    "codename" VARCHAR(100) NOT NULL,
    UNIQUE ("content_type_id", "codename")
)
;
CREATE TABLE "auth_group" (
    "id" serial NOT NULL PRIMARY KEY,
    "name" VARCHAR(80) NOT NULL UNIQUE
)
;
CREATE TABLE "auth_user" (
    "id" serial NOT NULL PRIMARY KEY,
    "username" VARCHAR(30) NOT NULL UNIQUE,
    "first_name" VARCHAR(30) NOT NULL,
    "last_name" VARCHAR(30) NOT NULL,
    "email" VARCHAR(75) NOT NULL,
    "password" VARCHAR(128) NOT NULL,
    "is_staff" BOOLEAN NOT NULL,
    "is_active" BOOLEAN NOT NULL,
    "is_superuser" BOOLEAN NOT NULL,
    "last_login" TIMESTAMP WITH TIME zone NOT NULL,
    "date_joined" TIMESTAMP WITH TIME zone NOT NULL
)
;
CREATE TABLE "auth_message" (
    "id" serial NOT NULL PRIMARY KEY,
    "user_id" INTEGER NOT NULL REFERENCES "auth_user" ("id") DEFERRABLE INITIALLY DEFERRED,
    "message" text NOT NULL
)
;
CREATE TABLE "auth_group_permissions" (
    "id" serial NOT NULL PRIMARY KEY,
    "group_id" INTEGER NOT NULL REFERENCES "auth_group" ("id") DEFERRABLE INITIALLY DEFERRED,
    "permission_id" INTEGER NOT NULL REFERENCES "auth_permission" ("id") DEFERRABLE INITIALLY DEFERRED,
    UNIQUE ("group_id", "permission_id")
)
;
CREATE TABLE "auth_user_groups" (
    "id" serial NOT NULL PRIMARY KEY,
    "user_id" INTEGER NOT NULL REFERENCES "auth_user" ("id") DEFERRABLE INITIALLY DEFERRED,
    "group_id" INTEGER NOT NULL REFERENCES "auth_group" ("id") DEFERRABLE INITIALLY DEFERRED,
    UNIQUE ("user_id", "group_id")
)
;
CREATE TABLE "auth_user_user_permissions" (
    "id" serial NOT NULL PRIMARY KEY,
    "user_id" INTEGER NOT NULL REFERENCES "auth_user" ("id") DEFERRABLE INITIALLY DEFERRED,
    "permission_id" INTEGER NOT NULL REFERENCES "auth_permission" ("id") DEFERRABLE INITIALLY DEFERRED,
    UNIQUE ("user_id", "permission_id")
)
;
CREATE TABLE "multilanguage_language" (
    "id" serial NOT NULL PRIMARY KEY,
    "code" VARCHAR(5) NOT NULL,
    "name" VARCHAR(16) NOT NULL
)
;
COMMIT;

W projekcie zastosowaliśmy ulepszone rozwiązanie multilingualmodel. Ulepszenie polegało głównie na lepszej integracji z wbudowanym panelem administracyjnym Django.

Całość działania systemu wielojęzykowego obrazuje przykładowy diagram ERD:

Na obrazku widzimy encję BEERS_BEER (unikalny wpis w bazie, który przechowuje główne informacje dla encji - informacje nie związane z językiem). Dla encji tej mamy powiązanie FK (model_id) w encji BEERS_BEERCONTENT, które zawiera pola do tłumaczenia - w przykładzie jedynie pole DESC i STATUS są tymi polami.

Do całości brakuje jeszcze przyporządkowania języka dla danego wpisu w tabeli *CONTENT - zupełnie osobna encją MULTILANGUAGE_LANGUAGE.

Takie podwójne tworzenie modeli (jeden podstawowy oraz drugi z powiązany z tłumaczeniami pól) stosujemy dla każdej encji wielojęzycznej. Dzięki takiemu rozwiązaniu możemy dodawać kolejne wersje językowe bez konieczności definiowania ich z góry - nic nie stoi na przeszkodzie aby dodać nowy język do tabeli MULTILANGUAGE_LANGUAGE, a następnie dodać wpis w BEERS_BEERCONTENT

Aby zachować spójność danych można dodać jeszcze klucz UNIQUE(language, model_id) do każdego modelu *CONTENT, dzięki czemu na 100% nie będziemy mieli 2 wersji tłumaczeń tego samego języka.