ადმინ-პანელი

TL;DR

ადმინ-პანელი არის პლატფორმის საოპერაციო ტვინი. დაახლოებით 50 გვერდი, წვდომის ოთხი დონე (Platform Admin, Store Admin, Manager, Dispatcher, Driver), სამი განსხვავებული layout-კონტექსტი მფლობელის დესკტოპისთვის, მძღოლის მობილური ეკრანისთვის და დისპეტჩერის მობილური ეკრანისთვის. ერთ სისტემაში ერთდროულად ცხოვრობს შეკვეთები, კატალოგი, ინვენტარი, პრომო-მექანიკები (კოდების bulk-გენერაციიდან QR-კამპანიებამდე და Mix & Match-მდე), ანგარიშები დღის ფინანსური შედარებით, კლიენტების საფულეები, შეფასებების მოდერაცია და ფლოტის მართვა. ცალკე ფენაა ანალიტიკა: რეგისტრაციის, ლოგინისა და ჩექაუთის ვორონკები, ინციდენტების მონიტორი, მოქმედებების ჟურნალი მომხმარებელთა სესიების ჩაწერით და აუდიტ-კვალი კატალოგის ცვლილებებზე. დიზაინი აშენებულია მუქი მწვანე #0e3814 ფერის გარშემო, როგორც ძირითადი ფერისა, და მკვრივი ცხრილური ინტერფეისების გარშემო reusable-კომპონენტებით: StatCard, DataTable, სტატუსის ბეჯები, მოდალები. ქვემოთ მოცემული სექციის მიზანია ვაჩვენოთ, რისი გაკეთება შეუძლია მფლობელს და მის გუნდს ხელით, ბაზის გახსნისა და დეველოპერისთვის დარეკვის გარეშე.

კონტექსტი და როლები

პლატფორმა ემსახურება ლოკალურ მიწოდებას საქონლის ბოლო მომხმარებლის კართან. ეს არ არის ჩვეულებრივი e-commerce: თითოეული შეკვეთა შეიძლება მოიცავდეს ნაღდი ანგარიშსწორებას, მძღოლის მიერ ხურდის ცალკე სცენარს, ცვლასთან მიბმას, მიწოდების ზონების შემოწმებას, ZIP-კოდების შეზღუდვებს პიკის საათებში. ამიტომ ერთი „ადმინკის" უკან იმალება რამდენიმე განსხვავებული სამუშაო ადგილი.

წვდომა გადანაწილებულია RoleGuard-ის მეშვეობით:

• Platform Admin — ერთადერთი როლი Audit Trail-ზე წვდომით. ხედავს აბსოლუტურად ყველაფერს.
• Store Admin — მართავს მაღაზიას: კატალოგი, ინვენტარი, პრომო, ანგარიშები, საფულეები, პარამეტრები.
• Manager — კატალოგი, ინვენტარი, მძღოლების და მანქანების ფლოტი, შეფასებების მოდერაცია.
• Dispatcher — მობილური layout დისპეტჩერის კონსოლით, რუკით, ინვოისებით.
• Driver — მობილური layout მძღოლის დაშბორდით, ჩემი შეკვეთებით, შემოსავალით.

ერთი და იგივე URL შეიძლება სრულიად განსხვავებულად გამოიყურებოდეს როლის მიხედვით. მარშრუტები, რომლებიც ხელმისაწვდომი არ არის, არ ჩანს ნავიგაციაში, ხოლო პირდაპირ გახსნის მცდელობა გადაამისამართებს ნებადართულ საწყის გვერდზე.

მფლობელის დაშბორდი

Dashboard (/)

ეს არის მფლობელის სარდლობის ცენტრი. პირველ ეკრანზე — KPI-ის ორი დონე: lifetime (Collection, Sales, Orders, Users — მთელი დროის განმავლობაში) და daily (იგივე დღეს). Lifetime გაძლევს ბიზნესის მასშტაბის შეგრძნებას, daily — პულსს ახლავე.

ცენტრალური ელემენტი — Revenue Chart Recharts BarChart-ზე date range picker-ით, Revenue-სა და Orders-ს შორის გადამრთველით და refresh ღილაკით. მის ქვეშ summary-პანელი ადარებს Lifetime-ს და Today-ს TrendingUp/Down იკონებითა და ცვლილების პროცენტით, რათა მფლობელმა მაშინვე დაინახოს, დღე საშუალოზე ზემოთ აღმოჩნდა თუ ქვემოთ.

ცალკე — ცხრილი „Users Sale“: კლიენტების სია შეკვეთების რაოდენობით, ბრუნვით, თითოეულზე მოგების/ზარალის შეფასებითა და Customer Since სვეტით. ეს უკვე არ არის უბრალოდ KPI, არამედ სწრაფი გზა გასაგებად, რომელი კლიენტები ქმნიან ბირთვს, და რომლები — ერთეულები.

Operations: შეკვეთები, კლიენტები, ფლოტი

Orders (/orders)

ყველა შეკვეთის გვერდი. ზევით — OrderFilters ძიებით, თარიღების დიაპაზონის არჩევით, სტატუსისა და მძღოლის მიხედვით ფილტრით, პლუს download ღილაკი ექსპორტისთვის. შემდეგ — Total Orders და Average Delivery Time მთვლელები და დანომრილი OrdersTable. თითოეული მწკრივი დაჭერადია და ხსნის OrderDetailModal-ს.

მოდალის შიგნით ოპერატორი აკეთებს სამ რამეს: ცვლის შეკვეთის სტატუსს ნებადართული ტრანზიციებით სავალდებულო ნოტით, ნიშნავს მძღოლს ხელმისაწვდომი შემსრულებლების dropdown-იდან და ანახლებს მონაცემებს. ეს არის ძირითადი ეკრანი იმისთვის, ვინც კლიენტთან ტელეფონზე ზის.

Customers (/customers) და Customer Detail (/customers/:id)

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

Drivers (/drivers) და Vehicles (/vehicles)

