Rinjae
114 lines
3.6 KiB
Markdown
114 lines
3.6 KiB
Markdown
# 사업자등록번호 중복 체크 구현 작업 계획서
|
|
|
|
## 1. 현황 분석
|
|
|
|
### 문제점
|
|
- 법인 등록 시 사업자등록번호(compRegNo) 중복 검증이 없음
|
|
- `PortalOrgRepository.findByCompRegNo()` 메서드는 존재하나 사용되지 않음
|
|
- 동일한 사업자등록번호로 여러 법인이 등록될 수 있는 상태
|
|
|
|
### 검증 시점
|
|
1. **실시간 검증**: 사용자가 사업자등록번호 입력 시 `/check-business-number` API 호출
|
|
2. **등록 시 검증**: 실제 법인 생성 시점 (`registerOrgFromDTOWithFile`)
|
|
|
|
---
|
|
|
|
## 2. 수정 대상 파일
|
|
|
|
| 파일 경로 | 수정 내용 |
|
|
|-----------|-----------|
|
|
| `src/main/java/.../apps/user/service/PortalOrgService.java` | 사업자등록번호 중복 체크 메서드 추가 |
|
|
| `src/main/java/.../apps/user/facade/OrgRegisterFacadeImpl.java` | `checkBusinessNumber()` 중복 체크 로직 추가, 등록 전 중복 체크 추가 |
|
|
|
|
---
|
|
|
|
## 3. 구현 상세
|
|
|
|
### 3.1 PortalOrgService.java
|
|
|
|
```java
|
|
// 추가할 메서드
|
|
public boolean existsByCompRegNo(String compRegNo) {
|
|
return portalOrgRepository.findByCompRegNo(compRegNo).isPresent();
|
|
}
|
|
```
|
|
|
|
### 3.2 OrgRegisterFacadeImpl.java
|
|
|
|
#### checkBusinessNumber 메서드 수정
|
|
- 형식 검증 + 중복 검증 동시 수행
|
|
- 중복 시 "이미 등록된 사업자등록번호입니다." 메시지 반환
|
|
|
|
```java
|
|
@Override
|
|
public ResponseEntity<ValidationResponse> checkBusinessNumber(String compRegNo) {
|
|
// 1. 형식 검증
|
|
boolean isValidFormat = validationService.isValidBusinessNumber(compRegNo);
|
|
if (!isValidFormat) {
|
|
return ResponseEntity.ok(new ValidationResponse(false, "유효하지 않은 사업자 등록번호입니다."));
|
|
}
|
|
|
|
// 2. 중복 검증
|
|
boolean isDuplicate = portalOrgService.existsByCompRegNo(compRegNo);
|
|
if (isDuplicate) {
|
|
return ResponseEntity.ok(new ValidationResponse(false, "이미 등록된 사업자등록번호입니다."));
|
|
}
|
|
|
|
return ResponseEntity.ok(new ValidationResponse(true, "사용 가능한 사업자 등록번호입니다."));
|
|
}
|
|
```
|
|
|
|
#### 법인 생성 메서드들에 중복 체크 추가
|
|
- `registerNewCorporateUser()`
|
|
- `convertExistingUserToCorporate()`
|
|
- `registerNewCorporateUserWithExistingData()`
|
|
|
|
각 메서드에서 `portalOrgService.registerOrgFromDTOWithFile()` 호출 전 중복 체크 수행
|
|
|
|
---
|
|
|
|
## 4. 검증 흐름
|
|
|
|
```
|
|
[사용자 입력]
|
|
↓
|
|
[실시간 검증] /check-business-number API
|
|
├── 형식 검증 (10자리 숫자)
|
|
└── 중복 검증 (DB 조회)
|
|
↓
|
|
[등록 요청]
|
|
↓
|
|
[등록 시 검증] registerOrgFromDTOWithFile 호출 전
|
|
└── 중복 체크 (이중 방어)
|
|
↓
|
|
[법인 생성]
|
|
```
|
|
|
|
---
|
|
|
|
## 5. 기존 중복 데이터 처리
|
|
|
|
- 기존에 중복 등록된 데이터는 그대로 유지
|
|
- 신규 등록 시에만 중복 체크 적용
|
|
- 필요시 관리자 화면에서 중복 데이터 조회/정리 기능 별도 개발 가능
|
|
|
|
---
|
|
|
|
## 6. 테스트 시나리오
|
|
|
|
| 시나리오 | 예상 결과 |
|
|
|----------|-----------|
|
|
| 형식이 잘못된 사업자등록번호 입력 | "유효하지 않은 사업자 등록번호입니다." |
|
|
| 이미 등록된 사업자등록번호 입력 | "이미 등록된 사업자등록번호입니다." |
|
|
| 사용 가능한 사업자등록번호 입력 | "사용 가능한 사업자 등록번호입니다." |
|
|
| 중복된 번호로 법인 등록 시도 | 등록 실패, 에러 메시지 표시 |
|
|
|
|
---
|
|
|
|
## 7. 작업 완료
|
|
|
|
- [x] PortalOrgService에 existsByCompRegNo 메서드 추가
|
|
- [x] OrgRegisterFacadeImpl.checkBusinessNumber 수정
|
|
- [x] 법인 등록 메서드들에 중복 체크 로직 추가
|
|
- [x] 빌드 검증 완료
|