professional-work
농산물 이커머스 — 운영 업무와 화면 권한
농산물 이커머스 이전을 위한 어드민의 초기 기반을 만들고, 재투입 후 발주, 외부 주문 매칭, 권한 제어를 맡았습니다. 반복되는 목록 UI와 업무별 규칙을 구분하고, 권한이 준비된 뒤 허용된 조작만 열도록 구성했습니다.
운영 화면의 기반을 만들고, 다시 업무 속으로
농산물 이커머스 어드민은 기존 판매 사이트를 이전하기 위해 개발한 운영 도구입니다. 저는 React/Vite 프로젝트와 라우터, 공통 UI의 초기 기반을 만들었습니다. 이후 대학 프로젝트에 투입되는 비중이 커졌다가 다시 돌아와 발주, 외부 주문의 상품과 옵션 매칭, 연결 클레임과 화면 권한 제어를 맡았습니다.
복귀 후 만난 문제는 초기 화면을 만드는 일과 달랐습니다. 외부 채널에서 들어온 주문을 내부 상품에 연결해야 했고, 발주와 클레임마다 확인하고 바꿀 상태도 달랐습니다. 비슷하게 생긴 표를 만드는 것과 각 업무의 규칙을 정확히 옮기는 일을 함께 해야 했습니다.
발주요청 목록에는 페이지네이션 테이블을 적용하고, 발주서 Excel 연결 양식과 다운로드 흐름을 만들었습니다. 상품과 옵션 매칭과 연결 클레임의 상태와 메모도 내부 운영 화면에서 다룰 수 있도록 연결했습니다.
권한이 준비되기 전의 화면도 생각하기
같은 화면을 보더라도 모든 사용자가 같은 조작을 할 수는 없습니다. 저는 기존 권한 API를 이용해 버튼과 화면 진입을 제어했습니다. 권한 정보를 아직 읽는 중인 상태와 실제로 허용된 상태를 구분하고, 정보가 준비된 뒤 명시적인 허용을 확인해야 조작할 수 있도록 했습니다. 주소를 직접 입력해 들어오는 경우에도 화면 진입을 제어했습니다.
이후 전역에 모여 있던 권한 매핑을 업무 도메인의 정책과 훅으로 정리했습니다. 반복되는 화면 요소는 함께 쓰면서도, 각 업무에서 무엇을 허용하는지는 구분해 읽을 수 있도록 바꾼 것입니다. 화면의 조작 제어는 서버의 인가를 보완하는 역할입니다.
여러 관리 화면에 공통 목록과 권한 제어를 적용하면서, 초기 기반 위에 실제 발주, 매칭 업무를 연결했습니다. 팀이 개발하는 어드민 안에서 제가 맡은 결과는 이 업무 화면과 프론트엔드 제어였습니다.
공통 UI와 업무 규칙 사이
업무 흐름을 연결하는 동안 API도 계속 바뀌었습니다. OpenAPI 수집과 diff, 참조 클라이언트 생성을 자동화하고, 바뀐 응답 구조와 요청 필드를 DTO와 Valibot 스키마에 반영했습니다. ID와 날짜, nullable 값, 페이지와 커서 방식의 차이를 정리해 화면에서 데이터를 해석하는 기준을 맞췄습니다.
발주 처리는 API 호출 한 번으로 끝나지 않았습니다. 발주보류, 발주서 생성, 메일 발송과 Excel 다운로드에 확인 모달과 오류 처리를 연결하고, 처리 뒤 목록을 갱신했습니다. 양식 관리에서는 정렬과 항목 선택, 불러오기와 중복 이름 오류도 다뤘습니다. 반복 목록과 선택 상태는 공통으로 쓰되, 운영자가 지금 어떤 처리를 확정하는지는 각 업무 안에서 분명하게 보여주려 했습니다.
개인 프로젝트인 Archon Admin에서는 직접 만든 테이블과 드롭다운이 복잡해지고 인가도 미완성으로 남았습니다. 지금 두 작업을 함께 읽으면 공통으로 만들 수 있는 화면과 업무별로 남겨야 하는 정책의 경계가 눈에 들어옵니다. 코드가 직접 이어졌다는 설명보다는, 다른 상황에서 되풀이해 마주한 질문에 가깝습니다.