ფლოტის მართვა, ხელმისაწვდომია Manager როლიდან და ზემოთ. Drivers — კურიერების სია მათი სტატუსებითა და მეტრიკებით. Vehicles — ავტომობილების ცნობარი: მარკა, მოდელი, ნომერი, მძღოლებთან მიბმა, დოკუმენტები.

Reviews (/reviews)

საქონლისა და შეკვეთების შეფასებების მოდერაცია. Manager და ზემოთ შეუძლია დაამტკიცოს, დამალოს ან წაშალოს შეფასება მანამ, სანამ ის საჯარო კატალოგში მოხვდება.

კატალოგი

Catalog → Products (/catalog/products)

საქონლის მთავარი ეკრანი. ProductFilters იძლევა ძიებას, კატეგორიის და ბრენდის მიხედვით ფილტრს. ProductsTable აჩვენებს საქონელს edit, delete და toggle visibility მოქმედებებით — ეს უკანასკნელი განსაკუთრებით მნიშვნელოვანია SKU-ებისთვის, რომლებიც სწრაფად უნდა მოიხსნას წაშლის გარეშე. ProductFormModal — შექმნისა და რედაქტირების ფორმა გამოსახულებების ატვირთვით, კატეგორიასთან, ბრენდთან მიბმით, ფასით, თვითღირებულებითა და ინვენტარით.

Catalog → Categories (/catalog/categories)

კატეგორიების იერარქია. CRUD: შექმნა, რედაქტირება, წაშლა, გადაადგილება — ბიზნესისთვის ეს არის კატალოგის რუბრიკატორი, SEO-სთვის — URL-ის სტრუქტურა.

Catalog → Brands (/catalog/brands)

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

Inventory

Inventory (/inventory)

დამოუკიდებელი მოდული სამი ტაბითა და კომპონენტების ნაკრებით: InventoryStats, InventoryFilters, InventoryTable, StockAdjustmentModal, LowStockAlerts, InventoryLogs.

პირველი ტაბი — Inventory List. ფილტრაცია, მარაგების კორექცია StockAdjustmentModal-ის მეშვეობით (მიზეზის მითითებით) და print ღილაკი, რომელიც ხსნის inventory/print-ს ახალ ფანჯარაში საწყობის ფიზიკური შედარებისთვის.

მეორე ტაბი — Stock Alerts. აქ შეგროვებულია low-stock და out-of-stock პოზიციები badge-მთვლელით პირდაპირ ტაბის იკონაზე, რათა ოპერატორმა დაინახოს პრობლემების რაოდენობა სექციის გახსნის გარეშე.

მესამე ტაბი — Activity Logs. ყველა კორექციის სრული, დანომრილი ისტორია: ვინ, რა, როდის, რა მიზეზით. ეს არის შიდა კონტროლისა და გადახრების გამოძიების ერთ-ერთი ინსტრუმენტი.

Promotions

პლატფორმაში არის მთელი ცალკე დომენი — პრომო-მექანიკები. ისინი ხუთია:

Promotions (/promotions)

ბაზისური პრომო-კოდები. ძიება კოდით, სტატუსით ფილტრი, დამატება და რედაქტირება PromoFormModal-ის მეშვეობით. CRUD-ოპერაციები: დამატება, განახლება, წაშლა, სტატუსის გადართვა. ეს არის ყველა ფასდაკლების ფესვი.

Promo Code Batches (/promotions/promocodes)

უნიკალური კოდების Bulk-გენერაცია აქციებისა და პარტნიორობებისთვის. შიგნით ორი ხედი.

Batches View — ჯგუფების ცხრილი: სახელი, ფასდაკლების ტიპი (% ან $), გამოყენების პროგრესი, მოქმედების პერიოდი, შექმნის თარიღი.

Generate Modal — მძლავრი ინსტრუმენტი: ადგენ რაოდენობას (1–1000), პრეფიქსს, კოდის სიგრძეს (4–12 სიმბოლო), ფასდაკლების ტიპს და მნიშვნელობას, მინიმალურ კალათას, ფასდაკლების მაქსიმალურ ზომას, მოქმედების პერიოდს. ცალკე ჩექბოქსები — „First Order Only“ (კოდი მუშაობს მხოლოდ კლიენტის პირველ შეკვეთაზე) და „Cashback to Wallet“ პროცენტის მითითებით, რათა ფასდაკლება დაუბრუნდეს საფულეზე და არ ჩამოეჭრას ანგარიშიდან შეკვეთის მომენტში. მოდალის მარჯვენა მხარეს — code preview, რათა დაინახოთ, როგორ გამოიყურება კონკრეტული კოდი.

Codes View — batch-ის შიგნით: ძიება, სტატუსის მიხედვით ფილტრი (Unused / Used), ერთი კოდის კოპირება, Copy All და CSV ექსპორტი. მარკეტოლოგმა დააგენერირა ათასი კოდი კამპანიისთვის, ჩამოტვირთა CSV, გადასცა პარტნიორს — სულ ეს არის.

Campaigns (/promotions/campaigns)

QR-კამპანიები. ზევით ოთხი StatCard: Active Campaigns, Total Scans, Total Orders, Avg Conversion %. მათ ქვეშ ცხრილი: name, code, ღილაკი QR-ისთვის, მიბმული promo code, სკანების რაოდენობა, შეკვეთების რაოდენობა, კონვერსია პროცენტებში, შემოსავალი და სტატუსი (Active / Paused / Ended).

Create/Edit Modal გაძლევთ საშუალებას ხელით შეიყვანოთ კოდი ან დააგენერიროთ, მიუთითოთ სამიზნე URL, აირჩიოთ მიბმული პრომო-კოდი dropdown-იდან, ჩართოთ auto-apply (პრომო ავტომატურად გამოიყენება QR-ით გადასვლისას), დააყენოთ მოქმედების პერიოდი.

QR Modal რენდერავს QR-კოდს QRCodeCanvas-ის მეშვეობით, მისი ჩამოტვირთვა შეიძლება როგორც PNG. თვალთვალის URL — {API}/api/v1/c/{campaignCode} — ფიქსირებს ყოველ სკანირებას და კავშირს მომდევნო შეკვეთასთან, რათა კონვერსია სამართლიანად ითვლებოდეს.

