$$config title: 멋블리 기술설명서 keywords: - IT - 기술설명서 $$ # 개요 - 여성의류 쇼핑몰 구현 - 주문쪽 기능은 장바구니까지만 구현(결제는 미구현) --- # 리포지터리 - [https://github.com/jhs512/mbly_final](https://github.com/jhs512/mbly_final) --- # 사용된 기술 ## 버전관리 - GIT, GITHUB --- ## 배포 - GITHUB, 젠킨스, 도커 --- ## 개발환경 - 아나콘다 - 파이참 - SQLYog - 크롬 - PIP - MariaDB - Windows 11 --- ## 서비스환경 - NGINX - MariaDB - 도커 - CentOS7 --- ## 기술 스택 - 파이썬 3 - 장고 4 - 장고 MTV - DRF - MariaDB - HTML, CSS, JS - 제이쿼리 - 테일윈드 - 부트스트랩 - 서머노트 --- # 요구사항 ## 회원 - 회원가입가입이 가능하다. - 회원가입 시 환영메일이 발송된다. - 카카오톡로그인이 가능하다. - ... ## 상품 - 상품리스팅이 가능하다. - ... ## 최종 관리자용 API - 최종관리자는 API를 사용해서 전체상품을 CRUD 할 수 있다. ## 마켓 관리자용 API - 마켓관리자는 API를 사용해서 자신의 마켓에 속한 상품을 CRUD 할 수 있다. ## 엘라스틱서치검색 - 마켓명을 검색할 수 있다. - ... ## 장바구니 - 장바구니 품목추가가 가능하다. - ... ## 마켓 - 마켓해시태그검색이 가능하다. - 상품의 평점수정시 자동으로 평균평점값이 마켓에 반영된다. ## 질문 - ... ## 서머노트 서포트 - ... --- # 기능 ## 회원 - 회원가입 - 회원가입환영메일 - 카카오톡로그인 - 카카오톡로그인 시 프로필이미지 가져오기 - 로그인 - 로그아웃 - 정보수정 - 아이디찾기 - 비번찾기(비번리셋메일 발송) - 팔로우, 팔로잉 ## 상품 - 상품리스팅 - 상품리스팅 페이징 - 상품키워드검색 - 상품카테고리검색 - 상품찜하기 ## 최종 관리자용 API - 상품 CRUD ## 마켓 관리자용 API - 상품 CRUD ## 엘라스틱서치검색 - 마켓명검색 - 카테고리명검색 - 상품상세내용검색 - 초성검색 - 자모검색 ## 장바구니 - 장바구니 품목추가 - 장바구니 품목리스팅 - 장바구니 품목수량수정 - 장바구니 품목삭제 ## 마켓 - 마켓해시태그검색기능 - 상품의 평점수정시 자동으로 평균평점값이 마켓에 반영 ## 질문 - 상품에 질문을 달 수 있음 - 제너릭 릴리에션으로, 어디에나 질문을 달 수 있도록 작업 ## 서머노트 서포트 - 서머노트에 사용된 이미지 중, 사용하지 않는 이미지 자동제거 --- # ERD ![ERD](https://i.postimg.cc/0kGPPSw-k/graphviz.png) --- # 주요 폴더 및 파일 - accounts : 회원앱 - base : 프로젝트 - cart : 장바구니앱 - db_var : DB영속변수 앱 - docker_projects : 엘라스틱서치관련 파일들 - media : 동적으로 발생하는 정적파일들을 담는 폴더 - static : 정적으로 발생하는 정적파일들을 담는 폴더 - seed : 시드앱 - node_modules : node 패키지 - products : 상품앱 - qna : QNA앱 - requirements : 의존성 - summernote_support : 서머노트서포트앱 - tags : 태그앱 - .env : 설정파일 - package.json : node 의존성 - git_pull_and_rerun.sh - 젠킨스에 의해서 실행회되는 재배포 스크립트 - tailwind.config.js : 테일윈드 설정 --- # 배포구조 - 커밋, 푸시, 젠킨스 빌드 유발, 컨테이너 내의 소스코드 리빌드 --- # 기술설명 ## 카카오톡 로그인 ![카카오톡 로그인](https://i.postimg.cc/mkGK0mbx/unknown.png) ```py # accounts/models.py class User(AbstractUser): ... @staticmethod def login_with_kakao(request: HttpRequest, provider_accounts_id: int, provider_accounts_nickname: str, provider_accounts_thumbnail_image_url: str): provider_type_code = User.ProviderTypeCodeChoices.KAKAO qs: QuerySet = User.objects.filter(provider_type_code=provider_type_code, provider_accounts_id=provider_accounts_id) if not qs.exists(): username = provider_type_code + "__" + str(provider_accounts_id) name = provider_accounts_nickname if provider_accounts_nickname else username email = "" password = str(random.randint(1000, 9999)) user = User.join(username=username, email=email, password=password, name=name, provider_type_code=provider_type_code, provider_accounts_id=provider_accounts_id) if provider_accounts_thumbnail_image_url: provider_accounts_thumbnail_image_url_parsed = urlparse(provider_accounts_thumbnail_image_url) provider_accounts_thumbnail_image_file_name = os.path.basename( provider_accounts_thumbnail_image_url_parsed.path) response = urlopen(provider_accounts_thumbnail_image_url) io = BytesIO(response.read()) user.profile_img.save(provider_accounts_thumbnail_image_file_name, File(io)) else: user: User = qs.first() login(request, user) ``` ## 회원가입 ![회원가입](https://i.postimg.cc/VzHV0N8j/unknown.png) ```html {% extends "layout.html" %} {% load django_bootstrap5 %} {% block content %}

