Dokumentacioni
Si funksionon BuildKos ERP
Një udhëzues i plotë me screenshot-e nga aplikacioni real — nga menaxhimi i projekteve dhe kontratave deri tek Faqja Publike që shet projektet tuaja online.
1. Hyrje
BuildKos ERP është një platformë e integruar e ndërtuar posaçërisht për kompanitë e ndërtimit dhe investitorët e pasurive të paluajtshme në Kosovë. Mbulon të gjithë ciklin e jetës së projektit — nga marrëveshja me pronarin e tokës, deri tek dorëzimi i çelësave te blerësi i fundit — me kontratat, pagesat dhe komunikimi me publikun të automatizuara.
Përdoruesit kryesorë
- · Drejtorë dhe menaxherë ekzekutivë
- · Menaxherë projekti dhe inxhinierë terreni
- · Ekipe shitjesh (menaxherë + agjentë)
- · Financierë dhe kontabilistë
2. Modulet e Aplikacionit (17 të dokumentuar)
Çdo modul ka ekrane të dedikuara, leje sipas roleve dhe audit log të veçantë. Më poshtë gjeni 17 modulet kryesore me screenshot-e nga aplikacioni real dhe shpjegime për secilin.
Dashboard Ekzekutiv
Pamja e parë sa hyni në sistem. Përmbledh gjithë statusin operativ dhe financiar të kompanisë në një ekran — pa pasur nevojë të kërkoni informacionin nëpër raporte.

- KPI në krye: Projekte Aktive, Njësi Totale, Totali i Shitjeve, Arkëtimet, Balanca e Hapur, Këste Vonuara
- Status njësish të agreguar: 'Të lira / Nën kontratë / Të shitura / Të rezervuara / Në interesim / Kompensim / Të bllokuara / Sold %'
- Grafiku i arkëtimeve mujore (6 muajt e fundit)
- Pie chart i statusit të njësive për kompaninë në tërësi
- Progresi i projekteve me përqindje (p.sh. Residenca Demo — 53%, 1 shituar/kontraktuar nga 8)
- Pipeline shitjesh me lead-et aktivë dhe asignimet e tyre
Projektet me Faza, Progres & KPI
Çdo projekt ka faqen e tij me KPI të dedikuar, fazat me peshë progresive, statuset e njësive, kontratat aktive, arkëtimet kumulative dhe shëndetin financiar. Sistemi kalkulon automatikisht përqindjen e plotë të realizimit duke marrë parasysh peshën e secilës fazë.

- Faqja e detajit me KPI: Progresi mesatar, Njësitë shituar/total, Buxheti, Kontratat aktive, Arkëtuar
- Status njësish të agreguar: të lira / nën kontratë / të shitura / të rezervuara / kompensim / të bllokuara
- Tab-e brenda projektit: Përmbledhje · Fazat · Njësitë · Kontratat · Financat · Shënime
- Fazat e ndërtimit me peshë (themeli 15%, struktura 35%, fasada 20%, mbarim 30%, etj.)
- Çdo fazë regjistron progresin nga inxhinieri i terrenit — me datë, autor dhe foto evidence
- Aktiviteti i fundit në fund të faqes për gjurmim real-time të ndryshimeve
Njësitë me Statuse të Drejtpërdrejta
Katalogu i plotë i njësive të të gjitha projekteve — banesa, lokale, parkim, garazh, dhoma magazine. Çdo njësi ka identifikues unik, sipërfaqe, çmim bazë dhe status të lidhur me kontratat aktive.

