GeoTax — საქართველოში საგადასახადო აღრიცხვის ავტომატიზაციის SaaS-პლატფორმა

კლიენტი: RMS Digital Services (in-house)

ვებ-საიტი: https://geotax.biz/

პროექტის შესახებ

GeoTax — ეს არის სრულფასოვანი SaaS-პლატფორმა ინდივიდუალური მეწარმეებისა და მცირე ბიზნესისთვის საქართველოში, რომელიც ავტომატიზირებს ფინანსური აღრიცხვის სრულ ციკლს: რეგისტრაციიდან და ანგარიშების გამოწერიდან საგადასახადო ანგარიშების გენერირებამდე და ტექნიკურ მხარდაჭერასთან ურთიერთქმედებამდე. სისტემა შექმნილია ფინანსური მონაცემების უსაფრთხოებისა და Revenue Service of Georgia (RS.ge) მოთხოვნებთან შესაბამისობის აქცენტით.

ამოცანა

შექმნათ კომპლექსური გადაწყვეტა საქართველოში მეწარმეებისთვის, რომელიც:
ავტომატიზირებს შემოსავლების, ხარჯების აღრიცხვას და გადასახადების გამოთვლას
უზრუნველყოფს მგრძნობიარე ფინანსური მონაცემების უსაფრთხო შენახვას
უზრუნველყოფს ინსტრუმენტებს ანგარიშების გამოწერისა და კონტრაგენტებთან მუშაობისთვის
ინტეგრირდება პოპულარულ საკომუნიკაციო არხებთან (Telegram, email, ონლაინ-ჩატი)
შეესაბამება საქართველოს საგადასახადო კანონმდებლობის მოთხოვნებს
მასშტაბირდება მომხმარებელთა ბაზის ზრდის შესაბამისად

გადაწყვეტა

შემუშავებულია მიკროსერვისული პლატფორმა პასუხისმგებლობის ზონების მკაფიო გამიჯვნით. არქიტექტურა აგებულია Clean Architecture-ის პრინციპებზე, რაც უზრუნველყოფს ბიზნეს-ლოგიკის დამოუკიდებლობას ინფრასტრუქტურისგან და ამარტივებს ცალკეული კომპონენტების მასშტაბირებას.

სისტემის არქიტექტურა

Frontend (კლიენტის აპლიკაცია)

თანამედროვე SPA Next.js-ზე TypeScript-ითა და Tailwind CSS-ით. ინტერფეისი აგებულია Shadcn UI კომპონენტურ ბიბლიოთეკაზე Framer Motion-ის ანიმაციებით პრემიუ�� მომხმარებლის გამოცდილების შესაქმნელად. მხარდაჭერილია მუქი და ღია თემები, სამი ენის (EN/RU/KA) სრული ლოკალიზაცია next-intl-ის საშუალებით. მდგომარეობის მართვა და API-სთან სინქრონიზაცია განხორციელებულია React Query-ით, ფორმების ვალიდაცია — Zod-ით.

Backend API

მაღალპროდუქტიული REST API Go-ზე Gin ფრეიმვორკით. სტრუქტურა მიჰყვება Clean Architecture-ს ფენებად დაყოფით: presentation (HTTP handlers), application (use cases), domain (business entities), infrastructure (external integrations). ავთენტიფიკაცია JWT-ით, ორფაქტორიანი ავთენტიფიკაციის მხარდაჭერა.

Background Worker

ცალკე სერვისი რესურსმომთხოვნი ასინქრონული ამოცანების შესასრულებლად:

PDF-ინვოისებისა და ფინანსური ანგარიშების გენერირება
შეტყობინებების გაგზავნა (email, Telegram)
მონაცემთა ბაზის სარეზერვო ასლების შექმნა
ამოცანების რიგების მართვა Redis-ის საშუალებით

მონაცემთა შენახვა

