Institutional Client Portal
Një platformë institucionale multi-tenant e strukturuar, ndërtuar për të centralizuar CRM, ciklin e jetës së kontratave, raportimin e granteve dhe faturimin në shkallë.
Ky sistem u zhvillua për të krijuar një infrastrukturë menaxhimi të shkallëzueshëm për klientët institucionalë në Shqipëri — OJQ, fondacione dhe organizata të financuara nga BE. Ai centralizon marrëdhëniet me klientët, proceset e kontratave, ndjekjen e etapave, raportimin e granteve dhe operacionet financiare në një platformë dygjuhësh. Arkitektura zëvendëson operacionet e fragmentuara të bazuara në fletëlllogaritëse me automatizim të strukturuar dhe transparencë të gatshme për auditim.
Klientët institucionalë në Shqipëri nuk kishin infrastrukturë menaxhimi digjital të ndërtuar për qëllime specifike. Operacionet kryheshin nëpërmjet zinxhirëve të shkëputur të emaileve, tabelave kompjuterike dhe dokumenteve PDF — pa bazë të dhënash të centralizuar klientësh, pa versionim të strukturuar kontratash, pa faturim të automatizuar dhe pa proces raportimi grantesh. Të dhënat jetonin në formate të shumta pa gjurmë auditimi, pa kontroll aksesi dhe pa mekanizëm shkallëzueshmërie. Kërkesat e pajtueshmërisë nga kuadri i financimeve të BE-së e komplikuan problemin: raportimi manual ishte me gabime dhe me vonesa kronike.
Arkitektura serverless edge-native u zgjodh për të eliminuar barrën e mirëmbajtjes së infrastrukturës duke garantuar performancë globale. Vendimi për të përdorur Cloudflare Workers u drejtua nga kërkesa për kohë përgjigjeje nën 50ms pa menaxhuar llogaritje të vazhdueshme. Supabase u zgjodh për përputhshmërinë e tij PostgreSQL, Row Level Security të integruar dhe aftësinë për të zbatuar izolimin e të dhënave për organizatë në shtresën e bazës së të dhënave — jo në shtresën e aplikacionit — që është vendi i duhur për të. Ndarja e përgjegjësive nëpër tre Workers (api-gateway, invoices, proposals) siguron që çdo shërbim ka një përgjegjësi të vetme dhe mund të vendoset, shkallëzohet ose zëvendësohet në mënyrë të pavarur.
System Layers
- Multi-tenant CRM with organisation-scoped data isolation
- Contract lifecycle management with version history
- Grant milestone tracking and structured reporting
- Approval-gated proposal state machine
- Automated PDF invoice generation (HTML→PDF, server-side)
- Albanian VAT computation and fiscal line items
- Role-based access control (admin / manager / viewer)
- Bilingual UI — English and Albanian
- Audit log on all state transitions
- Structured database views for reporting aggregation
Skema është normalizuar në formën e tretë normale nëpër organizata, kontakte, projekte, kontrata, etapa, fatura, propozime dhe aktivitete. Fushat e statusit përdorin enum PostgreSQL — jo vargje nullable — për të zbatuar tranzicione të vlefshme gjendjeje në shtresën e bazës së të dhënave. Kolonat slug janë të indeksuara me unike për rrugëzim URL të parashikueshëm. Të gjitha tabelat mbajnë timestamps created_at dhe updated_at, me një trigger automatik që mirëmban updated_at në çdo shkrim. Politikat Row Level Security zbatojnë izolimin e kufizuar nga organizata.
Ndërfaqja ndjek një paraqitje minimale, të dendur me informacion të optimizuar për efikasitet operacional dhe jo për përshtypje vizuale. Kufizimi kryesor i dizajnit është se përdoruesit institucionalë kalojnë orë në ditë në këtë sistem — ndaj qartësia, parashikueshmëria dhe shpejtësia e navigimit kanë prioritet ndaj elaborimit estetik. Sistemi i ngjyrave dark-first zvogëlon lodhjen e syve për përdoruesit administrativë. CTAtë janë pozicionuar inline me hapat e procesit për të minimizuar ndërrimin e kontekstit. Mbështetja dygjuhësh trajtohet nëpërmjet ndërrimit të lokalitetit, jo dyfishimit të faqes.
Siguria zbatohet në katër shtresa: rrjet (Cloudflare WAF dhe zbehje DDoS), transport (TLS i zbatuar nga Cloudflare), aplikacion (validimi JWT i Supabase Auth në çdo kërkesë Worker) dhe të dhëna (Row Level Security e PostgreSQL). Headers e sigurisë HTTP janë vendosur globalisht. Mbivendosjet e UI administrativ zbatojnë bllokimin e rrotullimit të trupit dhe rolet ARIA dialog. Linkut e jashtëm përdorin rel="noopener noreferrer". robots.txt kufizon hyrjen e crawlerit në /admin. Asnjë sekret nuk mbahet në kod të aksesueshëm nga klienti.
Të gjitha faqet frontend janë vendosur në Cloudflare Pages me caching global edge — duke eliminuar latencën e serverit origjinal për përmbajtje statike dhe të gjeneruar ISR. Komponentët e serverit ekzekutohen në edge, jo në një rajon të centralizuar. Pyetjet Supabase përdorin projeksion selektiv të kolonave (jo SELECT *) në endpoint-et e listimit. Indekset e filtruara nga statusi (indekse parciale) zvogëlojnë kohën e skanimit.
Platforma zëvendësoi një process të fragmentuar manual nëpër email, tabela kompjuterike dhe dokumente PDF të shkëputura. Klientët institucionalë kanë tani një sistem të strukturuar dhe të gatshëm për auditim për menaxhimin e ciklit të tyre të plotë operacional. Operacionet e brendshme që më parë kërkonin mjete të shumta dhe barasnim manual tani trajtohen në një platformë të vetme me tranzicione gjendjeje të zbatuara dhe histori të plotë auditimi.
Arkitektura multi-tenant ofron një rrugë direkte azhurnimi drejt vendosjes në nivel federimi. Zgjerimeve të planifikuara përfshijnë një shtresë raportimi me asistencë AI duke përdorur pgvector, një portal statusi propozimesh të hapur për palët e interesuara dhe integrimin me API-të fiskale të qeverisë shqiptare për raportim automatik tatimor.
Ndërtoni infrastrukturë të ngjashme për organizatën tuaj.