Identificadores: referencia de formato y ejemplos
Los rastreables utilizan varios identificadores que parecen similares al principio pero sirven para diferentes trabajos. El código público corto permanece globalmente único, el código secreto corto permanece globalmente único y el sistema mantiene esos dos espacios libres de colisiones entre sí, por lo que un código público corto nunca puede ser también el código secreto corto de otra persona.
| . | Ejemplo | Propósito | Regla de unicidad |
|---|---|---|---|
| Token de código público | LN-7K4V9T |
Token de seguridad pública utilizado en enlaces públicos y búsquedas públicas. | Único globalmente en todos los rastreables y también único frente a códigos secretos cortos. |
| Ruta de entrada pública | https://locationnotes.com/trackable/LN-7K4V9T |
URL corta de entrada para compartir. El navegador puede localizarla y luego abrir la pagina publica en <code>/{lang}/trackable/{publicCode}</code>. | La ruta sigue siendo única porque el token público corto en sí es único a nivel mundial. |
| Ruta secreta corta | https://locationnotes.com/trackable/LN4C8R2Z |
URL de entrada basada en posesión para alguien que tiene físicamente el artículo. | El prefijo coincide con la familia del sitio, pero no hay guión, por lo que es visiblemente diferente del código público. |
| Código secreto corto del sistema | LN4C8R2Z |
Credencial de posesión corta para ingreso manual y activación de sesión activa. | Único globalmente en todos los rastreables y también único frente a códigos públicos. |
| Prefijo del sistema alternativo | GT8M2Q7V |
El mismo patrón de secreto corto en implementaciones hermanas que usan el prefijo GT. | Único en todos los rastreables en esa implementación. |
| Trae tu propio código secreto | ITEM42X |
Código externo avanzado para un artículo físico que ya venía con su propio identificador. | Unico entre todos los trackables. No debe empezar con LN, GT ni GC. |
| Ruta de escaneo privada | https://locationnotes.com/trackable/AB4D5QW2...<100 chars total>... |
URL de entrada QR larga para que el escaneo pueda activar el flujo de posesión sin un campo de formulario. | Único en todos los rastreables. |
| Token de escaneo privado | AB4D5QW2...<100 chars total>... |
Token QR opaco que usa solo A-Z y 1-5. | Único en todos los rastreables. |
Si alguien teclea a mano un codigo secreto corto generado o un token publico generado, la busqueda tolera los errores de lectura mas comunes. En los codigos generados, O se interpreta como 0, I o L como 1, S como 5 y U como V. En los codigos secretos cortos del sistema, esa sustitucion solo afecta al cuerpo generado, no al prefijo literal como LN, GT o GC. Los codigos publicos usan ese mismo prefijo configurado mas un guion, asi que se distinguen a simple vista de los codigos secretos cortos.
La regla práctica más importante es que la ruta pública es segura para compartir, mientras que el código secreto corto y la ruta de escaneo privada no lo son. Los códigos secretos y las URL de escaneo privado se muestran solo una vez durante la creación. Después de esa revelación, las páginas normales y las lecturas API normales no las vuelven a mostrar. La única excepción especial es la exportación personal orientada a la salida, donde se pueden incluir secretos estrictamente personales propiedad del usuario para que el propietario saliente pueda recuperarlos.
Debido a que el código público corto es globalmente único, la búsqueda en la página de inicio puede aceptar de forma segura un token público como LN-7K4V9T por sí solo y dirigirse a la página pública correcta sin tener que adivinar entre múltiples rastreables.
La URL de entrada orientada hacia fuera para un codigo publico, un codigo secreto corto o un token largo de escaneo privado siempre empieza en <code>/trackable/{code}</code>. Los visitantes con codigo publico despues llegan a la pagina publica localizada en <code>/{lang}/trackable/{publicCode}</code>. No deberian existir URL del sitio para trackables con alcance solo de propietario.
Activación y propiedad
Un rastreable recién creado puede comenzar activado o desactivado. La activación siempre ocurre a nivel de elemento individual. El usuario activador elige el título final y la descripción de los elementos que requieren una identidad explícita en el momento de la activación.
Los modelos de lectura de trackables tambien llevan una marca de tiempo de ultima actividad para que paneles, paginas de detalle y listas de seguimiento muestren de un vistazo el movimiento o la interaccion recientes.
- Un rastreable no activado no puede registrar nueva actividad de viaje y no puede recibir comentarios.
- Si se activa para un usuario, ese usuario se convierte en el ámbito de propiedad.
- Si se activa para un equipo, el equipo se convierte en el ámbito de propiedad.
- El creador y el propietario no siempre son la misma persona.
Grupos y metadatos alternativos
Los rastreables se pueden crear uno a la vez o en grupos de hasta 100. Un grupo puede proporcionar metadatos de elementos alternativos, mostrar el progreso de activación en todo el lote y brindarle un lugar para moverse entre las páginas de elementos públicos y administrados.
- Algunos elementos creados en grupo pueden heredar de forma segura los valores predeterminados del grupo cuando sus propios metadatos están en blanco.
- Otros elementos creados en grupo requieren que el activador final elija su propio título y descripción en lugar de heredar las palabras del creador para siempre.
- Las reglas completas de reserva, edición y separación primero se encuentran en el Que es un grupo de trackables? guía.
Rastreables y notas
Los trackables se convierten en historial de movimiento mediante paradas de recorrido. Una nota puede adjuntar uno o mas trackables en ese lugar, y un reporte directo de ubicacion puede agregar una parada sin crear una nota. El recorrido conserva la instantanea del lugar mientras las notas siguen siendo sus propios registros editables.
Lugar, historial y acceso se mantienen separados: la parada del recorrido conserva la coordenada capturada, la nota mantiene su propio registro editable y la visibilidad de la nota junto con su alcance de acceso requerido deciden quien puede abrir el contenido de la nota.
Aqui tambien es donde la visibilidad de nota por trackable asociado adquiere sentido. Una nota puede empezar en ese modo de visibilidad y aun asi comportarse al principio como una nota publica. El primer trackable vinculado convierte despues la nota en descubrimiento protegido por trackable para todos excepto el propietario, los miembros autorizados del equipo y quienes ya desbloquearon uno de los trackables vinculados.
La vinculacion de notas es intencionalmente deliberada. El sitio pide un codigo de trackable a la vez, ese campo espera un codigo secreto corto existente y un codigo publico es para la pagina publica del trackable. Si un elemento de terceros aun no esta registrado, creelo primero desde la pagina de trackables. Los prefijos reservados del sitio, como LN, GT y GC, siguen fuera de los limites para los codigos propios.
- Todavia no hay trackables asociados: la nota se comporta como una nota publica.
- Despues de la primera asociacion: la nota deja de aparecer en el descubrimiento publico anonimo y en el acceso normal a la pagina publica de la nota.
- Visitante desbloqueado: alguien que ya desbloqueo un trackable asociado puede abrir la pagina de la nota y usar las rutas API publicas conectadas a la pagina de la nota.
- Propietario o miembro autorizado del equipo: conserva el acceso normal a la nota y los permisos de administracion.
- Guardar una nota con trackables adjuntos puede crear instantaneas de parada para cada elemento adjunto.
- Los usuarios que hayan iniciado sesión también pueden registrar una parada directa en el mapa sin crear una nota primero y luego convertir esa parada en una nota más tarde si desean obtener más detalles.
- Una parada respaldada por nota toma una instantanea de la coordenada cuando se adjunta el trackable, por lo que mover la nota despues no reescribe la ruta antigua del trackable.
- Los modelos de lectura del trackable tambien pueden mostrar las notas visibles actuales en esa coordenada, para que la ruta siga siendo precisa incluso cuando las notas cercanas cambian despues.
- La página rastreable puede precargar la ruta completa porque se espera que estos viajes sigan siendo a escala humana.
- Los pines del mapa y la lista de paradas vinculada conducen de regreso a la página de notas cuando el espectador tiene permiso.
- Las notas privadas aún pueden contribuir con puntos de viaje de solo coordenadas para los espectadores que no pueden leer la nota en sí.
Visible tras el acceso frente a siempre visible para todos
Los trackables son más fáciles de explicar como visibles tras el acceso frente a siempre visibles para todos. Un trackable siempre visible para todos tiene una ruta pública compartible. Un trackable visible tras el acceso conserva una página normal, pero solo los propietarios con sesión iniciada, los ámbitos de equipo o las personas ya vinculadas mediante el flujo de acceso secreto pueden seguir abriéndola.
El código secreto corto y el flujo QR son la forma de demostrar posesión la primera vez. Después de que una cuenta con sesión iniciada use correctamente ese flujo visible tras el acceso, LocationNotes puede mantener el trackable vinculado a la cuenta para que los dispositivos con sesión iniciada futuros no vuelvan a necesitar el secreto solo para reabrir, seguir o comentar el elemento. Ese acceso guardado se convierte en una de las formas en que un trackable puede aparecer despues en la pagina Mis recorridos junto con los recorridos propios y de equipo.
Seguimientos y sesiones de navegador
Ingresar un código secreto o escanear un QR privado válido puede crear una sesión activa rastreable en el navegador actual. Ese estado recordado le permite a la persona continuar aprendiendo el flujo, iniciar sesión más tarde y adjuntar el rastreable desde las páginas de notas sin tener que volver a ingresar el secreto cada vez.
Esta sesión activa del navegador no es lo mismo que la propiedad permanente ni que la autenticación. Solo recuerda el contexto de posesión en el dispositivo actual hasta que la persona lo desactive o la sesión caduque. Cuando el visitante tiene sesión iniciada, esa misma autorización visible tras el acceso también puede guardarse en la cuenta para dispositivos con sesión iniciada posteriores.
Comentarios y páginas públicas
Los comentarios de las páginas rastreables pertenecen a la propia página rastreable y están separados de los comentarios de las páginas de notas. Las páginas públicas rastreables son vistas de recorrido canónicas. Las páginas de perfil privado, las páginas de equipo privadas y las páginas rastreables que solo son visibles una vez que se accede a ellas son restricciones a nivel de ruta, no un secreto global para cada etiqueta relacionada con el elemento.
La lista publica de trackables y la lista publica de grupos de trackables del sitio siguen siendo multilingues para que los datos de recorrido, inventario y logistica no desaparezcan cuando los idiomas de autoria difieren.
Cambie el idioma del sitio cuando quiera la interfaz localizada alrededor de los mismos datos publicos del trackable.
- Los nombres rastreables, los nombres de usuarios y los nombres de equipos aún pueden aparecer en listados permitidos y contextos de viaje.
- Las etiquetas de propietario se pueden mostrar como enlaces cuando la ruta está disponible o como texto sin formato con texto flotante en la página privada cuando no lo está.
- Los usuarios autenticados pueden comentar normalmente. Los comentarios anonimos del trackable y los reportes directos del mapa tambien se permiten cuando este navegador ya tiene acceso activo a ese trackable exacto o quien llama reenvia su codigo secreto o su acceso privado de escaneo en la solicitud de escritura.
- Los comentarios anonimos del trackable y los reportes directos no pueden ser editados despues por la persona que los publico, y solo el propietario del trackable o los administradores actuales del equipo pueden eliminarlos.
Exportaciones, recuperación y eliminación
Los rastreables sobreviven a la eliminación de manera diferente a los registros personales simples porque pueden contener un historial compartido de muchas personas a lo largo del tiempo. El sistema intenta eliminar la actividad personal extraíble del usuario eliminado sin dañar el historial restante de otros usuarios o equipos.
- Las exportaciones de usuarios y equipos ahora incluyen paradas de recorrido de trackables, historial de paradas respaldadas por notas y comentarios de trackables.
- Las exportaciones de usuarios pueden incluir credenciales secretas de propiedad estrictamente personal.
- Las exportaciones del equipo excluyen esos secretos a menos que el propietario del usuario no esté disponible y el equipo necesite una copia de recuperación.
- Eliminar un usuario no elimina automáticamente un rastreable que todavía es importante para otras personas.
- Eliminar un equipo puede desvincular la propiedad del equipo y devolverle el control de acuerdo con las reglas de respaldo documentadas.