공정거래 정책 포털 관리 콘솔
MVP 이후 확장으로 회원 등급, 메뉴별 다중 관리자 권한, 게시물 예약, 주문·환불·결제 실패 기록, 결제 진단 로그, 구독 기간, 이관 검증 현황, 메뉴 순서를 관리하는 콘솔을 구현합니다.
프로젝트 개요
MVP 이후 확장으로 회원 등급, 메뉴별 다중 관리자 권한, 게시물 예약, 주문·환불·결제 실패 기록, 결제 진단 로그, 구독 기간, 이관 검증 현황, 메뉴 순서를 관리하는 콘솔을 구현합니다. 전산 인력이 없는 담당자도 결제 문제를 화면에서 추적할 수 있도록 진단 로그를 중심에 둡니다.
작업 범위
- 운영 현황·결제 진단: 대시보드에서 오늘 접수된 문의, 결제 실패·중단 건, 승인 결과와 주문 원장이 맞지 않는 건을 먼저 확인하고 진단 로그로 이동합니다
- 주문·환불: 주문·배송·취소·환불 건을 상태별로 걸러 보고, 결제 실패 건에서 망취소 요청 결과를 확인합니다
- 회원·권한: 회원 등급과 구독 열람 기간을 관리하고, 관리자 계정마다 메뉴별 권한을 부여합니다
- 게시 예약·이관 검증: 게시물 예약 일시를 지정하고 메뉴 순서를 바꾸며, 기존 홈페이지 자료의 이관 검증 현황과 옛 주소 연결 상태를 확인합니다
주요 업무
- 운영 현황·결제 진단 화면: 결제 요청·승인·확정 시점 로그를 주문과 대조해 불일치 건을 자동 분류하는 대사 목록과 상세 진단 대화상자를 구현합니다
- 주문·환불 화면: 주문 상태 전이 규칙에 따라 가능한 처리만 버튼으로 열고, 환불과 취소는 확인 대화상자를 거쳐 기록을 남깁니다
- 회원·권한 화면: 등급·구독 기간 변경은 이력으로 남기고, 관리자 역할을 바꾸면 화면의 메뉴와 버튼이 실제로 달라지도록 구현합니다
- 게시 예약·이관 검증 화면: 예약 목록과 메뉴 순서 편집, 이관 항목별 대조 결과와 리다이렉트 규칙 표를 하나의 콘텐츠 관리 화면으로 구성합니다




프로젝트 핵심 과제
결제 승인 응답과 주문 원장이 어긋나는 원인을 화면에서 추적하려면 시점별 이벤트 기록 설계가 필요하며
요청·승인·확정 세 시점 로그를 기본으로 남겨 대응합니다
메뉴를 추가하거나 순서를 바꿔도 권한 매트릭스가 어긋나지 않
메뉴 식별자를 순서와 분리해 설계합니다
예약 게시가 서버 재시작과 겹쳐도 중복 게시되지 않
작업 잠금과 상태 확인 단계를 둘 계획입니다
기존 게시물·첨부·회원 자료를 대조할 기준 건수를 어떻게 잡을지 정하는 이관 검증표 설계가 필요하며
항목별 원본·이관 건수 차이를 노출해 대응합니다
핵심 기능 상세
운영 현황·결제 진단
대시보드에서 오늘 접수된 문의, 결제 실패·중단 건, 승인 결과와 주문 원장이 맞지 않는 건을 먼저 확인하고 진단 로그로 이동합니다.
- 승인 응답 로그와 주문 원장을 주문 번호로 대조하는 SQL 뷰로 불일치 유형(금액·중복·누락)을 분류
- 시점별 결제 이벤트를 시간순으로 보여주는 타임라인 컴포넌트 구현
- Bull Queue 재대조 작업으로 중단 건의 상태를 주기적으로 다시 확인하는 구조 설계
결제 문제를 추측이 아니라 시점별 기록으로 설명하는 진단 화면을 구성해 원인 규명에 필요한 단서를 기본 로그로 남깁니다.


주문·환불
주문·배송·취소·환불 건을 상태별로 걸러 보고, 결제 실패 건에서 망취소 요청 결과를 확인합니다. 주문 상태 전이 규칙에 따라 가능한 처리만 버튼으로 열고, 환불과 취소는 확인 대화상자를 거쳐 기록을 남깁니다.
- 허용 상태 전이 표를 서버와 화면이 함께 쓰는 주문 상태 머신 구현
- 표준 결제 API의 취소 요청 결과를 주문별 이력으로 저장하는 구조 설계
- 면세 상품 주문을 구분해 세금계산서 항목이 나타나지 않도록 하는 표시 규칙 적용
환불·취소·망취소 요청과 응답을 한 이력에 묶어 사후 확인이 가능한 감사 기록을 구성합니다.


회원·권한
회원 등급과 구독 열람 기간을 관리하고, 관리자 계정마다 메뉴별 권한을 부여합니다. 등급·구독 기간 변경은 이력으로 남기고, 관리자 역할을 바꾸면 화면의 메뉴와 버튼이 실제로 달라지도록 구현합니다.
- 메뉴×읽기·쓰기 권한 매트릭스 테이블과 서버 측 권한 검사 미들웨어 구현
- 구독 시작·만료 일자를 결제 확정 이벤트에서 자동 부여하고 수동 연장은 사유와 함께 기록
- 회원 목록 조건 검색과 엑셀 내려받기 작업 구현
메뉴별 권한이 버튼 노출과 API 응답에 같은 규칙으로 적용되어 권한 밖 화면은 접근 안내만 표시됩니다.


게시 예약·이관 검증
게시물 예약 일시를 지정하고 메뉴 순서를 바꾸며, 기존 홈페이지 자료의 이관 검증 현황과 옛 주소 연결 상태를 확인합니다.
- Cron 기반 예약 게시 작업이 지정 시각에 게시 상태를 바꾸는 스케줄러 구현
- 드래그 정렬로 메뉴 순서를 바꾸고 순서 값을 일괄 저장하는 편집기 구성
- 이관 전·후 건수와 첨부 파일 존재를 대조하는 검증 결과표와 옛 주소 리다이렉트 매핑 테이블 설계
이관 대상 항목마다 원본과 새 위치를 대조하고 옛 주소가 새 페이지로 이어지는지 목록에서 확인하는 검증 화면을 구현합니다.


프로젝트 진행 단계
권한 모델과 감사 기록 설계 · 2026.11
관리자 역할·메뉴 권한 매트릭스와 변경 이력 테이블을 설계하고 서버 검사 미들웨어를 구현합니다.
결제 대사와 진단 로그 구현 · 2026.11
결제 이벤트 기록과 주문 원장 대조 뷰, 재확인 작업 큐를 구현합니다.
주문·환불·구독 관리 화면 · 2026.11
주문 상태 전이, 환불·취소 이력, 구독 기간 부여와 연장 화면을 구현합니다.
예약 게시·메뉴 편집과 이관 검증 · 2026.11
예약 게시 스케줄러와 메뉴 순서 편집 화면을 구현합니다. 이관 전후 대조표와 옛 주소 매핑 확인 화면도 함께 구현합니다.
개발 결과
기술적 주안점
- 결제 문제를 추측이 아니라 시점별 기록으로 설명하는 진단 화면을 구성해 원인 규명에 필요한 단서를 기본 로그로 남깁니다
- 환불·취소·망취소 요청과 응답을 한 이력에 묶어 사후 확인이 가능한 감사 기록을 구성합니다
- 메뉴별 권한이 버튼 노출과 API 응답에 같은 규칙으로 적용되어 권한 밖 화면은 접근 안내만 표시됩니다