Banners (/promotions/banners)

ვიტრინაზე ბანერების მართვა. ცხრილი: thumbnail, title, ტიპი (Normal / Category / Promo), სამიზნე მოწყობილობა (Desktop / Mobile / All), დახარისხების რიგი, active გადამრთველი.

Modal იძლევა ორ გზას სურათის ატვირთვისთვის: drag-and-drop ფაილი (JPEG, PNG, WebP, AVIF, GIF, 10 მბ-მდე) ან გარე გამოსახულების URL. დამატებით — title, target URL, banner type, target device, კატეგორიის სელექტორი (თუ არჩეულია type=category), sort order და სტატუსი. კარგი მაგალითია იმის, თუ როგორ ხურავს საოპერაციო ეკრანი კონტენტ-ამოცანას ცალკე CMS-ის გარეშე.

Day-wise Discounts (/promotions/daywise)

კვირის დღეების მიხედვით ფასდაკლებები — თითო დღეზე ერთი. ცხრილი: დღე, სახელი, ფასდაკლების ზომა (% ან $), მინიმალური კალათა, უფასო საჩუქრის ინფორმაცია, ქეშბექის ზომა, სტატუსი, edit და delete ღილაკები.

Modal დაყოფილია თემატურ სექციებად: Basic Info (დღე, name, აღწერა), Discount (ტიპი, მნიშვნელობა, მინიმალური კალათა), Free Product (ჩექბოქსი პლუს დასახელება და cart limit, რომლის დროსაც გაიცემა საჩუქარი), Wallet Cashback (თანხა და cart limit), Military Discount (ჩექბოქსი პლუს პროცენტი კლიენტთა ცალკე კატეგორიისთვის) და Status. ერთი ეკრანი — მთლიანი ყოველკვირეული აქტივაციის სტრატეგია.

Mix & Match (/promotions/mix-match)

ყველაზე რთული პრომო-ინსტრუმენტი: საფეხურეობრივი ფასდაკლებები რაოდენობის მიხედვით. ცხრილი: name + label, წესის ტიპი, default discount, მინიმალური რაოდენობა, ტირების რაოდენობა, სტატუსი.

Modal იყოფა ბლოკებად: Basic Info (name, label, წესის ტიპი — category_mix ან product_bundle, აღწერა), Discount Settings (ტიპი, default value, მინიმალური კალათა თანხითა და რაოდენობით), Tiers (საფეხურების დამატება და წაშლა — თითოეული თავისი threshold-ით რაოდენობით, მნიშვნელობითა და ფასდაკლების ტიპით), Scope (ბაზისური კატეგორიის ID, გამოსაყენებელი კატეგორიების სია და გამოსაყენებელი საქონლის სია UUID-ით). ასე ბიზნესი აშენებს მექანიკებს, როგორიცაა „იყიდე 3 — მიიღე 10%, იყიდე 5 — 20%“.

Reports: ფინანსები და საოპერაციო ანგარიშგება

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

Sales Report (/reports/sales)

Recharts BarChart „Sales Over Time“ აჩვენებს შემოსავალს დღეების, კვირების ან თვეების მიხედვით. გრაფიკის ზემოთ — პერიოდის პრესეტები: Today, Yesterday, This Week, Last Week, This Month, Last Month, This Year, Custom. Group By ადგენს დეტალიზაციას.

KPI Cards მოდის პერიოდის-პერიოდთან შედარებით, ისრებით ზემოთ და ქვემოთ: Total Revenue, Total Orders, Average Order Value, Pending Orders. მათ ქვეშ Secondary Stats: Discounts, Tax Collected, Delivery Fees, Tips, Cancelled count, Cancelled Value.

ცხრილები ავსებს სურათს: Payment Methods (Cash, Zelle, CashApp, Venmo, Split — შეკვეთები და თანხა თითოეულზე), COD Collection Methods, Top Selling Products (rank, name, qty, revenue), Previous Period Comparison.

Reconciliation Report (/reports/reconciliation)

ფინანსური შედარება. ეს უკვე არ არის მარკეტინგი, არამედ ბუღალტერია. KPI Cards ზევით: Gross Revenue, Net Revenue, Total Orders, Cost of Goods, Estimated Profit.

Financial Breakdown შლის შემოსავალს: Gross, Discounts Applied, Wallet Used, Rewards Used, Net, Tax, Delivery Fees. Payment Methods ცხრილი აჩვენებს გადახდების სტრუქტურას.

Cash Flow — ცალკე ბლოკი ნაღდი ფულის შესახებ: COD Sales Total, Cash in Envelope, Digital Payments (already on account), Change to Customer Wallets, Cash in Envelope (Net), Owner's Cash Total. ეს კრიტიკულია, რადგან ფულის ნაწილი ფიზიკურად მოდის კონვერტში მძღოლისგან, ხოლო ნაწილი მიდის კლიენტის საფულეში როგორც ხურდა.

P&L Summary — მუქი მწვანე ბანერი: Revenue, Tax, Delivery Fees, COGS, Estimated Profit. მის ქვეშ collapsible-სექცია Order Details, სადაც თითოეულ შეკვეთაზე: order #, date, customer, items, subtotal, discount, wallet used, cashback, total, payment method, cash received, change to wallet. როცა საჭიროა გაიგო, რატომ დაიხურა დღე ზუსტად ასე — ეს არის მთავარი ეკრანი.

EOD Report (/reports/eod)

End of Day — ანგარიში ერთ კონკრეტულ დღეზე, CSV და PDF download-ით. Metric Cards: Total Orders, ASAP Orders, Revenue, Collections, Avg Delivery Time, New Customers, Completed, Pending.

