MAKITTDocs

Signup Form

docs/hcs-asset/signup-form.md


id: 'signup-form' status: ready

Signup Form

Reference

  • URL: http://standard-commerce.makitt.localhost:3006/admin?component=signup-form
  • 위치: standard-commerce auth 진입 페이지의 회원가입 화면
  • 구조: 좌측 가입 폼 + 이메일 인증 단계 + 소셜 로그인 영역 + 우측 프로모션 이미지 패널
  • 시각 톤: white canvas, black CTA, beauty promo visual, thin borders

React Component

  • Path: apps/makitt-standard-commerce/src/components/assets/signup-form/
  • Status: implemented
  • 반응형: 데스크톱 2컬럼 / 모바일 단일 컬럼
  • i18n: ko, en, ja
  • API: shopApi.signupWithEmailPassword(), shopApi.verifyEmail(), shopApi.resendVerificationEmail(), shopApi.getSocialLoginConfig()

Prerequisites

makitt-server (shop-api)

고객 대면 API. shop storefront에서 호출.

APIMethodEndpointStatus
이메일 회원가입POST/shop/{shopId}/auth/signup/email-passwordavailable
이메일 인증POST/shop/{shopId}/auth/verify-emailavailable
인증 메일 재전송POST/shop/{shopId}/auth/resend-verification-emailavailable
소셜 로그인 설정 조회GET/shop/{shopId}/auth/social-login-config?marketCode={code}available

makitt-server (admin-api)

셀러가 회원가입/로그인 수단을 관리하는 API.

APIMethodEndpointStatus
로그인 설정 조회GET/api/v1/shops/{shopId}/auth/settingsavailable
기본 로그인 설정 수정PUT/api/v1/shops/{shopId}/auth/default-configavailable
마켓별 로그인 설정 수정PUT/api/v1/shops/{shopId}/auth/regions/{regionCode}available
provider 연결 정보 저장PUT/api/v1/shops/{shopId}/auth/providers/{provider}available

makitt-server (도메인/모델링)

항목내용Status
DynamoDB EntityShopAuthSettings — PK: SHOP#{shopId}, SK: AUTH_SETTINGSavailable
Domain ServiceShopAuthSettingsServiceavailable
ApplicationShopAuthApplication, ShopAuthSettingsApplicationavailable

makitt-web (셀러 어드민 UI)

기능설명Status
고객 로그인 설정 페이지/home/customers/settingsavailable
마켓별 기본/다른 로그인 수단 설정social config 제어available
소셜 로그인 연결 모달provider credential 저장/테스트available

makitt-shop (HCS 렌더링)

항목설명Status
form renderer회원가입/인증 폼 렌더링available
input, button, image, heading, icon rendererauth layout 구성available
auth.signup action회원가입 실행available
auth.verifyEmail action이메일 인증 실행available
auth.resendVerificationEmail action인증 메일 재전송available
setState, navigate actionverify step 전환, 홈 이동available

HCS Conversion Notes

  • 기본 단계는 auth.signup form, 성공 시 showVerify=true로 전환
  • verify 단계는 hidden email + code 입력으로 auth.verifyEmail 실행
  • social 로그인은 마켓별 설정 UI를 설명하는 정적 버튼 세트로 구성
  • “다른 로그인 수단”은 state 기반 accordion으로 처리
  • 우측 beauty promo image는 standard-commerce asset과 동일한 generated image 사용