このプロジェクトについて

これは、地下鉄警察便民サービス「警来帮」の警察官・カスタマーサービス対応端末向けデモプロジェクトであり、利用者向け音声紛失物発見大画面と連携して使用します。プロジェクトは純粋なフロントエンド単一ファイル(HTML + ネイティブJavaScript + localStorage)で実装されており、staff-lostfound-demo.html をダブルクリックするだけでブラウザで開くことができ、依存関係のインストールやバックエンドサービスは不要です。 機能は業務フローに従って上から下へ5つのエリアに分かれています: 0. 未登録・紛失問合せ:利用者が音声大画面で問い合わせた後に収集された情報は一旦キューに入り、正式な作業指示は直接生成されません。警察官が詳細を確認した後、「登録・建档」をクリックして正式なLF作業指示を生成し、マッチング待ちに移行します。情報が不完全な場合は「差戻し」で利用者に補足を通知でき、利用者のセルフサービス発行に警察官による確認ステップを追加し、誤報告を防ぎます。 1. マッチング待ち・追跡コード(LF):正式なLF作業指示がマッチング待ちのキューに並びます。行をクリックすると、物品タイプ、色、路線、駅が自動的に登録フォームに反映されます。 2. 拾得物登録:警察官が実際に拾得した物品を台帳に登録します。提出後、「物品タイプ + 色/駅」に基づいて自動的にマッチング待ちのLF作業指示と逆マッチングし、ヒットした場合は6桁の受け取りコードを生成します。必須項目は物品タイプと駅のみ(駅はキーワード検索で選択し、駅ディレクトリから取得して誤入力を防止)、色、路線、拾得時間、時間帯、拾得場所の詳細、説明、保管者、写真はすべて任意入力です。拾得場所の詳細は独立して登録され、例えば「3番出口の改札機横」「2号車両中央座席下」など。駅を選択すると自動的に路線が表示され、「駅 + 警察官室」のルールに従って自動的に落とし主の受取場所が決定されます。実物写真はアップロードを推奨し、画像認識によるマッチングに使用します。 3. 紛失物台帳:全件/在庫/ヒット済/受取済みでフィルタリング可能。受け取りコードによる消込・発行、再確認理由の記入によるマッチング除外、実物写真と乗客の受取フィードバックの確認が可能です。 4. 引渡確認待ち(HD):乗客が拾得後、大画面で登録し物品をカスタマーセンターに持ち込みます。警察官が引渡コードを確認後、自動的に台帳に登録されます。自動マッチングされない場合は手動でLF追跡コードをバインドでき、詳細には完全な進捗タイムラインが含まれます。 ステータス遷移について、紛失物台帳は in_stock(在庫)→ matched(ヒット済)→ claimed(受取済み)を経ます。乗客引渡書は pending(引渡待ち)→ confirmed_at_desk(カスタマーセンター到着)→ matched(落とし主発見)→ closed(完了)を経ます。すべての発行動作は、なりすまし受取を防止するため、6桁の受け取りコードによる確認と二次確認が必要です。 データはブラウザのlocalStorage(キー名 jlb_staff_lostfound_demo_v1)に保存され、リフレッシュしても失われません。ページ右上の「デモデータをリセット」で初期サンプル(4件のLF、2件の台帳、2件のHDを含む)を復元できます。プロジェクトは実際の本番システムから分離されており、フローのデモとトレーニングのみを目的としています。 本番環境に接続する際は、各データ操作をバックエンドの統一インターフェース呼び出しに置き換えるだけで、利用者側と同一の lost-reports / lost-handovers / lost-items API を共有します。マッチング待ちリスト、台帳リスト、引渡リストはGETを使用。実物登録、引渡確認、手動バインドはPOSTを使用。マッチング除外、受け取り消込は POST .../reject と POST .../release(受け取りコード付き)を使用します。 境界説明:このリポジトリには警察官対応ワークステーションのみが含まれており、利用者側の音声対話・通報インターフェースは含まれていません。後者は別のリポジトリ jinglaibang-h5 を参照してください。