- Filtrim sipas projektit, statusit, tipit (banese/lokal/parkim), sipërfaqes, çmimit
- 5 statuse të standardizuara: 'i lirë', 'i rezervuar', 'nën kontratë', 'i shitur', 'në kompensim'
- Bulk-update — ndryshoni status për shumë njësi në një operacion (p.sh. lock-up i një pallati)
- Lidhje direkte me kontratat e secilës njësi (kush e ka rezervuar, kush e ka blerë, çmimi përfundimtar)
- Hotspot-e për planet e kateve që janë të dukshme në Faqen Publike
- Eksportim Excel me kolonat që dëshironi për bordin ose bankën
Detyrat me Drawer të Plotë — me Bashkëngjitje, Komente & Aktivitet
Sistemi i menaxhimit të detyrave brenda BuildKos. Klikoni mbi një detyrë dhe hapet një drawer i plotë me 5 tab-e: Detajet, Nën-detyrat, Komente, Bashkëngjitje (foto, PDF, dokumente) dhe Aktivitete. Çdo detyrë mund të lidhet me një entitet (projekt, kontratë, blerës, fazë).

- Detaj drawer me 5 tab-e: Detajet · Nën-detyrat · Komente · Bashkëngjitje · Aktivitete
- Asignim te një ose më shumë përdorues (agjent, inxhinier, menaxher)
- Lidhje opsionale me entitete: projekt, kontratë, blerës, fazë, njësi
- Afate dhe prioritete (i ulët / i mesëm / i lartë / urgjent)
- Nën-detyra (subtasks) me checklist + status për secilën
- Bashkëngjitje fotografish nga terreni, PDF, skenime — dokumentim i plotë i punës
- Komente në kontekst — diskutimet rreth detyrës qëndrojnë aty, jo në WhatsApp
- Njoftime automatike kur asignohet, kur afati po skadon, kur statusi ndryshon
Kalkulime Financiare
Modeluesi i investimit për një projekt të ri — para se ta filloni. Llogarit kostot totale, çmimet mesatare, zbritjet, mark-up-in dhe ROI-në e projektuar. Eksporton në Excel për banka dhe borde.

- Definimi i njësive që planifikoni të ndërtoni (banesa, lokale, parkim) me sipërfaqe dhe çmim
- Kosto kapitale (toka, materiale, punëtori, licenca, projektim, jashtëkontrata)
- Skenarë: 'i sigurt', 'realist', 'agresiv' me supozime të ndryshme çmimi
- Çmim mesatar/m² automatik, mark-up % kundër kostos, ROI në vite
- Cashflow projektues mujor: hyrje (rezervime, kontrata, këste) vs dalje (paguar)
- Eksportim Excel me të gjitha llogaritjet — dorezohet bankës për kredinë e ndërtimit
Financat — Buxhete & Cashflow
Pasqyra financiare e gjallë e kompanisë: çfarë keni planifikuar, çfarë po shpenzoni në fakt, sa po arkëtoni, dhe ku shkojnë paratë. Të gjitha të dhënat vijnë automatikisht nga kontratat, pagesat dhe shpenzimet e regjistruara.

- Buxhetet për çdo projekt — i planifikuar vs. aktuali, me alarme kur tejkalon kufijtë
- Cashflow real: arkëtimet (kontrata, këste, kompensime) vs. shpenzimet (kontrata nënkontraktore, kosto operative)
- Projeksione vjetore me bazë në kontratat aktuale + plane kësti
- Raporte mujore/tremujore: Profit & Loss, Balance Sheet i thjeshtuar, Variance Analysis
- Eksportim PDF për borde, banka, kontabilistë të jashtëm
- Audit log i plotë — çdo numër mund të gjurmohet deri tek dokumenti origjinal
Kompensimet me Pronarë Toke
Marrëveshjet me pronarët e tokës janë unike për ndërtimin në Kosovë — shpesh kompensohen me njësi në pallat (jo cash). BuildKos modelon këtë realitet me strukturë të dedikuar, jo me 'work-around' mbi kontratën standarde.