PostgreSQL — მთავარი რელაციური მონაცემთა ბაზა ფინანსური ტრანზაქციებისა და ბიზნეს-სუბიექტებისთვის
Redis — ქეშირება, სესიების შენახვა და ამოცანების რიგების მართვა
HashiCorp Vault — საიდუმლოებისა და დაშიფვრის გასაღებების ცენტრალიზებული მართვა

ძირითადი შესაძლებლობები

უსაფრთხოება და ავტორიზაცია

მრავალდონიანი რეგისტრაცია საგადასახადო რეჟიმის არჩევით
ორფაქტორიანი ავთენტიფიკაცია (OTP email-ით)
პაროლის აღდგენის სისტემა
პერსონალური მონაცემების დაცვა უსაფრთხოების სტანდარტების შესაბამისად

ფინანსური აღრიცხვა

შემოსავლები: ტრანზაქციების რეგისტრაცია, კლიენტებთან მიბმა, ვალუტის ავტომატური კონვერტაცია
ხარჯები: ხარჯების კატეგორიზაცია, ჩეკების ატვირთვა, კატეგორიების მიხედვით ანალიტიკა
ანალიტიკა: მოგების გრაფიკები, საგადასახადო პროგნოზები, მცირე ბიზნესის ლიმიტების თვალყურის დევნება (500,000 GEL-მდე)
საგადასახადო compliance: VAT-ისა და Small Business Status-ის ზღვრების ავტომატური მონიტორინგი

დოკუმენტების ბრუნვა

ინვოისინგი: პროფესიონალური ანგარიშების შექმნა PDF-ში მორგებადი შაბლონებით
კლიენტები: კონტრაგენტების მონაცემთა ბაზა ურთიერთქმედებების ისტორიით
საგადასახადო ანგარიშები: მონაცემების ავტომატური მომზადება RS.ge-ში დეკლარაციების წარსადგენად

მხარდაჭერა და კომუნიკაცია

ონლაინ-ჩატი: ინტეგრაცია Chatwoot-თან SSO-ავთენტიფიკაციით. მომხმარებლები იღებენ წვდომას მხოლოდ საკუთარ ტიკეტებზე, მიმოწერის ისტორია სინქრონიზდება მოწყობილობებს შორის
Telegram Bot: პერსონალიზებული ბოტი ტრანზაქციების, ინვოისების სტატუსის ცვლილებებისა და უსაფრთხოების კრიტიკული მოვლენების შესახებ შეტყობინებების მისაღებად
Email შეტყობინებები: ავტომატური გაფრთხილებები სისტემაში მნიშვნელოვანი მოვლენების შესახებ

💳 გადახდის სისტემა

ინტეგრაცია PayPal-თან გამოწერების მართვისა და პრემიუმ ფუნქციებისთვის გადახდების მიღებისთვის

ტექნოლოგიური სტეკი

ფენა	ტექნოლოგიები
Frontend	Next.js, TypeScript, Tailwind CSS, Shadcn UI, React Query, Zod
Backend	Go, Gin, Clean Architecture
მონაცემთა ბაზა	PostgreSQL, Redis
ინფრასტრუქტურა	Docker, Docker Compose, Nginx
უსაფრთხოება	HashiCorp Vault, JWT, AES-256, 2FA
კომუნიკაცია	Chatwoot API, SMTP, Telegram Bot API
გადახდები	PayPal SDK
Background Jobs	Redis Queues, Worker Pattern

უსაფრთხოება და გაუმართაობის მდგრადობა

უსაფრთხოება — პროექტის არქიტექტურული საფუძველია, და არა ზენაშენი.

მონაცემთა დაშიფვრა

ყველა მგრძნობიარე მონაცემი (პერსონალური ინფორმაცია, ფინანსური რეკვიზიტები) იშიფრება კონვერტის დაშიფვრის (Envelope Encryption) გამოყენებით. დაშიფვრის გასაღებები ინახება სპეციალიზებულ საიდუმლოების საცავში, აპლიკაცია მუშაობს მხოლოდ დაშიფრულ მონაცემებთან.

უცვლელი აუდიტი

