결제 코드 리뷰은(는) 무엇을 하나요?
결제 코드에서 실제 돈이 드는 버그를 찾고, 각각을 금전적 관점에서 설명합니다: 누가 두 번 청구되는지, 어떤 확정(booking)이 손실되는지, 누가 자신의 이체를 승인할 수 있는지.
워크플로
-
범위를 지정합니다. 돈을 생성, 이동, 승인, 확정 또는 조정하는 코드를 찾습니다: 컨트롤러, 서비스, 리스너, 엔티티, 마이그레이션. 스택(Spring Boot, Kafka, JPA, Kotlin)을 기록합니다.
-
이 스킬의 폴더에서 스캐너를 실행합니다. 프로젝트 또는 변경된 파일을 대상으로 합니다:
python scripts/scan.py <path-to-code> # 마크다운 테이블 python scripts/scan.py <path-to-code> --format json # 추가 처리를 위해Python 3.10+만 필요하며 다른 것은 필요하지 않습니다.
--include-tests를 전달하지 않으면 테스트 소스를 건너뜁니다. 휴리스틱을 사용하여 소스 텍스트를 읽으므로 출력은 리드(leads) 목록입니다. -
코드를 읽어 모든 발견 항목을 확인합니다. 각 리드에 대해 파일을 열고 다음을 확인합니다:
double타입의amount가 실제로는 백분율 또는 비율인 경우 PAY001이 아닙니다.- 중복 또는 4-눈(4-eyes) 검사가 스캐너가 따라가는 것보다 더 깊은 곳(세 번 호출)에 있으면 컨슈머나 승인 메서드는 괜찮습니다. 따라가서 그 위치를 말합니다.
- 위양성은 한 줄로 이유를 설명하여 제거합니다. 그래야 독자가 나머지를 신뢰할 수 있습니다.
-
references/checklist.md의 수동 체크리스트를 수행합니다. 각 스캐너 규칙을 잘못된 예와 올바른 예와 함께 설명하고, 어떤 스캐너도 볼 수 없는 것들(잔액에 대한 경쟁 조건, 멱등 키 범위, 재시도 및 타임아웃 의미론, 상태 머신, 조정, 전송 중인 돈, 감사, 데이터 보호)을 나열합니다. 검토 중인 코드가 필요한 만큼만 깊이 들어갑니다.
-
아래 형식으로 보고서를 작성합니다. 금전적 영향이 가장 큰 것부터 시작합니다.
보고서 형식
## 결제 리뷰: <서비스 또는 PR>
**평가:** <한 문장: 병합해도 안전함 / 병합 전 수정 필요 / 재설계 필요>
| # | 심각도 | 위치 | 문제 | 금전적 영향 |
|---|---|---|---|---|
| 1 | 높음 | `TransferController.java:24` | POST /transfers에 멱등 키 없음 | 클라이언트 재시도 후 타임아웃으로 두 번째 이체 생성됨 |
### 1. <제목>
**중요한 이유:** <무엇이 잘못되는지, 구체적인 예시 금액과 함께>
**수정:** <가장 작은 안전한 변경, 짧은 코드 스니펫 포함>
### 확인됨, 이상 없음
- <올바른 것으로 확인된 사항들, 위치 포함; 리뷰의 정직성을 유지>
### 검토되지 않음
- <확인할 수 없었던 사항, 예: 이 저장소에 없는 데이터베이스 제약 조건>
리뷰 규칙
- 심각도는 금전적 기준입니다. 높음 = 돈이 잘못된 사람에 의해 손실, 중복 또는 이전될 수 있음. 중간 = 장애나 부하 시 발생 가능. 낮음 = 위생.
- 모든 발견 항목에 대해
file:line으로 라인을 인용합니다. 확인되지 않은 스캐너 리드를 보고하지 마십시오. - 가장 작은 안전한 수정을 선호합니다. 예를 들어 재작성 대신 고유 제약 조건과
Idempotency-Key헤더를 추가합니다. 올바른 수정이 구조적(트랜잭셔널 아웃박스)이라면 그렇게 명확히 말합니다. - 규정 준수를 주장하지 마십시오. 이 리뷰는 PCI DSS 또는 SOX 감사가 아닙니다. 요청받으면 그렇게 말하십시오.
- 데이터베이스도 확인합니다. 이러한 보장 중 상당수는 제약 조건(
UNIQUE,CHECK, 트리거)에 속합니다. 저장소에 있는 경우 마이그레이션(Flyway, Liquibase)을 살펴봅니다.