Kwa Kuchelewa, Mara Mbili au Kamwe: Kujenga Safari za Wakati Halisi juu ya Mitandao Isiyotegemewa

Safari ya Twende ni mazungumzo ya moja kwa moja kati ya simu mbili zinazosogea na seva, juu ya mitandao inayokatika bila taarifa. Hivi ndivyo tulivyojenga tabaka la wakati halisi nyuma ya kila safari, na kwa nini tunabuni kila tukio kana kwamba linaweza kufika kwa kuchelewa, mara mbili au kamwe.

Dakika 8 za kusoma

Abiria anaagiza safari. Dereva aliye mitaa miwili mbali anaikubali. Kwa dakika ishirini zinazofuata, simu mbili na seva wanaendelea na mazungumzo bila kukoma: dereva yuko wapi, amefika lini, safari imeanza, imeisha, nani ameighairi na kwa nini.

Kwenye ubao mweupe, mazungumzo hayo ni safi. Mishale inatoka kisanduku kimoja kwenda kingine, na kila ujumbe unafika mara moja tu, kwa mpangilio, kwa wakati.

Barabarani, dereva anapita chini ya daraja. Simu ya abiria inahama kutoka 4G kwenda 3G na kurudi. Kiokoa betri cha mtu kinaifunga programu chinichini. Ujumbe uliotumwa saa 14:02:07 unafika baada ya ule uliotumwa saa 14:02:09. Mwingine unafika mara mbili. Mwingine haufiki kabisa.

Insha hii, sehemu ya mfululizo wetu wa kihandisi, inahusu tabaka linaloshikilia kila safari ya Twende: muunganisho wa wakati halisi kati ya abiria, madereva na seva zetu. Kanuni tuliyoijengea juu yake ndiyo ile tungependa kila mhandisi wa usafiri aikumbuke daima: katika usafiri wa kuita gari, mtandao ndio sehemu isiyotegemewa. Buni kila tukio kana kwamba linaweza kufika kwa kuchelewa, mara mbili au kamwe.

Safari moja, pande tatu

Kabla ya kuzungumzia soketi, inasaidia kuona ni nini hasa tunachojaribu kukiweka sawa kila upande.

Kila safari ya Twende inapita katika seti ndogo ya hali zilizoainishwa kwa ukali:

DRIVER_ASSIGNED → ARRIVED → IN_TRIP → COMPLETED

huku CANCELLED ikiwezekana njiani.

Pande tatu zinajali hali hiyo: abiria, dereva na seva. Uamuzi muhimu zaidi katika muundo wetu wa wakati halisi unahusu nani anaisimamia. Jibu ni: seva ndiyo chanzo cha ukweli. Programu zinaomba mabadiliko, na seva inayatangaza.

Dereva anapobonyeza "Nimefika", programu ya dereva haiweki tu safari kuwa imefika. Inatuma ombi (trip:update-status), na ni pale tu seva inapotangaza matokeo (trip:status-updated) ndipo programu zote mbili zinasasisha skrini zao. Ni safari moja ya ziada ya ujumbe, na inastahili kila milisekunde: simu mbili zenye mitandao dhaifu haziwezi kutofautiana kwa muda mrefu kuhusu kinachoendelea, kwa sababu hakuna hata moja inayoamua peke yake.

Soketi moja kwa kila programu, wasikilizaji wengi

Kila programu ya Twende ina muunganisho mmoja tu wa wakati halisi na seva zetu, kwa kutumia Socket.IO juu ya WebSockets katika eneo maalum la safari. Hakuna skrini inayofungua muunganisho wake. Hakuna kipengele kinachozungumza na soketi moja kwa moja.

Badala yake, mtoa huduma mmoja juu kabisa ya programu ndiye anayemiliki muunganisho, na skrini zinajiandikisha kwa matukio zinazoyajali kupitia hook:

// Any screen can listen without ever touching the socket.
useRideSocketEffect({
  onRideRequestAccepted: (trip) => showDriverFound(trip),
  onTripStatusUpdated: (trip) => syncTripState(trip),
  onDriverLocationUpdate: ({ lat, lng, heading }) => moveDriverMarker(lat, lng, heading),
  onDriverDisconnected: () => warnPassenger(),
});

