Thesara – dokumentacija

1. Uvod u Thesaru

Thesara je online marketplace za mini-aplikacije i male igre koje se pokreću direktno u pregledniku. Ideja je jednostavna:

• korisnici mogu u par klikova pronaći i pokrenuti korisne alate ili zabavne mini-igre
• kreatori mogu vrlo brzo objaviti svoje mini-aplikacije (često generirane uz pomoć AI alata) bez brige o hostingu, deployu i infrastrukturi

Svaka mini-aplikacija vrti se u sigurnom sandboxu unutar Thesara sučelja. Thesara brine o hostingu, spremanju stanja, sigurnosti i integracijama, dok se kreator fokusira isključivo na logiku i UI svoje aplikacije.

2. Za koga je Thesara

3. Osnovni pojmovi

4. Prvi koraci – korisnici

4.1. Dolazak na Thesaru

Thesara je web platforma – dovoljno je otvoriti glavni URL u pregledniku. Početna stranica prikazuje istaknute i trend aplikacije ("Trending now"), kratke opise i oznake kao što su FREE i NEW.

Kao posjetitelj možeš pregledavati ponudu i pokrenuti mnoge besplatne aplikacije bez prijave. Za neke naprednije funkcije ipak će biti potreban korisnički račun.

4.2. Registracija i prijava

Korisnički račun ti omogućuje:

• koriÅ¡tenje privatnih soba i PIN-om zaÅ¡tićenog sadržaja
• potencijalnu kupnju plaćenih aplikacija ili pretplata
• personalizirane značajke (favoriti, povijest, NoAds status)

Prijava je moguća putem gumba Sign In u zaglavlju. Podržani načini prijave (npr. prijava mailom ili preko identity providera) definirani su u samom sučelju i mogu se s vremenom proširiti.

4.3. Osnovna navigacija

• Na naslovnici vidiÅ¡ istaknute aplikacije i osnovne statistike (npr. broj objavljenih aplikacija).
• Pritiskom na karticu aplikacije otvaraÅ¡ detaljan pogled s opisom, uputama i gumbom za pokretanje (Play).
• Kroz izbornik možeÅ¡ doći do FAQ-a, dokumentacije i stranice za povratne informacije.

5. Korištenje aplikacija (players)

5.1. Pokretanje aplikacije

Kad pronađeš aplikaciju koja te zanima, klikni na nju i zatim na gumb Play. Otvorit će se posebna stranica na kojoj se aplikacija učitava u sandboxiranom iframeu.

Većina aplikacija radi odmah bez ikakve dodatne pripreme. Ako aplikacija koristi sobe ili PIN (npr. za zajedničku listu), bit ćeš upitan želiš li:

• koristiti zajedničku demo sobu
• kreirati vlastitu sobu s PIN-om
• ili ući u sobu pomoću PIN-a koji si dobio od kreatora

5.2. Besplatne i plaćene aplikacije

Aplikacije na Thesari mogu biti:

• besplatne (FREE) – svi ih mogu koristiti
• plaćene – pristup je vezan uz jednokratnu kupnju ili pretplatu

Za plaćene aplikacije plaćanje se obrađuje preko sigurnog pružatelja usluge plaćanja (npr. Stripe). Broj kartice i osjetljivi podaci ne prolaze kroz Thesara servere.

5.3. Privatnost i dozvole

Mini-aplikacije rade u izoliranom sandboxu i nemaju direktan pristup tvojim lozinkama, kolačićima, Thesara računu ili drugim tabovima u pregledniku. Sve što aplikacija vidi su podaci koje joj sam uneseš i ono što pohrani u svoje server-side spremište.

Ako aplikacija traži pristup dodatnim uslugama (npr. vlastitom vanjskom API-ju), kreator će to jasno navesti u opisu aplikacije.

6. Prvi koraci – kreatori

6.1. Otvaranje kreatorskog računa

Kreator i obični korisnik koriste isti korisnički račun. Da bi objavio aplikaciju, prvo se prijavi na Thesaru, a zatim u glavnom izborniku odaberi Publish App ili My Projects.

