SYSTEM BLUEPRINT

단말기 통합 운영 서버
화면 설계 및 시나리오

조직, 제품, 가맹점, 펌웨어 배포, 다운로드 이력을 운영자가 실제로 다루는 흐름으로 설계했습니다.

본사 관리자 시나리오

본사 운영 통제 흐름

본사가 조직, 사용자, 권한, 전체 배포 상태를 통제하는 기본 흐름입니다.

1. 로그인

권한별 초기 화면 진입

2. 조직 확인

본사, 대리점, Agent 구조 확인

3. 사용자 권한

메뉴와 기능 권한 배정

4. 감사 로그

관리 작업 이력 추적

5. 운영 확인

배포와 장비 상태 요약

본사 관리자 | 화면 01

통합 운영 대시보드

idcenter.ops.local/admin/dashboard
통합 운영 대시보드
본사 기준 장비, 배포, 다운로드 상태
운영 정상
등록 장비
TL3800R 1,248대
Pay Vcat
842개 설치
오늘 다운로드
성공 318건
실패 추적
재시도 7건
배포 현황
대상버전상태
A 대리점1.1.0대기
B Agent1.1.0진행
C 가맹점1.0.1완료
최근 감사 로그
PACKAGE_UPLOAD
DEPLOY_START
DEVICE_DOWNLOAD
SETTING_SYNC

[화면 개요 및 목적]

본사 관리자가 장비 수, 배포 성공률, 실패 장비, 최근 감사 로그를 한눈에 보는 시작 화면입니다.

[핵심 기능 로직]

장비, 다운로드 이력, 업데이트 이력, 감사 로그를 집계해 운영 상태를 요약합니다.

  • PostgreSQL 집계 뷰
  • 권한별 대시보드 필터
본사 관리자 | 화면 02

조직 및 사용자 권한 관리

idcenter.ops.local/admin/orgs
조직과 권한 관리
조직 트리
본사
ㄴ A 대리점
ㄴ B Agent
ㄴ 가맹점
역할 권한
역할가능 메뉴배포
본사 총괄전체가능
대리점 관리자소속 장비요청
가맹점 사용자설정 조회불가

[화면 개요 및 목적]

본사, 대리점, Agent, 가맹점 계층과 사용자 역할을 같이 관리하는 화면입니다.

[핵심 기능 로직]

Organization, User, Role, Permission, Menu 데이터를 연결해 메뉴와 기능 접근을 제한합니다.

  • RBAC 권한 모델
  • 조직 경로 기반 데이터 필터
본사 관리자 | 화면 03

관리자 감사 로그

감사 로그와 실패 추적
시간작업결과
09:10PACKAGE_UPLOAD완료
09:12DEPLOY_START진행
09:13TL3800R-0002다운로드 실패
09:15RETRY_POLICY재시도 예약
실패 장비는 재시도 대상에 자동 분류하고 운영자가 원인을 추적할 수 있게 남깁니다.

[화면 개요 및 목적]

펌웨어 업로드, 설정 수정, 권한 변경 같은 위험 작업을 추적하는 화면입니다.

[핵심 기능 로직]

관리자 작업은 ActionType, TargetType, TargetId, ClientIP로 저장해 사후 추적에 사용합니다.

  • AuditLog 테이블
  • 관리자 작업 미들웨어
제품 운영 담당자 시나리오

제품과 펌웨어 배포 흐름

모델과 시리얼을 등록하고 펌웨어 파일을 배포하는 운영 흐름입니다.

1. 모델 등록

제조사와 모델 정보 등록

2. 시리얼 업로드

장비번호 대량 등록

3. 파일 등록

버전 파일과 해시 저장

4. 배포 실행

대상 장비 산정

5. 결과 확인

성공과 실패 이력 확인

제품 운영 담당자 | 화면 01

제품과 시리얼 관리

idcenter.ops.local/admin/devices
펌웨어 배포 센터
배포 파일
TL3800R_FW_1.1.0.bin
SHA256 검증 완료
대상 조건
모델 TL3800R
현재 버전 1.0.0 이하
배포 진행률72%
장비번호현재 버전결과
TL3800R-00011.0.0SUCCESS
TL3800R-00021.0.0RETRY
TL3800R-01011.0.1WAIT

[화면 개요 및 목적]

TL3800R과 PAYVCAT 장비를 제품별로 등록하고 현재 버전과 소속 조직을 관리합니다.

[핵심 기능 로직]

Device, Product, Organization 데이터를 연결해 장비별 배포 대상을 산정합니다.

  • 엑셀 업로드 검증
  • 장비 상태 필터
제품 운영 담당자 | 화면 02

