← 포트폴리오 목록

공정거래 정책 포털 관리 콘솔

MVP 이후 확장으로 회원 등급, 메뉴별 다중 관리자 권한, 게시물 예약, 주문·환불·결제 실패 기록, 결제 진단 로그, 구독 기간, 이관 검증 현황, 메뉴 순서를 관리하는 콘솔을 구현합니다.

프로젝트 납품 요약

아래 프로젝트 개요와 핵심 기능에서 구현 화면을 확인할 수 있습니다.

서비스 타입Web
업종플랫폼
기술 스택
React 18TypeScriptTailwind CSSNode.js + ExpressPostgreSQLPrismaRedisBull Queue
주요 기능
  • 운영 현황·결제 진단
  • 주문·환불
  • 회원·권한
  • 게시 예약·이관 검증

프로젝트 개요

범위: 개발, 디자인, 기획

MVP 이후 확장으로 회원 등급, 메뉴별 다중 관리자 권한, 게시물 예약, 주문·환불·결제 실패 기록, 결제 진단 로그, 구독 기간, 이관 검증 현황, 메뉴 순서를 관리하는 콘솔을 구현합니다. 전산 인력이 없는 담당자도 결제 문제를 화면에서 추적할 수 있도록 진단 로그를 중심에 둡니다.

작업 범위

  • 운영 현황·결제 진단: 대시보드에서 오늘 접수된 문의, 결제 실패·중단 건, 승인 결과와 주문 원장이 맞지 않는 건을 먼저 확인하고 진단 로그로 이동합니다
  • 주문·환불: 주문·배송·취소·환불 건을 상태별로 걸러 보고, 결제 실패 건에서 망취소 요청 결과를 확인합니다
  • 회원·권한: 회원 등급과 구독 열람 기간을 관리하고, 관리자 계정마다 메뉴별 권한을 부여합니다
  • 게시 예약·이관 검증: 게시물 예약 일시를 지정하고 메뉴 순서를 바꾸며, 기존 홈페이지 자료의 이관 검증 현황과 옛 주소 연결 상태를 확인합니다

주요 업무

  • 운영 현황·결제 진단 화면: 결제 요청·승인·확정 시점 로그를 주문과 대조해 불일치 건을 자동 분류하는 대사 목록과 상세 진단 대화상자를 구현합니다
  • 주문·환불 화면: 주문 상태 전이 규칙에 따라 가능한 처리만 버튼으로 열고, 환불과 취소는 확인 대화상자를 거쳐 기록을 남깁니다
  • 회원·권한 화면: 등급·구독 기간 변경은 이력으로 남기고, 관리자 역할을 바꾸면 화면의 메뉴와 버튼이 실제로 달라지도록 구현합니다
  • 게시 예약·이관 검증 화면: 예약 목록과 메뉴 순서 편집, 이관 항목별 대조 결과와 리다이렉트 규칙 표를 하나의 콘텐츠 관리 화면으로 구성합니다
공정거래 정책 포털 관리 콘솔
요구사항 정의

프로젝트 핵심 과제

프로젝트 진행 시 해결한 핵심 기술 과제입니다.

결제 승인 응답과 주문 원장이 어긋나는 원인을 화면에서 추적하려면 시점별 이벤트 기록 설계가 필요하며

요청·승인·확정 세 시점 로그를 기본으로 남겨 대응합니다

메뉴를 추가하거나 순서를 바꿔도 권한 매트릭스가 어긋나지 않

메뉴 식별자를 순서와 분리해 설계합니다

예약 게시가 서버 재시작과 겹쳐도 중복 게시되지 않

작업 잠금과 상태 확인 단계를 둘 계획입니다

기존 게시물·첨부·회원 자료를 대조할 기준 건수를 어떻게 잡을지 정하는 이관 검증표 설계가 필요하며

항목별 원본·이관 건수 차이를 노출해 대응합니다

구현 내용

핵심 기능 상세

핵심 기능 1

운영 현황·결제 진단

대시보드에서 오늘 접수된 문의, 결제 실패·중단 건, 승인 결과와 주문 원장이 맞지 않는 건을 먼저 확인하고 진단 로그로 이동합니다.

  • 승인 응답 로그와 주문 원장을 주문 번호로 대조하는 SQL 뷰로 불일치 유형(금액·중복·누락)을 분류
  • 시점별 결제 이벤트를 시간순으로 보여주는 타임라인 컴포넌트 구현
  • Bull Queue 재대조 작업으로 중단 건의 상태를 주기적으로 다시 확인하는 구조 설계

결제 문제를 추측이 아니라 시점별 기록으로 설명하는 진단 화면을 구성해 원인 규명에 필요한 단서를 기본 로그로 남깁니다.

운영 현황·결제 진단
운영 현황·결제 진단 실제 화면
핵심 기능 2

주문·환불

