# TuJE — specifikacija proizvoda (PRD)

**Status:** prijedlog za planiranje, 27. 10. 2026.  
**Opseg:** plan i prikaz proizvoda; ovaj paket ne isporučuje aplikaciju, poslužitelj ni PWA.  
**Namjena:** obiteljski inventar predmeta i njihovih stvarnih lokacija u domu.

## 1. Problem i cilj

Predmeti se spremaju u ladice, kutije i police, a članovi obitelji potom ne znaju gdje su. Fotografija prostorije može pomoći u orijentaciji, ali sama po sebi ne otkriva sadržaj zatvorene kutije. TuJE povezuje pretraživ inventar, hijerarhiju lokacija, fotografije i fizičke QR oznake. Korisnik uvijek potvrđuje prijedloge umjetne inteligencije prije spremanja.

**Primarni ishod:** član obitelji može upisati naziv ili kategoriju predmeta, vidjeti potvrđenu lokaciju i po potrebi skenirati QR oznaku na kutiji. **Sekundarni ishod:** administrator vidi kvalitetu i obuhvat inventara te može izvesti podatke.

## 2. Korisnici i uloge

| Uloga | Potreba | Predložene ovlasti |
|---|---|---|
| Vlasnik doma | Postaviti dom, članove, pravila i izvoz | Sve radnje, upravljanje pristupom i brisanjem doma |
| Urednik | Fotografirati, unositi i premještati predmete | Čitanje i izmjene inventara; bez upravljanja članovima |
| Preglednik | Pronaći predmet i vidjeti lokaciju | Čitanje samo odobrenog sadržaja |

U pilotu je dovoljan jedan dom s 2–5 članova. Više domova po računu predviđa se u modelu, ali nije preduvjet za pilot. Podaci nisu javni. Pozivnica i pristup fotografijama moraju biti eksplicitni.

## 3. Osnovni rječnik i pravila

- **Lokacija:** dom → kat/etaža → prostorija → komad namještaja → polica/ladica → kutija/spremnik. Međukoraci smiju izostati; predmet može biti pridružen prostoriji ili bilo kojem dubljem čvoru.
- **Predmet:** fizička stvar s nazivom, mogućom količinom, opisom, fotografijama, kategorijom, oznakama i jednom trenutačnom lokacijom. Povijest premještanja čuva se zasebno.
- **Spremnik:** čvor lokacije koji može imati QR oznaku; QR vodi na njegov zapis, a ne otkriva podatke bez prijave.
- **Potvrđeno:** korisnik je pregledao i prihvatio lokaciju, naziv ili odnos na fotografiji. AI prijedlog nikad nije potvrđen samim generiranjem.
- **Žarišna točka (hotspot):** ručno ili predloženo područje fotografije povezano s lokacijom/predmetom; površina slike nije dokaz sadržaja spremnika.

## 4. Ključni tokovi

1. **Uspostava doma:** vlasnik otvara dom, dodaje etaže i prostorije, poziva članove, odabire probne zone.
2. **Označavanje lokacije:** korisnik dodaje namještaj/policu/kutiju, ispisuje QR oznaku i provjerava da sken vodi na ispravan čvor.
3. **Unos predmeta:** korisnik otvara čvor skenom ili izborom stabla, fotografira predmet, upisuje minimum naziva i sprema. AI može predložiti naziv/kategoriju, uz vidljivo odbijanje i uređivanje.
4. **Pronalaženje:** korisnik pretražuje naziv, sinonim ili oznaku; rezultat prikazuje punu putanju i datum zadnje potvrde, a povezana fotografija pomaže orijentaciji.
5. **Premještanje:** urednik odabire novu lokaciju, potvrđuje promjenu i vidi zapis u povijesti. Poveznice na stare QR oznake lokacija ostaju stabilne.
6. **Pregled fotografije:** korisnik otvara fotografiju prostorije/namještaja, dodiruje žarišnu točku i vidi pridruženi čvor. Predložena žarišna točka ne objavljuje se bez potvrde.
7. **Administracija:** vlasnik vidi broj predmeta, nepopunjene ili neprovjerene lokacije i izvoz; statistika mora navesti definiciju broja i vrijeme izračuna.

## 5. Funkcionalni zahtjevi