სისტემაში ყველა კრიტიკული მოქმედება ფიქსირდება აუდიტის ჟურნალში კრიპტოგრაფიული დაცვით. თითოეული ჩანაწერი დაცულია ჰეშით საიდუმლო გასაღების გამოყენებით, რაც შეუძლებელს ხდის ლოგების შეუმჩნეველ ცვლილებას ან წაშლას.

მონაცემთა იზოლაცია

API-ს დონეზე წვდომის უფლებების მკაცრი შემოწმება უზრუნველყოფს, რომ თითოეულ მომხმარებელს ჰქონდეს წვდომა მხოლოდ საკუთარ მონაცემებზე — ფინანსური ჩანაწერებიდან მხარდაჭერის ჩატის დიალოგებამდე.

სარეზერვო კოპირება

მონაცემთა ბაზის სნეფშოტების შექმნის ავტომატიზირებული სისტემა ღრუბლოვან საცავებში დაცული გადაცემით. ლოკალური ქეშირებისა და ფაილების ავტომატური როტაციის მხარდაჭერა.

მთლიანობის მონიტორინგი

ჩაშენებული სერვისები აკონტროლებენ მონაცემთა მთლიანობას და ავტომატურად ასუფთავებენ ძველ ლოგებსა და დროებით ფაილებს შენახვის პოლიტიკის შესაბამისად.

რიგების მონიტორინგი

ინტერფეისი ფონური ამოცანების რეალურ დროში მონიტორინგისა და მართვისთვის, შესრულების თვალყურის დევნება, გამეორებების მართვა და შესრულების ანალიზი.

შედეგი

შექმნილია production-ready SaaS-პლატფორმა, რომელიც:

ავტომატიზირებს ფინანსური აღრიცხვის სრულ ციკლს — ტრანზაქციების რეგისტრაციიდან საგადასახადო ანგარიშებამდე
უზრუნველყოფს მონაცემთა უსაფრთხოებას — დაშიფვრა, იზოლაცია, კრიპტოგრაფიული აუდიტი
შეესაბამება RS.ge-ს მოთხოვნებს — ვალუტის ავტომატური გადაანგარიშება, ლიმიტების თვალყურის დევნება
უზრუნველყოფს მულტიარხიან მხარდაჭერას — ჩატი, Telegram, email
მასშტაბირდება — მიკროსერვისული არქიტექტურა ასინქრონული ამოცანების დამუშავებით
უზრუნველყოფს პრემიუმ UX-ს — თანამედროვე ინტერფეისი სამი ენისა და მუქი თემის მხარდაჭერით

დასკვნები

GeoTax — კომპლექსური SaaS-პროექტის მაგალითი, სადაც უსაფრთხოება და compliance არქიტექტურულ პრინციპებს წარმოადგენს, და არა ფიჩებს. პროექტი აჩვენებს ღრმა ექსპ��რტიზას შემდეგ მიმართულებებში:

Full-stack დეველოპმენტი — მაღალპროდუქტიული Go API-დან თანამედროვე Next.js frontend-მდე

მიკროსერვისული არქიტექტურა — პასუხისმგებლობის გაყოფა, ასინქრონული დამუშავება, ამოცანების რიგები

ფინანსური მონაცემების უსაფრთხოება — დაშიფვრა, იზოლაცია, კრიპტოგრაფიული აუდიტი, საიდუმლოებების მართვა

ინტეგრაციები — გადახდის სისტემები, მესენჯერები, email, ღრუბლოვანი საცავები

DevOps პრაქტიკები — კონტეინერიზაცია, ბექაფების ავტომატიზაცია, მონიტორინგი

ეს არ არის უბრალოდ CRUD-აპლიკაცია — ეს არის production-ready პლატფორმა, შექმნილი მგრძნობიარე ფინანსურ მონაცემებთან მუშაობისთვის რეგულირებად იურისდიქციაში.

ტექნიკური სტეკი

Go
Next.js
PostgreSQL
Redis
Docker
HashiCorp Vault