Gabay sa konsepto

Ano ang isang Trackable?

Ang trackable ay isang movable item identity na maaaring makaipon ng place-based na history ng paglalakbay sa paglipas ng panahon. Ang mga trackable ay nagkokonekta ng mga pisikal na bagay o external na natukoy na mga item sa mga pampublikong page, mga daloy ng code na nakabatay sa pagmamay-ari, mga komento, at mga mapa ng paglalakbay.

Mga Identifier: sanggunian sa format at mga halimbawa

Gumagamit ang mga trackable ng ilang identifier na mukhang magkapareho sa una ngunit nagsisilbi sa iba't ibang trabaho. Ang maikling pampublikong code ay nananatiling natatangi sa buong mundo, ang maikling sikretong code ay nananatiling natatangi sa buong mundo, at pinapanatili ng system ang dalawang espasyong iyon na walang banggaan laban sa isa't isa upang ang maikling pampublikong code ay hindi rin maaaring maging maikling sikretong code ng ibang tao.

Pormat Halimbawa Layunin Panuntunan sa pagiging natatangi
Pampublikong code na token LN-7K4V9T Pampublikong ligtas na token na ginagamit sa mga pampublikong link at pampublikong paghahanap. Natatangi sa buong mundo sa lahat ng trackable at natatangi din laban sa mga maiikling lihim na code.
Ruta ng pampublikong pagpasok https://locationnotes.com/trackable/LN-7K4V9T Maikling naibabahaging entry URL. Maaaring i-localize ito ng browser at pagkatapos ay buksan ang pampublikong pahina sa <code>/{lang}/trackable/{publicCode}</code>. Ang ruta ay nananatiling kakaiba dahil ang maikling pampublikong token mismo ay natatangi sa buong mundo.
Maikling lihim na ruta https://locationnotes.com/trackable/LN4C8R2Z Ang entry na nakabatay sa pagmamay-ari na URL para sa isang taong pisikal na may item. Ang prefix ay tumutugma sa pamilya ng site, ngunit walang gitling kaya ito ay nakikitang naiiba sa pampublikong code.
Maikling sikretong code ng system LN4C8R2Z Maikling kredensyal sa pagmamay-ari para sa manu-manong pagpasok at pag-activate ng aktibong session. Natatangi sa buong mundo sa lahat ng trackable at natatangi din laban sa mga pampublikong code.
Kahaliling prefix ng system GT8M2Q7V Parehong short-secret pattern sa mga sister deployment na gumagamit ng GT prefix. Natatangi sa lahat ng trackable sa deployment na iyon.
Dalhin-iyong-sariling sikretong code ITEM42X Advanced na panlabas na code para sa isang pisikal na item na mayroon nang sariling identifier. Natatangi sa lahat ng trackable. Hindi ito dapat magsimula sa LN, GT, o GC.
Pribadong ruta ng pag-scan https://locationnotes.com/trackable/AB4D5QW2...<100 chars total>... Mahabang QR entry na URL upang ma-activate ng pag-scan ang daloy ng pagmamay-ari nang walang field ng form. Natatangi sa lahat ng trackable.
Pribadong scan token AB4D5QW2...<100 chars total>... Opaque QR token gamit lang ang A-Z at 1-5. Natatangi sa lahat ng trackable.

Kapag ang isang tao ay nag-type ng isang nabuong maikling lihim na code o isang nabuong pampublikong-code na token sa pamamagitan ng kamay, ang paghahanap ay pagpapatawad tungkol sa mga pinaka-karaniwang mga bahid. Itinuturing ng nabuong paghahanap ng code ang O bilang 0, I o L bilang 1, S tulad ng 5, at U tulad ng V. Para sa mga maiikling sikretong code ng system, nalalapat ang kapalit na logic sa nabuong katawan, hindi sa literal na prefix tulad ng LN, GT, o GC. Ang mga pampublikong code ay gumagamit ng parehong naka-configure na prefix kasama ang isang gitling, kaya ang mga ito ay nakikitang naiiba mula sa mga maikling lihim na code sa isang sulyap.