| ID | Zahtjev | Kriterij prihvaćanja |
|---|---|---|
| F-01 | Hijerarhija lokacija | Korisnik može stvoriti, preimenovati i arhivirati čvor; sustav sprječava ciklus i premještanje čvora u vlastitog potomka. |
| F-02 | Inventar predmeta | Unos zahtijeva naziv i lokaciju; prikaz i pretraga vraćaju punu putanju; količina je opcionalna i jasno označena. |
| F-03 | Pretraživanje | Upit po nazivu/oznaci/kategoriji vraća samo zapise kojima korisnik smije pristupiti; prazan rezultat nudi pregled lokacija. |
| F-04 | QR oznake | Svaki označivi čvor ima stabilan ID i ispisivu oznaku; neautoriziran sken traži prijavu; QR ne sadrži osobne podatke. |
| F-05 | Fotografije i žarišne točke | Korisnik može dodati fotografiju i ručno postaviti/urediti/obrisati točku; koordinate ostaju ispravne pri promjeni veličine prikaza. |
| F-06 | AI prijedlozi | Predloženi naziv, kategorija, prostorija ili namještaj imaju izvor i status „na čekanju”; korisnik može prihvatiti, urediti ili odbiti pojedinačno. |
| F-07 | Povijest promjena | Premještanje predmeta bilježi tko, kada, odakle i kamo; preglednik ne može mijenjati povijest. |
| F-08 | PWA mobilno | Mobilni tok unosa i skeniranja radi na podržanim preglednicima; osnovni zasloni stanu na širinu 360 px bez vodoravnog pomicanja. |
| F-09 | Pregled na računalu | Administrator vidi stablo, pretraživanje i metrike pokrivenosti bez mobilnog skeniranja. |
| F-10 | Izvoz i obnova | Vlasnik može preuzeti strukturirani izvoz s metapodacima i fotografijama ili popisom njihovih referenci; probna obnova se dokumentira i provjerava. |
| F-11 | Pristup | Vlasnik može pozvati i ukloniti člana; uklonjeni član ne može čitati privatne podatke nakon opoziva sesije. |
| F-12 | Rad bez mreže | Ako je uključen u izdanje, korisnik vidi stanje sinkronizacije, može otvoriti već spremljen sadržaj i slati promjene nakon povratka veze. |

## 6. Nefunkcionalni zahtjevi i mjerila pilota

Pilot cilja jedan stvarni dom, najmanje 3 prostorije, 10 označenih spremnika i 100 unesenih predmeta. To su **pretpostavke za planiranje i provjeru**, ne obećanje trajanja ili komercijalnog ishoda.

| ID | Mjerilo | Način provjere |
|---|---|---|
| N-01 | Najmanje 90 % unaprijed odabranih 30 predmeta pronađeno u ≤ 30 s po pokušaju | Moderirani zadaci s članovima obitelji, od početka upita do prikaza točne lokacije |
| N-02 | Najmanje 95 % od 20 probnih QR skenova otvara ispravan čvor | Različiti uređaji, uobičajena kućna rasvjeta |
| N-03 | Nijedan AI prijedlog ne postaje potvrđeni podatak bez korisničke radnje | Automatizirani test stanja i pregled 20 pilot prijedloga |
| N-04 | Medijan otvaranja rezultata pretrage ≤ 2 s pri 1.000 predmeta na dogovorenoj pilot vezi | Instrumentirani preglednik; zabilježiti uređaj i mrežu |
| N-05 | Izvoz i testna obnova daju isti broj aktivnih čvorova i predmeta te iste ID-jeve | Usporedba brojeva i kontrolnih zbrojeva manifestacije |
| N-06 | Korisnik može uočiti nepotvrđenu ili zastarjelu lokaciju | Test korisničkog toka s 5 zadataka i bilježenjem nesporazuma |

Granice podataka: fotografije mogu sadržavati osjetljive detalje doma, dokumente ili lica. Prije učitavanja treba prikazati upozorenje i ponuditi uklanjanje/ponovno snimanje. Rok čuvanja obrisanih podataka, regija pohrane i pravila dijeljenja utvrđuju se prije implementacije.

### Izlazni kriteriji prvog izdanja

- U pilotu se može unijeti i pronaći 100 predmeta bez AI usluge i bez ručnog rada administratora u bazi.
- Za svaki rezultat pretrage jasno je koji je dom, prostorija i najdublji potvrđeni čvor lokacije; nepotvrđeno stanje nije prikazano kao činjenica.
- Neprijavljen korisnik ili član drugog doma ne može otvoriti predmet, fotografiju, QR odredište ni izvoz.
- Vlasnik može pregledati aktivne članove i ukloniti pristup prije šireg obiteljskog pilota.
- Izvoz i probna obnova imaju zapisane rezultate prije nego što se stvarni inventar smatra pouzdano pohranjenim.

