SaaS Billing & Proposal Engine
Një motor automatizimi serverless propozim-faturë me procese të kontrolluara nga miratimi, pajtueshmëri me TVSH shqiptare dhe gjenerim PDF edge-native.
Ky sistem u zhvillua për të zëvendësuar krijimin manual të propozimeve dhe ndjekjen e faturave nëpër studioje shqiptare kreative dhe teknologjike. Ai fut një proces të strukturuar të kontrolluara nga miratimi. Motori vendoset si një shtresë shërbimi të kompozueshëm, konsumohet nga portali institucional dhe është projektuar për ripërdorim nëpër organizata të shumta klienti.
Menaxhimi i propozimeve në agjenci shqiptare ishte krejtësisht manual: dokumente Word të dërguara me email, pranimi i konfirmuar verbalisht, shumat e faturave të llogaritura me dorë dhe TVSH-ja e aplikuar në mënyrë jo konsistente. Nuk kishte histori versionesh, gjurmë auditimi miratimi, konvertim të automatizuar nga propozim i miratuar në faturë dhe asnjë mekanizëm pajtueshmërie fiskale.
Cloudflare Workers u zgjodh ndaj serverit tradicional sepse proceset e propozimeve dhe faturimit janë drejtuar nga ngjarjet. Qasja e makinës së gjendjes zbatohet në shtresën e bazës së të dhënave duke përdorur tipin enum PostgreSQL, jo logjikën e aplikacionit, duke e bërë të pamundur krijimin e tranzicioneve të pavlefshme të gjendjes nëpërmjet thirrjeve API.
System Layers
- Proposal draft, edit, and versioned submission
- Approval-gated state machine (draft → submitted → approved → contracted)
- Automated proposal-to-invoice conversion on approval
- Albanian VAT computation and fiscal line item validation
- Server-side PDF generation with branded template
- PDF delivery and Cloudflare R2 storage
- Invoice status lifecycle: open → paid → void → uncollectible
- Approval audit log with actor and timestamp
- Multi-currency line item support
- Role-gated access: only managers can approve proposals
Propozimet dhe faturat ruhen në tabela të normalizuara të veçanta me marrëdhënie çelësi të huaj. Artikujt e propozimit janë një tabelë fëmijë. Kolonat e statusit përdorin enum PostgreSQL me tranzicione të vlefshme strict të zbatuara nëpërmjet kufizimeve të bazës së të dhënave. Çdo ndryshim statusi shkruhet në një tabelë regjistrimi auditimi të pandryshueshme.
Redaktori i propozimit ndjek një paraqitje formulari të strukturuar — seksion pas seksioni — për të zbatuar plotësinë para dorëzimit. Fushat e kërkuara vlerësohen nga ana e klientit me reagim të menjëhershëm. Procesi i miratimit paraqitet si një veprim i vetëm i dukshëm i disponueshëm vetëm për përdoruesit me rolin menaxher. Të gjitha veprimet shkatërruese kërkojnë një hap konfirmimi.
JWT tokens vlerësohen në çdo kërkesë Worker — nuk zgjerohet besimi ndaj frontend. Workers i propozimeve verifikon që përdoruesi i kërkimit i përket organizatës që zotëron propozimin para çdo operacioni lexim ose shkrim. Veprimet e miratimit janë të dyfish-të mbrojtura. PDF-të e gjeneruara ruhen në kova private Cloudflare R2 me URL-a të nënshkruara me skadim 1-orësh.
Fillimi i ftohtë i Worker është minimal — Cloudflare Workers përdorin izolate V8, jo kontejnerë. Pyetjet e bazës së të dhënave përdorin indeks të kompozuar. Gjenerimi i PDF është asinkron. Historitë e mëdha të propozimeve janë faqëzuar nga ana e serverit me faqëzim të bazuar në cursor.
Cikli propozim-faturë që më parë kërkonte hapa të shumtë manualë nëpër email, tabelë dhe softuer kontabiliteti është tani një process i strukturuar, i auditueshem, me platformë të vetme. Motori është vendosur nëpër dy llogari klienti institucional dhe trajton operacione aktive të faturimit.
Zgjerimeve të planifikuara përfshijnë integrimin direkt me API-të e autoritetit fiskal shqiptar për pajtueshmëri e-faturë, nënshkrim elektronik, barazim automatik i pagesave dhe një portal pranimi propozimesh të hapur për klientët.
Ndërtoni infrastrukturë të ngjashme për organizatën tuaj.