Cash Summary შლის დღეს გადახდის მეთოდების მიხედვით: COD Sales, Cash Envelope, Digital Payments, Change to Wallets, Owner's Cash, Card Sales, Crypto. ცალკე ცხრილი Products Sold სურათის preview-ით, რაოდენობით, კატეგორიითა და ბრენდით. Financial Summary ხურავს ბლოკს გადასახადებით, მიწოდებით, ჩაიის ფულითა და ფასდაკლებებით. ეს ანგარიში ყოველ საღამოს მიდის მფლობელთან PDF სახით.

Driver Report (/reports/driver)

მძღოლების პროდუქტიულობა. Filters: თარიღების დიაპაზონი, კონკრეტული მძღოლი, რეგიონი. ცხრილი: Driver Name, First Delivery, Last Delivery, # Deliveries, Avg Delivery Time, Sales, Cash Collected. ქვემოთ მწკრივი ჯამებით. ამ ეკრანის საფუძველზე იხდება ხელფასი და მიიღება გადაწყვეტილებები ფლოტის გაფართოებაზე.

Cash Drop Report (/reports/cash-drop)

ნაღდი ფულის შედარება მძღოლსა და მაღაზიას შორის ცვლის ბოლოს. ზევით ფორმა „Record Cash Drop“: მძღოლის სელექტორი, პერიოდის დასაწყისი და ბოლო, ღილაკი Calculate.

გათვლის შემდეგ ჩნდება მოსალოდნელი თანხები: Envelope Orders, Expected Cash, To Wallets, Owner's Cash და ცალკე callout digital payments-ის შესახებ, რათა მათი არევა შეუძლებელი იყოს. შემდეგ — Actual Amount ველი სხვაობის live-გათვლით (Difference), Notes ველი და Record ღილაკი.

Summary Cards: Total Expected, Total Dropped, Difference, Total Drops. ისტორია ქვემოთ — ყველა drop-ის ცხრილი: თარიღი, მძღოლი, მოსალოდნელი, ფაქტობრივი, სხვაობა (color-coded), შეკვეთების რაოდენობა, სტატუსი (verified / disputed / pending). ერთ-ერთი ყველაზე მნიშვნელოვანი ფინანსური კონტროლი სისტემაში: ზუსტად აქ იჭერენ ნაკლებობას.

Affiliate Report (/reports/affiliate)

პარტნიორული პროგრამა. Filters: პერიოდი, ძიება სახელით / email-ით / კოდით. Summary Cards: Total Affiliates, Total Referrals, Total Revenue, Total Commission მითითებული საკომისიოს განაკვეთით. ცხრილი affiliate-ის მიხედვით დაყოფით და Export CSV ღილაკით.

COG Report (/individual/cog)

Cost of Goods, ხელმისაწვდომია Store Admin როლიდან და ზემოთ. KPI: Revenue, Cost of Goods, Gross Profit, Gross Margin %, Inventory at Cost. თუ ზოგიერთ საქონელზე არ არის თვითღირებულება, ზევით ჩანს warning banner. Product Breakdown თითოეულ SKU-ზე გვიჩვენებს: name, qty sold, revenue, cost, profit (მწვანე პლუსისთვის, წითელი მინუსისთვის), margin % იგივე ფერადი კოდირებით. ეს არის ერთ-ერთი ყველაზე სასარგებლო ანალიტიკური ეკრანი პროდაქტისთვის: ის მაშინვე აჩვენებს, რომელი საქონელი იწვევს ფულს, ხოლო რომელი უბრალოდ ანაცვლებს მარაგებს.

Invoices (/reports/invoices)

ინვოისები შეკვეთების მიხედვით. Filters: თარიღების დიაპაზონი, ჩექბოქსები New Registration, Min Qty, Next Day Only, ღილაკი CSV download. ცხრილი: თარიღი, time slot, ტელეფონი, მომხმარებელი, email, მაღაზია, მძღოლი, სტატუსი, შექმნის თარიღი, grand total, view ღილაკი.

Invoice Detail Modal — დამოუკიდებელი არტეფაქტი. shipping label-ის preview 80×80 მმ ფორმატში, Print Label ღილაკი და PDF download jsPDF + autoTable-ის მეშვეობით. PDF მოიცავს: მაღაზიის მონაცემებს, შეკვეთის დეტალებს, კლიენტის, მძღოლის ინფორმაციას, პოზიციების ცხრილოვან სიას და ყველა ჯამის დაყოფას. არსებითად — ეს არის სრულფასოვანი დოკუმენტი დაბეჭდვისა და ანგარიშგებისთვის.

Daily Orders (/reports/daily-orders)

შეკვეთები ცვლების მიხედვით. აქ არის ერთი ნიუანსი: ცვლა იწყება 06:00-ზე Miami-ის დროით, და ანგარიში პატივს სცემს ამ დროის გადაწევას, რათა მონაცემები არ გაიხეთქოს კალენდარული შუაღამის მიხედვით.

Wallet History (/reports/wallet-history)

კლიენტების საფულეებზე ოპერაციების ისტორია ანგარიშის ჭრილში (და არა ცალკე მომხმარებლების).

Settings

Settings → Store (/settings)

ოთხი ტაბი:

• Store — მაღაზიის ზოგადი კონფიგურაცია: დასახელება, კონტაქტები, რეკვიზიტები, პარამეტრები.
• Time Slots — მიწოდების სლოტების დამატება, რედაქტირება, წაშლა და თითოეულის აქტივობის გადამრთველი.
• Delivery Zones — CRUD ზონებზე, რომლებშიც მუშაობს მიწოდება (თანხისა და დროის წესებით).
• Traffic Windows — ZIP-restrictions პიკის საათებისთვის: პიკის საათში შესაძლებელია ზონების ნაწილის გათიშვა, და storefront ამას დაინახავს.

Roles (/settings/roles)

RBAC-როლების მართვა. ცხრილი: name, description, უფლებების მოკლე აღწერა, ტიპი (System / Custom), სტატუსი, edit და delete ღილაკები (სისტემურის წაშლა შეუძლებელია). უფლებების დაყენება — მოდულების დონეზე. ეს მფლობელს აძლევს მოქნილობას არ დაიქირაოს დეველოპერი, რომ დაამატოს ახალი როლი ბუღალტრისთვის ან საწყობის მუშაკისთვის.

