À propos du projet

Il s'agit d'un projet de démonstration du poste de traitement destiné aux agents de police/service client du service de proximité du métro « Jinglaibang », utilisé en complément de l'écran vocal de recherche d'objets côté usagers. Le projet est une implémentation front-end pure en fichier unique (HTML + JavaScript natif + localStorage). Il suffit de double-cliquer sur staff-lostfound-demo.html pour l'ouvrir dans un navigateur, sans installation de dépendances ni service back-end. Les fonctionnalités sont organisées de haut en bas en cinq zones selon le flux métier : 0. En attente d'enregistrement · Demandes de perte : les informations collectées après la demande de l'usager sur l'écran vocal sont d'abord mises en file d'attente, sans générer directement de ticket officiel ; après vérification des détails, l'agent clique sur « Créer un dossier » pour générer un ticket LF officiel qui entre en attente de correspondance. Si les informations sont incomplètes, il peut « Renvoyer » pour notifier l'usager de les compléter, ajoutant ainsi un contrôle par l'agent en plus de la création autonome de ticket côté usager, afin d'éviter les fausses déclarations. 1. En attente de correspondance · Code de suivi (LF) : les tickets LF officiels sont en file d'attente de correspondance ; en cliquant sur une ligne, le type d'objet, la couleur, la ligne et la station sont automatiquement préremplis dans le formulaire de saisie. 2. Saisie des objets trouvés : l'agent enregistre les objets effectivement trouvés dans le registre. Après soumission, une correspondance inverse automatique est effectuée selon « type d'objet + couleur/station » avec les tickets LF en attente ; en cas de correspondance, un code de retrait à 6 chiffres est généré. Les champs obligatoires sont uniquement le type d'objet et la station (la station est sélectionnée par recherche par mots-clés, issue du répertoire des stations pour éviter les erreurs de saisie). La couleur, la ligne, l'heure de découverte, le créneau horaire, l'emplacement précis de la découverte, la description, le gardien et la photo sont facultatifs. L'emplacement précis de la découverte est enregistré séparément, par exemple « à côté du portique de sécurité de la sortie 3 » ou « sous le siège au milieu de la voiture 2 ». Après sélection de la station, la ligne est automatiquement renseignée, et le lieu de retrait par le propriétaire est automatiquement déterminé selon la règle « station + poste de police ». Il est recommandé de téléverser une photo de l'objet pour la correspondance par reconnaissance d'image. 3. Registre des objets trouvés : prise en charge du filtrage par tous/en stock/correspondance trouvée/retiré ; possibilité de valider la remise avec le code de retrait, de renseigner un motif de réexamen pour exclure une correspondance, de consulter les photos des objets et les retours de réclamation des passagers. 4. Remises en attente de confirmation (HD) : après avoir trouvé un objet, le passager s'enregistre sur l'écran et apporte l'objet au centre de service client. L'agent confirme avec le code de remise, et l'objet entre automatiquement dans le registre. En l'absence de correspondance automatique, il est possible de lier manuellement un code de suivi LF. Les détails comprennent une chronologie complète de l'avancement. En ce qui concerne les transitions d'état, le registre des objets trouvés passe par in_stock (en stock) → matched (correspondance trouvée) → claimed (retiré) ; les remises des passagers passent par pending (en attente de remise) → confirmed_at_desk (arrivé au service client) → matched (propriétaire trouvé) → closed (clôturé). Toutes les actions de remise nécessitent une double confirmation et la vérification du code de retrait à 6 chiffres, afin d'éviter les retraits frauduleux. Les données sont enregistrées dans le localStorage du navigateur (clé jlb_staff_lostfound_demo_v1) et ne sont pas perdues lors du rafraîchissement ; le bouton « Réinitialiser les données de démonstration » en haut à droite de la page permet de restaurer les exemples initiaux (comprenant 4 tickets LF, 2 entrées de registre, 2 remises HD). Le projet est isolé du système de production réel et sert uniquement à la démonstration des processus et à la formation. Lors de l'intégration ultérieure en production, il suffira de remplacer les opérations sur les données par des appels à l'interface back-end unifiée, en partageant avec le côté usagers le même ensemble d'API lost-reports / lost-handovers / lost-items : les listes en attente de correspondance, du registre et des remises utilisent GET ; la saisie des objets, la confirmation de remise et la liaison manuelle utilisent POST ; l'exclusion de correspondance et la validation de retrait utilisent POST .../reject et POST .../release (avec code de retrait). Remarque sur le périmètre : ce dépôt contient uniquement le poste de travail de traitement des agents de police, sans l'interface de dialogue vocal/déclaration côté usagers ; cette dernière se trouve dans un autre dépôt, jinglaibang-h5.