$$config title: ?도서 구매 및 리더북 서비스(Book_U_Luv) keywords: - IT - React - Spring Boot - Rest API - MariaDB - JPA - Javascript - Java - JQuery - Jenkins - Docker $$

최종 프로젝트 Book U Luv팀 기술서

> 도서 구매 및 리더북 서비스
> 신간 도서와 베스트셀러를 확인할 수 있고, 원하는 도서를 검색할 수 있습니다.
> 찾은 도서를 구매하고 다운로드해 리더기를 통해 읽어볼 수 있습니다.

프로젝트 산출물

- [수행 계획서](https://to2.kr/eF5) - [요구사항 정의서](https://to2.kr/eF6) - [사용자 화면 정의서(UI/UX)](https://to2.kr/eF8) - [DB 설계 자료](https://slog.gg/p/12859) 진행 기간: 2023.08.01 ~ 2023.08.29

? 팀원

_{고우영(팀장)}

_박창규

_황인성

## 목차 - [? 배포 링크](#-배포-링크) - [? 사전 선발 과제](#-사전-선발-과제) - [브랜치 전략](#브랜치-전략) - [커밋 메시지 컨벤션](#커밋-메시지-컨벤션) - [? 팀 규칙](#-팀-규칙) - [? 폴더 구조](#-폴더-구조) - [? 구현미리보기](#-구현미리보기)
## ? 배포 링크 [Book U Luv 배포주소 : https://www.bookuluv.devh.me](https://www.bookuluv.devh.me)
## ? Book U Luv |팀원이름 | GitHub Repository | | ------ | --------------------------------------------------------------------------------- | |book_u_luv|[Book U Luv(Back)](https://github.com/cojar/book_u_luv)| |book_u_luv_reader|[book_u_luv_reader(React)](https://github.com/cojar/book_u_luv_reader)| |고우영|[wooyoung0407](https://github.com/wooyoung0407?tab=repositories)| |박창규|[kael0595](https://github.com/kael0595?tab=repositories)| |황인성|[insung5189](https://github.com/insung5189?tab=repositories)|
## ? 협업 Tool ### Trello ![Trello](https://i.imgur.com/YFBpG2s.jpg)
## ? 폴더 구조 ``` ?Book U Luv ├── api : 리더기앱 rest api ├── app : 어플리케이션 소스 모음 ├── base : 기반 소스 모음 ├── configuration : 환경설정 ├── mail : 이메일 인증 ├── member : 회원 └── utils : 유틸 ```
## ?️ 기술 스택

## ? 구현미리보기 ### Book U Luv 1. Book U Luv - 도서 구매 - 리더북 서비스 ### Book U Luv 페이지 구현 설명 --- ### ? 메인페이지 - 가장 최근에 올린 신간, 베스트셀러가 3개씩 나와있고, 검색도 가능하다. 1. 구현이미지 ![메인페이지](https://i.imgur.com/k45WvvM.png) 2. 코드내용 ```java @Controller @RequiredArgsConstructor public class MainController { private final MemberService memberService; private final ProductService productService; @GetMapping("/") public String root(Model model, Principal principal) { List newBooks = productService.getNewBooks(); List bestsellers = productService.getBestsellers(); model.addAttribute("newBooks", newBooks); // 'books' 대신 'newBooks'로 변경 model.addAttribute("bestsellers", bestsellers); // 'books' 대신 'bestsellers'로 변경 if (principal != null) { Member member = this.memberService.getUser(principal.getName()); model.addAttribute("member", member); model.addAttribute("userImg", member.getImgFilePath()); return "main"; } return "main"; } } ``` ```java @Service @RequiredArgsConstructor public class ProductService { private final RestTemplate restTemplate; private final OAuth2AuthorizedClientService clientService; @Value("${spring.aladin.api.key}") private String apiKey; private final String searchUrl = "http://www.aladdin.co.kr/ttb/api/ItemSearch.aspx"; private final String listUrl = "http://www.aladin.co.kr/ttb/api/ItemList.aspx"; public List searchBooks(String query) { String url = buildSearchUrl("Keyword", query); return getBooksFromApi(url); } public List getNewBooks() { String url = buildListUrl("ItemNewAll"); return getBooksFromApi(url); } public List getBestsellers() { String url = buildListUrl("Bestseller"); return getBooksFromApi(url); } private String buildSearchUrl(String queryType, String query) { return searchUrl + "?ttbkey=" + apiKey + "&QueryType=" + queryType + "&MaxResults=10" + "&start=1" + "&SearchTarget=Book" + "&output=js" + "&Version=20131101" + (query != null ? "&Query=" + query : "") + "&CategoryId=0"; } private String buildListUrl(String queryType) { return listUrl + "?ttbkey=" + apiKey + "&QueryType=" + queryType + "&MaxResults=10" + "&start=1" + "&SearchTarget=Book" + "&output=js" + "&Version=20131101"; } private List getBooksFromApi(String url) { ResponseEntity responseEntity = restTemplate.getForEntity(url, String.class); String responseBody = responseEntity.getBody(); System.out.println(responseBody); ArrayList results = new ArrayList<>(); if (responseBody != null) { JSONObject responseJson = new JSONObject(responseBody); JSONArray items = responseJson.optJSONArray("item"); if (items != null) { for (int i = 0; i < items.length(); i++) { JSONObject item = items.getJSONObject(i); ProductDto result = new ProductDto(); result.setCoverImg(item.optString("cover")); result.setTitle(item.optString("title")); result.setLink(item.optString("link")); result.setAuthor(item.optString("author")); result.setPubDate(item.optString("pubDate")); result.setIsbn(item.optString("isbn")); result.setCategoryName(item.optString("categoryName")); result.setPublisher(item.optString("publisher")); result.setPriceStandard(item.optLong("priceStandard")); result.setPriceSales(item.optLong("priceSales")); results.add(result); } } else { System.out.println("JSON에서 'item' 키를 찾을 수 없음."); } } else { System.out.println("응답 본문이 null입니다."); } return results; } ```
### ? 로그인 - 기본 회원가입한 내용 로그인 및 소셜로그인 가능(카카오,네이버,구글) 1. 로그인구현이미지 ![로그인](https://i.imgur.com/u32JhJH.png) 2. 코드내용 ```java @Controller @RequiredArgsConstructor public class MemberController { @GetMapping("/member/login") public String login() { return "member/login"; } } ``` ```java @Service @RequiredArgsConstructor public class MemberSecurityService implements UserDetailsService { private final MemberRepository memberRepository; @Override public UserDetails loadUserByUsername(String userName) throws UsernameNotFoundException { System.out.println("loadUserByUsername's userName : " + userName); Optional memberOp = memberRepository.findByUserName(userName); Member member = memberOp.orElseThrow(() -> new UsernameNotFoundException("사용자를 찾을 수 없습니다.")); List authorities = new ArrayList<>(); if (isAdmin()) { authorities.add(new SimpleGrantedAuthority(MemberRole.ADMIN.getValue())); } else { authorities.add(new SimpleGrantedAuthority(MemberRole.USER.getValue())); } return new CustomMember( member.getUserName(), member.getPassword(), authorities, member.getNickName(), member.getBirthDate() ); } } ``` ```java @Getter @Setter @Component public class CurrentMember { private String userName; private String password; public String getUserName() { return userName; } public void setUserName(String userName) { this.userName = userName; } public String getPassword() { return password; } public void setPassword(String password) { this.password = password; } } ``` ```java @Getter @Setter public class CustomMember extends User { // 일반 이메일 계정으로 가입한 유저의 정보를 표시할 때 연결해주는 곳 private String nickName; private LocalDate birthDate; private String email; private LocalDateTime createDate; private String imgFilePath; Member member = new Member(); public CustomMember(String username, String password, Collection authorities, String nickName, LocalDate birthDate) { super(username, password, authorities); this.nickName = nickName; this.birthDate = birthDate; this.email = username; this.createDate = member.getCreateDate(); this.imgFilePath = member.getImgFilePath(); } } ``` 3. 소셜로그인구현이미지 ![카카오소셜로그인(수정예정)](https://i.imgur.com/wU0tmn5.png) ![네이버소셜로그인(수정예정)](https://i.imgur.com/jwmnCBN.png) ![구글소셜로그인(수정예정)](https://i.imgur.com/NX4iF68.png) ```java @Getter @Setter public class MemberContext extends User implements OAuth2User { // 소셜계정으로 가입한 유저의 정보를 표시할 때 연결해주는 곳 private final Long id; private final String email; private final String nickName; private final String imgFilePath; private final LocalDateTime createDate; private Map attributes; private String userNameAttributeName; public MemberContext(Member member, List authorities) { super(member.getUserName(), member.getPassword(), authorities); this.id = member.getId(); this.email = member.getSocialEmail(); this.nickName = member.getNickName(); this.createDate = member.getCreateDate(); this.imgFilePath = member.getImgFilePath(); } public MemberContext(Member member, List authorities, Map attributes, String userNameAttributeName) { this(member, authorities); this.attributes = attributes; this.userNameAttributeName = userNameAttributeName; } @Override public Set getAuthorities() { return super.getAuthorities().stream().collect(Collectors.toSet()); } @Override public Map getAttributes() { return this.attributes; } @Override public String getName() { return this.getAttribute(this.userNameAttributeName).toString(); } } ``` ```java @Service @Transactional(readOnly = true) @RequiredArgsConstructor public class OAuth2UserService extends DefaultOAuth2UserService { @Autowired private MemberRepository memberRepository; @Override @Transactional public OAuth2User loadUser(OAuth2UserRequest userRequest) throws OAuth2AuthenticationException { OAuth2User oAuth2User = super.loadUser(userRequest); String userNameAttributeName = userRequest.getClientRegistration().getProviderDetails().getUserInfoEndpoint() .getUserNameAttributeName(); Map attributes = oAuth2User.getAttributes(); String oauthId = null; Member member = null; String oauthType = userRequest.getClientRegistration().getRegistrationId().toUpperCase(); if (!"KAKAO".equals(oauthType) && !"NAVER".equals(oauthType) && !"GOOGLE".equals(oauthType)) { throw new OAuthTypeMatchNotFoundException(); } else if ("KAKAO".equals(oauthType)) { oauthId = oAuth2User.getName(); } else if ("NAVER".equals(oauthType)) { Map attributesResponse = (Map) attributes.get("response"); oauthId = (String) attributesResponse.get("id"); } else if ("GOOGLE".equals(oauthType)) { // oauthId; } String provider = userRequest.getClientRegistration().getRegistrationId(); String providerId = ""; if (isNew(oauthType, oauthId)) { switch (oauthType) { case "KAKAO" -> { Map attributesProperties = (Map) attributes.get("properties"); Map attributesKakaoAccount = (Map) attributes.get("kakao_account"); String nickName = (String) attributesProperties.get("nickname"); String profileImgUrl = (String) attributesProperties.get("profile_image"); String thumbnail_image = (String) attributesProperties.get("thumbnail_image"); providerId = oauthId; String email = "%s@kakao.com".formatted(oauthId); String userName = "KAKAO_%s".formatted(oauthId); Boolean gender = null; String age_range = null; LocalDate birthDate = null; Boolean mailAuth = null; boolean isActive = true; if ((boolean) attributesKakaoAccount.get("has_email")) { // 만약 이메일 공개 동의 시 수집 가능 email = (String) attributesKakaoAccount.get("email"); mailAuth = true; } if ((boolean) attributesKakaoAccount.get("has_age_range") // 만약 연령대 공개 동의 시 수집 가능 && !(boolean) attributesKakaoAccount.get("age_range_needs_agreement")) { age_range = (String) attributesKakaoAccount.get("age_range"); } if ((boolean) attributesKakaoAccount.get("has_birthday") // 만약 생년월일 공개 동의 시 수집 가능 && !(boolean) attributesKakaoAccount.get("birthday_needs_agreement")) { birthDate = (LocalDate) attributesKakaoAccount.get("birthday"); } if ((boolean) attributesKakaoAccount.get("has_gender") // 만약 성별 공개 동의 시 수집 가능 && !(boolean) attributesKakaoAccount.get("gender_needs_agreement")) { gender = (boolean) attributesKakaoAccount.get("gender"); } String fullName = (String) attributesProperties.get("nickname"); String lastname; String firstname; if (fullName.length() == 2 && isSpecialLastname(fullName)) { lastname = fullName.substring(0, 2); firstname = ""; } else if (fullName.length() == 3 && isSpecialLastname(fullName.substring(0, 2))) { lastname = fullName.substring(0, 2); firstname = fullName.substring(2); } else if (fullName.length() == 4 && isSpecialLastname(fullName.substring(0, 2))) { lastname = fullName.substring(0, 2); firstname = fullName.substring(2); } else { lastname = fullName.substring(0, 1); firstname = fullName.substring(1); } // 저장 member = Member.builder() .userName(userName) // 사용자ID 추가(email형식) .password("") .nickName(nickName) // 사용자 닉네임 추가 .socialEmail(email) // 사용자 이메일 추가 .imgFilePath(profileImgUrl) // 사용자 프로필 사진 추가 .createDate(LocalDateTime.now()) // 계정 생성일 추가 .birthDate(birthDate) // 사용자 생년월일 추가 .role(MemberRole.valueOf("USER")) // 사용자 권한 추가 .mailAuth(mailAuth) // 사용자 메일 인증여부 추가(일반 가입시 true) .gender(gender) // 사용자 성별 추가 .firstName(firstname) // 사용자 이름 추가 .lastName(lastname) // 사용자 성 추가 .provider(provider) .providerId(providerId) .isActive(isActive) // 계정 활성 여부 추가 .build(); // 빌드완료 memberRepository.save(member); } case "NAVER" -> { Map attributesResponse = (Map) attributes.get("response"); String phone_e164 = (String) attributesResponse.get("mobile_e164"); String age = (String) attributesResponse.get("age"); String id = (String) attributesResponse.get("id"); String userName = "NAVER_%s".formatted(id); providerId = oauthId; String profileImgUrl; String nickName; LocalDate birthDate; Boolean gender = null; boolean mailAuth = false; boolean isActive = true; String lastname; String firstname; String email; if (attributesResponse.containsKey("email")) { email = (String) attributesResponse.get("email"); mailAuth = true; } else { email = "%s@naver.com".formatted(oauthId); } if (attributesResponse.containsKey("nickname")) { nickName = (String) attributesResponse.get("nickname"); } else { nickName = null; } if (attributesResponse.containsKey("profile_image")) { profileImgUrl = (String) attributesResponse.get("profile_image"); } else { profileImgUrl = null; } if (attributesResponse.containsKey("birthday") && attributesResponse.containsKey("birthyear")) { String birthday = (String) attributesResponse.get("birthday"); String birthyear = (String) attributesResponse.get("birthyear"); String combinedDate = String.format("%s-%s", birthyear, birthday); birthDate = LocalDate.parse(combinedDate, DateTimeFormatter.ofPattern("yyyy-MM-dd")); } else { birthDate = null; } String naverGender = (String) attributesResponse.get("gender"); if (naverGender.equals("M")) { gender = true; } else if (naverGender.equals("F")) { gender = false; } String phone = (String) attributesResponse.get("mobile"); String sanitizedPhone = phone.replaceAll("-", ""); String fullName = (String) attributesResponse.get("name"); if (fullName.length() == 2 && isSpecialLastname(fullName)) { lastname = fullName.substring(0, 2); firstname = ""; } else if (fullName.length() == 3 && isSpecialLastname(fullName.substring(0, 2))) { lastname = fullName.substring(0, 2); firstname = fullName.substring(2); } else if (fullName.length() == 4 && isSpecialLastname(fullName.substring(0, 2))) { lastname = fullName.substring(0, 2); firstname = fullName.substring(2); } else { lastname = fullName.substring(0, 1); firstname = fullName.substring(1); } // 저장 member = Member.builder() .userName(userName) // 사용자ID 추가(email형식) .password("") .nickName(nickName) // 사용자 닉네임 추가 .socialEmail(email) .imgFilePath(profileImgUrl) .createDate(LocalDateTime.now()) // 계정 생성일 추가 .birthDate(birthDate) // 사용자 생년월일 추가 .phone(sanitizedPhone) // 사용자 연락처 추가 .mailAuth(mailAuth) // 사용자 메일 인증여부 추가(일반 가입시 true) .firstName(firstname) // 사용자 이름 추가 .lastName(lastname) // 사용자 성 추가 .gender(gender) // 사용자 성별 추가 .provider(provider) .providerId(providerId) .role(MemberRole.valueOf("USER")) // 사용자 권한 추가 .isActive(isActive) // 계정 활성 여부 추가 .build(); // 빌드완료 memberRepository.save(member); } } } else { member = memberRepository.findByUserName("%s_%s".formatted(oauthType, oauthId)) .orElseThrow(MemberNotFoundException::new); } List authorities = new ArrayList<>(); authorities.add(new SimpleGrantedAuthority("member")); return new MemberContext(member, authorities, attributes, userNameAttributeName); } private boolean isNew(String oAuthType, String oauthId) { return memberRepository.findByUserName("%s_%s".formatted(oAuthType, oauthId)).isEmpty(); } private boolean isSpecialLastname (String lastname){ String[] specialLastnames = {"남궁", "황보", "제갈", "사공", "선우", "서문", "독고", "동방", "어금", "망절", "무본", "황목", "등정", "장곡", "강전"}; for (String special : specialLastnames) { if (special.equals(lastname)) { return true; } } return false; } } ```
### ? 회원가입 - 이름(성,이름),이메일,닉네임,인증번호확인,비밀번호,비밀번호확인,전화번호,우편번호,도로명주소,지번주소,상세주소,참고항목,성별,생년월일 작성 후 회원가입이 가능하다. 1. 구현이미지 ![회원가입](https://i.imgur.com/paS8las.png) 2. 코드내용 ```java @Controller @RequiredArgsConstructor public class MemberController { private final MemberService memberService; @GetMapping("/member/join") public String showSignup(MemberJoinRequest memberJoinRequest) { return "member/join"; } @PostMapping("/member/join") public String signup(@Valid MemberJoinRequest dto, BindingResult bindingResult) { if (bindingResult.hasErrors()) { return "member/join"; } if (!dto.getPassword1().equals(dto.getPassword2())) { bindingResult.rejectValue("password1", "passwordIncorrect", "2개의 패스워드가 일치하지 않습니다."); return "member/join"; } try { // 인증 코드 검증 if (dto.getMailKey().equals(dto.getGenMailKey())) { LocalDate currentDate = LocalDate.now(); LocalDate birthDate = dto.getBirthDate(); // 회원가입 처리 MemberRole role = dto.getUserName().startsWith("admin") ? MemberRole.ADMIN : MemberRole.USER; this.memberService.join( dto.getUserName(), dto.getPassword1(), dto.getNickName(), dto.getRoadAddress(), dto.getJibunAddress(), dto.getDetailAddress(), dto.getExtraAddress(), dto.getPostalNum(), dto.getPhone(), dto.getFirstName(), dto.getLastName(), dto.isGender(), dto.getBirthDate(), dto.getMailKey(), role, true ); } else { // 두 값이 일치하지 않는 경우 // 예외 처리 로직을 실행합니다. bindingResult.rejectValue("mailKey", "mailKeyNotMatched", "유효하지 않은 이메일 또는 메일 키입니다."); return "member/join"; } } catch (DataIntegrityViolationException e) { e.printStackTrace(); bindingResult.reject("⚠️회원가입에 실패했습니다⚠️", "이미 등록된 아이디입니다."); return "member/join"; } catch (Exception e) { e.printStackTrace(); bindingResult.reject("⚠️회원가입에 실패했습니다⚠️", e.getMessage()); return "member/join"; } return "redirect:/"; } } ``` ```java @Service @RequiredArgsConstructor public class MemberService { public String join(String userName, String password, String nickName, String roadAddress, String jibunAddress, String detailAddress, String extraAddress, String postalNum, String phone, String firstName, String lastName, Boolean gender, LocalDate birthDate, Integer mailKey, MemberRole role, boolean mailAuth) { // 프로필 사진 파일 이름 // userName 중복체크 memberRepository.findByUserName(userName) .ifPresent(user -> { throw new AppException(ErrorCode.USERNAME_DUPLICATED, userName + " 는 존재합니다."); }); // 저장 Member member = Member.builder() .userName(userName) // 사용자ID 추가(email형식) .password(encoder.encode(password)) // 사용자 비밀번호 추가(passwordEncoder로 인코딩) .nickName(nickName) // 사용자 닉네임 추가 .roadAddress(roadAddress) // 사용자 도로명주소 추가(카카오API) .jibunAddress(jibunAddress) // 사용자 지번주소 추가(카카오API) .detailAddress(detailAddress) // 사용자 상세주소 추가(동네이름 / 아파트이름)(카카오API) .extraAddress(extraAddress) // 사용자 기타주소 추가(ex. 동, 호수) (카카오API) .postalNum(postalNum) // 사용자 우편번호 추가 .phone(콜) // 사용자 연락처 추가 .firstName(firstName) // 사용자 이름 추가 .lastName(lastName) // 사용자 성 추가 .gender(gender) // 사용자 성별 추가 .birthDate(birthDate) // 사용자 생년월일 추가 .mailKey(mailKey) // 사용자 이메일 인증당시 인증 키 추가 .role(role) // 사용자 권한 추가 .mailAuth(mailAuth) // 사용자 메일 인증여부 추가(일반 가입시 true) .createDate(LocalDateTime.now()) // 계정 생성일 추가 .build(); // 빌드완료 this.memberRepository.save(member); return "SUCCESS"; } } ```

♥♥♥최종 프로젝트 Book U Luv팀 기술서를 봐주셔서 감사합니다!!!♥♥♥

게시글 상세