← 포트폴리오 목록
카드단말기 통합관리 어드민
본 프로젝트의 요구사항인 계층형 조직 권한관리, 제품(모델/시리얼/펌웨어) 관리, 가맹점 리더기 통신설정 배포, Pay Vcat 연동 Download API를 기반으로 직접 구현한 프로젝트입니다.
계층형 RBAC 권한 모델 설계본사/대리점/Agent 3단계 조직과 PAGE 단위 접근 권한을 매핑하는 역할 기반 접근 제어 구조를 설계합니다
제품 시리얼·펌웨어 이력 관리 체계 구축모델-시리얼-펌웨어 3단계 관계와 A/S 출고·입고 이력을 추적하는 테이블 구조를 설계합니다
리더기 통신설정 배포 큐 설계가맹점별 리더기 통신 설정값을 일괄 등록·배포하는 큐 기반 처리 구조를 구현합니다
Overview
프로젝트 개요
본 프로젝트의 요구사항인 계층형 조직 권한관리, 제품(모델/시리얼/펌웨어) 관리, 가맹점 리더기 통신설정 배포, Pay Vcat 연동 Download API를 기반으로 직접 구현한 프로젝트입니다.
요구사항 정의
프로젝트 핵심 과제
프로젝트 진행 시 해결한 핵심 기술 과제입니다.
본사/대리점/Agent 계층별로 상이한 페이지 접근 권한을 세밀하게 제어하는 RBAC 로직 설계가 필요합니다
모델-시리얼-펌웨어 간 다대다 관계와 이력 변경을 정합성 있게 추적하는 DB 구조 설계가 필요합니다
가맹점별 리더기 통신설정 값을 대량으로 등록·배포할 때 부분 실패 없이 원자적으로 처리하는 로직이 필요합니다
Pay Vcat Download API가 외부 단말기 제어 프로그램과 안정적으로 통신하
프로토콜 규격을 명확히 설계해야 합니다
구현 내용
핵심 기능 상세
핵심 기능 1
계층형 조직 권한관리
본사/대리점/Agent 3단계 조직과 사용자 계정을 등록하고, 계층별로 접근 가능한 메뉴(PAGE)를 세밀하게 제어합니다
핵심 기능 2
제품 시리얼·펌웨어 관리
제조사/모델을 등록하고, 모델별 시리얼번호를 직접입력·엑셀업로드·자동등록으로 관리하며 펌웨어 이력을 추적합니다
핵심 기능 3
가맹점 리더기 통신설정 배포
가맹점 사업자정보를 등록하고, 리더기(TL3800R)의 VAN사·CAT ID·포트/속도 등 통신 설정값을 등록해 일괄 배포합니다
핵심 기능 4
Pay Vcat 연동 Download API
카드단말기 제어 프로그램이 펌웨어 파일과 통신 설정값을 내려받을 수 있는 Download API 2종을 제공하고 호출 이력을 관리합니다
구현 과정
프로젝트 진행 단계
STEP 1
조직 계층 구조 및 RBAC 설계
본사/대리점/Agent 3단계 조직 계층과 PAGE 기반 접근 제어 모델을 설계하고 PostgreSQL 스키마를 정의합니다
STEP 2
제품·시리얼·펌웨어 관리 API 개발
Express 기반 모델/시리얼/펌웨어 CRUD API와 엑셀 업로드 파서를 구현합니다
STEP 3
가맹점·리더기 통신설정 배포 기능 구현
가맹점별 리더기(TL3800R) 통신 설정값 등록과 일괄 배포 트랜잭션 큐를 설계합니다
STEP 4
Pay Vcat Download API 및 프로토콜 문서화
펌웨어·설정값 Download API 2종을 구현하고 서버-단말기 통신 프로토콜 문서를 작성합니다
STEP 5
통합 테스트 및 권한 검증
역할별 접근 시나리오를 테스트하고 API-프론트엔드 통합 검증을 진행합니다
프로젝트 성과
주요 성과
계층형 RBAC 권한 모델 설계본사/대리점/Agent 3단계 조직과 PAGE 단위 접근 권한을 매핑하는 역할 기반 접근 제어 구조를 설계합니다
제품 시리얼·펌웨어 이력 관리 체계 구축모델-시리얼-펌웨어 3단계 관계와 A/S 출고·입고 이력을 추적하는 테이블 구조를 설계합니다
리더기 통신설정 배포 큐 설계가맹점별 리더기 통신 설정값을 일괄 등록·배포하는 큐 기반 처리 구조를 구현합니다
Pay Vcat Download API 프로토콜 설계펌웨어·설정값 다운로드 API 2종의 요청/응답 프로토콜을 설계하고 문서화합니다
Review
기술적 주안점
- PAGE 단위 권한 매핑과 라우트 가드를 결합한 3단계 RBAC 구조를 구현하여 계층별 화면 노출 범위를 세밀하게 제어합니다
- 엑셀 업로드·직접입력·자동등록 3가지 시리얼 등록 경로를 하나의 검증 파이프라인으로 통합해 데이터 정합성을 유지합니다
- 가맹점별 리더기 통신설정을 등록부터 배포까지 하나의 흐름으로 처리하며, 배포 실패 시 롤백되는 트랜잭션 구조를 설계합니다