Nyuma ya hook hiyo kuna rejista ndogo: kila tukio lina orodha ya wasikilizaji, iliyopangwa kwa kitambulisho cha kipekee cha kila kipengele kilichopo kwenye skrini. Soketi ikipokea tukio, mtoa huduma analisambaza kwa kila aliyejiandikisha. Skrini ikiondoka, wasikilizaji wake wanaondolewa.

Hii inasikika kama mabomba yaliyofichwa ukutani, na ndivyo ilivyo, lakini ilitatua kundi zima la hitilafu kwetu. Ukiwa na muunganisho mmoja, kuna mahali pamoja pa kushughulikia uthibitishaji, pamoja pa kushughulikia kuunganisha upya, na pamoja pa kurekodi kinachoendelea. Skrini zinakuja na kuondoka watu wanapozunguka ndani ya programu. Muunganisho, na safari unayoibeba, havijali.

Kuunganisha upya ndiyo hali ya kawaida

Hili ndilo badiliko la fikra lililotuchukua muda mrefu zaidi: muunganisho uliokatika si kosa. Ni Jumanne ya kawaida.

Katika miji tunayoijengea, simu hupoteza mtandao kwenye msongamano, katikati ya majengo na pembezoni mwa mji. Kwa hiyo muunganisho umesanidiwa kulitarajia hilo, na kujirejesha wenyewe:

io(`${BACKEND_BASE_URL}/taxi`, {
  transports: ["websocket"],
  // Function form: a fresh token on every reconnect attempt.
  auth: (cb) => cb({ token: getCachedAuthToken() }),
  reconnectionAttempts: 10,
  reconnectionDelay: 1000,
  reconnectionDelayMax: 30000,
});

Mambo mawili hapo yanastahili maelezo, kwa sababu kila moja lilitokana na hitilafu halisi.

Tokeni inasomwa kila mara ya kuunganisha upya, si mara moja tu. Vikao vyetu vinatumia tokeni zinazoisha muda. Muunganisho ukikatika na programu ikaendelea kujaribu kwa tokeni iliyokuwa nayo mwanzoni, inaweza kukwama kwenye mzunguko: kujaribu milele kwa tokeni ambayo seva haitaikubali tena. Kupitisha kazi (function) badala ya thamani kunahakikisha kila jaribio la kuunganisha upya linachukua tokeni ya sasa.

Muda kati ya majaribio unaongezeka. Jaribio la kwanza linafanyika baada ya sekunde moja, na yanayofuata yanaachana hadi sekunde thelathini. Mtaa mzima ukipoteza mtandao kwa wakati mmoja kisha ukaupata tena, maelfu ya simu zikiunganisha upya sekunde ile ile zingeipiga seva kama wimbi. Kuachanisha majaribio kunalitawanya wimbi hilo.

Soketi inatupika. Safari haitupiki.

Sehemu muhimu zaidi ya kuunganisha upya si muunganisho wenyewe. Ni kinachotokea mara baada yake.

Programu inapounganisha upya, ni muunganisho mpya kabisa, na seva haijui chochote kuhusu safari iliyokuwa ikiifuatilia. Kwa hiyo jambo la kwanza kila programu inalofanya kwenye connect ni kuangalia hali yake iliyohifadhiwa na kujiunga tena na safari yake:

socket.on("connect", () => {
  const trip = useTripStore.getState().currentTrip;
  if (trip?.id) socket.emit("joinTrip", { tripId: trip.id });
});

Safari inaishi ndani ya hifadhi ya hali ya programu, si ndani ya soketi. Soketi ni bomba tu. Unaweza kulitupa, kufungua jipya, na kuendelea pale pale ulipoachia. Usiweke kamwe ndani ya muunganisho kitu ambacho huwezi kumudu kukipoteza pamoja nao.

Midundo miwili ya mahali

Mahali ndiyo trafiki yenye shughuli nyingi zaidi kwenye muunganisho, na tunaituma kwa midundo miwili tofauti sana kutegemea dereva anafanya nini.

Dereva akiwa mtandaoni akisubiri safari, programu yake inaripoti mahali alipo kila GPS inaposasishwa. Mtiririko huo unalisha injini yetu ya kuunganisha abiria na madereva: ndio unaoweka faharasa ya hexagoni ikiwa ya kisasa, ili dereva sahihi apatikane ombi linapokuja.

