Վարեք առաքումների մի օր
Առաջին մուտքից մինչև հաշվարկված կանխիկ հերթափոխ։ Դիսպետչերի աթոռին նստած մարդու համար։
Սկսել
Անհրաժեշտ է դիսպետչերի վահանակի համար բրաուզեր և յուրաքանչյուր առաքիչի համար հեռախոս՝ առաքիչի հավելվածով։ Հավելվածի խանութային տարբերակները դեռ հրապարակված չեն։
- 1
Բացեք վահանակը
Սեղմեք Բացել դեմոն կոճակը կամ անցեք ձեր տեղակայման վահանակի հասցեով։
- 2
Գրանցվեք կամ մուտք գործեք
Ծառայությունը գրանցվում է ինքնուրույն՝ անուն, հեռախոս, առաջին պահեստ և ձեր էլ. փոստը։ Մուտքի հղումը գալիս է էլ. փոստով և գործում է 15 րոպե։ Ով գրանցում է ծառայությունը, նա էլ դառնում է դրա սեփականատերը։
- 3
Կարդացեք քարտեզը
Յուրաքանչյուր առաքիչ ամենուր ունի գծի մեկ գույն՝ քարտեզում, ցուցակներում և պլաններում։ Անվան կողքի կարճ նշումը ցույց է տալիս՝ նա հերթափոխում է, ընդմիջման է, թե հերթափոխից դուրս։
Թիմ և դերեր
Ծառայությունում երեք դեր կա։ Սեփականատերը վարում է ընկերությունը՝ թիմը, պահեստները, ստացողի էջը և սակագինը։ Դիսպետչերը վարում է օրը։ Առաքիչն աշխատում է հավելվածում։ Մեկ մարդը կարող է լինել մի քանի ծառայությունում և անցնել դրանց միջև։
- 1
Հրավիրեք մարդկանց
Բացեք Ընկերություն, ապա Թիմ բաժինը և սեղմեք Հրավիրել։ Ընտրեք դերը և մուտքագրեք անունը։ Վահանակը կտա հղում, որը կարելի է պատճենել։ Եթե նշեք էլ. փոստ, հղումը կուղարկվի նաև նամակով։
- 2
Փոխանցեք հավելվածը
Առաքիչը բացում է հղումը հեռախոսում։ Հավելվածն ընդունում է հրավերը, ցույց է տալիս ծառայության անունը և բացատրում, թե ինչու է պետք դիրքը, նախքան հեռախոսը թույլտվություն հարցնելը։
- 3
Անջատեք անհրաժեշտության դեպքում
Անջատված մասնակիցը չի կարող մուտք գործել, իսկ անջատված առաքիչին պատվեր նշանակել հնարավոր չէ։ Մուտքը կորցրած առաքիչին կարելի է տալ մուտքի նոր հղում նույն ընտրացանկից։
Ստեղծեք պատվեր քարտեզի կետով
Երթուղու համար օգտագործվում է կետը։ Հասցեի տեքստը մարդկանց համար է։
- 1
Սկսեք նոր պատվեր
Մուտքագրեք ստացողի անունը և հեռախոսահամարը։
- 2
Նշեք կետը
Սեղմեք քարտեզին այնտեղ, որտեղ պետք է հասցնել առաքումը։ Կետը պետք է լինի Հայաստանի սահմաններում, այլապես API-ը կմերժի կոորդինատները։
- 3
Նշեք հասցեն
Հայերենը պարտադիր է։ Ռուսերենը և անգլերենը ոչ պարտադիր են, բայց դրանցով առաքիչի և հետևման էկրանները բնական են կարդացվում յուրաքանչյուր լեզվով։
- 4
Ավելացրեք կանխիկ կամ կոդ
Կանխիկի համար միացրեք այն և նշեք գումարը դրամով։ Մեկանգամյա ստացման կոդ պահանջելու համար միացրեք այն՝ ստացողը կոդը կտեսնի իր հետևման հղումում։
- 5
Պահեք և նշեք պատրաստ
Պատվերն անցնում է փուլերով՝ սևագիր, պատրաստ, նշանակված, վերցված, տեղում, առաքված։ Չհաջողված առաքումը վերադառնում է դիսպետչերին, որը կարող է այն նորից հերթ դնել։
Նշանակում և օպտիմալացում
Նշանակեք ձեռքով մեկ պատվեր կամ պլան խնդրեք շատերի համար։
- 1
Նշանակեք մեկ պատվեր
Ընտրեք պատրաստ պատվեր և ակտիվ առաքիչ։ Վերանշանակելիս նախորդ նշանակումը չեղարկվում է, երկու իրադարձությունն էլ գրանցվում են։
- 2
Խնդրեք պլան
Ընտրեք պատվերներ և առաքիչներ ու խնդրեք օպտիմալացնողից առաջարկ՝ նա կառաջարկի կանգառների հաջորդականություն յուրաքանչյուր առաքիչի համար։
- 3
Ստուգեք և ուղղեք
Օպտիմալությունը երաշխավորված չէ։ Կանգառները տեղափոխեք առաքիչների միջև, փոխեք հերթականությունը, նորից հաշվարկեք մնացածը։
- 4
Կիրառեք մեկ անգամ
Կիրառումը նշանակում է բոլոր կանգառները ընդունված հաջորդականությամբ կամ ոչինչ չի փոխում։ Եթե ստուգելիս պատվերը փոխվել է, պլանը մերժվում է որպես հնացած։
Ուղարկեք հետևման հղում
Ստացողին տվեք իր սեփական էջը, որտեղ ավելորդ ոչինչ չկա։
- 1
Ստեղծեք հղումը
Բացեք պատվերը և պատճենեք հետևման հղումը։ Ուղարկեք ցանկացած սովորական միջոցով։
- 2
Ինչ է երևում
Կարգավիճակը, ETA-ն, առաքիչի մոտավոր դիրքը, վերջին թարմացման ժամը և, եթե պետք է, ստացման կոդը, որը ասում են առաքիչին։
- 3
Ինչ երբեք չի երևում
Այլ կանգառներ, երթուղու պատմություն և պատվերի ներքին համար։ Առաքիչի հեռախոսը երևում է միայն, եթե սեփականատերը դա միացրել է ստացողի էջի կարգավորումներում։
- 4
Չեղարկեք ցանկացած պահի
Չեղարկումն ուժի մեջ է մտնում անմիջապես։ Նոր հղումը փոխարինում է հինին։ Հղումները առաքումից հետո նույնպես ժամկետանց են դառնում։
Առաքիչի հավելվածի հիմունքներ
Ինչ արժե պատմել առաքիչին առաջին առավոտ։
- 1
Սկսեք հերթափոխը
Հերթափոխի քարտի վրա սեղմեք «սկսել»։ Դիրքը հավաքվում է միայն հերթափոխի ընթացքում՝ ընդմիջումը դադարեցնում է, ավարտը՝ կանգնեցնում։
- 2
Կատարեք երթուղին
Կանգառները դասավորված են պլանավորված հերթականությամբ։ Սեղմեք մեկի վրա՝ տեսնելու, թե ուր գնալ, և մեկ հպումով բացեք նավիգացիան։
- 3
Նշեք փուլերը
Վերցրեցի, տեղում եմ, առաքվեց։ Եթե առաքումը չի հաջողվել, ընտրեք պատճառը՝ ստացողը բացակայում է, հրաժարվեց, սխալ հասցե կամ այլ։
- 4
Գրանցեք հաստատումը
Լուսանկարեք, մուտքագրեք, թե ով է ստացել, կամ խնդրեք մեկանգամյա կոդը, եթե պատվերը պահանջում է։
- 5
Կապը կորչելը սարսափելի չէ
Փոփոխությունները սպասում են հեռախոսում և ուղարկվում են ինքնաբերաբար, երբ կապը վերականգնվում է։ Վիճակի տողում երևում է, թե քանիսն են հերթում։
Կանխիկ առաքման պահին և հաշվարկ
Կանխիկը հաշվվում է դռան մոտ և հանձնվում հերթափոխի վերջում։
- 1
Ընդունեք դռան մոտ
Կանխիկով պատվերի դեպքում հավելվածը ցույց է տալիս վճարման ենթակա գումարը և լրացնում ստացված գումարը՝ հաշվելով մանրը։
- 2
Հետևեք մնացորդին
Առաքիչի գլխավոր էկրանին երևում է հանձնման ենթակա կուտակված գումարը։ Դիսպետչերը նույն թիվը տեսնում է յուրաքանչյուր առաքիչի համար։
- 3
Հանձնեք
Հերթափոխի վերջում առաքիչը սեղմում է «հանձնել կանխիկը»։ Մնացորդն անցնում է հաստատման սպասման վիճակի։
- 4
Հաստատեք ստացումը
Դիսպետչերը հաստատում է կանխիկի հաշվարկի վահանակում։ Մնացորդը վերադառնում է զրոյի։
API-ի ակնարկ
Այն ամենը, ինչ անում են վահանակը և հավելվածները, անցնում է մեկ HTTP API-ով։ Հարցումները կրում են bearer տոկեն POST /auth/login-ից կամ մուտքի հղումից, refresh տոկենները փոխվում են օգտագործելիս։ Յուրաքանչյուր հարցում աշխատում է օգտատիրոջ ակտիվ ընկերության սահմաններում։ Սխալները փոքր JSON օբյեկտներ են՝ type, title և status դաշտերով։
| Ոլորտ | Հիմնական endpoint-ներ |
|---|---|
| Նույնականացում | /auth/signup, /auth/login, /auth/magic-link, /auth/refresh, /auth/logout, /auth/switch-company, /me |
| Ընկերություն և թիմ | /company, /company/depots, /company/members, /company/invites, /company/billing, /auth/invite/accept |
| Պատվերներ | /orders, /orders/{id}, /orders/{id}/status, /orders/{id}/events, /orders/{id}/notify-late |
| Նշանակում և պլաններ | /orders/{id}/assign, /plans/recompute, /plans/move-stop, /plans/apply, /geo/optimize |
| Առաքիչներ | /couriers, /couriers/{id}, /couriers/{id}/eta, /courier/me, /courier/shift/start|break|end |
| Առաքիչի աշխատանք | /courier/orders, /courier/orders/{id}/status, /courier/location |
| Կանխիկ և վաստակ | /courier/cash, /cash/settlements, /courier/earnings, /courier/history |
| Ստացողի հետևում | /orders/{id}/tracking, /track/{token}, /track/{token}/rating |
| Ուղիղ իրադարձություններ | /events (server-sent events), /events/latest-cursor |
| Գեո | /geo/route, /geo/matrix, /geo/optimize, /healthz |
Գեո endpoint-ները հասանելի են միայն մուտք գործած դիսպետչերներին և առաքիչներին՝ հանրային հետևման էջը ETA-ն հաշվարկում է ինքնուրույն՝ սերվերում։
Սեփական սերվերում
Մեկ տեղակայումը սպասարկում է բազմաթիվ ծառայություններ։ Յուրաքանչյուրը տեսնում է միայն իր պատվերները, առաքիչները և կարգավորումները։
- 1
Ստուգեք վիճակը
GET /healthz-ը պատասխանում է 200, երբ երթուղիները, օպտիմալացումը, տվյալների բազան և սալիկները աշխատում են, և 503՝ խափանված մասի անունով, երբ ոչ։ - 2
Թարմացրեք քարտեզը
Շաբաթը մեկ թարմացրեք OpenStreetMap-ի տվյալները՝ մեկ հրամանը ներբեռնում է դրանք, վերակառուցում երթուղիների գրաֆը և ստուգում փորձնական երթուղի։
- 3
Պատճեններ և վերականգնման փորձ
Բազայի գիշերային պատճենները ստուգվում են ստեղծման պահին։ Վերականգնման փորձը կատարեք սխեմայի փոփոխությունից հետո և ամսական մեկ անգամ։
- 4
Սահմանեք պահպանման ժամկետները
Դիրքի պատմությունը և անվավեր հետևման տոկենները ջնջվում են ժամանակացույցով։ Լռելյայն արժեքները պայմանական են, մինչև իրավաբանը սահմանի իրական ժամկետները։
Լրիվ ուղեցույցը պահոցի OPERATIONS.md ֆայլն է։