lean04-sp

[leanhvie]

Pal Pad

Uživatelé budou moci vyhledávat karty Pokemon TCG a procházet decky vytvořené uživateli. Registrovaní uživatelé budou moci vyhledávat karty Pokémon TCG a ukládat je do vlastní sbírky, kde budou moci vyhledávat a filtrovat svou sbírku. Kromě toho mohou v aplikaci také vytvářet decky. Administrátor bude moci spravovat uživatelská data registrovaných uživatelů.

Popis funkcionalit

Funkce pro všechny uživatele:

• Vyhledávání karet:
  • Uživatelé budou moci vyhledávat karty Pokemon TCG.
• Procházení decků:
  • Uživatelé budou moci procházet decky vytvořené jinými uživateli.

Funkce pro registrované uživatele:

• Ukládání karet do sbírky:
  • Registrovaní uživatelé budou moci ukládat vyhledané karty do vlastní sbírky.
• Správa sbírky:
  • Uživatelé budou moci vyhledávat a filtrovat karty ve své sbírce.
• Vytváření decků:
  • Registrovaní uživatelé budou moci v aplikaci vytvářet vlastní decky.

Funkce pro administrátora:

• Správa uživatelských dat:
  • Administrátor bude moci spravovat uživatelská data registrovaných uživatelů.

Architektura

• webový server (Apache)
• backend (PHP 8+)
• databáze (MySQL)
• frontend (Typescript, React)
• návrhový vzor MVC, (PHP pro model a controller, React pro view)

Frontend bude odesílat požadavky na server PHP voláním příslušného endpointu s příslušnými metodami HTTP v rámci serveru Apache.

Wireframe

Use case diagram

Sequence diagram (hlavní funkcionality)

Database model

Diagram

DBML

Table users {
  id string [pk]
  username string
  email string
  password string
  privilege number
}

Table cards {
  id string [pk]
  name string
  supertype string
  type string
  subtype string
  hp number
  set_id string [ref: > card_sets.id]
  image_small_url string
  image_large_url string
}

Table card_sets {
  id string [pk]
  name string
  symbol_url string
  logo_url string
}

Table users_cards {
  Primary Key (user_id, card_id)
  user_id string [ref: > users.id]
  card_id string [ref: > cards.id]
  count number
}

Table decks {
  id string [pk]
  owner_id string
  name string
  created_at datetime
  updated_at datetime
}

Ref: decks.owner_id > users.id [delete: cascade]

Table decks_cards {
  Primary Key (deck_id, card_id)
  deck_id string
  card_id string
  count number
}

Ref: decks_cards.deck_id > decks.id [delete: cascade]
Ref: decks_cards.card_id > cards.id [delete: cascade]

Checklist

Kategorie	Požadavek	splnění	spolehlivost	komentář
Databáze	M:N vztahy	x
	1:N vztahy	x
	SQL joins	x
	Integritní omezení	x
	Testovací data	x
----------------------------	-------------------------------------------------	---------	--------------	----------
Validace a sanitace vstupů	Formuláře	x
	Datové typy	x
	Regulární výrazy
	Serverová validace požadavků	x
----------------------------	-------------------------------------------------	---------	--------------	----------
Psaní kódu	Potlačení warningů - nedefinované hodnoty
	Formátování kódu	x
	DRY princip - minimalizace opakování kódu	x
	SRP princip - single responsibility	x
	Pojmenování proměnných	x
	Konzistence stylu psaní kódu	x
	Verzování kódu (Git)	x
	HTML5 validní + sémantické značky	x
----------------------------	-------------------------------------------------	---------	--------------	----------
Objektové programování	Zapouzdření	x
	Dědičnost	x
	Abstrakce	x
	Rozhraní	x
	Polymorfismus	x
	Magické metody	x
----------------------------	-------------------------------------------------	---------	--------------	----------
Připojení k databázi	PDO	x
	Prepared statement	x
	SQL injection
----------------------------	-------------------------------------------------	---------	--------------	----------
Performance	Stránkování	x
	Indexace databázových tabulek	x
	Filtrace a organizování zdrojů	x
	Cache (mezipaměť)
----------------------------	-------------------------------------------------	---------	--------------	----------
Autentifikace	Cookies	x
	Session	x
	Lokální strategie pro registraci a přihlášení	x
	OAuth, access token, login	x
	Ukládánní hesel	x
	Uživatelská oprávnění	x
	Uživatelské role	x
----------------------------	-------------------------------------------------	---------	--------------	----------
Datum a čas	Časové pásmo	x
	Formátování časových hodnot	x
----------------------------	-------------------------------------------------	---------	--------------	----------
Návrhové vzory	Model	x
	View	x
	Controller	x
----------------------------	-------------------------------------------------	---------	--------------	----------
Bezpečnost	XSS	x
	CSRF	x
	SQL injection	x
----------------------------	-------------------------------------------------	---------	--------------	----------
API	CRUD operace	x
	HTTP metody	x
	Sémantické pojmenování zdrojů	x
	Verzování
	Idempotence
----------------------------	-------------------------------------------------	---------	--------------	----------
Provoz a údržba	Sledovatelnost a logování
	SEO URL
	Víceuživatelský přístup k datům
----------------------------	-------------------------------------------------	---------	--------------	----------
Funkcionality	Generování souborů PDF
	Posílání e-mailů
	Oddělení administrační a uživatelské části	x
----------------------------	-------------------------------------------------	---------	--------------	----------
Testování	Testovací scénáře pro manuální testování
	Dostupnost aplikace na internetu	x

[nvbach91]

• prejmenovat tabulku sets na card_sets
• proc maji primarni klice (vcetne jejich referenci) vsech tabulek datovy typ string?

[leanhvie]

• prejmenovat tabulku sets na card_sets
• proc maji primarni klice (vcetne jejich referenci) vsech tabulek datovy typ string?

• Tabulka prejmenovana z sets na card_sets
• Preferuju pouzit GUID misto INT a tabulky cards a card_sets budou mit data nastaveny z Pokemon TCG API kde jejich ID je taky ve stringu. Datovy typ IDcek bych chtel mit konzistentni napric vsech tabulek.