[BackEnd] 회원관리 비즈니스 로직 설계

[sooah-0208]

확정안

API 명세서

---

1. 사업자등록증 정보 추출 (POST)

Description: 업로드된 사업자등록증 이미지에서 파싱된 정보를 추출합니다.

항목	내용
Method	POST
URL	/user
Auth	N/A

Request Parameters

1. Path Parameters

Model명	형식	필수여부	설명
file	File	Required	스캔 또는 촬영된 사업자등록증 이미지 파일

Response Body (JSON)

성공

{
  "status": true,
  "fileUuid": "9723a601fda04dd89420454dcec6369c",
  "fileExt": "jpeg",
  "licenseData": {
    "사업자등록번호": "8290700318",
    "상호": "8290700318",
    "성명": "백재봉",
    "개업연월일": "2016년04월01일",
    "사업장소재지": "울산광역시 남구 수암로 59(신정동)",
    "발급날짜": "1991년01월20일",
    "발급세무서": null
  },
  "businessStatus": {
    "status": true,
    "message": "사업자 정보가 확인되었습니다.",
    "data": {}
  }
}

실패
// 상황에 따른 실패 응답 예시

{
  "status": false,
  "message": "응답 데이터가 올바르지 않습니다."
}
// 또는
{
  "status": false,
  "message": "폐업 상태입니다."
}
// 또는
{
  "status": false,
  "message": "API 서버 응답 실패"
}

---

2. 회원가입 완료 (PUT)

Description: 회원가입을 완료하고 데이터를 서버에 저장합니다.

항목	내용
Method	PUT
URL	/user
Auth	N/A

Request Parameters

1. Path Parameters

Model명	형식	필수여부	설명
name	str	N	이름

2. Request Body (JSON)

Model명	형식	필수여부	설명
email	String	Required	가입하고자 하는 유저의 고유 계정(이메일)
password	String	Required	비밀번호
licensefileId	String	Required	사업등록증 ID
businessNumber	String	Required	사업자 번호
companyName	String	Required	법인/단체명
ceoName	String	Required	대표자명
openingDate	String	Required	기업설립일 (YYYY-MM-DD)
corporateNumber	String	Optional	법인 등록번호
headOffice	String	Required	본점 소재지
texName	String	Required	발행처
industryId	String	Required	업태
subCategory	String	Required	종목
companySize	String	Required	기업 규모
agreed	Boolean	Required	약관 동의 여부 (true 고정)
industryCodes	String	Required	업종분류코드 id (INDUSTRY_CODE)

Response Body (JSON)

성공

{
  "status": true,
  "message": "회원가입이 완료되었습니다.",
  "data": {}
}

실패

{
 "status": false 
}

---

3. 회원 정보 수정 (PATCH)

Description: 회원 정보를 수정합니다.

항목	내용
Method	PATCH
URL	/user
Auth	N/A

Request Parameters

1. Path Parameters

Model명	형식	필수여부	설명
user_id	int	Required	DB user_id
newPassword	str	Optional	새 비밀번호
newPasswordConfirm	str	Optional	새 비밀번호 검증

Response Body (JSON)

성공

{
  "status": true,
  "message": "회원 정보가 수정되었습니다."
}

실패

{
  "status": false,
  "message": "수정 중 오류 발생"
}

---

4. 회원 탈퇴 처리 (DELETE)

Description: 회원 탈퇴 처리(delete_yn)입니다.

항목	내용
Method	DELETE
URL	/user
Auth	N/A

Request Parameters

1. Path Parameters

Model명	형식	필수여부	설명
user_id	int	Required	DB user_id

Response Body (JSON)

성공

{
  "status": true,
  "message": "회원 탈퇴가 완료되었습니다."
}

실패

{
  "status": false,
  "message": "탈퇴 처리 중 오류 발생"
}

---

영향 범위

FE @x2bjvhmmwg-gif / BE / 문서 @frankie516c

담당자

@mpsddd-commits , @choiyc05 @sooah-0208

결정일

2026-04-23

[frankie516c]

구조 너무 깔끔하게 잘 잡아주셔서 감사합니다.

• Request / Response 포맷이 일관돼서 FE에서 바로 붙이기 좋은 점
• status 기반으로 분기 처리 가능하게 설계된 점
• 기능 흐름(OCR → 회원가입 → 수정 → 탈퇴) 기준으로 API 나눈 점

덕분에 지금 상태면 구현 단계에서 커뮤니케이션 비용 거의 안 들 것 같습니다.

감사합니다.