Wakati wa safari, programu ya dereva inatuma mahali ilipo, pamoja na mwelekeo wake, kwa safari yenyewe kila sekunde mbili. Seva inaipeleka kwa abiria, ambaye ramani yake inasogeza alama ya dereva na kuigeuza kuelekea anakokwenda.

Kwa nini midundo miwili? Kwa sababu inajibu maswali tofauti. Faharasa ya kuunganisha inahitaji kujua takriban kila dereva aliye tayari yuko wapi. Abiria anayemtazama dereva wake akikaribia anahitaji taarifa laini na za mara kwa mara kuhusu gari moja mahususi. Kutuma kiwango hicho cha undani kwa kila dereva anayesubiri kungepoteza betri na data ya simu bila faida yoyote, na katika masoko ambako watu hununua bando kidogo kidogo, upotevu huo unalipwa na madereva wetu.

Kila ofa inahitaji mwisho

Muda kabla safari haijaanza ndio wenye msongamano zaidi, kwa sababu madereva kadhaa wanaweza kuwa wanaliangalia ombi moja kwa wakati mmoja. Kanuni tunayoifuata ni kwamba kila ofa lazima iishe kwa namna ambayo dereva anaweza kuiona. Ombi linalotoweka kimya kimya kwenye simu moja huku dereva mwingine akilikubali linachanganya kwa uchache, na kwa ubaya zaidi linamwacha dereva akielekea mahali pa kuchukua abiria ambaye si wake tena.

Kwa hiyo msamiati wa tabaka letu la wakati halisi una mwisho ulio wazi kwa kila namna ofa inavyoweza kuisha:

  • ride-request:accepted: umeipata.
  • ride-request:claimed: dereva mwingine ameikubali kwanza.
  • ride-request:expired: hakuna aliyeikubali kwa wakati.
  • ride-request:cancelled: abiria amebadilisha mawazo.

Kila moja linaondoa ombi kwenye skrini ya dereva likiwa na sababu iliyo wazi. Nyuma ya pazia, uchukuaji wa atomiki tuliouelezea katika insha yetu ya kuunganisha unahakikisha dereva mmoja tu anaweza kushinda. Matukio yanahakikisha wengine wote wanajua.

Salamu ya mkono inayofanya safari iwe salama

Sehemu moja ya mtiririko wetu wa wakati halisi haihusu kasi hata kidogo. Inahusu usalama, na ndiyo sehemu tunayojivunia zaidi.

Safari haianzi kwa sababu tu dereva amesema. Dereva akiwa tayari kuondoka, programu yake inatuma ombi la kuanza. Kwenye simu ya abiria, ukaguzi mfupi wa hatua mbili unatokea:

  1. Hakiki namba ya usajili. Je, namba ya usajili ya chombo kilicho mbele yako inalingana na ile iliyoonyeshwa kwenye programu?
  2. Thibitisha kuanza. Ni hapo tu ndipo abiria anakubali, na ni hapo tu ndipo seva inaihamisha safari kwenda IN_TRIP.

Abiria akiripoti kwamba namba ya usajili hailingani, safari inaghairiwa mara moja. Namba isiyolingana ni moja ya ishara za hatari zilizo wazi zaidi, na ni afadhali tusitishe safari ndani ya sekunde moja kuliko kumwomba abiria apande chombo kisicho sahihi.

Hiki ndicho ambacho miundombinu ya wakati halisi ipo kwa ajili yake. Si kuangalia gari likisogea kwenye ramani tu. Ni kumpa abiria udhibiti wakati unapojalisha zaidi. Kama tulivyoandika katika Usalama kwanza, usalama ni kitu tunachokijenga ndani ya kila hatua ya safari, na salamu hii ya mkono ni wazo hilo likigeuzwa kuwa itifaki.

Mambo yanapokuwa kimya

Hitilafu ngumu zaidi katika mfumo wa wakati halisi si zile zenye kelele. Ni zile za kimya.

Muunganisho wa dereva ukikatika katikati ya safari, abiria hapaswi kubaki akitazama alama iliyoganda na kujiuliza. Seva inamjulisha: tukio la driver-disconnected linafika kwenye programu ya abiria, inayoeleza kilichotokea na kutoa machaguo yaliyo wazi badala ya kumwacha akibahatisha.

