MAKITTDocs

지금 당장 할 일

docs/NOW.md

지금 당장 할 일

두 축

축 1: AI Native Shop Setup

현재 henriette shop은 DB에 데이터를 직접 밀어넣어 shop app이 full cycle로 동작하게 만든 것이다. 이 설정을, AI와 대화형으로 makitt-web에서 신규 가입 유저가 똑같이 할 수 있어야 한다.

축 2: 국제화 (i18n)

현재 henriette shop에서 한국어로 동작하는 모든 리소스 및 HCS에 정적/동적 번역이 적용되어야 한다.


Henriette Template이 사용하는 API 전체 목록

Resources

keyas (alias)params사용처
auth.mecustomerheader, account-dropdown
auth.socialLoginConfigsocialConfiglogin, signup
banner.bannerbannerid: {{$bannerId}}hero-banner, featured-product
blog.blogspostssize, categoryblog 목록, blog-shelf
blog.bySlugpostslug: {{url.params.slug}}blog 상세
cart.cartcartcart 페이지, header 카트 아이콘
cart.cartdrawerCartnav-drawer 카트
cart.quotequotecart 요약
cart.quotequotecartItemIds: {{form.values.selectedCartItemIds}}선택 아이템 견적
checkout.detailcheckoutid: {{url.params.checkoutId}}checkout 페이지
checkout.availableCouponsavailableCouponsid: {{checkout.checkoutId}}checkout 쿠폰
collection.bySlugcollectionslug: {{$collectionSlug}}컬렉션 헤더
collection.productsBySlugcollectionProductsslug, q, page, size컬렉션 상품 그리드
customer.addressesaddresses주소 관리
customer.countriescountries국가 목록
customer.fieldConfigfieldConfig주소 폼 필드 설정
customer.membershipmembership멤버십
customer.profileprofile프로필
customer.statsstats계정 통계
faq.faqsfaqssize, categoryFAQ
footer.configfooterConfigfooter
gallery.gallerygalleryid: {{$galleryId}}이미지 갤러리
market.i18nContexti18nContexti18n 모달
menu.byKeymenu, mobileMenukey: header-navheader, nav-drawer
notice.noticenoticeid: {{$noticeId}}공지 상세
notice.noticesnoticessize공지 목록
order.detailodid: {{$orderId}}주문 상세
order.listorderDatastartDate, endDate, page, size주문 내역
order.listrecentOrderssize마이페이지 최근 주문
order.statusCountsorderStats주문 상태 집계
payment.settingspaymentSettingscheckout 결제 수단
product.bySlugproductslug상품 상세
product.resolveresolveproductId, selections, quantityvariant 해석
review.mediaFeedmediaFeedlimit, sortBy리뷰 미디어 피드
review.mediaFeedModalmediaFeedModalq, limit, sortBy리뷰 릴스 모달
review.reviewsreviews, reviewsPageq, page, size, sortBy, mediaOnly, rating리뷰 목록
staticPage.bySlugpageslug정적 페이지

Domain Actions

action설명
auth.login로그인
auth.logout로그아웃
auth.oauthStartOAuth 시작
auth.signup회원가입
auth.verifyEmail이메일 인증
auth.resendVerificationEmail인증 이메일 재발송
cart.add장바구니 추가
cart.update장바구니 수량 변경
cart.remove장바구니 삭제
checkout.create체크아웃 생성
checkout.updateAddress배송지 저장
checkout.updateCountry국가 변경
checkout.updateShipping배송 옵션 변경
checkout.updatePaymentMethod결제 수단 변경
checkout.applyCoupon쿠폰 적용
checkout.removeCoupon쿠폰 해제
checkout.applyPoints적립금 적용
payment.prepare결제 준비
customer.updateProfile프로필 수정
address.search주소 검색
address.setDefault기본 주소 설정
address.delete주소 삭제
newsletter.subscribe뉴스레터 구독
i18n.update언어/국가 변경
emitfragment 간 이벤트 전달
fetchNext페이지네이션 다음 페이지
pagination페이지 이동
refreshShopContextshop context 갱신

Resource 뒤의 Entity (번역 대상)

ResourceEntity번역 필요 필드
product.bySlugProductname, description, seoTitle, seoDescription, variant/option 이름
banner.bannerBannerGrouptextLayers (title, subtitle, body), CTA text
blog.*Blogtitle, content, excerpt
notice.*Noticetitle, content
menu.byKeyMenuitem labels
faq.faqsFAQquestion, answer
collection.*Collectionname, description
review.*Reviewcontent (UGC — 번역 선택적)
staticPage.*StaticPagetitle, content
footer.configFooterConfig법적 텍스트, 링크 라벨
gallery.galleryGalleryalt text, caption
customer.fieldConfigFieldConfigfield labels, placeholders
payment.settingsPaymentSettings결제 수단 표시명
order.*Order상태 라벨 (시스템 번역)
checkout.*Checkout시스템 라벨 (시스템 번역)