Employees (/settings/employees)

თანამშრომლების სია: სახელი ავატარით, email, ტელეფონი, როლი, სტატუსი (Active / Inactive პლუს ცალკე ინდიკატორი Online), ბოლო ლოგინი, edit, delete. Modal გაძლევთ საშუალებას მიანიჭოთ როლი და შეცვალოთ მონაცემები.

Customer Plans (/settings/plans)

კლიენტების premium-დონეების კონფიგურაცია. თითოეული გეგმა — ცალკე ბარათი ფერადი სათაურით: Name, color picker, Cashback %, შეკვეთის მინიმალური თანხა.

ბარათის შიგნით ჩექბოქსები გადახდის მეთოდებისთვის (COD, Crypto, Wallet) და ნაღდი ფულის შეგროვების მეთოდებისთვის (Cash, Zelle, CashApp, Venmo). შემდეგ — მხარდაჭერის საათები, მიწოდების საათები, მიწოდების ფანჯარა start/end. ბონუს საქონლის picker slug-ით ძიებით, ბონუსის აღწერა, ვიტრინისთვის აღწერა.

ცალკე toggles: გეგმის ჩვენება მხოლოდ პირველი შეკვეთის შემდეგ, შეკვეთების ნება 24/7 მაღაზიის საათების გვერდის ავლით, შეკვეთების ნება ZIP-restrictions-ის გვერდის ავლით. ეს არის შენარჩუნების ინსტრუმენტი: პრემიუმ-გეგმის მქონე კლიენტს შეიძლება გაეხსნას ფანჯრები, რომლებიც დანარჩენებისთვის აკრძალულია.

საფულეები

Wallet List (/wallet)

ძიება email-ით, ცხრილი: email, ბალანსი, შექმნის თარიღი, view ღილაკი. ზევით — Money Transfer ღილაკი, რომელიც ხსნის MoneyTransferModal-ს საფულეებს შორის გადარიცხვისთვის. და Download ღილაკი — ყველა ბალანსის CSV-ექსპორტი.

Wallet Details (/wallet/details/:userId)

მომხმარებლის ბარათი ბალანსით და Add Balance ღილაკით. მის ქვეშ — ყველა ტრანზაქციის ცხრილი: email, თანხა (color-coded, პლუსი მწვანე, მინუსი წითელი), ვის გადაეცა, შეკვეთის ID, მიზეზი, კომენტარი, თარიღი.

Wallet Logs (/wallet/logs)

გლობალური ჟურნალი ყველა საფულეზე. ძიება email-ით, ტელეფონით, მიზეზით. ცხრილი: ვინ გადარიცხა, ვის, თანხა, მიზეზი (Credit / Debit / Refund / Bonus / Order Payment / Cashback), შექმნის თარიღი, view (გადასვლა მომხმარებლის დეტალურ გვერდზე). ეს არის anti-fraud-ის ერთ-ერთი მთავარი ინსტრუმენტი: საეჭვო დარიცხვები მაშინვე ჩანს.

ანალიტიკა

Conversion Analytics (/analytics/conversion)

ვორონკა: Sessions → Product Views → Cart Adds → Checkout → Orders, თითო ნაბიჯზე გადასვლის პროცენტით. ვორონკის ქვეშ — Recharts LineChart სამი სერიით: Sessions (მუქი მწვანე), Orders (წითელი), Cart Adds (ყვითელი, dashed). ეს არის პირველი გვერდი, რომელზეც დილით შედის მარკეტოლოგი.

Activity Log (/activity-log)

კლიენტური თვალთვალი ოთხი ტაბით.

All Events — ფილტრი მოვლენის ტიპით (page_view, product_view, cart_add, cart_remove, checkout_start, checkout_success, api_error, js_error და ა.შ.), user ID-ით, session ID-ით. ცხრილი: დრო, მოვლენის ბეჯი (color-coded), მომხმარებელი, URL, session (clickable, მიდის User Journey-ზე), IP. თითოეული მწკრივი გასაშლელია: აჩვენებს მოვლენის raw JSON payload-ს.

Errors — დაჯგუფებული შეცდომები: message, type, source, განმეორებების რაოდენობა, first/last seen. ეს არის დიაგნოსტიკის პირველი წერტილი, როცა საიტზე რაღაც არასწორად წავიდა.

Search Analytics — Top Searches და Searches with No Results. ჩანს, რას ეძებენ მომხმარებლები და სად ვერ ემსახურა მათ საიტი.

User Journey — session ID-ის შეყვანა იწყებს მთელი სესიის გზის ჩატვირთვას: დანომრილი ნაბიჯები, ბეჯები, დროის ნიშნულები, URL, payload. Watch Replay ღილაკი ხსნის rrweb-player-ს dynamic import-ის მეშვეობით და უკრავს რეალურ ჩანაწერს კლიკ-კლიკში.

Audit Trail (/audit-trail)

მხოლოდ Platform Admin. ეს არის კონტროლის სხვა დონე — არა კლიენტი, არამედ შიდა მომხმარებლები.

Summary Cards: Product Changes Today, Product Changes (7d), Wallet Ops Today, Top Modifier (7d) — ვინ ცვლიდა ყველაზე ხშირად რაღაცას ადმინებიდან კვირის განმავლობაში.

Product Changes ნაჩვენებია დაჯგუფებული ბარათების სახით: ერთი მომხმარებლის მიერ ორი წამის განმავლობაში გაკეთებული ცვლილებები იკეცება ერთ ბლოკში. თითოეული ბარათი აჩვენებს action badge-ს (Created / Updated / Deleted / Variant Added / Updated / Deleted), timestamp, performed by და პროდუქტის სახელწოდებას. Smart change display წინა პლანზე აყენებს პრიორიტეტულ ველებს: name, price, sale price, cost, inventory, active, featured, category, brand. დანარჩენი ცვლილებები იმალება გასაშლელი „+N more“-ის ქვეშ. ფორმატირების კონტექსტი — ფასები ნაჩვენებია როგორც $, booleans როგორც Yes/No, კატეგორიების და ბრენდების ID-ები იხსნება ადამიანურად წასაკითხ სახელებში, გრძელი ტექსტები იჭრება. ვარიანტების ცვლილებები — ცალკე indented sub-items.