Standardni (besplatni) račun predviđen je za objavu ograničenog broja aplikacija (npr. jedne aktivne mini-aplikacije). Za veći broj projekata predviđen je napredni / Pro plan, opisan u zasebnom poglavlju ove dokumentacije.

6.2. Podržane vrste aplikacija

Thesara je optimizirana za frontend mini-aplikacije koje rade u pregledniku:

• React ili drugi moderni JS framework
• plain HTML/CSS/JS bundle
• aplikacije generirane uz pomoć AI alata (LLM-ovi)

Backend logika (ako ti treba) treba biti iza vlastitog API-ja ili neke treće usluge – Thesara ne pokreće tvoje server-side procese, već služi kao siguran hosting i sandbox za frontend dio.

7. Objavljivanje aplikacija

Postoje dvije glavne rute za objavu aplikacije:

• Inline kod – zalijepiÅ¡ izvorni kod komponente, Thesara sve bundla umjesto tebe
• Upload bundle ZIP-a – za naprednije scenarije, kada već imaÅ¡ generirani dist/ ili sličan folder

7.1. Objava putem inline koda

1. U zaglavlju odaberi Publish App.
2. Odaberi način „inline code“ (ili sličnu opciju u sučelju).
3. Zalijepi kod svoje aplikacije – najčešće React/TSX komponenta (AI model ti može generirati primjer prilagođen Thesari).
4. Ispuni osnovne metapodatke:
   • naziv aplikacije
   • kratak i dugi opis
   • jezik(i) i kategorija
   • thumbnail / cover slika (opcionalno)
5. Odaberi vidljivost (public / unlisted / private) i eventualne opcije soba / storagea.
6. Spremi i pokreni objavu.

Nakon toga kreira se "build" tvoje aplikacije: Thesara dodaje potrebne shadere, wrapper komponentu i bundla kod u jedan app.js koji se koristi u Play pogledu.

7.2. Objava putem ZIP bundla

Ako već imaÅ¡ gotov bundle (npr. dist/ iz vlastitog build sustava), možeÅ¡ ga zapakirati u ZIP i uploadati.

1. Pripremi ZIP koji sadrži tvoj build (HTML/CSS/JS) i lock datoteku (package-lock.json, pnpm-lock.yaml ili slično) gdje je primjenjivo.
2. Odaberi upload / bundle objavu u publikacijskom sučelju.
3. Ispuni metapodatke jednako kao kod inline objave (naslov, opis, thumbnail…).
4. Pošalji bundle na obradu.

Worker proces na Thesari unutar sandboxa pokreće instalaciju ovisnosti, build, sanitizaciju HTML-a (uklanjanje nedozvoljenih script tagova, priprema CSP-a) i pripremu svega za Play pogled.

7.3. Pregled i odobravanje

Svaka javna aplikacija prolazi barem osnovni pregled kako bi se smanjio rizik od zloupotrebe i kršenja pravila. U tipičnom tijeku:

• nakon objave aplikacija dobiva status "pending review"
• nakon automatske i/ili ručne provjere, aplikacija se odobrava i postaje vidljiva u pregledu aplikacija i pretraživanju
• kreator dobiva trajni Play URL koji može dijeliti s korisnicima

Ako objava ili build ne prođu uspješno, sučelje prikazuje razlog i uputu što treba popraviti (npr. nedostajuće ovisnosti, pogrešna struktura bundla i sl.).

7.4. Ažuriranje postojeće aplikacije

Kad želiš nadograditi aplikaciju:

• u My Projects odaberi postojeći listing
• napravi novu objavu (inline ili ZIP) vezanu uz isti listing
• nakon uspjeÅ¡nog builda i odobrenja, novi build postaje "aktivan" za sve nove korisnike

8. Sobe i server-side spremište

8.1. Zašto sobe i storage?

Klasični localStorage u pregledniku radi samo na jednom ureÄ‘aju i u jednom pregledniku. Thesara umjesto toga nudi server-side storage i koncept soba:

• podaci se mogu dijeliti izmeÄ‘u viÅ¡e korisnika (npr. članovi obitelji u istoj shopping listi)
• stanje se sinkronizira izmeÄ‘u viÅ¡e tabova i ureÄ‘aja
• kreator u kodu radi s jednostavnim API-jem, dok Thesara brine o verzijama, konfliktima i sigurnosti

8.2. Kako sobe izgledaju za korisnika

Za aplikacije koje koriste sobe, Play stranica tipično nudi:

• gumb za kreiranje nove sobe (generira se PIN)
• polje za unos PIN-a i ulazak u postojeću sobu
• ponekad i demo sobu za brzo isprobavanje bez ikakve prijave

Sve promjene unutar sobe (npr. dodavanje stavke na listu) odmah su vidljive svim korisnicima spojenima na istu sobu.

8.3. Storage iz perspektive kreatora

Kreator u svojoj aplikaciji ne koristi direktno

window.localStorage, već storage helper:

• čitava logika spremanja ide kroz Thesara API (/api/storage)
• Thesara vodi verzije stanja i rjeÅ¡ava konflikte kada viÅ¡e korisnika mijenja podatke istovremeno
• sve to se odvija kroz sandboxirani bridge – aplikacija nikad ne vidi JWT token korisnika

Detaljan developerski API za storage i sobe nalazi se u tehničkoj dokumentaciji i primjerima koda (namijenjeno naprednim kreatorima).

9. Monetizacija i isplate

9.1. Model zarade za kreatore

Thesara podržava i besplatne i plaćene mini-aplikacije. Kada monetizacija bude u potpunosti aktivna, tipičan model je:

• kreator odreÄ‘uje cijenu za pristup svojoj aplikaciji
• Thesara obraÄ‘uje plaćanje preko sigurnog payment providera (npr. Stripe)
• prihod se dijeli prema unaprijed definiranom omjeru (npr. 70% kreator, 30% platforma)

Točan omjer, valute i detalji naknada uvijek su jasno naznačeni u uvjetima korištenja i kreatorskom sučelju.

9.2. Prag i dinamika isplate

Isplate se izvršavaju periodično (npr. mjesečno), nakon što tvoja akumulirana sredstva prijeđu minimalni prag (primjerice 50 USD ili ekvivalent u lokalnoj valuti). Detalji o aktualnom pragu i valuti nalaze se u kreatorskom dashboardu.

Kao kreator, sam si odgovoran za prijavu i plaćanje eventualnih poreza prema zakonima svoje države. Thesara osigurava preglednu povijest transakcija i izvode koje možeš koristiti u svojoj evidenciji.

9.3. Pretplate i NoAds

Osim jednokratnih kupnji, Thesara može nuditi i pretplatničke modele (npr. Pro plan ili NoAds paket) koji korisnicima daju:

• veći broj dostupnih aplikacija ili dodatne značajke
• isključivanje oglasa na cijeloj platformi
• specijalne oznake profila i pristup eksperimentalnim značajkama

Pojedini kreatori mogu svoje aplikacije vezati uz takve planove (npr. dodatne funkcije dostupne samo Pro korisnicima).

10. Pro, NoAds i Ambasador program

10.1. Pro plan (za kreatore i power korisnike)

Pro plan je zamišljen kao paket za korisnike koji intenzivno koriste Thesaru – bilo kao kreatori, bilo kao napredni korisnici. Tipične pogodnosti uključuju:

• povećan broj dopuÅ¡tenih aktivnih aplikacija po računu
• prioritetnu obradu buildova i odobravanja
• mogući pristup naprednim analitikama i alatima
• uključen NoAds status (bez oglasa na platformi)

Konkretnu strukturu Pro plana (cijena, točne pogodnosti) Thesara objavljuje u trenutku lansiranja plana i održava ažurnom u dokumentaciji.

10.2. NoAds status

NoAds status znači da se u sučelju Thesare korisniku više ne prikazuju oglasi. Status se može dobiti na različite načine:

• kroz plaćeni NoAds paket
• kroz Pro / Gold / Partner plan
• kao dio nagrade u Ambasador programu

Kada je NoAds aktivan, Thesara uopće ne učitava oglasne skripte, pa je iskustvo brže i čišće.

10.3. Ambasador program

Ambasador program je namijenjen najranijim i najaktivnijim podržavateljima Thesare – onima koji platformu promoviraju, sudjeluju u testiranju i svojim prijedlozima pomažu u oblikovanju budućih značajki.

Tipične pogodnosti za ambasadore mogu uključivati:

• trajni NoAds status i/ili Pro pogodnosti
• posebnu oznaku profila (badge) vidljivu uz aplikacije
• prioritetan pristup novim značajkama i beta testovima
• potencijalni referral / affiliate model (postotak od prihoda korisnika koje dovedu)

Detaljna pravila i uvjeti Ambasador programa definiraju se u zasebnom dokumentu i uvjetima sudjelovanja. Ovo poglavlje služi kao pregled glavne ideje programa.

11. Sigurnost i privatnost

11.1. Sandbox i izolacija aplikacija

Svaka mini-aplikacija na Thesari pokreće se u sandboxiranom iframe elementu s pojačanom Content Security Policy (CSP) i onemogućenim pristupom osjetljivim resursima parent stranice.

• aplikacija nema pristup tvojim Thesara kolačićima, lozinkama ili drugim tabovima
• svi pozivi prema Thesara API-ju prolaze kroz parent (Play stranicu), a ne direktno iz aplikacije
• JWT tokeni i autentikacija ostaju izolirani u parentu i nikad se ne Å¡alju u aplikacijski sandbox

11.2. Storage sigurnost

Storage API koristi verzije (ETag) i kontrolirane batch operacije kako bi spriječio nekonzistentnost i zloupotrebu. Tu spadaju:

• ograničenje veličine pojedinih zapisa
• ograničenje broja operacija u jednom zahtjevu
• rate-limiting po korisniku i prostoru imena (namespace)

Za tipične aplikacije (liste, kvizovi, jednostavne igre) ova ograničenja se u praksi ne osjete, ali značajno doprinose stabilnosti sustava.

11.3. Privatnost korisnika

Thesara prikuplja samo minimalan skup podataka potreban za rad računa, obračun eventualnih plaćanja i poboljšanje platforme. Detaljan popis i pravila obrade nalaze se u Politici privatnosti.

Za oglase i treće strane koriste se standardni mehanizmi privole (cookie / consent banner). Ako korisnik odbije personalizirane oglase ili kupi NoAds, oglasi se ne prikazuju.

12. Česta pitanja (sažetak)

Detaljni FAQ nalazi se na posebnoj stranici, ali ovdje je sažetak ključnih pitanja i odgovora.

• Å to je Thesara? – Marketplace za mini-aplikacije i igre u pregledniku, s fokusom na jednostavno objavljivanje (posebno za AI-generirane aplikacije) i siguran sandbox za korisnike.
• Kakve aplikacije mogu objaviti? – Sve Å¡to spada u kategoriju "lightweight" web aplikacije ili igre i poÅ¡tuje pravila koriÅ¡tenja (bez malicioznog koda, ilegalnog sadržaja itd.).
• Koliko traje objava? – Većinu vremena objava i build su gotovi u nekoliko minuta. Dodatno vrijeme može biti potrebno za ručni pregled.
• Gdje se pohranjuju moji buildovi? – Na Thesara storageu (lokalno ili u oblaku), uz automatizirane procese za build i posluživanje.
• Kada mogu povući zaraÄ‘ena sredstva? – Nakon Å¡to dosegneÅ¡ minimalni prag isplate i u redovnim ciklusima isplate (npr. mjesečno). Detalji se nalaze u kreatorskom dashboardu.
• Å to je Ambasador program? – Program za najaktivnije podržavatelje koji pomažu u promociji i razvoju platforme i za to dobivaju posebne pogodnosti (NoAds, Pro status, itd.).

13. Pojmovnik (brzi pregled)