SaaS Platform (Website-as-a-Service) për Bizneset Lokale në Kosovë.
Përshkruaje biznesin tënd me fjalë të thjeshta — AI gjeneron faqen e plotë profesionale në më pak se një minutë.
Shumë biznese lokale në Kosovë — barberë, klinika, restorante, sallone bukurie, dyqane, rrobaqepëse — nuk kanë faqe interneti. Ata ekzistojnë vetëm në Instagram ose TikTok, ku klientët e kanë të vështirë të gjejnë orarin, shërbimet, ose çmimet.
LokalWeb e zgjidh këtë duke ofruar:
- Gjenerim me AI: Përshkruaje biznesin tënd në pak fjalë, dhe sistemi gjeneron faqen e plotë — tekst, layout, ngjyra, përmbajtje — bazuar në regjistrin autentik të Kosovës.
- Sistem Rezervimesh: Klientët rezervojnë termin online, 24/7.
- Dashboard Menaxhimi: Pronari mund të editoj tekstet, të ngarkojë foto, dhe të ndryshojë stilin pa kod.
Pronari i biznesit kalon nëpër një wizard 5-hapësh ku përshkruan biznesin me fjalët e veta. AI-i ndërton faqen mbi këtë informacion.
| Hapi 1: Të dhënat bazë | Hapi 2: Përshkrimi & Shërbimet |
|---|---|
 |
 |
| Hapi 3: Struktura | Hapi 4: Stili Vizual |
 |
 |
Note
Hapi 5 (toni, gjuha, përmbledhja e zgjedhjeve) është një ekran i shkurtër pickeri — nuk është paraqitur këtu.
Note
Wizard-i mbledh inputet (industria, qyteti, numri i biznesit, përshkrimi, shërbimet, toni i komunikimit, gjuha). AI-i përkthen këto inpute në një faqe profesionale me përmbajtje të personalizuar për tregun kosovar.
Çdo biznes që përfundon wizard-in merr një faqe publike unike në subdomain-in e vet:
| Hero — Faqja Publike | Shërbimet — Faqja Publike |
|---|---|
 |
 |
Çdo faqe është:
- Plotësisht responsive — punon në desktop, tablet, mobile
- E lokalizuar — tekst në regjistrin kosovar
- Faktualisht e saktë — çmimet dhe shërbimet vijnë drejtpërdrejt nga inputet e përdoruesit, AI nuk shpik
- E dizajnuar — paleta, fontet dhe layout-i vijnë nga stile vizuale të para-definuara (WCAG compliant)
Pas gjenerimit, pronari menaxhon faqen përmes një dashboard intuitiv:
| Overview | Customization (Editim teksti & stili) |
|---|---|
 |
 |
- Wizard 5-hapësh për gjenerim të faqes me AI
- Editim i drejtpërdrejtë i tekstit të hero-s dhe historisë pas gjenerimit (pa rigjenerim)
- Menaxhim i shërbimeve me çmime dhe kohëzgjatje
- Konfigurim i orarit për çdo ditë të javës
- Galeri fotografike e ngarkuar në Supabase Storage
- Personalizim vizual përmes 8 stileve vizuale të para-validuara
- Booking Drawer modern me 3 hapa (Shërbimi → Orari → Konfirmimi)
- Mobile-first design — gjithçka punon në celular
- Kontakt direkt përmes WhatsApp dhe telefonit
- Multi-tenant arkitekturë përmes Next.js Middleware (subdomain routing)
- Row Level Security (RLS) në Supabase për izolim të dhënash për tenant
- AI Pipeline 4-fazësh me validim dhe post-processing
- Lab-CRUD Module: Implementim akademik i Layered Architecture (Repository → Service → API → UI) me CSV storage
Pjesa më teknike e projektit. Gjenerimi i një faqeje është një proces me 4 faza, jo një thirrje e vetme në model:
Wizard Inputs
↓
[Stage 1] Brand Brief Generator (Claude Haiku)
→ JSON i strukturuar: positioning, voice, target customer, defining traits
↓
[Stage 2] Theme Generator (Haiku ose Sonnet sipas tonit)
→ JSON me sections[]: hero, shërbimet, historia, footer
↓
[Stage 3] Post-processor (kodi tradicional)
→ Aplikon paleta nga stile vizuale
→ Vendos çmimet/kohëzgjatjet nga inputet e përdoruesit
→ Validon CTA-të kundër veprimeve reale të faqes
→ Aplikon zëvendësime leksikore (tani→tash, çfarë→çka, tek→te)
↓
[Stage 4] Validation & Rigjenerim
→ Skanon për fraza të ndaluara
→ Verifikon gjatësinë e teksteve
→ Rigjeneron një herë me feedback nëse dështon
↓
Faqja e Gjeneruar
Pse kjo arkitekturë: Modelet e AI-it janë krijues por jo të besueshëm për saktësi faktike. Pipeline-i ndan përgjegjësitë — krijimi i lihet AI-it, kontrolli i takon kodit. Rezultati është më i besueshëm se çdo prompt-engineering i izoluar.
Më shumë detaje teknike: docs/architecture.md
- Frontend: Next.js 14 (App Router), TypeScript, Tailwind CSS, shadcn/ui, Framer Motion
- Backend: Supabase (PostgreSQL, Auth, Storage, RLS)
- AI: Anthropic Claude (Haiku për brief, Haiku/Sonnet për tema)
- Deploy: Vercel
- State: TanStack Query (React Query) v5
- Maps: OpenStreetMap + Nominatim (gjeokodim)
Request (subdomain.lokalweb.com)
→ Next.js Middleware (subdomain detection)
→ Rewrite to /[subdomain] route
→ SSR Page Component
→ Supabase (RLS check)
→ Render
git clone https://github.com/VocaDev/Lokal_Web.git
cd Lokal_Webnpm install
cp .env.example .env.localVendos variablat në .env.local:
NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_anon_key
ANTHROPIC_API_KEY=your_anthropic_keynpm run devHapet në http://localhost:3000.
npm test # Vitest unit tests
npm run test:wizard # Playwright E2E (kërkon: npx playwright install)- Migrimi në Next.js 14 App Router
- Sistemi i Autentikimit & RLS
- Multi-tenancy (Subdomains)
- AI Pipeline 4-fazësh me Brand Brief + Theme Generation
- Post-processor me archetype palettes, lexical substitutions, validation
- Wizard 5-hapësh me stile vizuale
- Editim direkt i tekstit (hero/story) nga dashboard
- Menaxhim i shërbimeve, orarit, galerisë
- PWA support përmes next-pwa
- Deploy në Vercel
- Refactor i strukturës së seksioneve për diversitet më të madh në output
- Integrim me WhatsApp për notifikime
- Super Admin Panel për menaxhim të platformës
- Analitika për bizneset
- Sistem pagesash online për abonime
- Demo Plan — plani për prezantimin akademik
- Architecture — arkitektura teknike e plotë
- Project Audit — auditi i projektit
- Improvement Report — raporti i përmirësimeve
- Testing Strategy — strategjia e testimit
Ndërtuar nga Gentian Voca — Student i vitit të dytë në Software Engineering.
Projekti synon të ofrojë një zgjidhje reale për tregun kosovar dhe njëkohësisht të dëshmojë praktika moderne të zhvillimit të softuerit (multi-tenancy, AI integration, structured generation, validation pipelines, RLS, SSR).
Aktualisht i palicencuar. Të gjitha të drejtat të rezervuara.