## 7. Opseg po redoslijedu

- **MVP/pilot:** F-01 do F-05, F-07, F-08, F-09, F-11, osnovni izvoz iz F-10; AI kao ograničeni eksperiment F-06 nakon pouzdanog ručnog toka.
- **Sljedeće izdanje:** provjeren rad bez mreže F-12, obnovljiv izvoz s fotografijama, dorada AI i naprednije statistike.
- **Kasnije istraživanje:** neobavezna lokalizacija u zatvorenom i 3D prikaz; ne blokiraju osnovni inventar.

## 8. Odluke koje treba potvrditi

| ID | Odluka | Predloženi smjer | Tko potvrđuje |
|---|---|---|---|
| D-01 | Hosting i regija podataka | Odabrati prije uvoza stvarnih kućnih fotografija | Vlasnik proizvoda |
| D-02 | Mobilni preglednici | iOS Safari i Android Chrome kao minimalni probni skup; provjeriti stvarne uređaje | Vlasnik + razvoj |
| D-03 | Retencija | Definirati trajanje koša i sigurnosnih kopija | Vlasnik + razvoj |
| D-04 | AI pružatelj i proračun | Ograničeni opt-in pilot, mjesečni gornji iznos | Vlasnik |
| D-05 | Offline opseg | Čitanje spremljenih podataka prije uređivanja bez mreže | Vlasnik + razvoj |

## 9. Izričite granice tehnologije

Preglednik u PWA-u ne daje pouzdan pristup RSSI vrijednostima pojedinih Wi-Fi pristupnih točaka. GPS u zatvorenom prostoru ne može pouzdano zaključiti prostoriju. Postojeća četiri usmjerivača sama po sebi nisu jamstvo preciznog pozicioniranja: potreban bi bio odvojeni prototip s odgovarajućim uređajima, mjerenjima i kalibracijom. QR oznake ostaju pouzdana polazna metoda za potvrdu lokacije. AI može predložiti prostoriju ili namještaj iz konteksta fotografije, ali takav prijedlog nije fizičko mjerenje i zahtijeva potvrdu.

## 10. Opcionalni moduli nakon dokazanog pilota

Ove ideje nisu obveza MVP-a. Za svaku se prije razvoja bira prioritet i potvrđuje korist.

| ID | Mogućnost | Ovisnost | Kriterij prihvaćanja budućeg modula |
|---|---|---|---|
| X-01 | Posudbe i „vrati na mjesto” | F-02, F-07, članstvo | Predmet ima osobu kojoj je posuđen, očekivani povrat i originalnu lokaciju; vraćanje zatvara posudbu i ulazi u povijest. |
| X-02 | Jamstva, računi i upute | Privatni mediji, F-11 | Dokument je povezan s predmetom; rok je ručno potvrđen; preuzimanje poštuje iste uloge kao inventar. |
| X-03 | Rokovi trajanja i minimalna zaliha | Količina, potvrđeni datumi | Razlikovati dva pakiranja različitih rokova; podsjetnik se može isključiti; sustav ne pretpostavlja potrošnju bez promjene količine. |
| X-04 | Sezonske kutije i liste pakiranja | Lokacije, oznake, izvoz | Lista referencira postojeće predmete bez dupliranja; označavanje pakiranja ne premješta predmet bez potvrde lokacije. |
| X-05 | Slični i dvostruki predmeti | F-03, F-06 | AI nudi mogući duplikat; spajanje zahtijeva pregled oba zapisa i očuvanje povijesti; odbijanje ostavlja oba zapisa. |
| X-06 | Glasovni upit i prirodni jezik | Stabilna pretraga, dozvola mikrofona | Upit „gdje su rezervne baterije” vodi na postojeće rezultate; tekstualni upit uvijek ostaje dostupan; odgovor ne izmišlja lokaciju. |
| X-07 | Popis imovine za osiguranje | Izvoz, privatni dokumenti | Izvoz ima datum, korisnički unesene vrijednosti i dokazne fotografije; nije automatska tržišna procjena niti dokaz pokrića police. |
| X-08 | 360 obilazak s oznakama | I2, privatni mediji | Klik na oznaku vodi na potvrđenu lokaciju; nepoznate dimenzije i skriveni sadržaj ne prikazuju se kao činjenice. |