Wallet Operations — ცხრილი: დრო, ადმინის სახელი, კლიენტის სახელი, type badge (credit / bonus / refund / debit), თანხა, ბალანსი მანამდე და მის შემდეგ, მიზეზი. ეს არის საბოლოო ინსტრუმენტი შიდა ფროდის წინააღმდეგ: მფლობელი ხედავს ყოველ თეთრს, რომელიც ადმინმა დარიცხა.

Issues Monitor (/analytics/issues)

ინციდენტების ბარათები: Checkout Failures (მიზეზების ტოპით) და JS Errors (შეტყობინებების ტოპით). პერიოდის პრესეტები: Today, Yesterday, 7d, 30d. ეს არის მოკლე დილის ცნობა product manager-ისთვის: სად სტკივა დღეს.

Registration Funnel (/registration-funnel)

OTP-ზე დაფუძნებული რეგისტრაციის ვორონკა. ეტაპები: sent (კოდი გაგზავნილია), registered (მომხმარებელი შექმნილია), verified (კოდი დადასტურებულია), abandoned. მათ — კონვერსიები ეტაპებს შორის და ვადები (რამდენი გადის ნაბიჯებს შორის). ჩანს, რომელ ეტაპზე იკარგებიან კლიენტები.

Login Funnel (/login-funnel)

იგივე, მაგრამ ლოგინისთვის: რამდენი მომხმარებელი აღწევს წარმატებულ შესვლას და სად წყდება პროცესი.

Checkout Funnel (/checkout-funnel)

ჩექაუთის ვორონკა: დაწყებიდან წარმატებულ შეკვეთამდე, ვარდნებისა და მიზეზების ხაზგასმით.

ვიტრინის კონტენტი

Homepage Manager (/homepage)

ხელმისაწვდომია Store Admin როლიდან. featured-საქონლის მართვა: მთავარზე 8 სლოტამდე. საქონლის ძიება, კატეგორიის მიხედვით არჩევანი, სლოტებზე განთავსება. ცალკე CMS-ისა და პროგრამისტების გარეშე — ეს მარკეტოლოგის ყოველდღიური სამუშაოა.

Help (/help)

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

Driver Layout

როცა მძღოლი შედის სისტემაში, ის ხედავს სრულიად განსხვავებულ ინტერფეისს — მობილურს, ერთი ხელისთვის, დიდი ელემენტებით.

Driver Dashboard (/driver-dashboard)

Welcome header სახელითა და დღევანდელი თარიღით. მთავარი ელემენტი — Online/Offline toggle: დიდი მწვანე პულსირებადი ღილაკი, რომელიც დაჭერისას ითხოვს გეოლოკაციას და მძღოლს გადაჰყავს ცვლაში. მის ქვეშ — alert banner pending-შეკვეთებით, ვიჯეტები shift status, active orders, earnings. ქვემოთ — ბმულები My Orders-ზე.

My Orders (/my-orders) და My Orders Detail (/my-orders/:id)

დანიშნული შეკვეთების სია. შეკვეთაზე დაჭერით — დეტალური გვერდი მარშრუტით, კლიენტის კონტაქტით, შემადგენლობით, გადახდის მეთოდითა და სტატუსის გადასვლის ღილაკებით: Pickup, On the way, Delivered.

Dispatcher Layout

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

Dispatcher Console (/dispatcher)

დისპეტჩერის მთავარი ეკრანი. DispatcherStats აჩვენებს ცვლის overview-მეტრიკებს. PendingOrdersList — დანიშვნის მომლოდინე შეკვეთები სტატუსის ფილტრით. DriversList — ყველა ხელმისაწვდომი მძღოლი online ინდიკატორითა და სამუშაოში მყოფი აქტიური შეკვეთების რაოდენობით. AssignOrderModal — შეკვეთის კონკრეტულ მძღოლზე დანიშვნა. ცალკე ბლოკი DispatcherCustomers იძლევა სწრაფ წვდომას კლიენტის ინფორმაციაზე. Auto-refresh ხდება React Query invalidation-ის მეშვეობით: მონაცემები ნახლდება თავისით, F5-ის გარეშე.

Dispatch Map (/dispatcher/map)

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

Dispatcher Invoices (/dispatcher/invoices)

იგივე ინვოისების მოდული, რაც ძირითად ადმინკაში, მაგრამ გაშვებულია dispatcher-layout-ში — მობილური, მოსახერხებელი ტელეფონიდან მუშაობისთვის.

Telegram mini-apps

ძირითადი web-ადმინკისა და ვიტრინის გარდა, პლატფორმაში არის სამი ცალკე Telegram mini-app: მაღაზია კლიენტებისთვის, დისპეტჩერული და მძღოლის. ეს არის დამოუკიდებელი SPA-აპლიკაციები Vite + React-ზე, რომლებიც იშვებიან Telegram-ის შიგნით WebApp API-ის მეშვეობით: მომხმარებელი არაფერს აყენებს და ცალკე არ რეგისტრირდება — მინი-აპლიკაცია იხსნება პირდაპირ ბოტთან ჩატიდან და მაშინვე ცნობს ადამიანს Telegram.WebApp.initData-ს მიხედვით. initData-ს ხელმოწერა მოწმდება სერვერზე HMAC-ის მეშვეობით, და სისტემაში პირველი შესვლისას იქმნება მინიმალური პროფილი (ტელეფონი ფორმატში tg_{telegram_id}, სახელი Telegram-იდან). შემდეგ კლიენტს, დისპეტჩერსა და მძღოლს — სამი აბსოლუტურად განსხვავებული გამოცდილება ერთსა და იმავე backend-ის კოდურ ბაზაზე.

