From b59a14e165dc10ed2c6649d42b70f8a76e24fe75 Mon Sep 17 00:00:00 2001 From: Elide Babic Date: Fri, 20 Nov 2026 17:10:03 +0100 Subject: [PATCH 1/2] =?UTF-8?q?Dijagrami=20obrazaca=20uporabe=203.1,=20pre?= =?UTF-8?q?ure=C4=91en=20dijagram=20razreda=204.3.2=20i=20Dodatak=20A=20(E?= =?UTF-8?q?B)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/3-Obrasci-uporabe.md | 145 +++------ docs/A-Pregled-aktivnosti-grupe.md | 17 +- docs/Home.md | 15 +- .../diagrams/3-1-crisismap-system-UC.svg | 1 - docs/assets/diagrams/3-1-unideal-admin-UC.svg | 1 + .../diagrams/3-1-unideal-partner-UC.svg | 1 + .../diagrams/3-1-unideal-pregled-UC.svg | 1 + .../diagrams/3-1-unideal-prijava-UC.svg | 1 + .../diagrams/3-1-unideal-student-UC.svg | 1 + .../assets/diagrams/4-3-unideal-domain-CD.svg | 2 +- docs/puml/3-1-crisismap-system-UC.puml | 160 ---------- docs/puml/3-1-unideal-admin-UC.puml | 61 ++++ docs/puml/3-1-unideal-partner-UC.puml | 64 ++++ docs/puml/3-1-unideal-pregled-UC.puml | 63 ++++ docs/puml/3-1-unideal-prijava-UC.puml | 62 ++++ docs/puml/3-1-unideal-student-UC.puml | 71 +++++ docs/puml/4-3-unideal-domain-CD.puml | 283 ++++++++++-------- 17 files changed, 554 insertions(+), 395 deletions(-) delete mode 100644 docs/assets/diagrams/3-1-crisismap-system-UC.svg create mode 100644 docs/assets/diagrams/3-1-unideal-admin-UC.svg create mode 100644 docs/assets/diagrams/3-1-unideal-partner-UC.svg create mode 100644 docs/assets/diagrams/3-1-unideal-pregled-UC.svg create mode 100644 docs/assets/diagrams/3-1-unideal-prijava-UC.svg create mode 100644 docs/assets/diagrams/3-1-unideal-student-UC.svg delete mode 100644 docs/puml/3-1-crisismap-system-UC.puml create mode 100644 docs/puml/3-1-unideal-admin-UC.puml create mode 100644 docs/puml/3-1-unideal-partner-UC.puml create mode 100644 docs/puml/3-1-unideal-pregled-UC.puml create mode 100644 docs/puml/3-1-unideal-prijava-UC.puml create mode 100644 docs/puml/3-1-unideal-student-UC.puml diff --git a/docs/3-Obrasci-uporabe.md b/docs/3-Obrasci-uporabe.md index 6fd7d00..68b9d9f 100644 --- a/docs/3-Obrasci-uporabe.md +++ b/docs/3-Obrasci-uporabe.md @@ -6,98 +6,35 @@ **Cilj:** Prikazati granicu sustava, relevantne aktere i njihove glavne ciljeve u **preglednom UML dijagramu obrazaca uporabe**. Ako je za razumijevanje pojedinog dijela sustava potrebno prikazati više detalja, taj dio izdvojite u dodatni usmjereni dijagram. Dodatni dijagrami trebaju produbiti dio preglednog modela, a ne stvarati nepovezane ili duplicirane prikaze istog sustava. -![Dijagram obrazaca uporabe sustava CrisisMap](./assets/diagrams/3-1-crisismap-system-UC.svg) +Slika 3.1 je pregledni dijagram: prikazuje aktere i glavne skupine ciljeva. Svaka skupina razrađena je u jednom od četiri usmjerena dijagrama (Slike 3.2 – 3.5) s pojedinačnim obrascima uporabe, kako bi svaki dijagram bio pregledan i da nijedan akter nema previše obrazaca uporabe. Aplikaciju koriste četiri uloge: posjetitelj, student, partner i administrator. Student je specijalizacija posjetitelja, pa uz svoje ciljeve može i sve što i posjetitelj (pretraga, karta i profil partnera). Vanjski sustavi (pružatelji identiteta, Google Maps API, Stripe i Resend) i vremenski okidač sudjeluju kao sekundarni akteri; Stripe je primarni akter obrasca UC-6.2 jer sam šalje obavijest o plaćanju. Nastavnik i asistent (D-01) dionici su koji ne koriste aplikaciju, pa nisu prikazani. Strelica od aktera prema obrascu uporabe označava aktera koji pokreće obrazac, a strelica od obrasca prema akteru vanjski sustav koji u njemu sudjeluje. Specifikacije svih obrazaca uporabe nalaze se u odjeljku 3.2. -**Slika 3.1. Dijagram obrazaca uporabe sustava CrisisMap** +![Pregledni dijagram obrazaca uporabe sustava UniDeal](./assets/diagrams/3-1-unideal-pregled-UC.svg) -**PlantUML izvor:** [izvor](./puml/3-1-crisismap-system-UC.puml) +**Slika 3.1. Pregled obrazaca uporabe sustava UniDeal** (izvor: [3-1-unideal-pregled-UC.puml](./puml/3-1-unideal-pregled-UC.puml)) -**Provjera dijagrama:** Prikažite prepoznate uloge koje **komuniciraju s aplikacijom**, a ne dionike koji s njom nemaju interakciju. Svaki glavni korisnički cilj mora imati pridruženog aktera; uključeni obrazac uporabe može se dosegnuti preko drugog obrasca uporabe bez vlastite izravne veze s akterom. `<>` i `<>` koristite samo kada odnos odgovara stvarnom ponašanju. +![Dijagram obrazaca uporabe za prijavu i profil](./assets/diagrams/3-1-unideal-prijava-UC.svg) -
-Primjer aktera i granica sustava +**Slika 3.2. Prijava i profil** (izvor: [3-1-unideal-prijava-UC.puml](./puml/3-1-unideal-prijava-UC.puml)) -**Opis primjera — CrisisMap:** +![Dijagram obrazaca uporabe za partnere i ponude](./assets/diagrams/3-1-unideal-partner-UC.svg) -Dijagram prikazuje **ogledni scenarij** s građaninom, posjetiteljem i koordinatorom pomoći te vanjskim pružateljem identiteta. Pružatelj identiteta sudjeluje u obrascu uporabe „Prijava u sustav” kao sekundarni akter: korisnik pokreće prijavu u aplikaciji, a vanjski sustav provodi autentikaciju. Budući da projekt koristi vanjskog pružatelja identiteta, ta se ovisnost prikazuje i u dijagramu obrazaca uporabe; tehnički detalji integracije pripadaju arhitekturnoj dokumentaciji. +**Slika 3.3. Partneri i ponude** (izvor: [3-1-unideal-partner-UC.puml](./puml/3-1-unideal-partner-UC.puml)) -**Odabir aktera i ciljeva:** Granica pokazuje što aplikacija nudi, akteri imaju različite ciljeve, a nijedan akter ni obrazac uporabe ne tvrdi da ova studentska aplikacija angažira hitne službe. Dijagram usporedite s odobrenim funkcijskim zahtjevima i akterima. +![Dijagram obrazaca uporabe za pretragu, kupone i recenzije](./assets/diagrams/3-1-unideal-student-UC.svg) -**Pet pitanja za odabir sadržaja dijagrama** (ne pet dijagrama za predaju): +**Slika 3.4. Pretraga, kuponi i recenzije** (izvor: [3-1-unideal-student-UC.puml](./puml/3-1-unideal-student-UC.puml)) -| Fokus | Pitanje | -| ----------------------- | --------------------------------------------------------------------------------------------------------------------------- | -| Cijeli sustav | Koji korisnički ciljevi najbolje objašnjavaju čemu ova aplikacija služi? | -| Ključne funkcionalnosti | Koje ciljeve treba detaljnije opisati ili, ako je potrebno, prikazati zasebnim usmjerenim dijagramom? | -| Korisničke uloge | Koji akteri mogu sudjelovati u pojedinom cilju i kako se njihove ovlasti razlikuju? | -| Ključni procesi | Koji cilj ima važne alternative koje treba opisati u obrascu uporabe? | -| Vanjske integracije | Sudjeluje li drugi sustav u obrascu uporabe kao **sekundarni akter**, primjerice odobreni pružatelj identiteta pri prijavi? | +![Dijagram obrazaca uporabe za pretplatu i administraciju](./assets/diagrams/3-1-unideal-admin-UC.svg) -Vanjski sustav može biti sekundarni akter obrasca uporabe kada sudjeluje u ostvarenju korisničkog cilja; tehničke veze opisuju se u arhitekturi. Nemojte stvarati dodatni obavezni dijagram obrazaca uporabe samo radi popisa integracija. Prenatrpan dijagram podijelite prema povezanim akterima ili ciljevima samo kada time postaje čitljiviji. +**Slika 3.5. Pretplata i administracija** (izvor: [3-1-unideal-admin-UC.puml](./puml/3-1-unideal-admin-UC.puml)) + +**Provjera dijagrama:** Prikažite prepoznate uloge koje **komuniciraju s aplikacijom**, a ne dionike koji s njom nemaju interakciju. Svaki glavni korisnički cilj mora imati pridruženog aktera; uključeni obrazac uporabe može se dosegnuti preko drugog obrasca uporabe bez vlastite izravne veze s akterom. `<>` i `<>` koristite samo kada odnos odgovara stvarnom ponašanju. -
## 3.2 Specifikacije obrazaca uporabe **Cilj:** Za svaki obrazac uporabe iz dijagrama objasniti cilj aktera, uobičajenu interakciju s aplikacijom i važne alternative. Jednostavne obrasce uporabe opišite kratko; proširite one kod kojih alternative, vanjske ovisnosti ili posljedice zahtijevaju dodatno objašnjenje. -**Za svaki obrazac uporabe koristite jednu okomitu tablicu.** Navedite samo onoliko pojedinosti koliko interakcija zahtijeva; neprimjenjivu alternativu izostavite umjesto da je popunjavate samo radi forme. - -### UC-[ID]: [Naziv usmjeren na cilj] - -| Element specifikacije | Opis | -| :-------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------- | -| **Primarni akter** | [Uloga definirana u analizi zahtjeva] | -| **Povezani zahtjevi** | [Identifikatori funkcijskih zahtjeva, npr. F-001, F-004] | -| **Preduvjeti** | [Stanje sustava koje mora biti zadovoljeno prije početka izvođenja] | -| **Glavni uspješni tok** | 1. Akter pokreće akciju.
2. Program obrađuje unos i vraća povratnu informaciju.
3. [Koračni prikaz interakcije do ostvarenja cilja] | -| **Alternativni tokovi / Iznimke** | **[Korak]a — [Naziv iznimke]:** [Uvjet nastanka, reakcija programa i nastavak toka] | -| **Posljedice (ishod)** | [Promjena stanja podataka ili potvrda nakon uspješnog završetka] | - -
-Primjeri specifikacija: Registracija i prijava kriznog događaja - -**Primjer — CrisisMap:** - -**UC-001: Registracija računa.** Ovaj kratki primjer odnosi se na projekt čiji odobreni zadatak uključuje račune s adresom e-pošte i lozinkom. - -| Polje | Opis | -| ------------------------------------------------- | ----------------------------------------------------------------------------------------------- | -| Primarni akter | Građanin (A-02 u primjeru) | -| ID zahtjeva | F-001 | -| Preduvjeti, ako postoje | Nema. | -| Glavni tijek | Građanin unosi adresu e-pošte; aplikacija šalje poveznicu za potvrdu; građanin potvrđuje račun. | -| Alternativni ili neuspješni tijekovi, ako postoje | Adresa e-pošte već postoji → aplikacija objašnjava zašto se registracija ne može nastaviti. | -| Rezultat | Račun je aktivan nakon potvrde. | - -Ako odobreni zadatak umjesto toga koristi isključivo OAuth prijavu, zamijenite ovaj primjer odgovarajućim ponašanjem prijave; nemojte dodavati registraciju lokalnom lozinkom samo radi podudaranja s primjerom. - -**UC-002: Podnošenje prijave kriznog događaja.** Ista polja mogu opisati dulji tijek u kojem odabir lokacije, provjera valjanosti i pohrana mogu ne uspjeti. - -| Polje | Opis | -| ------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Primarni akter | Građanin | -| ID zahtjeva | F-004 | -| Preduvjeti, ako postoje | Obrazac za prijavu dostupan je. Ako odobreni zadatak zahtijeva prijavu u sustav, građanin je prijavljen. | -| Glavni tijek | 1. Građanin otvara obrazac za prijavu; aplikacija prikazuje polja za vrstu kriznog događaja, razinu ozbiljnosti, opis i lokaciju.
2. Građanin unosi podatke i odabire lokaciju na karti ili drugim podržanim načinom.
3. Građanin podnosi obrazac; aplikacija provjerava obavezna polja i lokaciju.
4. Aplikacija pohranjuje prijavu i prikazuje potvrdu s referencom na nju. | -| Alternativni ili neuspješni tijekovi, ako postoje | **1a — Prijava u sustav nije uspjela:** Ako je prijava obavezna, a pružatelj identiteta je ne dovrši, prijava kriznog događaja ostaje nepodnesena i aplikacija objašnjava kako pokušati ponovno.
**2a — Odbijen pristup lokaciji:** Ako aplikacija nudi geolokaciju, ali je korisnik odbije, građanin ručno odabire lokaciju ako ta mogućnost postoji; tijek se nastavlja u koraku 3.
**3a — Nevaljana ili nedostajuća lokacija:** Aplikacija objašnjava problem, po mogućnosti zadržava unesene podatke i ne pohranjuje prijavu; građanin ispravlja lokaciju i ponavlja korak 3.
**3b — Pohrana nije uspjela:** Aplikacija prijavljuje neuspjeh i ne prikazuje lažnu potvrdu o podnošenju. | -| Rezultat | Aplikacija pohranjuje prijavu kriznog događaja i potvrđuje njezino podnošenje. | - -**Odabir razine detalja:** Oba primjera koriste ista polja. UC-001 je kratak jer je glavna iznimka jasna; UC-002 zahtijeva numerirane korake i alternative jer oni mijenjaju ishod i mogu usmjeravati ispitivanje.Pri prilagodbi primjera koristite ID-ove zahtjeva i ponašanje vlastite aplikacije. - -**UC-005: Moderiranje prijave kriznog događaja.** Ovaj primjer vrijedi samo za projekt u kojem odobreni opseg uključuje moderatorski pregled prijava. - -| Polje | Opis | -| ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Primarni akter | Moderator (A-05 u primjeru) | -| ID zahtjeva | F-008 | -| Preduvjeti, ako postoje | Moderator je prijavljen i ima moderatorske ovlasti; postoji prijava koja čeka pregled. | -| Glavni tijek | 1. Moderator otvara prijavu koja čeka pregled.
2. Aplikacija prikazuje podatke prijave i dostupne moderatorske radnje.
3. Moderator odabire odobravanje ili odbijanje.
4. Aplikacija provjerava ovlasti, mijenja status prijave i prikazuje novi status. | -| Alternativni ili neuspješni tijekovi, ako postoje | **3a — Radnja nije potvrđena:** Moderator odustaje od promjene i prijava ostaje nepromijenjena.
**4a — Ovlasti nisu valjane:** Aplikacija odbija promjenu i status prijave ostaje nepromijenjen. | -| Rezultat | Prijava ima novi status ako je moderatorska radnja uspješno provedena; inače ostaje nepromijenjena. | - -
- --- ### UC-1.1: Prijava studenta Microsoft računom @@ -264,47 +201,47 @@ _Trenutačno oblikovanje: favoriti (#26) još nisu ostvareni. Tablica `favorites ### UC-5.1: Generiranje kupona za ponudu -| Element specifikacije | Opis | -| :-------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| **Primarni akter** | A-02 Student | -| **Povezani zahtjevi** | F-020, F-021, F-004, F-032, NF-07, NF-08 | -| **Preduvjeti** | Student je prijavljen i ima potvrđen status studenta. Ponuda je aktivna i rok joj nije prošao. | -| **Glavni uspješni tok** | 1. Student otvara stranicu ponude.
2. Student odabire „Generiraj kupon”.
3. Sustav provjerava da je student potvrđen i da je ponuda aktivna.
4. Sustav generira jedinstveni kod od 10 znakova koji nije moguće pogoditi i sprema kupon sa statusom „izdan”.
5. Sustav prikazuje stranicu kupona s kodom, QR kodom, nazivom ponude i partnera, rokom važenja i napomenom da uz kupon treba pokazati studentsku iskaznicu (X-icu). | +| Element specifikacije | Opis | +| :-------------------------------- | :--- | +| **Primarni akter** | A-02 Student | +| **Povezani zahtjevi** | F-020, F-021, F-004, F-032, NF-07, NF-08 | +| **Preduvjeti** | Student je prijavljen i ima potvrđen status studenta. Ponuda je aktivna i rok joj nije prošao. | +| **Glavni uspješni tok** | 1. Student otvara stranicu ponude.
2. Student odabire „Generiraj kupon”.
3. Sustav provjerava da je student potvrđen i da je ponuda aktivna.
4. Sustav generira jedinstveni kod od 10 znakova koji nije moguće pogoditi i sprema kupon sa statusom „izdan”.
5. Sustav prikazuje stranicu kupona s kodom, QR kodom, nazivom ponude i partnera, rokom važenja i napomenom da uz kupon treba pokazati studentsku iskaznicu (X-icu). | | **Alternativni tokovi / Iznimke** | **1a — Korisnik nije prijavljen:** umjesto gumba prikazuje se poveznica „Prijavi se za kupon”; nakon prijave student se vraća na istu ponudu.
**3a — Status studenta nije potvrđen:** sustav prikazuje poruku da kupon može generirati samo student s potvrđenim statusom; kupon se ne stvara (F-004).
**3b — Ponuda je istekla ili nije dostupna:** sustav prikazuje poruku i kupon se ne stvara.
**3c — Ponuda „jednom po studentu” je već iskorištena:** sustav prikazuje poruku o razlogu i kupon se ne stvara (F-021).
**3d — Ponuda „jednom po studentu”, student već ima važeći neiskorišten kupon:** sustav ne stvara novi kupon, nego prikazuje postojeći (F-021).
**4a — Generirani kod već postoji:** sustav generira novi kod, najviše tri puta; ako ne uspije, prikazuje poruku da generiranje nije uspjelo. | -| **Posljedice (ishod)** | U bazi postoji kupon sa statusom „izdan” vezan uz studenta i ponudu. Student ga pokazuje partneru na zaslonu mobitela do isteka ponude. | +| **Posljedice (ishod)** | U bazi postoji kupon sa statusom „izdan” vezan uz studenta i ponudu. Student ga pokazuje partneru na zaslonu mobitela do isteka ponude. | ### UC-5.2: Potvrda korištenja kupona -| Element specifikacije | Opis | -| :-------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| **Primarni akter** | A-03 Partner | -| **Povezani zahtjevi** | F-014, F-032, NF-03 | -| **Preduvjeti** | Partner je prijavljen i njegov profil je odobren. Student mu pokazuje kupon na mobitelu. | +| Element specifikacije | Opis | +| :-------------------------------- | :--- | +| **Primarni akter** | A-03 Partner | +| **Povezani zahtjevi** | F-014, F-032, NF-03 | +| **Preduvjeti** | Partner je prijavljen i njegov profil je odobren. Student mu pokazuje kupon na mobitelu. | | **Glavni uspješni tok** | 1. Partner otvara zaslon za potvrdu kupona.
2. Partner upisuje kod s kupona ili skenira QR kod.
3. Sustav pronalazi kupon i prikazuje ponudu, status i napomenu da student treba pokazati studentsku iskaznicu (X-icu).
4. Partner potvrđuje korištenje.
5. Sustav kuponu postavlja status „iskorišten” i vrijeme korištenja te prikazuje potvrdu. | -| **Alternativni tokovi / Iznimke** | **3a — Kod ne postoji:** sustav prikazuje poruku da kupon nije pronađen.
**3b — Kupon je za ponudu drugog partnera:** sustav odbija potvrdu.
**3c — Kupon je već iskorišten ili je istekao:** sustav prikazuje status kupona i ne dopušta potvrdu.
**4a — Student ne pokaže X-icu:** partner odustaje od potvrde; kupon ostaje „izdan”. | -| **Posljedice (ishod)** | Kupon ima status „iskorišten” s vremenom korištenja; student za njega može ostaviti recenziju (UC-5.4). | +| **Alternativni tokovi / Iznimke** | **3a — Kod ne postoji:** sustav prikazuje poruku da kupon nije pronađen.
**3b — Kupon je za ponudu drugog partnera:** sustav odbija potvrdu.
**3c — Kupon je već iskorišten ili je istekao:** sustav prikazuje status kupona i ne dopušta potvrdu.
**4a — Student ne pokaže X-icu:** partner odustaje od potvrde; kupon ostaje „izdan”. | +| **Posljedice (ishod)** | Kupon ima status „iskorišten” s vremenom korištenja; student za njega može ostaviti recenziju (UC-5.4). | ### UC-5.3: Pregled povijesti kupona -| Element specifikacije | Opis | -| :-------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| **Primarni akter** | A-02 Student | -| **Povezani zahtjevi** | F-022 | -| **Preduvjeti** | Student je prijavljen. | +| Element specifikacije | Opis | +| :-------------------------------- | :--- | +| **Primarni akter** | A-02 Student | +| **Povezani zahtjevi** | F-022 | +| **Preduvjeti** | Student je prijavljen. | | **Glavni uspješni tok** | 1. Student otvara svoj profil.
2. Sustav prikazuje popis svih studentovih kupona s ponudom, partnerom, datumom i statusom (izdan, iskorišten, istekao).
3. Student odabire kupon i sustav prikazuje stranicu kupona. | -| **Alternativni tokovi / Iznimke** | **2a — Student nema kupona:** sustav prikazuje poruku da još nema generiranih kupona. | -| **Posljedice (ishod)** | Nema promjene podataka. | +| **Alternativni tokovi / Iznimke** | **2a — Student nema kupona:** sustav prikazuje poruku da još nema generiranih kupona. | +| **Posljedice (ishod)** | Nema promjene podataka. | ### UC-5.4: Ocjenjivanje partnera -| Element specifikacije | Opis | -| :-------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| **Primarni akter** | A-02 Student | -| **Povezani zahtjevi** | F-023 | -| **Preduvjeti** | Student je prijavljen i ima iskorišten kupon za ponudu tog partnera. | +| Element specifikacije | Opis | +| :-------------------------------- | :--- | +| **Primarni akter** | A-02 Student | +| **Povezani zahtjevi** | F-023 | +| **Preduvjeti** | Student je prijavljen i ima iskorišten kupon za ponudu tog partnera. | | **Glavni uspješni tok** | 1. Student u povijesti kupona odabire iskorišteni kupon i „Ocijeni”.
2. Student odabire ocjenu od 1 do 5 i po želji piše komentar.
3. Sustav sprema recenziju i ažurira prosječnu ocjenu partnera. | -| **Alternativni tokovi / Iznimke** | **1a — Kupon nije iskorišten:** mogućnost ocjenjivanja se ne prikazuje; pokušaj mimo sučelja baza odbija.
**3a — Kupon je već ocijenjen:** sustav odbija drugu recenziju za isti kupon. | -| **Posljedice (ishod)** | Recenzija je javno vidljiva na profilu partnera; administrator je može ukloniti. | +| **Alternativni tokovi / Iznimke** | **1a — Kupon nije iskorišten:** mogućnost ocjenjivanja se ne prikazuje; pokušaj mimo sučelja baza odbija.
**3a — Kupon je već ocijenjen:** sustav odbija drugu recenziju za isti kupon. | +| **Posljedice (ishod)** | Recenzija je javno vidljiva na profilu partnera; administrator je može ukloniti. | ### UC-6.1: Plaćanje pretplate diff --git a/docs/A-Pregled-aktivnosti-grupe.md b/docs/A-Pregled-aktivnosti-grupe.md index 754c9af..12aaf09 100644 --- a/docs/A-Pregled-aktivnosti-grupe.md +++ b/docs/A-Pregled-aktivnosti-grupe.md @@ -29,7 +29,7 @@ | od 2. 11. 2026. (paralelno) | Kuponi: generiranje koda i QR koda, ograničenje korištenja, potvrda kod partnera, povijest kupona, recenzije | EB | [#27]–[#31] | | od 2. 11. 2026. (paralelno) | Plaćanje: Stripe proizvodi i Checkout, webhook, skrivanje ponuda bez pretplate, stranica pretplate | JČ | [#32]–[#36] | | od 2. 11. 2026. (paralelno) | Administracija: korisnici, odobravanje partnera, kategorije, moderacija, cijene pretplate, statistika za administratora, izvoz CSV/PDF | FČ | [#37]–[#42], [#44] | -| 11.–20. 11. 2026. | Priprema za prvu predaju (20. 11. 2026.): dokumentacija, granice projekta, ručno ispitivanje prijave, ažuriranje README-a | EB ([#48], [#86]), KB ([#49], [#84]), FL ([#46], [#85]), JČ ([#50]), KD ([#51]), FČ ([#47], [#87]), MB ([#9]) | oznaka [`zajednicko`][oznaka-zajednicko] | +| 11.–20. 11. 2026. | Priprema za prvu predaju (20. 11. 2026.): dokumentacija, granice projekta, ručno ispitivanje prijave, ažuriranje README-a | EB ([#48], [#86]; dijagram obrazaca uporabe 3.1), KB ([#49]; [#84] arhitekturne odluke 4.1), FL ([#46], [#85]), JČ ([#50]), KD ([#51]), FČ ([#47], [#87]), MB ([#9]) | oznaka [`zajednicko`][oznaka-zajednicko] | | od 21. 11. 2026. | Nastavak rada na zadacima koji nisu riješeni do prve predaje, dovršetak otvorenih zadataka u svakom području i integracija područja (pretplata ↔ vidljivost ponuda, kuponi ↔ recenzije, statistika) | svi, svatko za svoje područje | otvoreni zadaci po oznaci područja | [#1]: https://github.com/matejban/UniDeal/issues/1 @@ -69,7 +69,7 @@ | Aktivnost ili rezultat | Član | Prijavljeni sati | Reprezentativni rezultat ili poveznica | | --- | --- | --- | --- | | Otvaranje repozitorija | FČ | | Početni commit repozitorija | -| Struktura projekta prema predlošku kolegija | EB | | Direktoriji `docs/`, `tests/`, `db/`, `build/` | +| Struktura projekta prema predlošku kolegija | EB | 3 | Direktoriji `docs/`, `tests/`, `db/`, `build/` | | Odjeljak 1.4 Postojeći pristupi | FČ | | `docs/1-Projekt.md` | | Opis projekta, osnovna Next.js aplikacija, objektno orijentirana struktura i prijava Google računom | MB | | `README.md`, `src/` | | Analiza zahtjeva | KB | | `docs/2-Analiza-zahtjeva.md` | @@ -78,15 +78,15 @@ | Članovi tima u README-u i dorada analize zahtjeva | KB | | Zadatak [#45] | | Shema baze i migracije, RLS po ulogama, Supabase repozitoriji, zaštita ruta po ulozi, uređivanje profila, CI i README | MB | | Zadaci [#2]–[#5], [#7]–[#9] | | Registracija partnera s provjerom OIB-a | FL | | Zadatak [#10] | -| Generiranje kupona s jedinstvenim kodom i QR kodom | EB | | Zadatak [#27] | +| Generiranje kupona s jedinstvenim kodom i QR kodom | EB | 7 | Zadatak [#27] | | Odobravanje partnera u administraciji | FČ | | Zadatak [#37], PR [#68] | | Javni profil partnera i uređivanje profila | FL | | Zadatak [#11] | | Upload logotipa partnera u Supabase Storage | FL | | Zadatak [#13] | | E-mail obavijesti preko Resenda | FL | | Zadatak [#14] | -| Ograničenje korištenja kupona (jednom po studentu) | EB | | Zadatak [#29] | +| Ograničenje korištenja kupona (jednom po studentu) | EB | 3 | Zadatak [#29] | | Stripe klijent i cijene mjesečne i godišnje pretplate | JČ | | Zadatak [#32] | | Dokumentacija i testovi temelja i autentifikacije | MB | | UC-1.1 – UC-1.4, CT-1.x, ST-1.x | -| Obrasci uporabe, sljedivost i ispitivanje kupona | EB | | Zadatak [#48]; UC-5.1 – UC-5.4, CT-5.1, CT-5.2, ST-5.1 – ST-5.4 | +| Obrasci uporabe, sljedivost i ispitivanje kupona | EB | 5 | Zadatak [#48]; UC-5.1 – UC-5.4, CT-5.1, CT-5.2, ST-5.1 – ST-5.4 | | Upravljanje kategorijama ponuda | FČ | | Zadatak [#39], PR [#78] | | Statistika za administratora (u tijeku) | FČ | | Zadatak [#42] | | Izrada, uređivanje i brisanje ponude te dijagram razreda (4.3.2) | KD | | Zadatak [#16] | @@ -98,8 +98,10 @@ | Google Maps karta s oznakama partnera | KB | | Zadatak [#23] | | Geokodiranje adrese partnera i ručno označavanje lokacije | KB | | Zadatak [#24] | | Dokumentacija administratorskog područja | FČ | | UC-7.1 – UC-7.4 | -| Dijagram razreda za kupone: `Coupon`, `CouponService` i `CouponRepository` | EB | | PR [#95]; `docs/puml/4-3-unideal-domain-CD.puml` | +| Dijagram razreda za kupone: `Coupon`, `CouponService` i `CouponRepository` | EB | 2 | PR [#95]; `docs/puml/4-3-unideal-domain-CD.puml` | | Dokumentacija pretplate: obrasci uporabe, sljedivost i ispitivanje | JČ | | PR [#94]; UC-6.1, UC-6.2, CT-6.1 – CT-6.3, ST-6.1 – ST-6.4 | +| Izjava o uporabi AI-ja, licenca i stanje funkcionalnosti u README-u; dorada Home.md | EB | 4 | Zadaci [#51] i [#86], PR #98 | +| Dijagrami obrazaca uporabe (3.1) i preuređen dijagram razreda (4.3.2) | EB | 4 | `docs/puml/3-1-unideal-*-UC.puml`, `docs/puml/4-3-unideal-domain-CD.puml` | [#2]: https://github.com/matejban/UniDeal/issues/2 [#5]: https://github.com/matejban/UniDeal/issues/5 @@ -137,8 +139,11 @@ Graf može pokazati kada su zapisi promjena napravljeni i tko ih je napravio, al | Status studenta trebalo je potvrditi bez ručne provjere dokumenata, a domena e-mail adrese ne razlikuje studenta od djelatnika iste ustanove (AS-01). | MB je uveo prijavu studenata studentskim Microsoft računom; SQL funkcija `student_institution` dodjeljuje status studenta prema popisu domena hrvatskih visokih učilišta. MB i EB dodali su uvjete korištenja (F-032) s obvezom pokazivanja X-ice pri korištenju kupona, a prijava putem AAI@EduHr zapisana je kao budući rad (7.3). | Student FER-a dobiva potvrđen status pri prvoj prijavi (ST-1.1). Ostaje ograničenje: djelatnik može dobiti status studenta, popis domena održava se ručno, a stvarnim računom provjerena je samo domena `fer.hr` (5.4). | | Nakon zamjene loga partnera ili fotografije ponude stara datoteka ostajala je u Supabase Storageu, a brisanje nije javljalo grešku. | MB je utvrdio da Storage za brisanje treba i pravilo za `select` nad `storage.objects`. Dodao je to pravilo (vlasnik vidi samo datoteke u mapi svojeg partnera) i funkciju `deleteImage()`, koja briše staru sliku pri zamjeni i pri brisanju ponude ([#81]). | Nakon zamjene u Storageu ostaje samo nova datoteka. Neuspjelo brisanje samo se zapisuje u log, a partnerova radnja svejedno uspijeva, pa datoteka u tom slučaju i dalje može ostati. | | Stripe ključ nije radio na starijoj preview inačici aplikacije, iako je bio upisan u Vercel. | Uočeno je da je pri slanju ključa preko Outlooka (JČ je ključ iz Stripea poslao MB-u, koji ga je upisao u Vercel) prvo slovo ključa automatski postalo veliko. Ključ je ponovno upisan u Vercel u izvornom obliku. | Plaćanje preko Stripea je proradilo, jer je promijenjeno slovo bilo jedina greška. | +| Kod kupona morao je biti jedinstven i teško pogodiv (NF-07), a dva studenta mogu istodobno generirati kupon s istim nasumičnim kodom. | EB je uvela nasumični kod od 10 znakova bez lako zamjenjivih znakova (0, O, 1, I). Stupac `code` u bazi je jedinstven, pa kad baza javi da je kod zauzet (greška 23505), `CouponService.issue()` generira novi kod, najviše tri puta. | Komponentni test CT-5.1 generira 10 000 kodova i svi su različiti. | +| Pravilo „jednom po studentu” (F-021) trebalo je ispitati i za iskorišten kupon, a partnerska potvrda kupona još ne postoji. | EB je u ispitivanju ST-5.4 kupon ručno označila kao iskorišten izravno u bazi (Supabase, tablica `coupons`) i provjerila da student ne dobiva novi kupon. Ograničenje je zapisano u 5.4. | Pravilo radi (ST-5.4 prošao). Kad bude ostvarena partnerska potvrda ([#28]), ispitivanje treba ponoviti kroz aplikaciju. | [#81]: https://github.com/matejban/UniDeal/pull/81 +[#28]: https://github.com/matejban/UniDeal/issues/28 --- diff --git a/docs/Home.md b/docs/Home.md index c6264d9..471395f 100644 --- a/docs/Home.md +++ b/docs/Home.md @@ -75,7 +75,9 @@ Kratak sažetak: [README – Uporaba umjetne inteligencije](../README.md#ai-usag | Dokumentacija područja 5: UC-5.1 – UC-5.4, retci 2.6, ispitivanje CT-5.x i ST-5.x | Izrada nacrta | Prijedlog teksta prema kodu | Tekst provjeren prema kodu i aplikaciji i ispravljen; testove sam izvela i upisala stvarne rezultate | [3](3-Obrasci-uporabe.md), [2.6](2-Analiza-zahtjeva.md), [5](5-Ispitivanje.md) | | Kod kupona (#27, #29) | Objašnjenje i prijedlozi dijelova koda | Prijedlozi po koracima | Kod sam pokrenula i testirala lokalno (`npm run dev`, `npm test`), izmijenila dijelove i ručno provjerila na [www.unideal.site](https://www.unideal.site) | PR #67, PR #73 | | Dijagram razreda 4.3.2 | Izvor dijagrama | Nacrt PlantUML-a prema kodu | Iscrtan, uspoređen s kodom i pojednostavljen |[`4-3-unideal-domain-CD.puml`](puml/4-3-unideal-domain-CD.puml) | -| [npr. 3. Obrasci uporabe, UC-002] | [Izrada nacrta / preoblikovanje / prijevod / izvor dijagrama / sažimanje] | [Kratak opis] | [Ulaz zadan alatu; dodane, ispravljene ili uklonjene činjenice] | [Stranica dokumentacije, `.puml` datoteka, PR] | +| Dijagrami obrazaca uporabe 3.1 | Izvor dijagrama | Nacrt PlantUML-a prema uputama | Pregledni dijagram i četiri usmjerena dijagrama prema savjetu asistentice; iscrtani i provjereni prema UC-1.1 – UC-7.4 | [`docs/puml`](puml) | + + Stranice i artefakti koji nisu navedeni iznad izrađeni su bez pomoći generativne umjetne inteligencije. [Po želji: kao dodatne retke navedite kod ili ispitivanja izrađena uz pomoć umjetne inteligencije.] @@ -94,9 +96,15 @@ Stranice i artefakti koji nisu navedeni iznad izrađeni su bez pomoći generativ | Problem | Kako je pronađen | Rješenje | | --- | --- | --- | | Koraci CT-5.1 i CT-5.2 tražili su da se u ispisu pogleda skupina testova | Pokretanjem `npm test`: zadani ispis Vitesta ne prikazuje skupine | Koraci promijenjeni u `npm test -- --reporter=verbose` | -| [Netočna, izmišljena ili iz predloška preuzeta tvrdnja] | [Pregled, ispitivanje ili usporedba s aplikacijom] | [Ispravak s poveznicom] | +| Dijagram obrazaca uporabe 3.1: prvi nacrt imao je sve obrasce na jednom dijagramu, zatim podjelu bez preglednog dijagrama i veze bez smjera; jedan nacrt imao je i sintaksnu grešku | Savjet asistentice o preglednosti, usporedba s uputama sa predavanja i iscrtavanje na plantuml.com | Pregledni dijagram (Slika 3.1) i četiri usmjerena dijagrama (Slike 3.2 – 3.5) sa strelicama od aktivnih aktera; [3.1](3-Obrasci-uporabe.md) | +| Dijagram razreda 4.3.2: razredi su bili podijeljeni u pakete po slojevima (aplikacijski, domenski, infrastruktura), što je otežavalo pregled | Savjet asistentice | Paketi uklonjeni, razredi složeni u retke i stupce, sadržaj isti; [`4-3-unideal-domain-CD.puml`](puml/4-3-unideal-domain-CD.puml) | + + + + + + UPUTA: Zabilježite stvarne ispravke ili napišite „Nisu utvrđene”. Općenita tvrdnja poput „sav tekst je pregledan” nije dokaz; dokaz su prethodne tablice. Tim mora moći objasniti svaku rečenicu koju objavi.
Primjer zapisa uporabe umjetne inteligencije @@ -116,3 +124,4 @@ Stranice i artefakti koji nisu navedeni iznad izrađeni su bez pomoći generativ **Analiza primjera:** Svaki redak navodi stranicu ili datoteku, ono što je alat generirao i ono što je tim promijenio. Pogreške su tipične za generiranu dokumentaciju: funkcionalnost koja ne postoji i tekst predloška prikazan kao činjenica o projektu. Tvrdnje poput „AI je korišten svugdje” ili „sav tekst je pregledan” nije moguće provjeriti. Ovo je nastavni scenarij, a ne opis objavljenog projekta.
+--> \ No newline at end of file diff --git a/docs/assets/diagrams/3-1-crisismap-system-UC.svg b/docs/assets/diagrams/3-1-crisismap-system-UC.svg deleted file mode 100644 index 316139b..0000000 --- a/docs/assets/diagrams/3-1-crisismap-system-UC.svg +++ /dev/null @@ -1 +0,0 @@ -Sustav CrisisMap - slučajevi uporabeSustav CrisisMap - slučajevi uporabeSustav CrisisMapUC-01Prijava u sustavUC-02Pregled prijava na kartiUC-03Filtriranje prikaza događajaUC-04Podnošenje prijavekriznog događajaUC-05Provjera podataka prijaveUC-06Dodavanje fotografijeUC-07Moderiranje prijavekriznog događajaUC-08Pregled dostupnih resursaUC-09Raspodjela resursa pomoćiUC-10Primanje obavijesti odogađajima u bliziniKorisnik aplikacijeGrađaninPosjetiteljModeratorKoordinator pomoćiPružatelj identiteta(OAuth)«external system»Pružatelj obavijesti«external system»Pružatelj kartografskeusluge«external system»«extend»[filtriranje zatraženo]«extend»[fotografija priložena]«include» \ No newline at end of file diff --git a/docs/assets/diagrams/3-1-unideal-admin-UC.svg b/docs/assets/diagrams/3-1-unideal-admin-UC.svg new file mode 100644 index 0000000..422bbeb --- /dev/null +++ b/docs/assets/diagrams/3-1-unideal-admin-UC.svg @@ -0,0 +1 @@ +UniDeal - pretplata i administracija (Slika 3.5)Sustav UniDealUC-6.1Plaćanje pretplateUC-6.2Ažuriranje stanjapretplateUC-7.1Odobravanje partneraUC-7.2Upravljanjekorisničkim računimaUC-7.3Upravljanjekategorijama ponudaUC-7.4Pregled statistikeplatformePartnerAdministratorStripe«external system»Resend(e-mail)«external system» \ No newline at end of file diff --git a/docs/assets/diagrams/3-1-unideal-partner-UC.svg b/docs/assets/diagrams/3-1-unideal-partner-UC.svg new file mode 100644 index 0000000..7ddc750 --- /dev/null +++ b/docs/assets/diagrams/3-1-unideal-partner-UC.svg @@ -0,0 +1 @@ +UniDeal - partneri i ponude (Slika 3.3)Sustav UniDealUC-2.1Registracijaposlovnog subjektaUC-2.2Uređivanje javnogprofila partneraUC-4.3Označavanje lokacijepartneraUC-3.1Izrada, uređivanje ibrisanje ponudeUC-3.2Objava ponudeUC-2.3Pregled profilapartneraPartnerPosjetiteljGoogle Maps API«external system»Vremenski okidač«external system»«extend»[adresa upisana]«extend»[adresa promijenjena] \ No newline at end of file diff --git a/docs/assets/diagrams/3-1-unideal-pregled-UC.svg b/docs/assets/diagrams/3-1-unideal-pregled-UC.svg new file mode 100644 index 0000000..46e7c56 --- /dev/null +++ b/docs/assets/diagrams/3-1-unideal-pregled-UC.svg @@ -0,0 +1 @@ +UniDeal - pregled obrazaca uporabe (Slika 3.1)Sustav UniDealPrijava i profilUC-1.1 - UC-1.4(Slika 3.2)Pretraga ponuda i partneraUC-2.3, UC-4.1, UC-4.2(Slika 3.3, 3.4)Kuponi, favoriti i ocjeneUC-2.4, UC-4.4, UC-5.1, UC-5.3, UC-5.4(Slika 3.4)Profil partnera i ponudeUC-2.1, UC-2.2, UC-3.1, UC-3.2, UC-4.3(Slika 3.3)Potvrda kuponaUC-5.2(Slika 3.4)Pretplata partneraUC-6.1, UC-6.2(Slika 3.5)AdministracijaUC-7.1 - UC-7.4(Slika 3.5)PosjetiteljStudentPartnerAdministrator \ No newline at end of file diff --git a/docs/assets/diagrams/3-1-unideal-prijava-UC.svg b/docs/assets/diagrams/3-1-unideal-prijava-UC.svg new file mode 100644 index 0000000..f5b2fbb --- /dev/null +++ b/docs/assets/diagrams/3-1-unideal-prijava-UC.svg @@ -0,0 +1 @@ +UniDeal - prijava i profil (Slika 3.2)Sustav UniDealUC-1.1Prijava studentaMicrosoft računomUC-1.2Prijava partnera Googleračunom ili e-mailomUC-1.3Prihvaćanje uvjetakorištenjaUC-1.4Uređivanje profila ideaktivacija računaStudentPartnerAdministratorPružatelji identiteta(Microsoft, Google)«external system»Resend(e-mail)«external system»«extend»[prva prijava]«extend»[prva prijava] \ No newline at end of file diff --git a/docs/assets/diagrams/3-1-unideal-student-UC.svg b/docs/assets/diagrams/3-1-unideal-student-UC.svg new file mode 100644 index 0000000..1d5cfb4 --- /dev/null +++ b/docs/assets/diagrams/3-1-unideal-student-UC.svg @@ -0,0 +1 @@ +UniDeal - pretraga, kuponi i recenzije (Slika 3.4)Sustav UniDealUC-4.1Pretraga ifiltriranje ponudaUC-4.2Pregled partnerana kartiUC-4.4Spremanje u favoriteUC-2.4Praćenje kategorijai partneraUC-5.1Generiranje kuponaza ponuduUC-5.3Pregled povijestikuponaUC-5.4OcjenjivanjepartneraUC-5.2Potvrda korištenjakuponaPosjetiteljStudentPartnerGoogle Maps API«external system»Resend(e-mail)«external system»«extend»[kupon iskorišten] \ No newline at end of file diff --git a/docs/assets/diagrams/4-3-unideal-domain-CD.svg b/docs/assets/diagrams/4-3-unideal-domain-CD.svg index fa20b23..5927ac9 100644 --- a/docs/assets/diagrams/4-3-unideal-domain-CD.svg +++ b/docs/assets/diagrams/4-3-unideal-domain-CD.svg @@ -1 +1 @@ -UniDeal - domenski model ponuda, partnera i kuponaUniDeal - domenski model ponuda, partnera i kuponaAplikacijski slojDomenski slojInfrastrukturaOfferServicesearch(filter: OfferFilter): OfferListing[]getActiveOffer(id: String): OfferListinggetPartnerOffers(partnerId: String): Offer[]getOwnOffer(ownerId: String, offerId: String): OffercreateOffer(ownerId: String, data: OfferInput, photo: File): OfferErrorsupdateOffer(ownerId: String, offerId: String, data: OfferInput, photo: File): OfferErrorsdeleteOffer(ownerId: String, offerId: String): BooleanPartnerServicegetAll(): Partner[]getByOwner(ownerId: String): PartnergetCities(): String[]getProfile(id: String): ProfileCouponServiceissue(user: User, offerId: String): IssueResultgetCoupon(id: String): CouponOfferStatusnacrtaktivnaisteklaDiscountTypepostotakiznosUsageLimitjednom_po_studentuneogranicenoCouponStatusizdaniskoristenistekaoOfferid: Stringtitle: Stringdescription: Stringcategory: StringcategoryId: StringdiscountType: DiscountTypediscountValue: NumbervalidUntil: Stringconditions: Stringstatus: OfferStatusphotoUrl: StringusageLimit: UsageLimitdiscountLabel: StringisActive(): BooleanisOncePerStudent(): BooleancanBeActivated(): BooleancanBeEdited(): BooleanPartnerid: Stringname: Stringcategory: Stringcity: Stringaddress: Stringhours: StringCouponid: StringofferId: StringstudentId: Stringcode: Stringstatus: CouponStatusissuedAt: DatevalidUntil: StringisValid(): BooleanOfferRepositoryfindAll(): Offer[]findById(id: String): OfferfindByPartner(partnerId: String): Offer[]create(partnerId: String, data: OfferInput): Stringupdate(id: String, data: OfferInput): voidsetPhoto(id: String, photoUrl: String): voiddelete(id: String): voidPartnerRepositoryfindAll(): Partner[]findById(id: String): PartnerfindByOwner(ownerId: String): PartnerCategoryRepositoryfindAll(): Category[]CouponRepositorycreate(offerId: String, studentId: String, code: String): CouponfindById(id: String): CouponfindByStudentAndOffer(studentId: String, offerId: String): Coupon[]SupabaseOfferRepositorySupabasePartnerRepositorySupabaseCouponRepositoryobjavljuje0..*1ima0..*1 \ No newline at end of file +UniDeal - domenski model ponuda, partnera i kuponaOfferStatusnacrtaktivnaisteklaDiscountTypepostotakiznosUsageLimitjednom_po_studentuneogranicenoCouponStatusizdaniskoristenistekaoPartnerid: Stringname: Stringcategory: Stringcity: Stringaddress: Stringhours: StringOfferid: Stringtitle: Stringdescription: Stringcategory: StringcategoryId: StringdiscountType: DiscountTypediscountValue: NumberdiscountLabel: StringvalidUntil: Stringconditions: Stringstatus: OfferStatusphotoUrl: StringusageLimit: UsageLimitisActive(): BooleanisOncePerStudent(): BooleancanBeActivated(): BooleancanBeEdited(): BooleanCouponid: StringofferId: StringstudentId: Stringcode: Stringstatus: CouponStatusissuedAt: DatevalidUntil: StringisValid(): BooleanPartnerServicegetAll(): Partner[]getByOwner(ownerId: String): PartnergetCities(): String[]getProfile(id: String): ProfileOfferServicesearch(filter: OfferFilter): OfferListing[]getActiveOffer(id: String): OfferListinggetPartnerOffers(partnerId: String): Offer[]getOwnOffer(ownerId: String, offerId: String): OffercreateOffer(ownerId: String, data: OfferInput, photo: File): OfferErrorsupdateOffer(ownerId: String, offerId: String, data: OfferInput, photo: File): OfferErrorsdeleteOffer(ownerId: String, offerId: String): BooleanCouponServiceissue(user: User, offerId: String): IssueResultgetCoupon(id: String): CouponPartnerRepositoryfindAll(): Partner[]findById(id: String): PartnerfindByOwner(ownerId: String): PartnerOfferRepositoryfindAll(): Offer[]findById(id: String): OfferfindByPartner(partnerId: String): Offer[]create(partnerId: String, data: OfferInput): Stringupdate(id: String, data: OfferInput): voidsetPhoto(id: String, photoUrl: String): voiddelete(id: String): voidCategoryRepositoryfindAll(): Category[]CouponRepositorycreate(offerId: String, studentId: String, code: String): CouponfindById(id: String): CouponfindByStudentAndOffer(studentId: String, offerId: String): Coupon[]SupabasePartnerRepositorySupabaseOfferRepositorySupabaseCouponRepositoryobjavljuje0..*1ima0..*1 \ No newline at end of file diff --git a/docs/puml/3-1-crisismap-system-UC.puml b/docs/puml/3-1-crisismap-system-UC.puml deleted file mode 100644 index a9f9832..0000000 --- a/docs/puml/3-1-crisismap-system-UC.puml +++ /dev/null @@ -1,160 +0,0 @@ -' ============================================================================== -' 3-1-crisismap-system-UC_v1.puml -' -' Svrha: Prikazuje tko i s kojim ciljem koristi sustav CrisisMap (građani, -' moderatori, koordinatori pomoći) te koje vanjske sustave sustav -' koristi. Interna logika, pohrana podataka i korisničko sučelje -' namjerno nisu obuhvaćeni (kasniji modeli). -' Autor: Vlado Sruk, kolegij Programsko inženjerstvo -' AI: Dijagram je izradio autor. AI je pomogao u reviziji i komentarima; -' autor ih je pregledao i odgovara za konačni sadržaj. -' Zahtjevi: UC-01 do UC-10 (svaki slučaj uporabe ima ID za praćenje -' prema implementaciji i testovima) -' -' Diagram level: System Requirements -' Diagram type: Use Case Diagram -' Version: 1.3 -' ============================================================================== - -@startuml -title Sustav CrisisMap – slučajevi uporabe -left to right direction - -skinparam shadowing false -skinparam defaultFontName Arial -skinparam ArrowColor #212529 - -skinparam actor { - BackgroundColor #F8F9FA - BorderColor #212529 - BackgroundColor<> #FFF3CD - BorderColor<> #856404 -} - -skinparam usecase { - BackgroundColor #E7F1FF - BorderColor #0D6EFD -} - -' ============================================================================== -' Primarni akteri -' ============================================================================== - -' Akteri su uloge, a ne stanja: nazivi ne sadrže "prijavljen" ni "anoniman". -' Stanje prijave opisuje bilješka ispod aktera Posjetitelj. -actor User as "Korisnik aplikacije" -actor Citizen as "Građanin" -actor Visitor as "Posjetitelj" -actor Moderator as "Moderator" -actor Manager as "Koordinator pomoći" - -' Sve uloge su specijalizacije korisnika aplikacije, pa im je pregled karte -' dostupan bez dodatne veze. -Citizen -|> User - User -|> Visitor -Moderator -|> User -Manager -|> User - -' Samo za raspored na dijagramu. -Manager -[hidden]down-> Citizen -Moderator -[hidden]down-> Citizen -Citizen -[hidden]down-> Visitor -Visitor -[hidden]down-> User - -'note left of Visitor -' Posjetitelj nije prijavljen u sustav. -' Prijavom (UC-01) postaje Građanin. -' Ne može podnijeti prijavu događaja (UC-04). -' Ostale uloge pretpostavljaju prijavu. -'end note - -' ============================================================================== -' Sekundarni akteri (vanjski sustavi) -' ============================================================================== - -actor "Pružatelj identiteta\n(OAuth)" as IdP <> -actor "Pružatelj obavijesti" as Notifications <> -actor "Pružatelj kartografske\nusluge" as Maps <> - -' ============================================================================== -' Granica sustava -' ============================================================================== - -rectangle "Sustav CrisisMap" as CrisisMap { - - ' Pristup - (UC-01\nPrijava u sustav) as UC_SignIn - - ' Prijave i karta - (UC-02\nPregled prijava na karti) as UC_Map - (UC-03\nFiltriranje prikaza događaja) as UC_Filter - (UC-04\nPodnošenje prijave\nkriznog događaja) as UC_Report - (UC-05\nProvjera podataka prijave) as UC_ValidateReport - (UC-06\nDodavanje fotografije) as UC_UploadPhoto - (UC-07\nModeriranje prijave\nkriznog događaja) as UC_Moderate - - ' Koordinacija resursa - (UC-08\nPregled dostupnih resursa) as UC_Resources - (UC-09\nRaspodjela resursa pomoći) as UC_Allocate - - ' Obavijesti - (UC-10\nPrimanje obavijesti o\ndogađajima u blizini) as UC_Alert -} - -' ============================================================================== -' Asocijacije aktera i slučajeva uporabe -' ============================================================================== - -User -- UC_Map - -' Posjetitelj namjerno NEMA vezu s UC-04: podnošenje prijave događaja traži -' prijavu u sustav jer prijava u ERD-u (4-2) ima obvezan user_id. Posjetitelj -' može samo pregledavati kartu i prijaviti se. -Visitor -- UC_SignIn - -' Moderator i koordinator prijavljuju se istim postupkom. Uloga im se -' dodjeljuje izvan ovog modela (administracija korisnika nije u opsegu). -Moderator -- UC_SignIn -Manager -- UC_SignIn - -Citizen -- UC_Report -Citizen -- UC_Alert - -Moderator -- UC_Moderate - -Manager -- UC_Resources -Manager -- UC_Allocate - -' ============================================================================== -' Veze između slučajeva uporabe -' ============================================================================== - -' Neobavezno ponašanje koje proširuje potpuni osnovni slučaj. -UC_Map <.. UC_Filter : <>\n[filtriranje zatraženo] - -UC_Report <.. UC_UploadPhoto : <>\n[fotografija priložena] - -' Obvezno ponašanje koje se uvijek izvodi pri podnošenju prijave. -UC_Report ..> UC_ValidateReport : <> - -' Prijava namjerno NIJE <> zaštićenih slučajeva (UC-04, UC-07, -' UC-08, UC-09, UC-10): korisnik je već prijavljen prije njihova početka. -' Prijava je preduvjet, a <> bi bio ispravan tek da se uvijek -' izvodi unutar samog slučaja. - -' ============================================================================== -' Interakcije sa sekundarnim akterima -' ============================================================================== - -UC_SignIn -- IdP - -' Kartografska usluga je prikazana jer je ključna vanjska ovisnost. U strožem -' modelu usmjerenom na ciljeve pojavila bi se tek u arhitekturnom prikazu. -UC_Map -right- Maps - -UC_Alert -right- Notifications - -' Samo za raspored vanjskih sustava u jednom stupcu. -Maps -[hidden]left-> IdP -Maps -[hidden]down-> Notifications -@enduml diff --git a/docs/puml/3-1-unideal-admin-UC.puml b/docs/puml/3-1-unideal-admin-UC.puml new file mode 100644 index 0000000..a8afecb --- /dev/null +++ b/docs/puml/3-1-unideal-admin-UC.puml @@ -0,0 +1,61 @@ +' ============================================================================== +' 3-1-unideal-admin-UC.puml +' +' Svrha: Pretplata i administracija: plaćanje pretplate partnera i poslovi administratora (UC-6.1, UC-6.2, UC-7.1 – UC-7.4). +' Autor: Elide Babić +' AI: Nacrt je izrađen uz pomoć alata Claude prema uputama autorice; +' autorica ga je iscrtala, provjerila prema specifikacijama u 3.2 i +' odgovara za sadržaj. +' +' Diagram level: System Requirements +' Diagram type: Use Case Diagram +' ============================================================================== + +@startuml +' Smjer veza (predavanja, slajd 24): aktivni akter -> obrazac, obrazac -> pasivni akter. +title UniDeal – pretplata i administracija (Slika 3.5) +left to right direction + +skinparam shadowing false +skinparam defaultFontName Arial +skinparam ArrowColor #212529 + +skinparam actor { + BackgroundColor #F8F9FA + BorderColor #212529 + BackgroundColor<> #FFF3CD + BorderColor<> #856404 +} + +skinparam usecase { + BackgroundColor #E7F1FF + BorderColor #0D6EFD +} + +actor "Partner" as Partner +actor "Administrator" as Admin + +actor "Stripe" as Stripe <> +actor "Resend\n(e-mail)" as Mail <> + +rectangle "Sustav UniDeal" { + (UC-6.1\nPlaćanje pretplate) as UC61 + (UC-6.2\nAžuriranje stanja\npretplate) as UC62 + (UC-7.1\nOdobravanje partnera) as UC71 + (UC-7.2\nUpravljanje\nkorisničkim računima) as UC72 + (UC-7.3\nUpravljanje\nkategorijama ponuda) as UC73 + (UC-7.4\nPregled statistike\nplatforme) as UC74 +} + +Partner --> UC61 +UC61 --> Stripe +' Stripe je aktivni akter UC-6.2: sam šalje obavijest o plaćanju. +Stripe --> UC62 + +Admin --> UC71 +Admin --> UC72 +Admin --> UC73 +Admin --> UC74 + +UC71 --> Mail +@enduml diff --git a/docs/puml/3-1-unideal-partner-UC.puml b/docs/puml/3-1-unideal-partner-UC.puml new file mode 100644 index 0000000..4fe2667 --- /dev/null +++ b/docs/puml/3-1-unideal-partner-UC.puml @@ -0,0 +1,64 @@ +' ============================================================================== +' 3-1-unideal-partner-UC.puml +' +' Svrha: Partner i ponude: registracija i profil partnera, lokacija, izrada i objava ponuda (UC-2.1 – UC-2.3, UC-3.1, UC-3.2, UC-4.3). +' Autor: Elide Babić +' AI: Nacrt je izrađen uz pomoć alata Claude prema uputama autorice; +' autorica ga je iscrtala, provjerila prema specifikacijama u 3.2 i +' odgovara za sadržaj. +' +' Diagram level: System Requirements +' Diagram type: Use Case Diagram +' ============================================================================== + +@startuml +' Smjer veza (predavanja, slajd 24): aktivni akter -> obrazac, obrazac -> pasivni akter. +title UniDeal – partneri i ponude (Slika 3.3) +left to right direction + +skinparam shadowing false +skinparam defaultFontName Arial +skinparam ArrowColor #212529 + +skinparam actor { + BackgroundColor #F8F9FA + BorderColor #212529 + BackgroundColor<> #FFF3CD + BorderColor<> #856404 +} + +skinparam usecase { + BackgroundColor #E7F1FF + BorderColor #0D6EFD +} + +actor "Partner" as Partner +actor "Posjetitelj" as Visitor + +actor "Google Maps API" as Maps <> +actor "Vremenski okidač" as Timer <> + +rectangle "Sustav UniDeal" { + (UC-2.1\nRegistracija\nposlovnog subjekta) as UC21 + (UC-2.2\nUređivanje javnog\nprofila partnera) as UC22 + (UC-4.3\nOznačavanje lokacije\npartnera) as UC43 + (UC-3.1\nIzrada, uređivanje i\nbrisanje ponude) as UC31 + (UC-3.2\nObjava ponude) as UC32 + (UC-2.3\nPregled profila\npartnera) as UC23 +} + +Partner --> UC21 +Partner --> UC22 +Partner --> UC31 +Partner --> UC32 + +' Lokacija se upisuje pri registraciji ili uređivanju profila (UC-4.3, korak 1). +UC21 <.. UC43 : <>\n[adresa upisana] +UC22 <.. UC43 : <>\n[adresa promijenjena] + +Visitor --> UC23 + +UC43 --> Maps +' Vremenski okidač ponudama kojima je prošao rok postavlja status „istekla”. +UC32 --> Timer +@enduml diff --git a/docs/puml/3-1-unideal-pregled-UC.puml b/docs/puml/3-1-unideal-pregled-UC.puml new file mode 100644 index 0000000..601b621 --- /dev/null +++ b/docs/puml/3-1-unideal-pregled-UC.puml @@ -0,0 +1,63 @@ +' ============================================================================== +' 3-1-unideal-pregled-UC.puml +' +' Svrha: Pregledni dijagram: granica sustava, akteri i glavne skupine ciljeva. +' Svaka skupina detaljnije je prikazana na jednom od usmjerenih +' dijagrama (Slike 3.2 – 3.5). Vanjski sustavi prikazani su tamo. +' Autor: Elide Babić +' AI: Nacrt je izrađen uz pomoć alata Claude prema uputama autorice; +' autorica ga je iscrtala, provjerila prema specifikacijama u 3.2 i +' odgovara za sadržaj. +' +' Diagram level: System Requirements +' Diagram type: Use Case Diagram +' ============================================================================== + +@startuml +' Smjer veza (predavanja, slajd 24): aktivni akter -> obrazac, obrazac -> pasivni akter. +title UniDeal – pregled obrazaca uporabe (Slika 3.1) +left to right direction + +skinparam shadowing false +skinparam defaultFontName Arial +skinparam ArrowColor #212529 + +skinparam actor { + BackgroundColor #F8F9FA + BorderColor #212529 +} + +skinparam usecase { + BackgroundColor #E7F1FF + BorderColor #0D6EFD +} + +actor "Posjetitelj" as Visitor +actor "Student" as Student +actor "Partner" as Partner +actor "Administrator" as Admin + +rectangle "Sustav UniDeal" { + usecase "Prijava i profil\nUC-1.1 – UC-1.4\n(Slika 3.2)" as G1 + usecase "Pretraga ponuda i partnera\nUC-2.3, UC-4.1, UC-4.2\n(Slika 3.3, 3.4)" as G2 + usecase "Kuponi, favoriti i ocjene\nUC-2.4, UC-4.4, UC-5.1, UC-5.3, UC-5.4\n(Slika 3.4)" as G3 + usecase "Profil partnera i ponude\nUC-2.1, UC-2.2, UC-3.1, UC-3.2, UC-4.3\n(Slika 3.3)" as G4 + usecase "Potvrda kupona\nUC-5.2\n(Slika 3.4)" as G5 + usecase "Pretplata partnera\nUC-6.1, UC-6.2\n(Slika 3.5)" as G6 + usecase "Administracija\nUC-7.1 – UC-7.4\n(Slika 3.5)" as G7 +} + +' Student može sve što i posjetitelj +Student -|> Visitor + +Visitor --> G2 +Student --> G1 +Student --> G3 +' Partner i administrator crtaju se s desne strane granice sustava +G1 <-- Partner +G4 <-- Partner +G5 <-- Partner +G6 <-- Partner +G1 <-- Admin +G7 <-- Admin +@enduml diff --git a/docs/puml/3-1-unideal-prijava-UC.puml b/docs/puml/3-1-unideal-prijava-UC.puml new file mode 100644 index 0000000..f1f2ab6 --- /dev/null +++ b/docs/puml/3-1-unideal-prijava-UC.puml @@ -0,0 +1,62 @@ +' ============================================================================== +' 3-1-unideal-prijava-UC.puml +' +' Svrha: Prijava i profil: kako se student, partner i administrator prijavljuju i uređuju profil (UC-1.1 – UC-1.4). +' Autor: Elide Babić +' AI: Nacrt je izrađen uz pomoć alata Claude prema uputama autorice; +' autorica ga je iscrtala, provjerila prema specifikacijama u 3.2 i +' odgovara za sadržaj. +' +' Diagram level: System Requirements +' Diagram type: Use Case Diagram +' ============================================================================== + +@startuml +' Smjer veza (predavanja, slajd 24): aktivni akter -> obrazac, obrazac -> pasivni akter. +title UniDeal – prijava i profil (Slika 3.2) +left to right direction + +skinparam shadowing false +skinparam defaultFontName Arial +skinparam ArrowColor #212529 + +skinparam actor { + BackgroundColor #F8F9FA + BorderColor #212529 + BackgroundColor<> #FFF3CD + BorderColor<> #856404 +} + +skinparam usecase { + BackgroundColor #E7F1FF + BorderColor #0D6EFD +} + +actor "Student" as Student +actor "Partner" as Partner +actor "Administrator" as Admin + +actor "Pružatelji identiteta\n(Microsoft, Google)" as IdP <> +actor "Resend\n(e-mail)" as Mail <> + +rectangle "Sustav UniDeal" { + (UC-1.1\nPrijava studenta\nMicrosoft računom) as UC11 + (UC-1.2\nPrijava partnera Google\nračunom ili e-mailom) as UC12 + (UC-1.3\nPrihvaćanje uvjeta\nkorištenja) as UC13 + (UC-1.4\nUređivanje profila i\ndeaktivacija računa) as UC14 +} + +Student --> UC11 +Student --> UC14 +Partner --> UC12 +Partner --> UC14 +Admin --> UC14 + +' Uvjeti korištenja prikazuju se samo pri prvoj prijavi. +UC11 <.. UC13 : <>\n[prva prijava] +UC12 <.. UC13 : <>\n[prva prijava] + +UC11 --> IdP +UC12 --> IdP +UC12 --> Mail +@enduml diff --git a/docs/puml/3-1-unideal-student-UC.puml b/docs/puml/3-1-unideal-student-UC.puml new file mode 100644 index 0000000..b3542a6 --- /dev/null +++ b/docs/puml/3-1-unideal-student-UC.puml @@ -0,0 +1,71 @@ +' ============================================================================== +' 3-1-unideal-student-UC.puml +' +' Svrha: Student i kuponi: pretraga, karta, favoriti, kuponi, recenzije i obavijesti (UC-2.4, UC-4.1, UC-4.2, UC-4.4, UC-5.1 – UC-5.4). +' Autor: Elide Babić +' AI: Nacrt je izrađen uz pomoć alata Claude prema uputama autorice; +' autorica ga je iscrtala, provjerila prema specifikacijama u 3.2 i +' odgovara za sadržaj. +' +' Diagram level: System Requirements +' Diagram type: Use Case Diagram +' ============================================================================== + +@startuml +' Smjer veza (predavanja, slajd 24): aktivni akter -> obrazac, obrazac -> pasivni akter. +title UniDeal – pretraga, kuponi i recenzije (Slika 3.4) +left to right direction + +skinparam shadowing false +skinparam defaultFontName Arial +skinparam ArrowColor #212529 + +skinparam actor { + BackgroundColor #F8F9FA + BorderColor #212529 + BackgroundColor<> #FFF3CD + BorderColor<> #856404 +} + +skinparam usecase { + BackgroundColor #E7F1FF + BorderColor #0D6EFD +} + +actor "Posjetitelj" as Visitor +actor "Student" as Student +actor "Partner" as Partner + +actor "Google Maps API" as Maps <> +actor "Resend\n(e-mail)" as Mail <> + +' Student može sve što i posjetitelj. +Student -|> Visitor + +rectangle "Sustav UniDeal" { + (UC-4.1\nPretraga i\nfiltriranje ponuda) as UC41 + (UC-4.2\nPregled partnera\nna karti) as UC42 + (UC-4.4\nSpremanje u favorite) as UC44 + (UC-2.4\nPraćenje kategorija\ni partnera) as UC24 + (UC-5.1\nGeneriranje kupona\nza ponudu) as UC51 + (UC-5.3\nPregled povijesti\nkupona) as UC53 + (UC-5.4\nOcjenjivanje\npartnera) as UC54 + (UC-5.2\nPotvrda korištenja\nkupona) as UC52 +} + +Visitor --> UC41 +Visitor --> UC42 + +Student --> UC44 +Student --> UC24 +Student --> UC51 +Student --> UC53 + +' Ocjena se ostavlja iz povijesti kupona, za iskorišten kupon. +UC53 <.. UC54 : <>\n[kupon iskorišten] + +Partner --> UC52 + +UC42 --> Maps +UC24 --> Mail +@enduml diff --git a/docs/puml/4-3-unideal-domain-CD.puml b/docs/puml/4-3-unideal-domain-CD.puml index 47e1e8a..03efe2e 100644 --- a/docs/puml/4-3-unideal-domain-CD.puml +++ b/docs/puml/4-3-unideal-domain-CD.puml @@ -5,7 +5,14 @@ ' OfferService, PartnerService i CouponService te sučelja repozitorija ' kojima je trajna pohrana apstrahirana. Servisi primaju repozitorije ' kroz konstruktor. +' Raspored: odozgo prema dolje: vrijednosti (enum), domenski razredi, servisi, +' sučelja repozitorija, implementacije za Supabase. Svaki stupac +' pripada jednom pojmu: partner, ponuda, kupon. ' Kod: src/domain, src/services, src/repositories +' Autor: Elide Babić +' AI: Nacrt je izrađen uz pomoć alata Claude prema uputama autorice; +' autorica ga je iscrtala, usporedila s kodom, preuredila i +' odgovara za sadržaj. ' ' Diagram level: Structural / Domain Design ' Diagram type: Class Diagram @@ -17,141 +24,177 @@ title UniDeal – domenski model ponuda, partnera i kupona skinparam shadowing false skinparam defaultFontName Arial -skinparam packageStyle rectangle skinparam ArrowColor #212529 +skinparam nodesep 60 +skinparam ranksep 50 skinparam class { BackgroundColor #E7F1FF BorderColor #0D6EFD } -package "Aplikacijski sloj" { - class OfferService { - +search(filter: OfferFilter): OfferListing[] - +getActiveOffer(id: String): OfferListing - +getPartnerOffers(partnerId: String): Offer[] - +getOwnOffer(ownerId: String, offerId: String): Offer - +createOffer(ownerId: String, data: OfferInput, photo: File): OfferErrors - +updateOffer(ownerId: String, offerId: String, data: OfferInput, photo: File): OfferErrors - +deleteOffer(ownerId: String, offerId: String): Boolean - } - class PartnerService { - +getAll(): Partner[] - +getByOwner(ownerId: String): Partner - +getCities(): String[] - +getProfile(id: String): Profile - } - class CouponService { - +issue(user: User, offerId: String): IssueResult - +getCoupon(id: String): Coupon - } +' ============================================================================== +' Vrijednosti (enum) +' ============================================================================== + +enum OfferStatus { + nacrt + aktivna + istekla +} +enum DiscountType { + postotak + iznos +} +enum UsageLimit { + jednom_po_studentu + neograniceno +} +enum CouponStatus { + izdan + iskoristen + istekao +} + +' ============================================================================== +' Domenski razredi +' ============================================================================== + +class Partner { + +id: String + +name: String + +category: String + +city: String + +address: String + +hours: String +} + +class Offer { + +id: String + +title: String + +description: String + +category: String + +categoryId: String + +discountType: DiscountType + +discountValue: Number + +discountLabel: String + +validUntil: String + +conditions: String + +status: OfferStatus + +photoUrl: String + +usageLimit: UsageLimit + +isActive(): Boolean + +isOncePerStudent(): Boolean + +canBeActivated(): Boolean + +canBeEdited(): Boolean +} + +class Coupon { + +id: String + +offerId: String + +studentId: String + +code: String + +status: CouponStatus + +issuedAt: Date + +validUntil: String + +isValid(): Boolean +} + +' ============================================================================== +' Servisi +' ============================================================================== + +class PartnerService { + +getAll(): Partner[] + +getByOwner(ownerId: String): Partner + +getCities(): String[] + +getProfile(id: String): Profile +} + +class OfferService { + +search(filter: OfferFilter): OfferListing[] + +getActiveOffer(id: String): OfferListing + +getPartnerOffers(partnerId: String): Offer[] + +getOwnOffer(ownerId: String, offerId: String): Offer + +createOffer(ownerId: String, data: OfferInput, photo: File): OfferErrors + +updateOffer(ownerId: String, offerId: String, data: OfferInput, photo: File): OfferErrors + +deleteOffer(ownerId: String, offerId: String): Boolean } -package "Domenski sloj" { - enum OfferStatus { - nacrt - aktivna - istekla - } - enum DiscountType { - postotak - iznos - } - enum UsageLimit { - jednom_po_studentu - neograniceno - } - enum CouponStatus { - izdan - iskoristen - istekao - } - class Offer { - +id: String - +title: String - +description: String - +category: String - +categoryId: String - +discountType: DiscountType - +discountValue: Number - +validUntil: String - +conditions: String - +status: OfferStatus - +photoUrl: String - +usageLimit: UsageLimit - +isActive(): Boolean - +isOncePerStudent(): Boolean - +canBeActivated(): Boolean - +canBeEdited(): Boolean - +discountLabel: String - } - class Partner { - +id: String - +name: String - +category: String - +city: String - +address: String - +hours: String - } - class Coupon { - +id: String - +offerId: String - +studentId: String - +code: String - +status: CouponStatus - +issuedAt: Date - +validUntil: String - +isValid(): Boolean - } - interface OfferRepository { - +findAll(): Offer[] - +findById(id: String): Offer - +findByPartner(partnerId: String): Offer[] - +create(partnerId: String, data: OfferInput): String - +update(id: String, data: OfferInput): void - +setPhoto(id: String, photoUrl: String): void - +delete(id: String): void - } - interface PartnerRepository { - +findAll(): Partner[] - +findById(id: String): Partner - +findByOwner(ownerId: String): Partner - } - interface CategoryRepository { - +findAll(): Category[] - } - interface CouponRepository { - +create(offerId: String, studentId: String, code: String): Coupon - +findById(id: String): Coupon - +findByStudentAndOffer(studentId: String, offerId: String): Coupon[] - } +class CouponService { + +issue(user: User, offerId: String): IssueResult + +getCoupon(id: String): Coupon } -package "Infrastruktura" { - class SupabaseOfferRepository - class SupabasePartnerRepository - class SupabaseCouponRepository +' ============================================================================== +' Sučelja repozitorija i implementacije +' ============================================================================== + +interface PartnerRepository { + +findAll(): Partner[] + +findById(id: String): Partner + +findByOwner(ownerId: String): Partner } -Partner "1" -- "0..*" Offer : objavljuje > -Offer --> OfferStatus -Offer --> DiscountType -Offer --> UsageLimit -Offer "1" -- "0..*" Coupon : ima > -Coupon --> CouponStatus +interface OfferRepository { + +findAll(): Offer[] + +findById(id: String): Offer + +findByPartner(partnerId: String): Offer[] + +create(partnerId: String, data: OfferInput): String + +update(id: String, data: OfferInput): void + +setPhoto(id: String, photoUrl: String): void + +delete(id: String): void +} +interface CategoryRepository { + +findAll(): Category[] +} -OfferService --> OfferRepository -OfferService --> PartnerRepository -OfferService --> CategoryRepository -PartnerService --> PartnerRepository -PartnerService --> OfferRepository -CouponService --> CouponRepository -CouponService --> OfferRepository +interface CouponRepository { + +create(offerId: String, studentId: String, code: String): Coupon + +findById(id: String): Coupon + +findByStudentAndOffer(studentId: String, offerId: String): Coupon[] +} + +class SupabasePartnerRepository +class SupabaseOfferRepository +class SupabaseCouponRepository + +' ============================================================================== +' Veze između domenskih razreda (jedan red: partner – ponuda – kupon) +' ============================================================================== + +Partner "1" -right- "0..*" Offer : objavljuje > +Offer "1" -right- "0..*" Coupon : ima > + +' Vrijednosti iznad razreda koji ih koristi +OfferStatus <-up- Offer +DiscountType <-up- Offer +UsageLimit <-up- Offer +CouponStatus <-up- Coupon + +' ============================================================================== +' Servisi koriste repozitorije (svaki servis ispod svojeg razreda) +' ============================================================================== + +Partner -[hidden]down- PartnerService +Offer -[hidden]down- OfferService +Coupon -[hidden]down- CouponService + +PartnerService -down-> PartnerRepository +PartnerService -down-> OfferRepository +OfferService -down-> OfferRepository +OfferService -down-> PartnerRepository +OfferService -down-> CategoryRepository +CouponService -down-> CouponRepository +CouponService -down-> OfferRepository + +' ============================================================================== +' Implementacije ispod sučelja +' ============================================================================== -SupabaseOfferRepository ..|> OfferRepository -SupabasePartnerRepository ..|> PartnerRepository -SupabaseCouponRepository ..|> CouponRepository +SupabasePartnerRepository .up.|> PartnerRepository +SupabaseOfferRepository .up.|> OfferRepository +SupabaseCouponRepository .up.|> CouponRepository @enduml - \ No newline at end of file From d6535035fcb2a6c2601b2882ee6420a2ce85575a Mon Sep 17 00:00:00 2001 From: Elide Babic Date: Fri, 20 Nov 2026 17:40:37 +0100 Subject: [PATCH 2/2] =?UTF-8?q?Napomene=20o=20neostvarenim=20UC-5.2=20?= =?UTF-8?q?=E2=80=93=20UC-5.4=20i=20ispravak=20pretrage=20u=20README-u=20(?= =?UTF-8?q?EB)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 2 +- docs/3-Obrasci-uporabe.md | 6 ++++++ 2 files changed, 7 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 739597a..68f5d84 100644 --- a/README.md +++ b/README.md @@ -13,7 +13,7 @@ Aplikacija je u izradi. Označene funkcionalnosti već rade na javnoj adresi, a **Ključne funkcionalnosti** - [x] Prijava studenata računom visokog učilišta (Microsoft), čime je potvrđen status studenta, a partnera Google računom ili e-mailom -- [x] Pretraga ponuda prema kategoriji, gradu, visini popusta i roku trajanja te prikaz partnera na interaktivnoj karti +- [x] Pretraga ponuda prema kategoriji i gradu te prikaz partnera na interaktivnoj karti; filtri po visini popusta i roku trajanja tek trebaju biti ostvareni - [x] Digitalni kupon s jedinstvenim kodom i QR kodom; potvrdu kupona kod partnera tek treba ostvariti - [ ] Ocjene i recenzije koje može ostaviti samo student koji je ponudu stvarno iskoristio - [x] Plaćanje pretplate partnera (Stripe); automatsko aktiviranje pretplate nakon plaćanja tek treba ostvariti diff --git a/docs/3-Obrasci-uporabe.md b/docs/3-Obrasci-uporabe.md index 68b9d9f..1a2cc36 100644 --- a/docs/3-Obrasci-uporabe.md +++ b/docs/3-Obrasci-uporabe.md @@ -212,6 +212,8 @@ _Trenutačno oblikovanje: favoriti (#26) još nisu ostvareni. Tablica `favorites ### UC-5.2: Potvrda korištenja kupona +_Trenutačno oblikovanje: potvrda kupona (#28) još nije ostvarena._ + | Element specifikacije | Opis | | :-------------------------------- | :--- | | **Primarni akter** | A-03 Partner | @@ -223,6 +225,8 @@ _Trenutačno oblikovanje: favoriti (#26) još nisu ostvareni. Tablica `favorites ### UC-5.3: Pregled povijesti kupona +_Trenutačno oblikovanje: povijest kupona (#30) još nije ostvarena._ + | Element specifikacije | Opis | | :-------------------------------- | :--- | | **Primarni akter** | A-02 Student | @@ -234,6 +238,8 @@ _Trenutačno oblikovanje: favoriti (#26) još nisu ostvareni. Tablica `favorites ### UC-5.4: Ocjenjivanje partnera +_Trenutačno oblikovanje: recenzije (#31) još nisu ostvarene; tablica `reviews` već postoji u bazi._ + | Element specifikacije | Opis | | :-------------------------------- | :--- | | **Primarni akter** | A-02 Student |