jinglaibang-staff

이것은 지하철 경무 편민 서비스 「경래방」의 경찰관/고객센터 처리 단말 데모 프로젝트로, 군중 단말 음성 분실물 찾기 대형 화면과 함께 사용됩니다. 프로젝트는 순수 프론트엔드 단일 파일 구현(HTML + 네이티브 JavaScript + localStorage)으로, staff-lostfound-demo.html을 더블클릭하면 브라우저에서 바로 열 수 있으며, 의존성 설치도 백엔드 서비스도 필요하지 않습니다. 기능은 업무 흐름에 따라 위에서 아래로 다섯 구역으로 나뉩니다: 0. 등록 대기·분실 문의: 군중이 음성 대형 화면에서 문의한 후 수집된 정보가 먼저 대기열에 들어가며, 곧바로 정식 작업 지시가 생성되지 않습니다. 경찰관이 상세 내용을 확인한 후 「등록建档」을 클릭하면 정식 LF 작업 지시가 생성되어 매칭 대기로 들어가고, 정보가 불충분하면 「반려」하여 군중에게 보충을 알릴 수 있습니다. 이는 군중 셀프 발급 외에 경찰관의 검증 절차를 추가하여 무분별한 신고를 방지하는 것과 같습니다. 1. 매칭 대기·추적 코드(LF): 정식 LF 건이 매칭을 기다리며 대기합니다. 특정 행을 클릭하면 물품 유형, 색상, 노선, 역이 자동으로 입력 양식에 채워집니다. 2. 습득 분실물 입력: 경찰관이 실제로 습득한 물품을 대장에 등록하고, 제출 후 「물품 유형 + 색상/역」에 따라 매칭 대기 중인 LF 건을 자동으로 역매칭하여, 적중 시 6자리 수령 코드를 생성합니다. 필수 항목은 물품 유형과 역뿐이며(역은 키워드 검색 선택으로, 역 목록에서 가져와 오타를 방지), 색상, 노선, 습득 시간, 시간대 시각, 습득 구체적 위치, 설명, 보관인, 사진은 모두 선택 사항입니다. 습득 구체적 위치는 독립적으로 등록되며, 예를 들어 「3번 출구 보안검색대 옆」「2호차 중앙 좌석 아래」와 같습니다. 역을 선택하면 노선이 자동으로 표시되고, 「역 + 경무실」 규칙에 따라 실소유자 수령 장소가 자동으로 결정됩니다. 실물 사진 업로드를 권장하며, 이미지로 이미지를 찾는 매칭에 사용됩니다. 3. 분실물 대장: 전체/보관 중/적중됨/수령 완료 필터링을 지원하며, 수령 코드로 정리 발급, 재검토 사유 작성으로 매칭 제외, 실물 사진 및 승객 수령 피드백 확인이 가능합니다. 4. 확인 대기 상납서(HD): 승객이 습득 후 대형 화면에 등록하고 물품을 가지고 고객센터에 오면, 경찰관이 상납 코드로 확인 후 자동으로 대장에 들어가며, 자동 매칭이 안 될 경우 LF 추적 코드를 수동으로 바인딩할 수 있고, 상세 내용에는 전체 진행 타임라인이 포함됩니다. 상태 흐름 측면에서 분실물 대장은 in_stock 보관 중 → matched 적중됨 → claimed 수령 완료를 거치고, 승객 상납서는 pending 전달 대기 → confirmed_at_desk 고객센터 도착 → matched 실소유자 발견 → closed 결안 완료를 거칩니다. 모든 발급 동작은 2차 확인과 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를 참조하십시오.