펌웨어 파일 등록

idcenter.ops.local/admin/packages
펌웨어 배포 센터
배포 파일
TL3800R_FW_1.1.0.bin
SHA256 검증 완료
대상 조건
모델 TL3800R
현재 버전 1.0.0 이하
배포 진행률72%
장비번호현재 버전결과
TL3800R-00011.0.0SUCCESS
TL3800R-00021.0.0RETRY
TL3800R-01011.0.1WAIT

[화면 개요 및 목적]

버전명, 파일명, 파일 크기, SHA256, 릴리즈 노트를 함께 등록하는 화면입니다.

[핵심 기능 로직]

UpdatePackage와 ProductCurrentVersion을 분리해 파일 이력과 현재 운영 버전을 안정적으로 관리합니다.

  • 파일 해시 검증
  • 버전 충돌 방지
제품 운영 담당자 | 화면 03

Download API 결과 조회

idcenter.ops.local/admin/downloads
Download API 흐름
POST /api/device/version-check
deviceNo: TL3800R-0001, currentVersion: 1.0.0
server: updateRequired true, version 1.1.0
GET /api/download/package/12
report: SUCCESS, hash matched, log saved

[화면 개요 및 목적]

장비가 어떤 버전을 요청했고 어떤 파일을 받았는지 결과를 추적합니다.

[핵심 기능 로직]

다운로드 요청과 완료 시간을 남겨 실패 장비를 재시도 대상으로 분류합니다.

  • Data Aggregation & Visualization
  • DownloadHistory 및 ResultCode
가맹점 운영 담당자 시나리오

가맹점 리더기 설정 배포 흐름

가맹점별 VAN 설정과 포트 설정을 등록하고 장비에 내려주는 흐름입니다.

1. 가맹점 등록

사업자와 매장 정보 입력

2. 리더기 매핑

TL3800R 장비 연결

3. 통신값 입력

VAN, CAT ID, 포트 설정

4. 설정 배포

Download API로 설정 동기화

5. 이력 조회

설정 변경과 적용 결과 확인

가맹점 운영 담당자 | 화면 01

가맹점 조회와 등록

idcenter.ops.local/admin/merchants
가맹점 리더기 설정
가맹점
사업자번호 123-45-67890
매장명 강남 테스트 매장
리더기
TL3800R
CAT ID CAT-2408-001
VAN사
KICC
리더기 포트
COM3 / 9600
서명패드
COM5 / 115200
배포 상태
대기 중
Download API 요청 시 이 설정값을 장비별로 내려주고 결과를 이력에 남깁니다.

[화면 개요 및 목적]

사업자번호, 매장명, 담당자, 연락처, 상태를 관리하고 장비 설정 화면으로 연결합니다.

[핵심 기능 로직]

가맹점 정보와 장비 시리얼을 연결해 설정 배포 대상을 명확히 합니다.

  • 가맹점 검색 필터
  • 사업자번호 중복 검증
가맹점 운영 담당자 | 화면 02

리더기 통신 설정

idcenter.ops.local/admin/reader-settings
가맹점 리더기 설정
가맹점
사업자번호 123-45-67890
매장명 강남 테스트 매장
리더기
TL3800R
CAT ID CAT-2408-001
VAN사
KICC
리더기 포트
COM3 / 9600
서명패드
COM5 / 115200
배포 상태
대기 중
Download API 요청 시 이 설정값을 장비별로 내려주고 결과를 이력에 남깁니다.

[화면 개요 및 목적]

VAN사, CAT ID, 리더기 포트, 서명패드 포트를 가맹점별로 저장하는 화면입니다.

[핵심 기능 로직]

설정값은 가맹점과 장비 기준으로 버전 관리하고 요청 시 내려줍니다.

  • 설정값 버전 관리
  • 장비별 설정 조회 API
가맹점 운영 담당자 | 화면 03

설정 배포 결과

idcenter.ops.local/admin/setting-history
감사 로그와 실패 추적
시간작업결과
09:10PACKAGE_UPLOAD완료
09:12DEPLOY_START진행
09:13TL3800R-0002다운로드 실패
09:15RETRY_POLICY재시도 예약
실패 장비는 재시도 대상에 자동 분류하고 운영자가 원인을 추적할 수 있게 남깁니다.

[화면 개요 및 목적]

어떤 가맹점 설정이 언제 배포됐고 장비가 정상 수신했는지 확인합니다.

[핵심 기능 로직]

설정 변경 내역과 장비 결과 보고를 묶어 장애 원인 분석에 사용합니다.

  • 설정 변경 감사 로그
  • Issue Tracking & Status Management