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 página pública 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 rastreables. 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 código secreto corto generado o un token público generado, la búsqueda tolera los errores de lectura más comunes. En los códigos generados, O se interpreta como 0, I o L como 1, S como 5 y U como V. En los códigos secretos cortos del sistema, esa sustitucion solo afecta al cuerpo generado, no al prefijo literal como LN, GT o GC. Los códigos públicos usan ese mismo prefijo configurado más un guion, así que se distinguen a simple vista de los códigos 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 código público, un código secreto corto o un token largo de escaneo privado siempre empieza en <code>/trackable/{code}</code>. Los visitantes con código público después llegan a la página pública localizada en <code>/{lang}/trackable/{publicCode}</code>. No deberían existir URL del sitio para rastreables 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 rastreables también llevan una marca de tiempo de última actividad para que paneles, páginas 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 ¿Qué es un grupo de rastreables? guía.
Rastreables y notas
Los rastreables se convierten en historial de movimiento mediante paradas de recorrido. Una nota puede adjuntar uno o más rastreables en ese lugar, y un reporte directo de ubicación 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.
Aquí también es donde la visibilidad de nota por rastreable asociado adquiere sentido. Una nota puede empezar en ese modo de visibilidad y aun así comportarse al principio como una nota pública. El primer rastreable vinculado convierte después la nota en descubrimiento protegido por rastreable para todos excepto el propietario, los miembros autorizados del equipo y quienes ya desbloquearon uno de los rastreables vinculados.
La vinculacion de notas es intencionalmente deliberada. El sitio pide un código de rastreable a la vez, ese campo espera un código secreto corto existente y un código público es para la página pública del rastreable. Si un elemento de terceros aun no esta registrado, creelo primero desde la página de rastreables. Los prefijos reservados del sitio, como LN, GT y GC, siguen fuera de los limites para los códigos propios.
- Todavía no hay rastreables asociados: la nota se comporta como una nota pública.
- Despues de la primera asociación: la nota deja de aparecer en el descubrimiento público anónimo y en el acceso normal a la página pública de la nota.
- Visitante desbloqueado: alguien que ya desbloqueo un rastreable asociado puede abrir la página de la nota y usar las rutas API públicas conectadas a la página 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 rastreables 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 rastreable, por lo que mover la nota después no reescribe la ruta antigua del rastreable.
- Los modelos de lectura del rastreable también pueden mostrar las notas visibles actuales en esa coordenada, para que la ruta siga siendo precisa incluso cuando las notas cercanas cambian después.
- 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 rastreables son más fáciles de explicar como visibles tras el acceso frente a siempre visibles para todos. Un rastreable siempre visible para todos tiene una ruta pública compartible. Un rastreable 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 rastreable 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 rastreable puede aparecer después en la página 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 pública de rastreables y la lista pública de grupos de rastreables del sitio siguen siendo multilingues para que los datos de recorrido, inventario y logística no desaparezcan cuando los idiomas de autoría difieren.
Cambie el idioma del sitio cuando quiera la interfaz localizada alrededor de los mismos datos públicos del rastreable.
- 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 anónimos del rastreable y los reportes directos del mapa también se permiten cuando este navegador ya tiene acceso activo a ese rastreable exacto o quien llama reenvia su código secreto o su acceso privado de escaneo en la solicitud de escritura.
- Los comentarios anónimos del rastreable y los reportes directos no pueden ser editados después por la persona que los público, y solo el propietario del rastreable 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 rastreables, historial de paradas respaldadas por notas y comentarios de rastreables.
- 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.