회원가입

{% endblock %} ``` ```py # accounts/forms.py class JoinForm(UserCreationForm): def __init__(self, *args, **kwargs): super().__init__(*args, **kwargs) self.fields['email'].required = True self.fields['name'].required = True self.fields['username'].label = '아이디' self.fields['profile_img'].widget.attrs['accept'] = 'image/png, image/gif, image/jpeg' class Meta(UserCreationForm.Meta): model = User fields = ['username', 'password1', 'password2', 'email', 'name', 'gender', 'profile_img'] def clean_email(self): email = self.cleaned_data.get('email') if email: qs = User.objects.filter(email=email) if qs.exists(): raise forms.ValidationError("이미 등록된 이메일 주소입니다.") return email ``` ## 상품키워드검색 ![상품키워드검색](https://i.postimg.cc/sgVZ4WZw/unknown.png) ```html {% extends "layout.html" %} {% load humanize %} {%block content %}

상품리스트 상품

{% if request.GET.search_keyword or request.GET.product_cate_item_id %}

{% if request.GET.search_keyword %} 검색어 `{{request.GET.search_keyword}}` {% endif %} {% if request.GET.product_cate_item_id %} 카테고리 `{{product_cate_item_name}}` {% endif %}

{% endif %}

VIEW MORE
{{product.market.name}} {{product.market.review_point|floatformat:"1"}} {{product.display_name}} {{ product.sale_price|intcomma }}원 {{ product.price|intcomma }}원 {{ product.colors|safe }} {% if product.picked_users %} {% endif %}

이전
이전
{{ page_number }}
{{page_number }}
다음
다음

{%endblock%} ``` ```py # proudcts/views.py # 일반사용자용 뷰 시작 # 상품 리스트 @require_GET def product_list(request: HttpRequest): # 카테고리 정보 product_cate_items = ProductCategoryItem.objects.all() # 필터요소 1, 검색어가 있다면 저장 search_keyword = request.GET.get('search_keyword', '') # 필터요소 2, 카테고리 아이템이 있다면 저장 product_cate_item_id = request.GET.get('product_cate_item_id', '') # 선택된 카테고리 아이템의 이름을 저장, 없으면 빈값 product_cate_item_name, = (product_cate_item.name for product_cate_item in product_cate_items if product_cate_item.id == int(product_cate_item_id)) if product_cate_item_id else tuple( ['']) # 페이징 page = request.GET.get('page', '1') products = Product \ .objects \ .prefetch_related('cate_item') \ .prefetch_related('product_reals') \ .prefetch_related('market') \ .order_by('-id') if request.user.is_authenticated: products = products \ .prefetch_related( Prefetch('product_picked_users', queryset=User.objects.filter(id=request.user.id), to_attr='picked_users')) if search_keyword: products = products.filter(display_name__icontains=search_keyword) if product_cate_item_id: products = products.filter(cate_item_id=product_cate_item_id) paginator = Paginator(products, 8) # 페이지당 10개씩 보여주기 products = paginator.get_page(page) return render(request, "products/product_list.html", { "products": products, "product_cate_item_name": product_cate_item_name, "product_cate_items": product_cate_items }) ``` --- # 기능테스트 ## 회원 - 회원가입 : 2022-02-22 - 회원가입환영메일 : 2022-02-22 - 카카오톡로그인 : 2022-02-22 - 카카오톡로그인 시 프로필이미지 가져오기 : 2022-02-22 - 로그인 : 2022-02-22 - 로그아웃 : 2022-02-22 - 정보수정 : 2022-02-22 - 아이디찾기 : 2022-02-22 - 비번찾기(비번리셋메일 발송) : 2022-02-22 - 팔로우, 팔로잉 : 2022-02-22 ## 상품 - 상품리스팅 : 2022-02-22 - 상품리스팅 페이징 : 2022-02-22 - 상품키워드검색 : 2022-02-22 - 상품카테고리검색 : 2022-01-22 - 상품찜하기 : 2022-02-22 ## 최종 관리자용 API - 상품 CRUD : 2022-02-22 ## 마켓 관리자용 API - 상품 CRUD : 2022-02-22 ## 엘라스틱서치검색 - 마켓명검색 : 2022-02-22 - 카테고리명검색 : 2022-02-22 - 상품상세내용검색 : 2022-02-23 - 초성검색 : 2022-02-22 - 자모검색 : 2022-02-24 ## 장바구니 - 장바구니 품목추가 : 2022-02-22 - 장바구니 품목리스팅 : 2022-02-22 - 장바구니 품목수량수정 : 2022-02-22 - 장바구니 품목삭제 : 2022-02-22 ## 마켓 - 마켓해시태그검색기능 : 2022-02-22 - 상품의 평점수정시 자동으로 평균평점값이 마켓에 반영 : 2022-02-22 ## 질문 - 상품에 질문을 달 수 있음 : 2022-02-22 - 제너릭 릴리에션으로, 어디에나 질문을 달 수 있도록 작업 : 2022-02-22 ## 서머노트 서포트 - 서머노트에 사용된 이미지 중, 사용하지 않는 이미지 자동제거 : 2022-02-22