- Definim i kompensimit: njësi, cash, ose mix (p.sh. 2 banesa + €40,000 cash)
- Lidhje me parcelat e tokës nga regjistri i pronarëve
- Track i njësive të caktuara për kompensim — nuk mund të shiten më në treg
- Plan pagese për pjesën cash me këste të auto-gjeneruara
- Statuse: 'aktive', 'i kompletuar', 'i anuluar', 'i përfunduar'
- Audit log + dokumente të bashkëlidhura (kontratë origjinale, regjistër tokash, fotografi)
Nënkontraktorët & Punimet
Menaxhimi i nënkontraktorëve për punimet — themel, ndërtim, elektrike, ujësjellës, gypa, fasadë, mbarim, etj. Çdo kontratë lidhet me sasi/çmim dhe pagesat rrjedhin sipas progresit real në terren.

- Kontrata me nënkontraktor: pune, kohëzgjatja, çmimi total, kushtet e pagesës
- Punimet brenda kontratës — secila me sasi, çmim/njësi, totali
- Progresi i punimeve regjistrohet nga inxhinieri i terrenit (% e kryer)
- Pagesa parciale automatikisht e lidhur me % e punës së kryer — pa mbi-paguar
- Mbajtje 5% / 10% retencion deri në dorëzim
- Foto evidence të bashkëngjitura për çdo fazë të punimit
Dinamika e Punës (Progresi)
Pamja operative për menaxherët dhe inxhinierët — sa po ec çdo projekt, ku është bllokuar, dhe çfarë po zhvillohet ditë për ditë në terren.

- Listim i të gjitha fazave aktive përtej projekteve me përqindje progresi
- Filtra sipas projektit, fazës, menaxherit, statusit ('në kohë', 'i vonuar', 'i bllokuar')
- Regjistrim ditor i punimeve me orë, materiale, fotografi në terren
- Lidhje me nënkontraktorin që po e kryen (për gjurmim pagese)
- Pengesa (obstacles) — dokumentim i problemeve, përgjegjësia, plan i zgjidhjes
- Notification automatic kur një fazë skadon afatin pa u përfunduar
Kontratat e Shitjes
Pipeline-i i plotë i kontratave — nga rezervimi (afat 7-ditësh default) tek parakontrata dhe kontrata e plotë me planin e kësteve të auto-gjeneruar. PDF auto-gjenerohet, dhe çdo modifikim regjistrohet në audit log.

- Tre tipe kontrate: rezervim, parakontratë, kontratë e plotë
- Numërim automatik për tenant me format KON-YYYY-NNNN (parandalim kolizionesh)
- Lidhje me njësi + blerës + projekt + rezervim (kur konvertohet)
- Parapagimi, çmimi total, zbritja, vlera finale — të gjitha të auto-llogaritura
- Plan kësti me numër kësti, datë afati, shuma borxh — auto-gjenerohet kur kontrata aktivizohet
- PDF i kontratës auto-gjenerohet me parametrat e kompanisë dhe stampë digjitale
Pagesat — me Referenca & Void
Regjistri qendror i pagesave të blerësve. Çdo pagesë ka referencë banke unike, datë, metodë (cash / transfer / kartë), lidhje me këstin, dhe mund të void-ohet me arsye nëse shfaqet gabim — pa fshirje, gjithçka mbahet në historik.

- Indeksim partial-unique mbi (tenant, referencë banke) — nuk mund të regjistrosh dy herë të njëjtën pagesë
- Idempotency token per veprim — sigurojnë që rrjeti nuk dyfishon pagesa nëse përdoruesi klikon dy herë
- Void me arsye (jo soft-delete) — pagesa qëndron në historik, statusi i këstit auto-rikalkulohet
- Auto-lidhje me këstin që po paguhet, statusi i kontratës bëhet 'i përfunduar' kur i fundit paguhet
- Eksport CSV/Excel për kontabilist dhe rakordim bankar
- Audit log: kush ka regjistruar, kush ka void-uar, kur dhe pse
Këstet & Plani i Pagesës
Çdo kontratë e plotë ka një plan kësti automatik. Sistemi gjurmon këstet e paguara, pjesërisht të paguara, në pritje dhe të vonuara, dhe lëshon alarme kur afatet po vijnë.