Ang pinakamahalagang praktikal na tuntunin ay ang pampublikong ruta ay ligtas na ibahagi, habang ang maikling sikretong code at ang pribadong ruta ng pag-scan ay hindi. Isang beses lang ipinapakita ang mga lihim na code at pribadong scan URL sa panahon ng paggawa. Pagkatapos ng isang pagbubunyag, ang mga normal na pahina at normal na API na mga nabasa ay hindi na muling nagpapakita sa kanila. Ang isang espesyal na pagbubukod ay ang personal na pag-export na nakatuon sa pag-alis, kung saan maaaring isama ang mahigpit na mga personal na lihim na pagmamay-ari ng user upang mabawi ng paalis na may-ari ang mga ito.

Dahil ang maikling pampublikong code ay natatangi sa buong mundo, ang paghahanap sa homepage ay maaaring ligtas na tumanggap ng isang pampublikong token tulad ng LN-7K4V9T nang mag-isa at ruta sa tamang pampublikong pahina nang hindi nanghuhula sa pagitan ng maraming trackable.

Palaging nagsisimula sa <code>/trackable/{code}</code> ang entry na URL na nakaharap sa labas para sa pampublikong code, maikling sikretong code, o mahabang pribadong scan token. Ang mga bisita sa pampublikong code ay dumarating sa lokal na pampublikong pahina sa <code>/{lang}/trackable/{publicCode}</code>. Hindi dapat umiral ang mga nasusubaybayang URL ng website na nasasakupan ng may-ari.

Pag-activate at pagmamay-ari

Ang isang bagong likhang trackable ay maaaring magsimulang i-activate o hindi aktibo. Palaging nangyayari ang pag-activate sa antas ng indibidwal na item. Pinipili ng nag-a-activate na user ang panghuling pamagat at paglalarawan para sa mga item na nangangailangan ng tahasang pagkakakilanlan sa oras ng pag-activate.

Ang mga trackable read model ay may dalang timestamp para sa huling aktibidad upang ang mga dashboard, pahina ng detalye, at listahan ng panonood ay maaaring magpakita ng kamakailang galaw o pakikipag-ugnayan sa isang sulyap.

Mga pangkat at fallback metadata

Ang mga trackable ay maaaring gawin nang paisa-isa o sa mga pangkat na hanggang 100. Ang isang grupo ay maaaring magbigay ng fallback na metadata ng item, magpakita ng pag-usad ng activation sa buong batch, at bigyan ka ng isang lugar upang lumipat sa pagitan ng pinamamahalaan at pampublikong mga pahina ng item.

Mga trackable at tala

Ang mga trackable ay nagiging history ng paggalaw sa pamamagitan ng mga paghinto sa paglalakbay. Ang isang tala ay maaaring mag-attach ng isa o higit pang mga trackable sa lugar na iyon, at ang isang direktang ulat sa lokasyon ay maaaring magdagdag ng paghinto nang hindi gumagawa ng isang tala. Pinapanatili ng paglalakbay ang snapshot ng lugar habang ang mga tala ay nananatiling sarili nilang mga nae-edit na tala.

Ang lugar, kasaysayan, at pag-access ay mananatiling hiwalay: pinapanatili ng paghinto ng paglalakbay ang naputol na coordinate, pinapanatili ng tala ang sarili nitong nae-edit na tala, at ang visibility ng tala kasama ang kinakailangang saklaw ng pag-access ang magpapasya kung sino ang makakapagbukas ng nilalaman ng tala.

Dito rin nagiging makabuluhan ang nauugnay na masusubaybayang visibility ng tala. Ang isang tala ay maaaring magsimula sa visibility mode na iyon at kumilos pa rin tulad ng isang pampublikong tala sa simula. Ang unang naka-link na trackable pagkatapos ay i-flip ang tala sa trackable-gated na pagtuklas para sa lahat maliban sa may-ari, awtorisadong miyembro ng team, at mga manonood na na-unlock na ang isa sa mga naka-link na trackable.