Sales mini-app — მაღაზია Telegram-ში

ანონიმური კატალოგი, ღია ბოტის მეშვეობით მოკლე დომენით. შესვლამდე — KYC-gate კლიენტის თანხმობით და პროფილის დადასტურებით. gate-ის შემდეგ ჩანს სრული კატალოგი: კატეგორიების ჰორიზონტალური სია, Featured სექცია საქონლის კარუსელ-ბარათებით, გრიდი ფასებით, კალათის იკონა შაპკაში.

კალათა ცხოვრობს localStorage-ში — სერვერული სინქრონიზაციის გარეშე, რათა შესაძლებელი იყოს შეკვეთის შეკრება ავტორიზაციის გარეშე. მხოლოდ Telegram-ის მეშვეობით გაფორმების მომენტში ჩნდება კავშირი კლიენტის პროფილთან: იგივე ჩექაუთი, რაც ვიტრინაზე, ყველა სცენარით (Express, Scheduled, Cash, Wallet), მაგრამ მკვრივ მობილურ layout-ში, ერთი ხელისთვის გათვლილი.

ცალკე ნაკადი ამ მინი-აპლიკაციაში — Affiliate Program: კლიენტს შეუძლია გახდეს პარტნიორი, მიიღოს პერსონალური promo-კოდი და share-ბმული, რომელსაც გაუზიარებს მეგობრებს პირდაპირ Telegram-ში. იქიდან შეტყობინებები ახალი შეკვეთის, მისი დადასტურების, მიწოდების სტატუსების შესახებ მოდის კლიენტთან ჩატში ბოტთან — push-შეტყობინებებისა და email-ის გარეშე.

Dispatcher mini-app — დისპეტჩერული ჯიბეში

იშვება დისპეტჩერულ ბოტთან ჩატიდან. ავტორიზაცია — Telegram-ის მეშვეობით, dispatcher როლთან მიბმა ხდება ავტომატურად telegram_id-ის მიხედვით, რომელიც ადრე შესაბამებულია ადმინკაში. შესვლის შემდეგ იხსნება dispatch-კონსოლი: KPI-ზოლი ზევით (Pending, Ready, Assigned, Delivery, Drivers, Done), ოთხი ტაბი — Orders, Drivers, Customers, Map.

ტაბ Orders-ში დისპეტჩერი ხედავს აქტიურ შეკვეთებს სიის სახით: ნომერი, თანხა, მიწოდების ტიპი (EXPRESS / scheduled time slot), თარიღი, კლიენტის სახელი, მისამართი და მანძილი საწყობიდან. დაჭერით — შეკვეთის დეტალური ბარათი თავისუფალი მძღოლების სიიდან მძღოლის დანიშვნის შესაძლებლობით. ნაგულისხმებად სია ფილტრდება Area-ს მიხედვით — დისპეტჩერს შეუძლია შემოიფარგლოს თავისი პასუხისმგებლობის ზონით.

ტაბ Drivers-ში — ყველა მძღოლის სია ონლაინ/ოფლაინ ინდიკატორით, აქტიური ტრანსპორტით, მიწოდებების რაოდენობით. თავისუფლები მონიშნულია მწვანედ, დაკავებულები — ნაცრისფერით. შეიძლება მძღოლზე დაჭერა და მისი ბოლო მიწოდებების ნახვა.

ტაბ Customers — სწრაფი წვდომა კლიენტებზე: ძიება სახელით ან ტელეფონით, Add Customer ღილაკი ზარით შეკვეთისას პროფილის ხელით შესაქმნელად, თითოეულ ჩანაწერთან — შეკვეთების მთლიანი თანხა და კონტაქტი.

და, ბოლოს, Map — გეოგრაფიული ვიზუალიზაცია: მიწოდების ზონის რუკა (მაიამის რაიონი და მისი გარეუბნები) მძღოლებისა და შეკვეთების წერტილების მარკერებით. ცენტრირება და ზუმი — Leaflet-ის ზემოთ, ფილები — OpenStreetMap-ის მეშვეობით. ეს არის, შესაძლოა, ყველაზე ხშირი ტაბი აქტიურ დისპეტჩერთან: ის ხედავს, რომელი მძღოლი უფრო ახლოსაა ახალ შეკვეთასთან, და რამდენიმე დაჭერით ნიშნავს.

ყველა მონაცემი ნახლდება WebSocket-არხის მეშვეობით: ახალი შეკვეთა — მოდის რეალურ დროში, მძღოლის ან შეკვეთის სტატუსის ცვლილება — ასევე. Push-შეტყობინებები Pushover-ის მეშვეობით ადუბლიკებს კრიტიკულ მოვლენებს (ახალი შეკვეთა → priority=2, მაქსიმალურ ხმაზე), რათა დისპეტჩერმა გაიგოს ისინი მაშინაც კი, როცა ტელეფონი ჯიბეშია.

Driver mini-app — მძღოლი Telegram-ში

იშვება მძღოლის ბოტთან ჩატიდან. მძღოლის Telegram-ანგარიში მიბმულია სისტემის profile-ზე preassigned mapping-ის მეშვეობით — მძღოლი არ შეიყვანს არცერთ პაროლს. შესვლის შემდეგ იხსნება dashboard.

მთავარ ეკრანზე — მძღოლის ბარათი სახელითა და ცვლის მიმდინარე სტატუსით (Offline / Online), ამოცანის ღილაკი მიმაგრებული მანქანების სიიდან არჩევისთვის, მთავარი მწვანე ღილაკი Go Online. დაჭერისას ითხოვება გეოლოკაცია, და მძღოლი ხვდება active-რეჟიმში: მისი კოორდინატები იწყებენ სერვერზე გადაცემას N წამში ერთხელ, და მისი ავატარი ხდება ხილული რუკაზე დისპეტჩერთან.