- Statuset: 'paguar / pjeserisht paguar / në pritje / vonuar' me auto-tranzicione
- Penaliteti automatik për këste të vonuara (i konfigurueshëm si % në muaj)
- Flag 'kreditim' për këste të paguara me kredi bankare
- Idempotency: nuk mund të krijoni dy plane aktive për të njëjtën kontratë
- Alarme automatike përmes njoftimeve për këste që afrohen ose vonohen
- Detaj kësti me historikun e pagesave që e kanë ushqyer
Blerësit — Pipeline CRM
Pipeline-i CRM nga lead-i fillestar deri tek dorëzimi i çelësave. Çdo blerës ka fazën e tij (i kontaktuar / në negociim / i konvertuar), agjentin e asignuar, dhe historikun e plotë të kontakteve.

- 5 faza standarde të pipeline-it me lëvizje automatike sipas veprimeve
- Asignim te një agjent me përgjegjësi për follow-up
- Lead-et nga formulari i Faqes Publike kapen automatikisht me burim 'public-form'
- Histori e plotë e kontakteve, takimeve, mesazheve
- Konvertim me një klik: 'aktiv' → 'i konvertuar' krijon rezervimin + kontratën
- Eksport CSV për kampanja email ose follow-up jashtë sistemit
Kontaktet — Furnitorë & Bashkëpunëtorë
Direktoriumi i kontakteve B2B: furnitorë materialesh, nënkontraktorë, arkitektë, inxhinierë, banka, noterë. Përdoret nga moduli i nënkontraktorëve dhe shpenzimeve për lidhje të shpejta.

- Kategoritë: furnitor, nënkontraktor, arkitekt_inxhinier, jurist, bankë, tjetër
- Të dhëna fiskale (nr_fiskal), persona kontaktues, telefon, email
- Filtra dhe kërkim me index për perform të mirë në lista të mëdha
- Soft-delete: çdo kontakt ruan historikun e tij të kontratave edhe pas 'fshirjes'
- Lidhje me kontrata, shpenzime, pagesa — për audit financiar
Pronarët e Tokave
Regjistri i plotë i pronarëve të tokës me parcelat e tyre, marrëveshjet e kompensimit, dhe libri i tokës. Lidhet me modulin e Kompensimeve për gjurmim të njësive të caktuara si pagesë.

- Të dhëna personale: emri, mbiemri, telefoni, nr_personal, qyteti
- Parcelat me numër katastror, sipërfaqe m², vlerë/m² dhe vlerë totale
- Lidhje me projektin që po zhvillohet mbi atë tokë
- Histori e plotë e ndryshimeve me audit log
- Soft-delete me cascade: fshirja e pronarit fsheh parcelat por liron njësitë e kompensuara
- Eksport për noteri për transferim pronësie kur tranzaksioni mbyllet
Raportet — Eksport për Borde & Banka
Raporte të para-përcaktuara për mbledhje borde, banka kreditori dhe kontabilistë të jashtëm. Çdo raport mund të eksportohet në PDF ose Excel me parametrat që zgjidhni.

- Raporti i shitjeve mujor me grafikë trend-i
- Cashflow real vs. i planifikuar — variancë analizë për borde
- Raporti i pagesave të nënkontraktorëve me progres
- Raporti i kompensimeve — sa njësi janë caktuar pronarëve
- Raporti i njësive të lira/të rezervuara/të shitura — për banka
- Eksportim Excel me kolonat e personalizueshme
Funksionalitet horizontal
Foto & Dokumente nga Terreni
Inxhinieri i terrenit shkon në sheshndërtim me telefonin, ngarkon fotografi direkt në një detyrë, nën-detyrë ose fazë projekti. Menaxheri sheh evidencën nga zyra në kohë reale. Çdo foto ka datë, autor dhe lidhje me entitetin përkatës — gjurmim i plotë i progresit.
Ku mund të ngarkohen foto?
- · Bashkëngjitje në detyrë (tab "Bashkëngjitje")
- · Nën-detyra me foto evidence (subtask completion)
- · Foto progresi për çdo fazë projekti
- · Hotspot-e për planet e kateve (Faqja Publike)
- · Foto për nënkontraktor work-items
- · Dokumente bashkëngjitur me kontratat dhe pagesat
Çfarë formati?
- · Foto: JPG, PNG, WebP, HEIC (iPhone)
- · Dokumente: PDF për kontrata dhe skenime
- · Madhësi maksimale: 10 MB për skedar
- · Ruajtja: Vercel Blob (kriptuar dhe i sigurt)
- · Audit log: kush ka ngarkuar çfarë dhe kur
- · Eksport automatik në raporte për borde


