Process Evidence · 04
유스케이스·계약·코드 검증으로 연결합니다
도메인 모델을 실제 API, DTO, 시퀀스 다이어그램, 서버 재검증 기준으로 고정했습니다.
미리보기, 주문, 결제 시작, 승인 확인, 콜백, 상태 조회 같은 유스케이스를 나누고 각 단계의 검증 조건을 문서화했습니다.
How I worked
실제 작업 방식
- 입력
사용자 시나리오, PG 반환·콜백 흐름, 프론트 필요 응답, 운영자가 확인해야 하는 상태를 한 흐름으로 놓고 검토했습니다.
- 확인 질문
각 API가 어떤 유스케이스를 끝내는지, 어떤 값은 힌트이고 어떤 값은 서버가 재계산해야 하는지, 어떤 상태가 수락 기준인지 나눴습니다.
- 산출
시퀀스 다이어그램, DTO, 엔드포인트 순서, 오류 응답, 미구현 범위, 서버 재검증 조건을 같은 문서 안에 남겼습니다.
구현 근거를 API 계약·레이어 연결·테스트·감사 결과로 나눠 확인
수집한 구현 자료는 “코드가 있다”가 아니라 요구 분석 결과가 컨트롤러, DTO, 서비스, 팩토리, 리포지토리, Worker, 테스트와 한 줄로 이어지는지 기준으로 정제했습니다.
- B2B 코드 연결
- 사원 인증 흐름과 기업·제휴처 인증, 카테고리 모듈은 행위자 요구가 컨트롤러, DTO, 서비스, 엔티티, 팩토리, 리포지토리, Swagger 문서, 테스트로 이어지는 샘플입니다.
- 검증된 한계
- 같은 B2B 샘플에서 빌드 통과와 런타임 계약 검증은 분리합니다. 필드 불일치, 가드 메타데이터 불일치, 동시 승인 안전성 부족은 성공 사례가 아니라 감사 결과로 표시합니다.
- 실서비스 코드
- 결제·구독 프로젝트에서는 장바구니 가격 견적, 주문 가격 스냅샷, Entitlement 팩토리·서비스, 구독 내부 확정 재시도 핸들러를 구현 근거로 연결했습니다.
- 대표 검증
- 보상 회계 프로젝트에서는 보상 파사드, 정산 배치, Accrual · Ledger · Wallet 서비스, 언어별 알림 전달 흐름을 실행 순서와 회귀 테스트 기준으로 확인했습니다.
인증·승인·반려 흐름을 API 계약과 테스트 단위로 연결
비공개 B2B 플랫폼에서 기업 인증 요청, 사원 인증 승인·반려, 제휴처 카테고리 승인 흐름을 컨트롤러, 서비스, 리포지토리, 팩토리, DTO, Swagger 문서와 테스트 단위로 연결하려 했습니다. 후속 코드 감사에서는 빌드 통과와 런타임 계약 검증을 분리해, 성공 주장 대신 검증 기준의 빈틈까지 남겼습니다.
다이어그램을 렌더링하는 중입니다.
실제 구현으로 이어진 위치
- 멀티 PG·구독 결제 시스템 · 최초 결제 유스케이스
단건 결제와 최초 구독 결제의 호출 순서, 프론트 사용 기준, 서버 재검증 조건을 시퀀스 다이어그램과 구현 기준으로 고정했습니다.
최초 구독 결제 유스케이스 보기 - 멀티 PG·구독 결제 시스템 · PG 라우팅 계약
PG별 콜백·반환·승인 응답을 어댑터에서 정규화하고, 핸들러와 프로세서가 결제수단·유스케이스별 진입 조건과 상태 전이를 고정하도록 나눴습니다.
PG 라우팅·핸들러 계약 보기 - 포인트 회계·보상 시스템 · 보상 Facade
게시글·댓글·가입·결제·추천 이벤트를 Facade에서 읽히는 실행 순서로 조립하고, 정책 계산·회계 기록·언어별 알림 후속 처리를 별도 서비스로 위임했습니다.
보상 Facade 구현 흐름 보기
- 입력
- actor별 화면 흐름과 승인/반려 정책을 API 요청, 응답, 권한 조건, 예외 케이스로 풀었습니다.
- 계약
- 컨트롤러와 DTO는 외부 계약을, 서비스는 유스케이스 실행 순서를, 팩토리와 리포지토리는 도메인 객체 생성과 저장 책임을 갖도록 나눴습니다.
- 검증
- Swagger 문서와 컨트롤러·서비스·팩토리 테스트가 같은 유스케이스 이름과 상태 전이를 검증하도록 맞췄습니다.
- 산출
- 요구사항이 API 엔드포인트 목록에서 끝나지 않고 시퀀스, DTO, 응답, 실패 조건, 테스트 단위까지 이어지게 했습니다.
- 주의
- 이 샘플은 분석 산출물이 코드 레이어로 연결되는 방식을 보여주되, 실제 DB 실행·권한 평가·동시 승인 안전성은 미검증 또는 결함 확인 상태로 표시합니다.
분석 산출물이 API 계약과 수락 기준으로 이어졌는지 확인 가능
결제·구독 유스케이스 문서에는 엔드포인트 순서, DTO, 응답 표시 기준, 에러 조건, 프론트가 믿어도 되는 값과 서버가 다시 확정해야 하는 값을 나눠 둔 근거가 있습니다.
실제 구현으로 이어진 위치
- 멀티 PG·구독 결제 시스템 · 정책 경계
갱신 실패, 플랜 변경, 해지, 접근 권한에서 구현된 상태 정책과 환불·proration처럼 분리해 둔 미구현 범위를 함께 확인할 수 있습니다.
정책·미구현 범위 보기
- 계약
- 주문 생성, 결제 시작, 승인 확인, 콜백, 상태 조회처럼 유스케이스별 엔드포인트와 응답 기준을 분리했습니다.
- 검증
- 같은 멱등키·다른 요청 내용, 권한 없음, PG 콜백 지연, 승인 확인 순서 역전 같은 실패 조건을 문서와 테스트 기준으로 남겼습니다.
- 한계
- 구독 환불과 일부 proration 정책처럼 최종 구현 범위에 들어가지 않은 항목은 미구현으로 별도 표시했습니다.