프랜차이즈 POS 판매 데이터 통합 수집 관리

전체 매장의 일·주·월 매출과 시간대별·메뉴별·판매채널별 판매량을 한 화면에서 비교하고, 상단 상태바로 Agent 수집 상태를 함께 확인합니다.

• Prisma 집계 쿼리와 PostgreSQL 인덱스로 매장·일자·시간대 단위 판매 집계를 조회
• 필터 상태를 URL 쿼리와 동기화하여 조회 조건을 링크로 공유
• SVG 기반 시간대 히트맵과 매장 비교 막대 차트를 직접 구현

브랜드·매장·기간 필터를 하나의 집계 API로 묶고 슬림 상태바에 수집 현황을 함께 노출해, 매출과 데이터 신뢰 상태를 한 화면에서 판단하는 구조를 구현합니다.

판매현황에서 매장을 선택하면 해당 매장의 주문 목록이 열리고, 주문별 메뉴·결제정보·취소 이력을 상세 패널에서 확인합니다. 마스터-디테일 목록, 결제수단 분할 표시, 취소·수정 이력 타임라인을 구현합니다.

• 커서 기반 페이지네이션과 가상 스크롤로 대량 주문 목록을 렌더링
• 주문 헤더·품목·결제 테이블을 조인한 상세 API와 결제수단 분할 표시 컴포넌트
• 변경 이력 테이블을 시간순 타임라인으로 매핑하여 취소·금액수정 내역을 표시

주문 원천 데이터와 변경 이력을 함께 조회하는 상세 구조를 설계하여, 취소·환불·결제수단 변경이 반영된 최신 상태와 이전 값을 나란히 확인하는 화면을 구현합니다.

매장별 Agent의 설치 여부, 연결 상태, 마지막 수집 시각, 버전, 에러 로그를 목록과 상세 패널로 확인하고 배포 대상 버전을 지정합니다.

• Agent 하트비트 수신 API와 마지막 수신 시각 기준의 연결 상태 판정 로직
• Windows Service 자동 시작과 재부팅 후 수집 재개 상태를 상태 이력으로 기록
• 버전별 배포 대상 매장을 지정하는 배포 관리 화면과 자동 업데이트 상태 표시

설치·연결·수집·버전 상태를 매장 단위로 하나의 상태 모델에 모아, 이상 Agent를 우선 대응 큐로 올리는 관제 구조를 구현합니다.

매장·영업일별로 POS 원천 매출과 중앙 집계 금액을 비교하여 차이를 표시하고, 차이가 있는 건은 재수집을 요청하며 진행 상태를 확인합니다.

• 영업일 단위 대사 배치와 매장별 원천 합계 대비 집계 합계 차이 계산
• 차이 발생 건의 재수집 요청을 큐에 적재하고 Agent 응답 상태를 단계별로 추적
• 대사 결과와 재수집 결과를 알림 화면에 기록하고 상태별로 필터링

원천 매출과 중앙 집계의 차이를 영업일 단위로 대사하고 재수집 요청까지 이어지는 흐름을 구현하여, 데이터 정확성 검증이 관리 화면 안에서 완결되는 구조를 설계합니다.