Pse kjo bën ndryshim
Pa BuildKos, fotot e progresit shkojnë në WhatsApp, humbasin brenda javës, dhe asnjë nuk e mban mend kush bëri çfarë. Me BuildKos, çdo foto qëndron e lidhur me detyrën, fazën ose kontratën përkatëse — për gjithë jetën e projektit. Auditi i bankës ka evidencë, pronari ka prova, kompania ka histori.
Karakteristikë e veçantë
Faqja Publike — vitrina juaj online, e automatizuar
Çdo kompani ndërtimi që përdor BuildKos merr automatikisht një faqe publike profesionale — pa pasur nevojë për zhvillues, pa CMS shtesë, pa harxhime mujore për hosting.

Moduli "Faqja Publike" brenda dashboard-it — kjo është ku ju modifikoni hero-n, projektet në vitrinë, statistikat dhe formularin e kontaktit.
Faqe automatike për çdo projekt
Çdo ndryshim në dashboard (njësi e re, status i ndryshuar, çmim i përditësuar) shfaqet menjëherë në faqen publike.
CMS i thjeshtë me një klik
Përmbajtja menaxhohet nga moduli 'Faqja Publike' brenda dashboard-it — pa kod, pa zhvillues, pa shërbim të jashtëm.
SEO & Open Graph e gatshme
Meta tags, sitemap, hreflang dhe canonical URL — të gjitha të konfiguruara nga sistemi. Indeksohet shpejt në Google.
Lead-gen i integruar
Formulari i kontaktit dërgon lead-in direkt në CRM-në tuaj. Asnjë kopjim manual. Asnjë lead i humbur.
Pamje 'i lirë / i shitur' për njësi
Klientët potencialë shohin saktësisht cilat njësi janë në dispozicion në kohë reale. Pa email, pa telefonata të humbura.
Domain personal opsional
Ndërroni nga `juaj.buildkos.online` në `kompania-juaj.com` me një klik — DNS-i lidhet automatikisht përmes Vercel.


