[BE] 회원관리 API 명세서 | Notion

1. Token의 사용

Library: Spring Security
목적: 회원 권한에 따른 페이지 이동 제한
방식: Http 요청마다 Header에 Auth 이름으로 포함되어 전송된다.
이외 방식 조사
- cookie로 전달하는 방식 고려 → 2가지 이유로 부적절하다고 판단
  1. CSRF → REST방식과 잘 호환되지 않는 문제
  2. 보안이 낮아서 설정이 따로 필요함
작동방식
- 최초 로그인 시 토큰을 발행
- 로그인하지 않은 회원은 GUEST 권한을 가지며 API 사용이 제한된다.

2. 이미지 전송과 저장

구상
- FireBase나 개인 AWS 계정에서 Storage를 활용해 이미지를 저장을 구상했으나 프로젝트 기간이 촉박해 AWS Linux 서버 내 파일 저장
- Dockerfile 단계에서 ubuntu 내의 디렉토리를 spring boot docker 내부와 연결
저장 경로
- Window: C: 경로 하위의 image 폴더
- linux: tmp/
  - 해당 경로와 파일명을 DB에 저장
  - img src=”” 로 바로 사용할 수 있도록 가공해서 json값으로 응답

서비스	설명	url	HTTP Method	메서드명	추가사항
회원가입	일반회원가입	/user/register	POST	`signUp`	GUEST/ROLL_USER/ADMIN
인증메일발송	일반회원가입시 인증메일 발송	/authEmail/send	POST	`sendEmail`	인증 전에는 GUEST로 분류
소셜회원가입	소셜로그인회원가입	스프링 시큐리티 디폴트값	POST
회원정보조회	회원의 데이터 반환	/user/detail/{email}	GET	`detailUser`
회원정보수정	회원의 정보 수정	/user/ update	PUT	`updateUserInfo`
회원탈퇴	회원기록삭제	/user	DELETE	`deleteUser`
~~비밀번호찾기~~	회원이 잃어버린 비밀번호를 찾을 수 있는 기능	/user/find_password/{email}	GET		비밀번호 암호화
~~증명서 업로드/가져오기~~	재직 증명서	user/upload / user/getFile	POST / GET	`uploadFile` / `getFile`	회원정보수정으로 통일

고객 기능

서비스	설명	url	HTTP Method	메서드명	추가사항
아이등록	관리하고 있는 아이 등록	user/care	POST	`saveBaby`	REST로 쓰면 뒤에 다 지우기
아이전체조회	해당 담당자가 등록한 아이를 모두 조회	/user/care/{user_id}	GET	`lookupAllBaby`
특정아이조회	고객이 담당하는 아이들 조회, 간단한 배너형식	user/care/lookup	POST	`lookupBaby`	user_id와 아이의 id를 전송
아이정보수정	아이의 정보를 수정	user/care	PUT	`updateBabyInfo`
아이정보삭제	아이의 정보를 삭제	user/care/{baby_id}	DELETE	`deleteBabyInfo`
아이상담일지	아이의 데이터를 열람
상세정보, 통계포함	user/care/data/consult/{baby_id}	POST	`getConsultData`
아이활동시간	아이의 데이터를 열람
상세정보, 통계포함	user/care/data/time/{baby_id}	POST
아이성향분석	아이의 데이터를 열람
상세정보, 통계포함	/user/care/data/character/{baby_id}	POST

관리자 기능

서비스	설명	url	Http Method	메서드명	구현
회원가입승인	인증이 완료된 회원 승인	/admin/auth/type	POST	approveUserType	O
전체회원조회	등록된 회원들을 조회	/admin/lookup/all	GET	lookupAllUser	O
특정회원조회	등록된 회원 조회	/admin/lookup	POST	lookupUser	O
회원삭제	회원 삭제	/admin/delete	POST	deleteUser	O
미승인회원조회	승인을 대기 중인 회원 조회	/admin/lookup/unapproved/{page}	GET	`lookupUnapprovedUser`	O