주문·배송·취소·환불 건을 상태별로 걸러 보고, 결제 실패 건에서 망취소 요청 결과를 확인합니다. 주문 상태 전이 규칙에 따라 가능한 처리만 버튼으로 열고, 환불과 취소는 확인 대화상자를 거쳐 기록을 남깁니다.

  • 허용 상태 전이 표를 서버와 화면이 함께 쓰는 주문 상태 머신 구현
  • 표준 결제 API의 취소 요청 결과를 주문별 이력으로 저장하는 구조 설계
  • 면세 상품 주문을 구분해 세금계산서 항목이 나타나지 않도록 하는 표시 규칙 적용

환불·취소·망취소 요청과 응답을 한 이력에 묶어 사후 확인이 가능한 감사 기록을 구성합니다.

주문·환불
주문·환불 실제 화면
핵심 기능 3

회원·권한

회원 등급과 구독 열람 기간을 관리하고, 관리자 계정마다 메뉴별 권한을 부여합니다. 등급·구독 기간 변경은 이력으로 남기고, 관리자 역할을 바꾸면 화면의 메뉴와 버튼이 실제로 달라지도록 구현합니다.

  • 메뉴×읽기·쓰기 권한 매트릭스 테이블과 서버 측 권한 검사 미들웨어 구현
  • 구독 시작·만료 일자를 결제 확정 이벤트에서 자동 부여하고 수동 연장은 사유와 함께 기록
  • 회원 목록 조건 검색과 엑셀 내려받기 작업 구현

메뉴별 권한이 버튼 노출과 API 응답에 같은 규칙으로 적용되어 권한 밖 화면은 접근 안내만 표시됩니다.

회원·권한
회원·권한 실제 화면
핵심 기능 4

게시 예약·이관 검증

게시물 예약 일시를 지정하고 메뉴 순서를 바꾸며, 기존 홈페이지 자료의 이관 검증 현황과 옛 주소 연결 상태를 확인합니다.

  • Cron 기반 예약 게시 작업이 지정 시각에 게시 상태를 바꾸는 스케줄러 구현
  • 드래그 정렬로 메뉴 순서를 바꾸고 순서 값을 일괄 저장하는 편집기 구성
  • 이관 전·후 건수와 첨부 파일 존재를 대조하는 검증 결과표와 옛 주소 리다이렉트 매핑 테이블 설계

이관 대상 항목마다 원본과 새 위치를 대조하고 옛 주소가 새 페이지로 이어지는지 목록에서 확인하는 검증 화면을 구현합니다.

게시 예약·이관 검증
게시 예약·이관 검증 실제 화면
구현 과정

프로젝트 진행 단계

STEP 1

권한 모델과 감사 기록 설계 · 2026.11

관리자 역할·메뉴 권한 매트릭스와 변경 이력 테이블을 설계하고 서버 검사 미들웨어를 구현합니다.

STEP 2

결제 대사와 진단 로그 구현 · 2026.11

결제 이벤트 기록과 주문 원장 대조 뷰, 재확인 작업 큐를 구현합니다.

STEP 3

주문·환불·구독 관리 화면 · 2026.11

주문 상태 전이, 환불·취소 이력, 구독 기간 부여와 연장 화면을 구현합니다.

STEP 4

예약 게시·메뉴 편집과 이관 검증 · 2026.11

예약 게시 스케줄러와 메뉴 순서 편집 화면을 구현합니다. 이관 전후 대조표와 옛 주소 매핑 확인 화면도 함께 구현합니다.

개발 결과

결제 이벤트 대사 뷰와 불일치 분류 구현요청·승인·확정 로그를 주문 번호로 대조하는 SQL 뷰를 만들고 금액·중복·누락 세 유형으로 분류합니다.
재확인 작업 큐 설계Bull Queue로 중단 결제 건의 상태를 다시 확인하는 작업과 재시도 규칙, 결과 기록 구조를 설계합니다.
메뉴별 읽기·쓰기 권한 매트릭스 구축역할×메뉴 권한 테이블과 서버 미들웨어를 구축해 화면 버튼과 API 응답에 같은 규칙을 적용합니다.
예약 게시 스케줄러 구현지정 시각에 게시 상태를 바꾸는 Cron 작업과 중복 실행 방지 잠금을 구현합니다.

기술적 주안점

  • 결제 문제를 추측이 아니라 시점별 기록으로 설명하는 진단 화면을 구성해 원인 규명에 필요한 단서를 기본 로그로 남깁니다
  • 환불·취소·망취소 요청과 응답을 한 이력에 묶어 사후 확인이 가능한 감사 기록을 구성합니다
  • 메뉴별 권한이 버튼 노출과 API 응답에 같은 규칙으로 적용되어 권한 밖 화면은 접근 안내만 표시됩니다

유사한 프로젝트를 기획하고 계신가요?

필요한 기능과 일정을 알려주시면 개발 범위를 함께 정리하겠습니다.

프로젝트 문의