Ang attachment ng tala ay sadyang sinadya. Ang website ay humihingi ng isang trackable code sa isang pagkakataon, ang field na iyon ay umaasa ng isang umiiral na maikling lihim na code, at ang isang pampublikong code ay para sa pampublikong trackable na page sa halip. Kung hindi pa nakarehistro ang isang third-party na item, gawin muna ito mula sa page ng trackables. Ang mga nakareserbang prefix ng site gaya ng LN, GT, at GC ay hindi limitado para sa bring-your-own-own code.

Nakikita Kapag Na-access kumpara sa Palaging Nakikita Ng Lahat

Ang mga trackable ay mas madaling ipaliwanag bilang Nakikita Kapag Na-access kumpara sa Palaging Nakikita Ng Lahat. Ang Isang Laging Nakikita Ng Lahat na nasusubaybayan ay may naibabahaging pampublikong ruta. Ang isang Nakikitang Kapag Na-access na trackable ay mayroon pa ring normal na pahina, ngunit tanging ang mga naka-sign-in na may-ari, saklaw ng team, o mga taong naka-link na sa pamamagitan ng lihim na daloy ng pag-access ang maaaring patuloy na magbubukas nito.

Ang maikling sikretong code at daloy ng QR ay kung paano napatunayan ang pagmamay-ari sa unang pagkakataon. Pagkatapos gamitin ng isang naka-sign-in na account ang Visible Once Accessed flow na matagumpay, maaaring patuloy na i-link ng LocationNotes ang trackable na iyon sa account para hindi na kailanganin ng mga device na naka-sign in sa hinaharap ang sikreto para lang muling mabuksan, sundan, o magkomento sa item. Ang naka-save na access na iyon ay nagiging isa sa mga paraan na maaaring lumitaw ang isang nasusubaybayan sa ibang pagkakataon sa naka-sign-in na pahina ng Aking Mga Paglalakbay kasama ng mga paglalakbay ng pagmamay-ari at ng koponan.

Mga trackable at mga session ng browser

Ang paglalagay ng isang lihim na code o pag-scan ng wastong pribadong QR ay maaaring lumikha ng isang aktibong nasusubaybayang session sa kasalukuyang browser. Ang naaalalang estado na iyon ay nagbibigay-daan sa tao na magpatuloy sa pag-aaral ng daloy, mag-sign in sa ibang pagkakataon, at ilakip ang nasusubaybayan mula sa mga pahina ng tala nang hindi muling ipinapasok ang lihim sa bawat oras.

Ang aktibong session ng browser na ito ay hindi katulad ng permanenteng pagmamay-ari at hindi katulad ng pagpapatotoo. Ito ay tinatandaan lamang ang konteksto ng pagmamay-ari sa kasalukuyang device hanggang sa i-deactivate ito ng tao o mag-expire ang session. Kapag naka-sign in ang viewer, ang parehong Visible Once Accessed na access ay maaari ding i-save sa account para sa mga device na naka-sign in sa ibang pagkakataon.

Mga komento at pampublikong pahina

Ang mga komento sa trackable-page ay nabibilang sa trackable mismo at hiwalay sa mga komento sa note-page. Ang mga pampublikong nasusubaybayang pahina ay mga canonical na view ng paglalakbay. Ang mga pribadong pahina ng profile, mga pahina ng pribadong koponan, at mga nasusubaybayang pahina na Nakikita lamang Kapag Na-access ay mga paghihigpit sa antas ng ruta, hindi pandaigdigang lihim para sa bawat label na nauugnay sa item.

Ang pampublikong listahan ng masusubaybayan at pampublikong listahan ng masusubaybayang pangkat ng website ay mananatiling multilinggwal upang hindi mawala ang data ng paglalakbay, imbentaryo, at logistik kapag magkaiba ang mga wikang may akda.

Ilipat ang wika ng website kapag gusto mong i-localize ang chrome sa parehong pampublikong nasusubaybayang data.

Mga pag-export, pagbawi, at pagtanggal

Ang mga trackable ay nakaligtas sa pagtanggal nang iba sa mga simpleng personal na talaan dahil maaari silang magdala ng nakabahaging kasaysayan mula sa maraming tao sa paglipas ng panahon. Sinusubukan ng system na alisin ang naaalis na personal na aktibidad ng user nang hindi sinisira ang natitirang kasaysayan para sa ibang mga user o team.

Mga kaugnay na gabay