Tulijifunza jinsi ukimya unavyoweza kuwa wa hila kwa njia ngumu, kwenye meza zetu wenyewe. Wakati wa utengenezaji, simu ya majaribio ilikuwa ikielekezwa kwenye anwani ya mtandao isiyo sahihi ya seva yetu. Haikuunganika na chochote, haikutoa kosa lolote na haikuwahi kutuma ombi la safari. Upande mwingine, zana zetu za kuiga madereva zilikaa zikisubiri maombi ambayo hayangekuja kamwe. Hakuna kilichokuwa kimeharibika hasa. Lakini hakuna kilichokuwa kikitokea pia. Ilituchukua muda mrefu kuliko tungependa kukiri kugundua kwamba tatizo lilikuwa anwani moja ya IP iliyopitwa na wakati.

Somo ni hili: katika mifumo ya wakati halisi, "hakuna kilichotokea" ni dalili, si ishara kwamba mambo ni shwari. Fanya ukimya uonekane: rekodi miunganisho, onyesha miunganisho iliyokatika, na wape watu hatua inayofuata upande wa pili unapokuwa kimya.

Kuwa mkali katika unachotuma, mvumilivu katika unachopokea

Jambo moja la mwisho, kwa sababu wahandisi watalitambua.

Kadiri backend yetu ilivyokua, baadhi ya matukio yalianza kuifunga safari ndani ya kitu kingine, huku mengine yakiituma moja kwa moja. Badala ya kuharibu programu kila mara muundo unapobadilika, programu ya abiria inakubali yote mawili kimya kimya:

socket.on("trip:status-updated", (data) => {
  const trip = data?.trip ?? data;
  notifyListeners(trip);
});

Ni wazo la mstari mmoja lililoazimwa kutoka siku za mwanzo za intaneti: kuwa mkali katika unachotuma, na mvumilivu katika unachopokea. Programu zako zikiishi kwenye simu ambazo huwezi kuzisasisha papo hapo, uvumilivu pembeni unakupa muda wa kubadilisha katikati kwa usalama.

Msimamo wetu, bila kuzunguka

Ikiwa unajenga chochote cha wakati halisi kinachoendeshwa kwenye simu katika ulimwengu halisi, hiki ndicho tungekuambia:

  1. Kwa kuchelewa, mara mbili au kamwe. Buni kila tukio ukidhani linaweza kufika kwa kuchelewa, zaidi ya mara moja, au lisifike kabisa.
  2. Chanzo kimoja cha ukweli. Iache seva iamue hali. Programu zinaomba mabadiliko; seva inayatangaza.
  3. Soketi inatupika. Weka hali nje ya muunganisho, ili kuunganisha upya kusiwe jambo la kuzingatiwa.
  4. Unganisha upya kwa umakini. Vitambulisho vipya kwa kila jaribio, na achanisha majaribio ili urejeshaji usigeuke kuwa hitilafu kubwa.
  5. Kila ofa inahitaji mwisho. Imekubaliwa, imechukuliwa, imeisha muda au imeghairiwa. Usiache kamwe kitu kitoweke tu.
  6. Fanya ukimya uonekane. "Hakuna kilichotokea" ni dalili. Ionyeshe.
  7. Tumia wakati halisi kwa ajili ya uaminifu, si ufuatiliaji tu. Ujumbe wenye thamani zaidi katika mfumo wetu si taarifa ya mahali. Ni abiria akithibitisha kwamba namba ya usajili inalingana kabla safari haijaanza.

Safari ni ahadi inayotimizwa kwa dakika ishirini juu ya mitandao isiyotegemewa. Ramani, injini ya kuunganisha na ukaguzi wa usajili tuliouandikia vyote ni muhimu. Lakini ni tabaka la wakati halisi linalobeba ahadi hiyo, tangu dereva anapokubali hadi abiria anapofika.

Uko tayari kusafiri na Twende?

Jiunge na orodha ya kusubiri na uwe miongoni mwa wa kwanza kupata usafiri salama na wa haki katika miji ya Afrika.

Makala zinazohusiana