ServerSource Պահանջներ User flow-եր Տվյալների մոդել Ճարտարապետություն և API UI/UX նախատիպ

User flow-եր Փուլ 1

Հիմնական 10 հոսքերը՝ քայլ առ քայլ։ Բոլորը իրագործելի են նախատիպում՝ UI/UX նախատիպ։

Flow 1․ Գրանցում և ընկերության ստուգում

  1. Հյուրը սեղմում է «Գրանցվել» և մուտքագրում email, հեռախոս, գաղտնաբառ, ընտրում դեր (բեռնատեր / փոխադրող)։
  2. Հաստատում է email-ը (կոդ կամ հղում)։
  3. Ստեղծում է ընկերության պրոֆիլ՝ անուն, երկիր, ՀՎՀՀ, տեսակ (shipper / carrier / both)։
  4. Վերբեռնում է հիմնադիր փաստաթղթերը (վկայական, լիցենզիա)։
  5. Համակարգը ընկերությանը դնում է pending կարգավիճակում․ բորսան դիտելու համար բաց է, հրապարակելու՝ ոչ։
  6. Պլատֆորմի ադմինը Admin Panel-ում ստուգում է փաստաթղթերը։
  7. Որոշում․ verified → բոլոր գործառույթները բաց են / rejected → պատճառով վերադարձ քայլ 4։
  8. Երկու դեպքում էլ՝ email ծանուցում + գրառում աուդիտում։

Flow 2․ Բեռի հրապարակում (բեռնատեր)

  1. Մուտք → «Հրապարակել բեռ»։
  2. Լրացնում է՝ ուղղություն (երկիր/քաղաք), բեռնման ամսաթիվ, քաշ, ծավալ, տեսակ, գին + արժույթ, նկարագրություն։
  3. Վալիդացիա → հայտը դառնում է active և հայտնվում է բորսայում։
  4. Խմբագրում/դադարեցում հասանելի է մինչև առաջարկի ընդունումը։
  5. Բեռնաթափման ամսաթիվն անցնելիս՝ ավտոմատ archived։

Flow 3․ Որոնում և առաջարկ (փոխադրող)

  1. Բորսա → ֆիլտրներ․ ուղղություն, ամսաթիվ, քաշ, տեսակ, գնի միջակայք։
  2. Բացում է բեռի քարտը՝ ամբողջական պայմաններ և ընկերության վարկանիշ։
  3. Ուղարկում է գնային առաջարկ՝ գին + մեկնաբանություն։
  4. Բեռնատերը ստանում է in-app + email ծանուցում։

Flow 4․ Բանակցություն → պատվեր

  1. Բեռնատերը բացում է առաջարկը։
  2. Չատում քննարկում են պայմանները․ փոխադրողը կարող է ներկայացնել նոր գին (առաջարկը անցնում է negotiating)։
  3. Բեռնատերը ընդունում է առաջարկը։
  4. Համակարգը ավտոմատ ստեղծում է պատվեր created կարգավիճակով՝ եզակի համարով, և գրում է պատմություն։
  5. Բեռի հայտը անցնում է booked․ այլ առաջարկները փակվում են։

Flow 5․ Պատվերի կյանքի ցիկլ

Ստեղծված→ Հաստատված→ Ուղիղ ճանապարհին→ Առաքված→ Ավարտված
Չեղարկված— մինչև ուղիղ ճանապարհը, պատճառով Վիճարկված— ցանկացած պահի, ադմինի որոշմամբ
ԱնցումՈվ է կատարումՀետևանք
created → confirmedՈրևէ կողմ (հաստատում)Ծանուցում մյուս կողմին
confirmed → in_transitՓոխադրողՄեկնման գրառում պատմությունում
in_transit → deliveredՓոխադրողԾանուցում բեռնատիրոջը
delivered → completedԲեռնատերԲացվում է վարկանիշի ձևը
ցանկացած → cancelledԿողմերից մեկը (մինչև in_transit)Պատճառի գրառում
ցանկացած → disputedԿողմերից մեկըԱդմինի հերթապահություն

Ամեն անցում գրանցվում է order_status_history-ում (ով, երբ, ումից → ում)՝ ընդունման չափանիշ №5։

Flow 6․ Փաստաթղթերի շրջանառություն

  1. Պատվերի էջում կողմերը վերբեռնում են պայմանագիր, CMR, հաշիվ, մաքսային փաստաթղթեր։
  2. Ֆայլերը պահվում են փակ object storage-ում՝ ոչ հրապարակային URL-ներով։
  3. Ներբեռնումը՝ միայն կարճաժամկետ ստորագրված URL-ով, միայն պատվերի կողմերի և ադմինի համար (ընդունման չափանիշ №6)։
  4. Յուրաքանչյուր վերբեռնում/ներբեռնում → աուդիտի գրառում։

Flow 7․ Հաղորդագրություններ և ծանուցումներ

  1. Չատը կապված է առաջարկի/պատվերի հետ․ մասնակիցները միայն երկու կողմերն են։
  2. Նոր հաղորդագրությունը իրական ժամանակում է հասնում (WebSocket) + email fallback։
  3. Ծանուցումների կենտրոնում՝ չընթերցված հաշվիչ, «նշել բոլորը ընթերցված»։

Flow 8․ Բաժանորդագրություն և վճարում

  1. Ընկերության ադմինը ընտրում է պլան (Անվճար / Բազային / Պրո)։
  2. Համակարգը ստեղծում է payment intent Idempotency-Key-ով։
  3. Վճարումը կատարվում է provider-ի միջոցով, հաստատումը՝ webhook-ով։
  4. Նույն բանալիով կրկնվող հարցումը վերադարձնում է նույն արդյունքը՝ առանց կրկնակի գանձման (ընդունման չափանիշ №8)։
  5. Հաջողության դեպքում՝ subscription-ը ակտիվանում է, ձևավորվում է հաշիվը։

Flow 9․ Ադմինի մոդերացիա

  1. Admin Panel → սպասող ընկերությունների հերթ (pending)։
  2. Փաստաթղթերի դիտում → verify կամ reject (պատճառով)։
  3. Բորսայի հայտերի մոդերացիա՝ հեռացում պատճառով։
  4. Վիճարկումների քննում՝ որոշման գրառում պատվերի պատմությունում։
  5. Աուդիտի մատյանի և վիճակագրության դիտում։

Flow 10․ Վարկանիշ

  1. Պատվերը հասնում է completed։
  2. Երկու կողմերն էլ գնահատում են միմյանց՝ 1–5 + մեկնաբանություն։
  3. Մեկ գնահատական մեկ կողմից մեկ պատվերի համար (unique constraint)։
  4. Միջին վարկանիշը ցուցադրվում է ընկերության պրոֆիլում և հասանելի է որոնման ֆիլտրում։