[BackEnd] 로그인 비즈니스 로직 설계

[sooah-0208]

확정안

API 명세서

---

1. 로그인 정보 확인 (POST)

Description: 로그인 정보 확인 및 회사 선택 페이지 이동을 위한 데이터를 전달합니다.

항목	내용
Method	POST
URL	/auth
Auth	-

Request Parameters

1. Path Parameters

순서	Model명	형식	필수여부	설명
① 로그인 입력	email	EmailStr	Required	이메일
	password	str	Required	비밀번호

Response Body (JSON)

성공 (200 OK)

{
  "status": true,
  "message": "로그인에 성공했습니다.",
  "data": {
    "uuid": "ec70c7bd080a49259b21a6d730afe626",
    "companys": [
      {
        "id": 1,
        "name": "홍길동",
        "email": "test@gmail.com",
        "role_id": 2,
        "role": "ESG담당자",
        "company_id": 1,
        "company_name": "A회사"
      }
    ],
    "tempLogin": false
  }
}

실패

{
  "status": false,
  "message": "이메일 또는 비밀번호가 올바르지 않습니다.",
  "data": {}
}

---

이거 있는지 확인후 없으면 삭제

2. 비밀번호 체크 (PATCH)

Description: 회원정보 수정 등 2차 인증이 필요한 경우 비밀번호를 체크하기 위함입니다.

항목	내용
Method	PATCH
URL	/auth
Auth	-

Request Parameters

1. Path Parameters

순서	Model명	형식	필수여부	설명
1	password	str	Required	비밀번호

Response Body (JSON)

성공 (200 OK)

{
  "status": true,
  "message": "임시 비밀번호가 메일로 발송 됐습니다.",
  "data": {}
}

실패

{
  "status": false,
  "message": "등록되지 않은 이메일이거나 탈퇴한 회원입니다.",
  "data": {}
}

---

3. 로그아웃 처리 (DELETE)

Description: 로그아웃 처리(TOKEN Table의 uuid 관련 처리)를 수행합니다.

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

Request Parameters

1. Path Parameters

Model명	형식	필수여부	설명
uuid	str	Required	TOKEN Table uuid

2. Header Parameters
해당 사항 없음

Response Body (JSON)

성공

{
  "status": true,
  "message": "로그아웃 완료",
  "data": {}
}

실패

{
  "status": false,
  "message": "로그아웃 처리 중 오류 발생"
}

---

영향 범위

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

담당자

@mpsddd-commits , @choiyc05 @sooah-0208

결정일

2026-04-23

[frankie516c]

@sooah-0208
영향 범위에 FE / BE / 문서 각 팀 별 리더 언급해주신 부분은 실무적으로 매우 유용하게 쓰일 예정입니다.
또, 결정 내리신 부분이 인증/로그인 방식 시스템의 핵심이 될 것 같습니다.
로직 고민하시느라 수고 많으셨습니다.

다만, 현재 내용이 구현 로직 위주로 나열되어 있어, FE 담당자가 보고 바로 API 연동을 준비하기에 어려움이 있지 않을까 싶습니다. 협업 효율을 위해서 하기 사항을 참조하시어 추후에 모든 코드가 확정 된 다음과 같은 사항들 추가 요청드립니다.

• 인터페이스 구체화: '최종 결정' 섹션에 FE와 주고 받을 Request/Response 데이터 규격(Key값)을 명시해주시기 바랍니다.
• 용어 정리: T(Table) 같은 DB 용어보다 기능 단위(회원가입 API, 로그인 API)로 목차를 잡아주시기 바랍니다.

감사합니다.

[sooah-0208]

확인했습니다!