ტაბ Orders — კონკრეტულ მძღოლზე დანიშნული შეკვეთების სია. თითოეულზე — სტატუსი (Assigned, Picked Up, On the way, Delivered), გადასვლის ღილაკები და ჩაშენებული სანავიგაციო ბმულები: „გახსნა Google Maps-ში“ ან „კლიენტთან დარეკვა“. შეკვეთის დასრულებისას — მოდალი ნაღდი თანხის დადასტურებით (თუ COD) და ფოტოთი proof-of-delivery-სთვის.

ტაბ Earnings — მძღოლის შემოსავალი: დღეს, კვირა, თვე. ნაჩვენებია ბაზისური განაკვეთი, ჩაიის ფული ცალკე და მიწოდებების მთლიანი რაოდენობა. ეს ხურავს გიგ-ეკონომიკის მძღოლების კლასიკურ ტკივილს: „რამდენი გამოვიმუშავე ამ მომენტისთვის და ღირს თუ არა კიდევ ერთი საათი მუშაობა“.

ქუდის ქვეშ სამივე მინი-აპლიკაცია იყოფს web-ვიტრინასთან საერთო API-ს (NestJS), კლიენტისა და შეკვეთის საერთო entity-ებს, შეტყობინებების საერთო რიგს (Redis pub/sub), WebSocket-მოვლენების საერთო ფორმატს. განსხვავდება მხოლოდ UI და endpoint-ების ნაკრები, რომელიც თითოეულ როლზეა ხელმისაწვდომი. ეს საშუალებას აძლევს Sales mini-app-ში შექმნილ შეკვეთას წამებში გამოჩნდეს dispatcher-რუკაზე, ხოლო დანიშვნის შემდეგ — Driver mini-app-ში მძღოლთან მომდევნო წამებში. ყველაფერი Telegram-ის ერთი ეკოსისტემის შიგნით, აპლიკაციებს შორის გადასვლების გარეშე.

Login

Login (/login)

ადმინკაში შესვლის წერტილი. დაცულია GuestGuard-ით: უკვე ავტორიზებული მომხმარებელი გადამისამართდება თავის საწყის გვერდზე, როლის მიხედვით.

დიზაინ-პატერნები და ინტერფეისის ერთიანი ენა

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

• ფერი. მუქი მწვანე #0e3814 — ძირითადი headers-ისთვის, ღილაკებისთვის, sidebar-ისთვის. მუქი პანელები ამ ფერში თეთრი ტექსტით გამოიყენება summary-ბლოკებსა და chart-სექციებში, რათა ვიზუალურად გამოიყოს „ჯამები“ სამუშაო ცხრილებისგან.
• StatCard. უნივერსალური კომპონენტი KPI-სთვის. გამოიყენება Dashboard-ში, Sales Report-ში, EOD-ში, Campaigns-ში, Activity Log-ში და სხვებში — ყველგან ერთი და იგივე layout-ით: იკონი, ციფრი, ხელმოწერა, ოფციონალურად ისარი ცვლილების პროცენტით.
• DataTable. Reusable-კომპონენტი dark-ვარიანტის მხარდაჭერით. ყველა სია — შეკვეთები, საქონელი, ბანერები, საფულეები, შეფასებები — აშენებულია მისი მეშვეობით, ამიტომ პაგინაცია, hover-ეფექტი, სვეტების გასწორება ყველგან ერთნაირად იქცევა.
• Status badges. სემანტიკური ფერადი სქემა: მწვანე active-ისთვის და delivered-ისთვის, ყვითელი pending-ისთვის, წითელი cancelled-ისთვის, ლურჯი confirmed-ისთვის. ეს მაშინვე იკითხება, ლეგენდაში ჩახედვის გარეშე.
• Modal pattern. ყველგან ერთი და იგივე ფიქსირებული overlay backdrop-ზე დაჭერით დახურვით. არავითარი მოულოდნელი „სხვა მოდალი სხვაგვარად მუშაობს“.
• Toggle switches სტატუსებისთვის (visible / hidden, active / inactive) — უფრო კომპაქტური, ვიდრე ღილაკები, და მაშინვე იძლევა უკუკავშირს.
• Pagination Previous / Next-ით, წვრილ მიდგომებად ფრაგმენტაციის გარეშე.
• Loading state — Loader2 lucide-react-დან ერთნაირი ანიმაციით.
• იკონები — ექსკლუზიურად lucide-react, სხვა ნაკრებებთან მიქსების გარეშე. ეს მნიშვნელოვანია როგორც ვიზუალური მთლიანობისთვის, ასევე bundle size-ისთვის.

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

რას ნიშნავს ეს ბიზნესისთვის

გარე e-commerce admin-პანელების უმეტესობა ფარავს პირველ ორ-სამ დონეს: კატალოგი, შეკვეთები, მომხმარებლები. აქ გაკეთდა მცდელობა, წავიდეს გაცილებით ღრმად: დღის ფინანსური შედარება, კონვერტში მძღოლისგან ნაღდი ფულის კონტროლი, audit trail კატალოგისა და საფულეების ცვლილებებზე, ვორონკების ანალიტიკა ცალ-ცალკე რეგისტრაციაზე, ლოგინზე და ჩექაუთზე, მომხმარებელთა სესიების ჩაწერა replay-ით admin-ის შიგნით, მულტი-როლი მობილური layout-ებით მძღოლისთვის და დისპეტჩერისთვის.

ოპერაციების თვალსაზრისით ეს ნიშნავს, რომ მფლობელს და გუნდს შეუძლიათ ბიზნესის წარმოება დამოუკიდებლად, ტიპური ამოცანებისთვის დეველოპერთან მიმართვის გარეშე. პროდუქტის თვალსაზრისით — სისტემაში არის ჩაშენებული ინსტრუმენტები თვითდიაგნოსტიკისთვის: სად იკარგება ფული, სად ეცემა კონვერსია, ვინ ცვლის რაღაცას ადმინებიდან ღამით, რომელი SKU-ები არ მოაქვს მარჟას.

დაკავშირებული სექციები

• Last-mile Delivery Platform — ბიზნეს-მიმოხილვა
• Last-mile Delivery Platform — ტექნიკური არქიტექტურა
• ყველა ქეისი