Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
151 changes: 47 additions & 104 deletions docs/3-Obrasci-uporabe.md

Large diffs are not rendered by default.

17 changes: 11 additions & 6 deletions docs/A-Pregled-aktivnosti-grupe.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,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
Expand Down Expand Up @@ -71,7 +71,7 @@
| Aktivnost ili rezultat | Član | Prijavljeni sati | Reprezentativni rezultat ili poveznica |
| --- | --- | --- | --- |
| Otvaranje repozitorija | FČ | 1 | 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Č | 2 | `docs/1-Projekt.md` |
| Opis projekta, osnovna Next.js aplikacija, objektno orijentirana struktura i prijava Google računom | MB | 8 | `README.md`, `src/` |
| Analiza zahtjeva | KB | 2 | `docs/2-Analiza-zahtjeva.md` |
Expand All @@ -80,15 +80,15 @@
| Upravljanje korisničkim računima i deaktivacija | FČ | 8 | Zadatak [#38], PR [#56] |
| Shema baze i migracije, RLS po ulogama, Supabase repozitoriji, zaštita ruta po ulozi, uređivanje profila, CI i README | MB | 22 | Zadaci [#2]–[#5], [#7]–[#9] |
| Registracija partnera s provjerom OIB-a | FL | 6 | Zadatak [#10], PR [#69] |
| 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Č | 6 | Zadatak [#37], PR [#68] |
| Javni profil partnera i uređivanje profila | FL | 2,5 | Zadatak [#11], PR [#70] |
| Upload logotipa partnera u Supabase Storage | FL | 3,5 | Zadatak [#13], PR [#71] |
| E-mail obavijesti preko Resenda i predlošci e-mailova Supabase Autha na hrvatskom | FL | 3 | Zadatak [#14], PR [#72] |
| 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Č | 3 | Zadatak [#32] |
| Dokumentacija i testovi temelja i autentifikacije | MB | 7 | 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Č | 7 | Zadatak [#39], PR [#78] |
| Statistika za administratora (u tijeku) | FČ | 7 | Zadatak [#42], PR [#79] (prikaz statistike bez prihoda od pretplata; prihod čeka #34) |
| Izrada, uređivanje i brisanje ponude te dijagram razreda (4.3.2) | KD | 15 | Zadatak [#16] |
Expand All @@ -102,7 +102,7 @@
| Obrasci uporabe administratorskog područja | FČ | 7 | UC-7.1 – UC-7.4; PR [#93] |
| Pregled aktivnosti grupe: A.1 Evidencija sastanaka, A.2 Plan rada i A.3 Aktivnosti i doprinosi članova | FČ | 3 | `docs/A-Pregled-aktivnosti-grupe.md`; PR [#96] |
| Ispitni slučajevi s ručnim ispitivanjem na produkciji, sljedivost zahtjeva F-025 – F-031, 6.3, 7.2 i A.5 | FČ | 6 | CT-7.1 – CT-7.4, ST-7.1 – ST-7.5; PR [#103] |
| 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` |
| Obrasci uporabe područja 4 (pretraga, karta i favoriti) | KB | 1 | Zadatak [#48], PR [#100]; UC-4.1 – UC-4.4 |
| Sljedivost i ispitivanje područja 4 | KB | 2 | PR [#100]; CT-4.1 – CT-4.4, ST-4.1 – ST-4.9 |
| Ključne arhitekturne odluke (4.1) | KB | 1,5 | Zadatak [#84], PR [#109] |
Expand All @@ -113,6 +113,8 @@
| Obrasci uporabe i sljedivost područja partnera | FL | 1,5 | PR [#99]; UC-2.1 – UC-2.4 |
| Ispitni slučajevi područja partnera | FL | 1 | PR [#106]; CT-2.1 – CT-2.3, ST-2.1 – ST-2.6 |
| Upravljanje repozitorijem i issueima, pregled i spajanje PR-ova te održavanje produkcije (Vercel) | MB | 10 | [GitHub Issues](https://github.com/matejban/UniDeal/issues), [GitHub PR-ovi](https://github.com/matejban/UniDeal/pulls) |
| 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
Expand Down Expand Up @@ -168,8 +170,11 @@ Graf broji samo commitove, pa ne prikazuje pregled i spajanje pull requestova (M
| 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

---

Expand Down
8 changes: 7 additions & 1 deletion docs/Home.md
Original file line number Diff line number Diff line change
Expand Up @@ -92,6 +92,7 @@ Kratak sažetak: [README – Uporaba umjetne inteligencije](../README.md#ai-usag
| ER dijagram 4.3.1 | Izvor dijagrama | Nacrt PlantUML-a prema SQL migracijama | Dijagram sam iscrtao na plantuml.com i usporedio s tablicama u Supabaseu, zadržao samo reprezentativne atribute i ispravio kardinalnosti veza | [`4-2-unideal-data-ERD.puml`](puml/4-2-unideal-data-ERD.puml), [4.3.1](4-Arhitektura-i-oblikovanje.md) |
| README | Izrada nacrta i jezično dotjerivanje | Nacrt opisa aplikacije, brzog početka i tablice tehnologija te dotjerani jezik i formatiranje | Korake brzog početka (`git clone`, `npm ci`, `.env.local`, `npm run dev`) prošao sam i provjerio; sam sam odlučio što se navodi kao ostvareno, a što pod Ograničenja | [README](../README.md) |
| Temelji i autentifikacija (#1 – #9, #53) | Objašnjenje | Objašnjenja Next.js-a, Supabasea, RLS-a i poruka o greškama | Kod sam napisao sam i provjerio lokalno (`npm run dev`, `npm run lint`, `npm run build`), automatskim testovima (`npm test` i SQL test RLS-a) i ručno na [www.unideal.site](https://www.unideal.site) | PR #57 – #65 |
| 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.

Expand All @@ -110,6 +111,8 @@ 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` |
| 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 s 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) |
| Karta za ručno označavanje lokacije nakon spremanja nove adrese zadržavala je staru oznaku | Ispitivanjem ST-4.6 | Karta se ponovno stvara kad se lokacija u bazi promijeni (PR #92) |
| Nacrt analize zahtjeva sadržavao je izmišljene datume i sastanak s asistentom koji se nije dogodio | Pregledom nacrta | Datumi i sastanak uklonjeni |
| Komponenta karte pozivala je setState izravno u efektu | `npm run lint` | Ispravljeno prije commita |
Expand All @@ -121,7 +124,9 @@ Stranice i artefakti koji nisu navedeni iznad izrađeni su bez pomoći generativ
| Nacrti su sadržavali krive nazive ruta, tablica i stupaca te putanje datoteka i naredbe | Usporedbom s kodom i shemom baze u Supabaseu te pokretanjem naredbi | Ispravljeno prema kodu i shemi |
| Nacrt ER dijagrama imao je krive kardinalnosti veza Profil – Partner, Partner – Pretplata, Kupon – Recenzija te Favorit i Pretplata na obavijesti | Usporedbom sa stranim ključevima i ograničenjima `unique` u migracijama | Ispravljeno: partner pripada najviše jednom profilu i ima najviše jednu pretplatu, kupon ima najviše jednu recenziju, a favorit i pretplata na obavijesti imaju zadan točno jedan od dvaju stranih ključeva |

<!-- 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. -->
<!--| [Netočna, izmišljena ili iz predloška preuzeta tvrdnja] | [Pregled, ispitivanje ili usporedba s aplikacijom] | [Ispravak s poveznicom] |

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.

<details>
<summary><strong>Primjer zapisa uporabe umjetne inteligencije</strong></summary>
Expand All @@ -141,3 +146,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.

</details>
-->
1 change: 0 additions & 1 deletion docs/assets/diagrams/3-1-crisismap-system-UC.svg

This file was deleted.

Loading
Loading