Hola Tuk Tuk

01Խնդիրը

Hola Tuk Tuk-ը զբոսաշրջիկներին շրջեցնում է Բարսելոնայով էլեկտրական տուկ-տուկերով։ Ընկերությանը պետք էր կայք, որտեղ զբոսաշրջիկն ինքն է ընտրում տուրը, օրը և ժամը և անմիջապես վճարում, իսկ սեփականատերը մեկ տեղում տեսնում է բոլոր ամրագրումները՝ կայքից, գործընկեր հյուրանոցներից, GetYourGuide-ից և Viator-ից, և բաշխում դրանք վարորդների ու մեքենաների միջև։

02Ինչպես է աշխատում համակարգը

Համակարգը երեք մասից է՝ Next.js-ով կայք անգլերեն և իսպաներեն, React-ով ադմին վահանակ (Vite, React Query) և Laravel-ով API՝ MySQL տվյալների բազայով։ Կայքում զբոսաշրջիկը օրացույցում ընտրում է օրը և մեկնման ժամը, լրացնում տվյալները և վճարում PayPal-ով, բանկային քարտով կամ Bizum-ով․ քարտով և Bizum-ով վճարումներն անցնում են Redsys վճարային դարպասով։ Վճարումից առաջ տեղը 15 րոպեով պահվում է, և էկրանին հետհաշվարկ է գնում․ եթե ժամանակը լրանում է, հաճախորդը վերադառնում է ընտրությանը և չի վճարում արդեն զբաղված ժամի համար։ Ամրագրումը կարելի է գտնել համարով կամ էլ. հասցեով՝ նամակով եկած կոդը մուտքագրելուց հետո․ այնտեղ կարելի է ներբեռնել հաշիվը և վաուչերը և ավարտել ընդհատված վճարումը։ Հյուրանոցներն ու տուրիստական գործակալությունները գալիս են գործընկերային հղումով և ամրագրում առանց վճարման՝ անմիջապես ստանալով վաուչեր։

Bókun-ը համակարգի հետ կապված է երկու ուղղությամբ․ ամեն տասը րոպեն մեկ այնտեղից բերվում են ազատ տեղերն ու գները, GetYourGuide-ի և Viator-ի ամրագրումները գալիս են վեբհուկով, իսկ կայքի ամրագրումներն ուղարկվում են Bókun, որպեսզի հարթակները այդ տեղերը տեսնեն որպես վաճառված։ Ադմին վահանակում սեփականատերը նշում է տուկ-տուկերի քանակը, տարողությունը և գները խմբի տարբեր չափերի համար, քարտեզի վրա գծում տուրի երթուղին, էջերը հավաքում բլոկներից, վարում բլոգը և մեդիադարանը և լրացնում SEO դաշտերը՝ նախադիտմամբ։ Կայքը հեռախոսում տեղադրվում է որպես հավելված (PWA)։

03Գլխավորը՝ ազատ տեղերը

Տուկ-տուկերը ընդհանուր են բոլոր տուրերի համար, ուստի ժամը սահմանափակվում է ոչ միայն իր ժամանակացույցով, այլև մյուս տուրերի այն ամրագրումներով, որոնք այդ պահին դեռ ճանապարհին են։ Յուրաքանչյուր ամրագրում պահում է ավարտի ժամը, և տեղերը հաշվվում են ամբողջ պարկով․ եթե ժամը 10:00-ի երկժամյա տուրը զբաղեցրել է բոլոր մեքենաները, 11:00-ի մեկնումը փակ է, իսկ 12:30-ինը՝ նորից բաց։ Մի քանի կանոն այս հաշվարկը դարձնում է հուսալի․

• չվճարված ամրագրումը պահում է տեղը, մինչև պլանավորիչը չեղարկի այն ադմին վահանակում նշված ժամկետն անցնելուց հետո,
• տուրի տևողությունը փոխելիս արդեն ստեղծված ամրագրումները վերահաշվարկվում են, այդ թվում, երբ տևողությունը գալիս է Bókun-ից,
• Bókun-ից եկող ազատ տեղերի թիվը սահմանափակվում է պարկի չափով,
• ժամերը համեմատվում են Բարսելոնայի ժամային գոտով, թեև սերվերն աշխատում է UTC-ով։

04Դիսպետչերական և ֆինանսներ

Բոլոր ամրագրումները՝ կայքից, գործընկերներից և Bókun-ից, հավաքվում են մեկ գործառնական աղյուսակում, և դրա վրա է կառուցված օրվա դիսպետչերական վահանակը։ Վահանակում երևում է, թե վարորդներից ով է աշխատում, ով է հանգստանում ութշաբաթյա հերթափոխի գրաֆիկով, ինչ տուրեր ունի յուրաքանչյուրը և երբ կվերադառնա, որտեղ են պարապուրդները, ճաշը և արտաժամյա աշխատանքը, և որ ամրագրումներն են դեռ չբաշխված։ Երբ վարորդին տուր է նշանակվում, նա նամակ է ստանում իր լեզվով, իսկ նշանակման համար ստեղծվում է առանց գների PDF թերթիկ։ Վճարված ամրագրումները և GetYourGuide-ից ու Viator-ից եկամուտը գրանցվում են ֆինանսական մատյանում՝ վահանակով, հաշիվները ձևավորվում են PDF-ով՝ QR կոդով, իսկ աշխատակիցների մուտքը ադմինի բաժիններին սահմանափակված է դերերով և իրավունքներով։

05Այլ լուծումներ

PayPal-ի թեստային վճարումը միանում է միայն հստակ կարգավորմամբ, որը սերվերը չի ընդունում իրական միջավայրում, իսկ առանց PayPal-ի բանալիների նա սխալ է վերադարձնում, ոչ թե կեղծ պատվեր, ուստի իրական սերվերում հնարավոր չէ պատահաբար «ընդունել» չեղած վճարում։ Service worker-ը քեշավորում է միայն նկարները և մանիֆեստը․ էջերը, տվյալները, սկրիպտներն ու ոճերը միշտ գալիս են ցանցից, ուստի գներն ու ազատ տեղերը չեն հնանում։ Երթուղու քարտեզն աշխատում է առանց վճարովի ծառայությունների՝ OpenStreetMap-ի սալիկներ, ճանապարհներով անցնող գիծ OSRM-ից՝ սերվերի քեշավորող պրոքսիի միջոցով, իսկ երթուղու խմբագրիչում հասցեի որոնումը՝ Nominatim-ով։

06Արդյունքը

Կայքն աշխատում է երկու լեզվով և ամրագրումներ է ընդունում՝ holatuktuk.com։ Բեքենդը ծածկված է թեստերով՝ տուրերի հատում ըստ ժամի, պարկի տարողություն, չվճարված ամրագրումներ, վերահաշվարկ տևողությունը փոխելիս, ինչպես նաև Bókun-ի հետ համաժամեցում, դիսպետչերական և ֆինանսական մատյան։