PRD: 와디즈 펀딩용 대량 재고 카드 + 어드민 재고 운영
- 상태: In progress (2026-07-30)
- 작성자: / 리뷰어:
- 관련 문서: frontmatter
related:참조
1. 배경과 문제 정의
와디즈 펀딩으로 NFC 카드만 단독 판매한다. 와디즈는 메이커에게 구매자 이름·이메일을 제공하지 않으므로 계정을 미리 만들어 배정할 수 없다 — 카드는 주인 없는 상태로 배송되고, 받은 사람이 첫 태그로 선점해 소유를 확정한다(기존 셀프 선점 기능). 추후 자사몰 판매도 같은 모델을 쓴다.
현재 어드민은 카드를 1장씩만 발급할 수 있고, 미연결 카드 목록이 2열 그리드라 수백 장 재고 운영이 불가능하다. 카드와 와디즈 주문을 잇는 기록 수단도 없다.
2. 목표
- 관리자가 재고 카드를 한 번에 대량 생성(1~500장)할 수 있다. 전 장
IN_STOCK+ 셀프 선점 개방이 기본. - 생성 직후 제작업체 전달용 CSV(라벨, NFC URL)를 내려받을 수 있다 — 업체는 이 URL만 카드에 인코딩한다.
- 관리자가 카드마다 비고(와디즈 주문번호 등)를 기록·수정·검색할 수 있다. 선점 이후에도 수정 가능.
- 어드민이 재고 수백 장을 운영할 수 있는 화면이 된다: 상태 퍼널, 검색, 전폭 단일 테이블, 비고 인라인 편집.
3. 비목표
- 와디즈 주문 CSV 업로드(추후 확장), 사용자 쪽 주문번호 입력, 배치 엔티티·주문 도메인, 목록 페이징(500장 규모), 판매 채널 필드, 선점 시 본인 확인 절차 추가.
4. 정책·도메인 결정
- 소유 확정 = 첫 태그 선점 그대로. 실물 소지가 곧 증명이다. 와디즈가 구매자 정보를 주지 않아 다른 검증 수단도 없다. 선점 플로우(FE·BE) 무변경.
- 주문번호는 물리 카드에 박지 않는다. DB 비고(
memo)로만 기록하며 메인 소스는 와디즈다. 어드민만 입력하고, 상태 무관 수정을 허용한다 — 선점 뒤 구매자가 CS 채널로 주문번호를 알려오면 그때 매핑하는 게 주 경로다. - 커스텀 디자인 흐름: 구매자 디자인은 와디즈로 수집 → 어드민이 비고(주문번호)로 카드를 찾아 기존 커스텀 명함 이미지 기능으로 등록.
- 배치 구분은 라벨 prefix가 대신한다 (
WDZ1-001…). 별도 배치 테이블 없음 — prefix 검색이 곧 배치 필터. - 환불·폐기는 기존 논리 삭제로 처리. 삭제된 카드는 태그 시 사용 불가 안내로 빠진다.
5. 직무별 관점
| 직무 | 핵심 관심사·제약 | 관련 문서 |
|---|---|---|
| 기획 | 와디즈 CS 추적은 비고 매핑 정확도에 의존 — 강제 아닌 운영 규율 | |
| 디자인 | 재고 테이블은 전폭 단일 열(기존 2열 그리드 폐기), 비고 인라인 편집 | |
| FE | 어드민 2메뉴 재설계(재고 운영/회원 카드), CSV는 FE 생성 | |
| BE | 대량 생성은 단일 트랜잭션, 비고는 공개 응답에 노출 금지(어드민 전용) | nfc-card |
6. 시스템 흐름과 API 연결
대량 생성 → CSV로 제작 발주 → 배송 → 구매자 첫 태그 선점 → (CS로 주문번호 수신) → 어드민 비고 기록 → 디자인 등록.
| API | 역할 |
|---|---|
POST /v1/admin/nfc-cards/bulk | 재고 카드 대량 생성 — count(1~500), labelPrefix, selfClaimable(기본 true). 라벨 PREFIX-001…N |
PUT /v1/admin/nfc-cards/{cardId}/memo | 비고 기록·수정·삭제(null). 상태 무관 허용 |
GET /v1/admin/nfc-cards | 기존 query 검색에 비고 매칭 추가 |
계약 상세는 tapple-be openapi.yaml 참조.
어드민 화면: 사이드바 2메뉴(재고 운영 / 회원 카드). 재고 운영이 기본 화면 — 상태 퍼널 타일(재고·개방·선점·연결), 검색(라벨/토큰/비고), 상태 필터, 전폭 테이블(라벨·상태·선점개방 토글·비고 인라인 편집·URL 복사·생성일·액션), 대량 생성 다이얼로그(완료 시 CSV 다운로드). 회원 카드 메뉴는 기존 사용자 테이블 이동.
7. 열린 질문
- 한 회원이 여러 장 선점 가능(현행 미제한) — 커스텀 이미지의 1인 1카드 전제와 충돌 여지. 와디즈에서 다량 구매자 나오면 재검토.
- 자사몰 판매 시작 시 주문 도메인(결제 연동) 필요 여부.
8. 변경 이력
| 날짜 | 변경 내용 | 변경자 |
|---|---|---|
| 2026-07-30 | 최초 작성 | AI |