웹 제품과 업무 시스템 소프트웨어 개발
구매 승인을 메신저로 받고 ERP에 다시 입력하는 조직에서는 화면보다 상태의 불일치가 먼저 문제를 만듭니다. 승인된 금액, 남은 예산, 발주 여부를 서로 다른 곳에서 관리하면 같은 요청이 두 번 처리되거나 변경된 견적에 예전 승인이 붙습니다. 이 페이지는 그 흐름을 하나의 거래 기록으로 묶는 설계를 다룹니다.

설계 시나리오: 직원 300명 제조기업의 구매 요청·승인 시스템
3개 사업장에서 구매 요청을 올리고 재무팀이 ERP에 발주 전표를 입력하는 업무를 대상으로 합니다. 규모와 시간은 설계 입력 및 검증 목표입니다.
- 조직·권한
- 직원 300명 / 사업장 3개 / 부서 12개
- 업무량
- 월 1,800건 / 마감일 동시 사용자 60명
- 승인 규칙
- 100만원 미만 부서장 / 이상 재무 검토 추가
- 연동 조건
- 기존 ERP 유지 / 단일 발주 참조번호 조회 가능
중복 입력보다 위험한 것은 서로 다른 승인 상태입니다
영업팀이 설비 부품 견적을 메신저로 전달하고, 부서장이 승인하면 구매 담당자가 스프레드시트를 갱신합니다. 재무팀은 그 표를 보고 ERP에 발주를 등록합니다. 그 사이 공급사가 단가를 바꾸면 견적 파일은 교체되지만 이미 받은 승인이 여전히 유효한지 기록이 남지 않습니다.
월말에는 같은 요청을 여러 담당자가 처리합니다. 한 사람은 메신저에서 승인됐다고 보고, 다른 사람은 ERP에 없다고 판단해 다시 입력합니다. 여기서 필요한 첫 기능은 대시보드가 아니라, 요청의 어느 버전을 누가 승인했으며 외부 발주가 어디까지 진행됐는지를 분리하는 일입니다.
| 업무 지점 | 현재 발생할 수 있는 문제 | 시스템에서 명시할 것 |
|---|---|---|
| 견적 수정 | 금액이 바뀌어도 과거 승인 재사용 | 요청 버전별 승인 / 수정 시 재승인 |
| 동시 승인 | 서로 다른 탭에서 중복 처리 | 버전 조건부 갱신 / 한 번만 상태 변경 |
| ERP 입력 | 응답 유실 뒤 재전송으로 중복 발주 | 외부 참조번호와 전송 상태 분리 |
| 예산 차감 | 승인 완료와 예산 집계의 시점 차이 | 동일 트랜잭션에서 예산 예약 |
월 1,800건은 저장량보다 예외 처리의 설계가 더 중요한 규모입니다. 처음부터 수십 개 서비스를 나누기보다 요청·승인·예산·감사 기록을 한 데이터베이스에서 관리하고, ERP 연동만 별도 작업자로 분리하는 쪽을 출발점으로 잡습니다.
승인과 발주를 하나의 완료 상태로 합치지 않습니다
화면의 ‘완료’가 무엇을 뜻하는지 먼저 정합니다. 승인 완료는 회사 내부의 구매 의사결정이 끝난 상태이고, 발주 완료는 ERP에서 전표 생성이 확인된 상태입니다. ERP가 잠시 멈춰도 승인이 취소되지는 않으며, 승인됐다고 발주가 성공한 것처럼 표시해서도 안 됩니다.
| 상태 | 허용 작업 | 다음 상태 / 조건 |
|---|---|---|
| 초안 | 작성자 수정·삭제·제출 | 제출: 필수 견적·비용 코드 검증 |
| 검토 중 | 승인자 승인·반려 / 작성자 회수 | 규칙 충족 시 승인 완료 |
| 최종 승인 처리 | 조건부 상태 변경·예산 예약·이벤트 저장 | 한 DB 트랜잭션으로 ERP 확인 대기 전환 |
| ERP 확인 대기 | 상태 조회·통제된 재시도 | 외부 참조번호 확인 시 발주 완료 |
| 발주 완료 | 조회 / 별도 취소 요청 | ERP 취소 확인 후 예산 해제 |
요청에는 request_id, version, status를 둡니다. 승인 기록은 요청 ID뿐 아니라 승인한 버전을 참조합니다. 금액·공급사·계좌 정보 같은 결제에 영향을 주는 필드가 바뀌면 기존 승인을 그대로 이어 쓰지 않고 새 버전으로 검토를 시작합니다.
재무 검토 기준은 이 시나리오의 업무 규칙입니다. 금액만 하드코딩하지 않고 비용 유형·사업장과 함께 버전이 있는 정책으로 저장합니다. 제출 시 적용한 정책 버전도 남겨, 정책 변경 전 요청에 어떤 규칙이 적용됐는지 재현할 수 있게 합니다.
거래는 DB에서 확정하고 외부 전송은 아웃박스로 분리합니다
구매 승인 API는 권한 확인, 요청 버전 검사, 예산 예약, 감사 기록, 전송 이벤트 기록을 한 DB 트랜잭션으로 묶습니다. 마지막 단계가 실패하면 중간 기록만 남지 않도록 전체를 되돌립니다. PostgreSQL의 트랜잭션은 이 DB 내부 원자성을 설명합니다. ERP의 HTTP 호출까지 같은 트랜잭션으로 묶어 주는 것은 아닙니다.
따라서 DB에 확정한 이벤트를 별도 작업자가 읽어 ERP로 보냅니다. 이 아웃박스 방식은 ‘승인은 저장됐지만 전송할 메시지는 사라진 상태’를 피하기 위한 경계입니다. AWS의 Transactional outbox 안내에서도 중복 전달 가능성과 수신 측 멱등 처리를 함께 다룹니다.
발주 이벤트 키는 purchase:{request_id}:{approved_version}처럼 승인 버전에서 결정합니다. ERP가 멱등 키를 지원하면 동일 키로 재시도합니다. 지원하지 않으면 내부 어댑터가 처리 중인 키를 잠그고, ERP의 외부 참조번호 조회 결과를 먼저 확인합니다. 조회도 확정할 수 없는 타임아웃은 자동 재발주하지 않고 ‘대조 필요’로 보냅니다. 외부 계약이 없는데 정확히 한 번 실행된다고 가정하지 않습니다.
- 승인 API
사용자·부서·요청 버전 검증
- DB 트랜잭션
상태·예산 예약·감사·outbox 저장
- 전송 작업자
확정 이벤트만 전달 / 실패 재시도
- ERP 어댑터
이벤트 키·외부 참조번호 대조
- 확인 반영
발주 완료 또는 대조 필요 표시
사용자가 볼 수 있는 버튼과 실행 권한은 다릅니다
버튼을 숨기는 것은 화면 정리일 뿐입니다. 서버는 조회·승인·첨부 다운로드 요청마다 조직, 부서, 요청의 소유 관계, 현재 상태를 확인합니다. 작성자는 자기 요청을 승인할 수 없고, 부서장은 권한을 위임받지 않은 부서의 요청을 읽을 수 없습니다. OWASP 권한 가이드의 기본 거부와 매 요청 권한 검증 원칙을 이 업무 객체에 적용합니다.
| 역할 | 볼 수 있는 범위 | 변경할 수 있는 것 |
|---|---|---|
| 요청자 | 자기 요청·첨부·진행 상태 | 초안 / 검토 중 회수 |
| 부서 승인자 | 할당된 부서의 제출 버전 | 승인·반려 사유 |
| 재무 담당자 | 정책상 재무 검토 대상 | 추가 승인 / 대조 업무 처리 |
| 운영 관리자 | 오류·전송 이력 | 재시도 예약 / 승인 금액 수정 불가 |
구매 금액은 원 단위 정수로 저장하고, 외부 입력을 부동소수점 합계로 처리하지 않습니다. 중복 방지 키에는 NOT NULL과 UNIQUE를 함께 둡니다. PostgreSQL의 고유 제약이 지키는 것은 저장된 값의 중복 제한입니다. 같은 키로 다른 본문을 보내면 기존 성공을 반환하기보다 충돌로 거절해 잘못된 재사용을 드러냅니다.
첨부 문서는 공개 URL 대신 짧은 유효기간의 다운로드 경로를 사용하고, 발급 직전 권한을 다시 확인합니다. 로그에는 요청 ID와 오류 유형을 남기되 견적 원문·계좌·접근 토큰은 기록하지 않습니다.
타임아웃·취소·중복 클릭을 먼저 시험합니다
정상 흐름이 한 번 끝나는 것보다, 응답을 받지 못한 사용자가 다시 눌렀을 때의 결과가 중요합니다. ‘저장 중’ 화면이 사라져도 요청이 사라지지 않도록 API 결과와 브라우저 상태를 연결합니다. 클라이언트가 같은 명령을 재전송하면 서버는 같은 키의 결과를 돌려줍니다.
| 주입할 상황 | 기대 동작 | 확인 기록 |
|---|---|---|
| 동일 승인 동시 20회 | 상태 변경 1회 / 예산 예약 1건 | 버전 충돌 수·승인 이벤트 수 |
| DB 커밋 직후 작업자 종료 | 재시작 후 outbox 전달 재개 | 미처리 이벤트·처리 시각 |
| ERP 성공 후 응답 유실 | 조회 대조 / 무조건 재발주 금지 | 외부 참조번호·대조 상태 |
| 승인 직후 작성자 취소 | 이미 시작된 발주는 별도 취소 흐름 | 취소 의도와 ERP 확정 결과 |
| 권한 없는 첨부 요청 | 403 / 파일 내용 노출 0건 | 거절 사유·접근 주체 |
작업 재시도에는 횟수뿐 아니라 시간 제한을 둡니다. 일시적인 연결 오류는 지수 백오프로 재시도하고, 잘못된 비용 코드 같은 데이터 오류는 담당자 수정 대기로 보냅니다. 같은 오류를 계속 재시도해 대기열을 채우지 않도록 실패 원인을 나눕니다.
출시 승인은 화면 수가 아니라 업무 불변식으로 결정합니다
개발 완료의 기준을 ‘승인 화면 구현’으로 두면 중요한 검증이 빠집니다. 어떤 재시도나 동시 요청에서도 같은 승인으로 예산이 두 번 예약되지 않는지, 승인 후 수정된 요청이 ERP로 전달되지 않는지를 검증 조건으로 적습니다.
| 항목 | 검증 조건 | 통과 기준 |
|---|---|---|
| 목록 조회 | 10만 건 데이터 / 동시 사용자 60명 | 서버 응답 p95 800ms 이하 |
| 승인 명령 | 중복·동시 실행 포함 / ERP 비동기 분리 | 내부 커밋 p95 1초 이하 / 중복 예약 0건 |
| 전송 적체 | ERP 30분 중단 후 복구 | 유실 0건 / 재처리 가능한 대조 목록 확보 |
| 권한 | 역할×부서×상태별 자동 시험 | 허용되지 않은 조회·변경 성공 0건 |
| 배포 복구 | 이전 앱 버전으로 되돌리기 | 스키마 호환 유지 / 승인 기록 손실 0건 |
측정에는 데이터 크기, 요청 비율, 장비와 네트워크 조건을 함께 저장합니다. DB 조회가 느린지 API에서 외부 요청을 기다리는지 구분해야 같은 문제를 서버 증설로만 해결하지 않게 됩니다.
한 부서의 병행 운영으로 전환 경계를 확인합니다
처음부터 세 사업장을 동시에 전환하지 않습니다. 읽기 전용 데이터 이전으로 원본 요청과 합계를 대조하고, 한 부서의 신규 요청만 새 시스템으로 받습니다. ERP 전표 생성은 기능 플래그로 꺼 둔 채 생성 예정 이벤트를 검토합니다. 그 다음 소액 요청부터 실제 연동을 엽니다.
- 데이터 대조: 요청 ID, 공급사, 금액, 상태별 건수와 합계를 기존 자료와 비교합니다.
- 읽기 전환: 조회 경로를 먼저 검증하고 변경은 기존 시스템으로 제한합니다.
- 부서 단위 쓰기 전환: 같은 요청을 두 시스템에서 수정하지 못하게 기준 시스템을 표시합니다.
- ERP 연동 개방: 발주 참조번호와 예산 예약을 건별 대조합니다.
- 범위 확대: 미처리·중복·권한 오류가 통과 기준 안에 있는지 확인한 뒤 다음 부서를 추가합니다.
되돌리기는 페이지 주소만 바꾸는 일이 아닙니다. 새 시스템에서 이미 발주한 요청은 기존 표에 다시 대기 건으로 넣지 않습니다. 전환 시각과 마지막 확정 ID를 기록하고 미확정 이벤트를 먼저 정리한 뒤 쓰기 경로를 바꿉니다.
결과물에는 운영자가 다음 결정을 할 수 있는 근거가 남습니다
납품물은 화면과 소스코드에 그치지 않습니다. 상태 전이표, 역할별 권한표, 데이터 모델, API 계약, ERP 이벤트 명세, 재시도 규칙, 배포·롤백 절차, 테스트 결과를 함께 정리합니다. 운영 화면에는 ‘실패’ 한 단어 대신 재시도 가능, 데이터 수정 필요, 외부 대조 필요를 나눠 보여 줍니다.
운영자는 요청 ID로 승인 버전부터 ERP 결과까지 추적할 수 있어야 합니다. 개발자가 데이터베이스에 직접 접속하지 않아도 오류의 원인과 다음 조치를 확인할 수 있게 만들면, 기능이 늘어날 때도 운영 경계가 유지됩니다.
처음 논의를 시작할 때는 현재 구매 요청서, 승인 규칙, ERP 연동 명세, 중복이나 누락이 생긴 경로를 보내 주세요. 개인정보와 거래처 비밀은 제거해도 됩니다. 무엇이 틀렸는지 설명할 수 있는 요청 한 건이 추상적인 화면 목록보다 빠르게 설계의 기준을 만듭니다.