From 2b3d8649ba15186ad6ea669379cb8b40ed32f5c0 Mon Sep 17 00:00:00 2001 From: thug0bin Date: Wed, 25 Feb 2026 09:34:41 +0900 Subject: [PATCH] =?UTF-8?q?feat:=20=ED=9A=8C=EC=9B=90=EA=B0=80=EC=9E=85=20?= =?UTF-8?q?=ED=8E=98=EC=9D=B4=EC=A7=80=20=EC=B6=94=EA=B0=80=20+=20?= =?UTF-8?q?=EC=B9=B4=EC=B9=B4=EC=98=A4=20=EC=A0=84=ED=99=94=EB=B2=88?= =?UTF-8?q?=ED=98=B8=20=EC=8B=A0=EC=B2=AD=20=EB=AC=B8=EC=84=9C?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - /signup 회원가입 페이지 (이름 + 전화번호 + 개인정보 동의) - /api/signup API (get_or_create_user + 세션 저장) - 카카오 간편 가입 버튼 (카카오 로그인으로 가입) - 홈 화면에 회원가입 메뉴 추가 - 이미 로그인 시 /signup 접근하면 마이페이지로 리다이렉트 - 카카오 전화번호 수집 신청용 수집 사유 + 시나리오 문서 Co-Authored-By: Claude Opus 4.6 --- backend/app.py | 39 +++ backend/templates/index.html | 8 + backend/templates/signup.html | 482 ++++++++++++++++++++++++++++++++++ docs/kakao-phone-request.md | 79 ++++++ 4 files changed, 608 insertions(+) create mode 100644 backend/templates/signup.html create mode 100644 docs/kakao-phone-request.md diff --git a/backend/app.py b/backend/app.py index f9b5c27..7838416 100644 --- a/backend/app.py +++ b/backend/app.py @@ -535,6 +535,45 @@ def index(): ) +@app.route('/signup') +def signup(): + """회원가입 페이지""" + if 'logged_in_user_id' in session: + return redirect(f"/my-page?phone={session.get('logged_in_phone', '')}") + return render_template('signup.html') + + +@app.route('/api/signup', methods=['POST']) +def api_signup(): + """회원가입 API""" + try: + data = request.get_json() + name = data.get('name', '').strip() + phone = data.get('phone', '').strip().replace('-', '').replace(' ', '') + + if not name or not phone: + return jsonify({'success': False, 'message': '이름과 전화번호를 모두 입력해주세요.'}), 400 + + if len(phone) < 10: + return jsonify({'success': False, 'message': '올바른 전화번호를 입력해주세요.'}), 400 + + user_id, is_new = get_or_create_user(phone, name) + + # 세션에 유저 정보 저장 + session.permanent = True + session['logged_in_user_id'] = user_id + session['logged_in_phone'] = phone + session['logged_in_name'] = name + + return jsonify({ + 'success': True, + 'message': '가입이 완료되었습니다.' if is_new else '이미 가입된 회원입니다. 로그인되었습니다.', + 'is_new': is_new + }) + except Exception as e: + return jsonify({'success': False, 'message': f'오류가 발생했습니다: {str(e)}'}), 500 + + @app.route('/claim') def claim(): """ diff --git a/backend/templates/index.html b/backend/templates/index.html index 0e3e9c0..94e9d00 100644 --- a/backend/templates/index.html +++ b/backend/templates/index.html @@ -340,6 +340,14 @@
›
+ +
📝
+
+
회원가입
+
전화번호 + 이름으로 간편 가입
+
+
›
+
📊
diff --git a/backend/templates/signup.html b/backend/templates/signup.html new file mode 100644 index 0000000..6295113 --- /dev/null +++ b/backend/templates/signup.html @@ -0,0 +1,482 @@ + + + + + + + + + + + + + 회원가입 - 청춘약국 + + + + + + +
+
+
회원가입
+ 홈으로 +
+ + +
+
+
회원가입
+
+ 청춘약국 마일리지 서비스에 가입하세요.
+ 영수증 QR 스캔으로 포인트를 적립할 수 있습니다. +
+ +
+
+ + +
+ +
+ +
+ 010 - + +
+
+ +
+ +
+ + +
+ +
또는
+ + + + + + 카카오로 간편 가입 + + +
+ +
+ 개인정보 처리방침 +
+
+
+ + +
+
+ + + +
+
가입 완료!
+
+
+ 홈으로 + 내 마일리지 +
+
+
+ + + + diff --git a/docs/kakao-phone-request.md b/docs/kakao-phone-request.md new file mode 100644 index 0000000..b6a73a5 --- /dev/null +++ b/docs/kakao-phone-request.md @@ -0,0 +1,79 @@ +# 카카오 개인정보 동의항목 - 전화번호 수집 신청 + +## 수집 사유 (신청 폼에 입력할 내용) + +``` +청춘약국 마일리지 적립 서비스에서 고객 식별을 위해 전화번호가 필요합니다. + +[서비스 개요] +오프라인 약국(청춘약국)에서 의약품 구매 시 영수증 QR 코드를 스캔하면 +구매금액의 3%를 마일리지 포인트로 적립해주는 서비스입니다. + +[전화번호가 필요한 이유] +1. 고객 식별: 동일 고객의 마일리지를 하나의 계정으로 통합 관리하기 위해 + 전화번호를 고유 식별자로 사용합니다. +2. 포인트 조회: 고객이 마이페이지에서 자신의 적립 내역과 잔액을 + 전화번호로 조회합니다. +3. 오프라인 연계: 약국 방문 시 포인트 사용을 위해 전화번호로 + 본인 확인이 필요합니다. + +[현재 상황] +전화번호를 카카오에서 받지 못하는 경우, 카카오 로그인 후 +별도의 전화번호 입력 화면을 추가로 거쳐야 합니다. +카카오 계정의 전화번호를 직접 받을 수 있으면 입력 단계를 +생략하여 사용자 경험이 크게 개선됩니다. + +[수집 범위] +- 수집 항목: 전화번호 (카카오 계정에 등록된 번호) +- 이용 목적: 마일리지 적립 계정 식별 및 포인트 조회 +- 보유 기간: 회원 탈퇴 시까지 +- 제3자 제공: 없음 +``` + +## 회원가입 시나리오 (회원가입 화면 설명용) + +### 시나리오 1: 카카오 로그인으로 QR 적립 (메인 플로우) + +``` +1. 고객이 약국에서 의약품 구매 후 영수증을 받음 +2. 영수증에 인쇄된 QR 코드를 스마트폰 카메라로 스캔 +3. https://mile.0bin.in/claim?t=거래번호:인증코드 페이지 이동 +4. "카카오로 적립하기" 버튼 클릭 +5. 카카오 로그인 동의 화면 표시 (닉네임, 프로필, 이메일, 이름, 전화번호) +6-A. [전화번호 수집 가능 시] → 자동으로 마일리지 적립 완료 +6-B. [전화번호 미수집 시] → 전화번호 입력 화면으로 이동 → 수동 입력 후 적립 +7. 적립 완료 화면 표시 (적립 포인트, 총 잔액) +``` + +### 시나리오 2: 카카오 로그인으로 마이페이지 조회 + +``` +1. https://mile.0bin.in 접속 +2. "카카오로 시작하기" 클릭 +3. 카카오 로그인 → 카카오 ID로 기존 회원 매칭 +4. 마이페이지 이동 (적립 내역, 포인트 잔액 확인) +``` + +### 시나리오 3: PWA 앱에서 자동 적립 (재방문 고객) + +``` +1. 이전에 카카오 로그인으로 적립한 이력이 있는 고객 +2. 홈 화면의 "청춘약국" PWA 앱에서 QR 스캔 +3. 세션이 유지되어 있으므로 입력 없이 자동 적립 완료 +``` + +## 제출 체크리스트 + +- [x] 회원가입 링크: `https://mile.0bin.in` +- [x] 개인정보 처리방침: `https://mile.0bin.in/privacy` +- [ ] 회원가입 화면 스크린샷: 카카오 로그인 버튼이 보이는 적립 화면 캡처 + - `/claim?t=거래번호:인증코드` 페이지 또는 메인 페이지 캡처 + - 개인정보가 보이면 마스킹 필요 +- [ ] 수집 사유: 위 텍스트 복사하여 입력 + +## 스크린샷 촬영 가이드 + +회원가입 화면으로 제출할 스크린샷: +1. `https://mile.0bin.in` 메인 페이지 캡처 (카카오로 시작하기 버튼 포함) +2. 또는 적립 페이지 `/claim?t=xxx` 캡처 (카카오로 적립하기 버튼 + 개인정보 동의 체크박스 포함) +3. 캡처 시 개인정보(전화번호 등)가 보이면 마스킹 처리