Pse kjo është vlerë reale
Një faqe e zakonshme e pasurive të paluajtshme në Kosovë kushton €2,000–€5,000 për ndërtimin fillestar dhe €50–€100/muaj për mirëmbajtje. Me BuildKos, e merrni falas, dhe ajo përditësohet vetë sa herë që ndryshoni një status njësie në dashboard.
4. Rolet e Përdoruesve
Sistemi ka 8 role të para-përcaktuara me leje të kufizuara në modulet dhe veprimet që mund të kryejnë.
| Roli | Qëllimi |
|---|---|
super_adminSuper Admin | Akses i plotë në çdo modul + konfigurime sistemi. |
drejtoriDrejtori | Pamja ekzekutive, raporte financiare, vendimet strategjike. |
financierFinancier | Buxhete, kalkulim, projeksione, pagesa, kompensime — pa qasje në strukturat e shitjeve. |
menaxher_shitjeshMenaxher Shitjesh | Pipeline CRM, asignim agjentësh, kontratat, statuset e njësive. |
menaxher_projektiMenaxher Projekti | Fazat, punimet, nënkontraktorët, progresi në terren. |
agjent_shitjeshAgjent Shitjesh | Lead-et e tij personale, rezervimet, kontaktet me blerës. |
inxhinier_terreniInxhinier Terreni | Vetëm progresi i fazave dhe statuset e punimeve. Pa qasje financiare. |
readonlyReadonly | Vetëm shikim — për investitorë, partnerë ose audit të jashtëm. |
5. Fluksi i Punës
Një projekt tipik kalon nëpër këto 7 faza, dhe BuildKos i mbështet të gjitha pa lënë boshllëqe:
- 1
Marrëveshja me pronarin e tokës
Regjistroni pronarin, parcelat, kushtet e kompensimit (cash, njësi ose mix). BuildKos gjeneron kontratën dhe librin e tokës.
- 2
Krijimi i projektit & njësive
Definoni fazat, njësitë (banesa, lokale, parkim), çmimet bazë dhe specifikimet. Faqja Publike përditësohet automatikisht.
- 3
Hap publik për shitje
Klientët shohin njësitë në Faqen Publike. Plotësojnë formularin → lead direkt në CRM → agjenti merr njoftim në kohë reale.
- 4
Rezervim & kontratë
Agjenti regjistron rezervimin (afat 7 ditë default), pastaj kontratën me planin e kësteve të auto-gjeneruar.
- 5
Pagesat & gjurmimi
Çdo pagesë regjistrohet; sistemi alarmon këste të vonuara, përditëson statusin e kontratës dhe rakorston cashflow-në.
- 6
Punimet & nënkontraktorët
Menaxheri i projektit regjistron progresin e fazave; pagesat e nënkontraktorëve janë të lidhura me sasinë e punimeve të kryera.
- 7
Dorëzimi & audit
Kur njësia kalon në 'i shitur', sistemi auto-mbyll kontratën, raporton në financa dhe arkivon çdo dokument në audit log.
6. Siguria & Multi-Tenant
BuildKos është ndërtuar nga themeli si platformë multi-tenant. Të dhënat e kompanisë suaj janë plotësisht të ndara nga ato të çdo kompanie tjetër — në nivelin e databazës.
Të dhënat e izoluara
Asnjë kompani tjetër nuk mund të shohë ose ndryshojë të dhënat tuaja. Garancia kontrollohet automatikisht në çdo veprim dhe është audituar nga ne mbi 99 herë.
Histori e plotë e veprimeve
Çdo krijim, ndryshim ose fshirje regjistrohet me datë, autor dhe pamjet para/pas. Të dhënat personale të ndjeshme fshihen automatikisht nga regjistri.
Hyrja skadon pas 8 orëve
Sesionet aktive mbyllen automatikisht pas 8 orëve për parandalim humbjeje aksesi. Ndryshimi i fjalëkalimit pas hyrjes së parë është i detyrueshëm.
Mbrojtje nga abuzimi
Limit i rreptë mbi përpjekjet e regjistrimit, hyrjes dhe rivendosjes së fjalëkalimit, që të bllokojë sulmet automatike para se të arrijnë te ju.
7. Regjistrimi & Onboarding
Krijimi i një hapësire të re zgjat më pak se 60 sekonda. Pa kartë krediti. Sistemi automatikisht:
- Krijon një tenant të ri me 15 ditë demo aktivisht.
- Mbushë automatikisht me të dhëna shembull sipas tipit (rezidencial, komercial ose mikse).
- Krijon llogarinë tuaj si super_admin me një fjalëkalim që duhet të ndryshoni në hyrjen e parë.
- Konfiguron subdomain-in
kompania-juaj.buildkos.onlineautomatikisht. - Aktivizon Faqen Publike — gati për të marrë vizitorë në sekonda.


Si të filloni — sot
Krijoni një llogari provë në më pak se një minutë. 15 ditë me akses të plotë, të dhëna shembull për ta provuar, asnjë kartë krediti. Faqja Publike juaj aktivizohet menjëherë.
Versioni: 2.1 · Përditësuar: Maj 2026 · Gjuha: Shqip
Për pyetje që nuk mbulohen këtu, na shkruani te skender.rama@gmail.com.