HeuJung
3ebbda5d86
공개 (답변 중복 등록)/(문의 삭제 시 답변 잔존) 수정과 동형 결함 전수 해소.
- 문의 답변 단일성: 1차(피벗 is_answered) + 2차(게시판 리스너 duplicate 마커) 이중 방어,
경합 경로에서도 사유(reply_already_exists 422)가 보존되도록 훅 반환 계약 확장
- 질문·답변·피벗 생명주기 대칭: 삭제/복원/영구삭제 훅 연동 + 고아 데이터 백필 업그레이드 스텝
- 게시판별 답글 삭제 정책(cascade/block) 신설, 정렬 화이트리스트·per_page 게이트
(전량 조회 소비처 200/999 를 수용하는 상한 999 — 조였다가 관리자 화면 2곳 422 회귀 즉시 정정)
- 결제/본인인증 플러그인 검증 계약: FormRequest 15종 승격 + 컨트롤러 catch 정합.
거래 조회 tid 상한은 저장 컬럼(varchar 100) 기준 — 해외 CBT TID(40자) 수용
- onError 토스트 고정 문구 전수 해소(67건/50파일/15확장) — 서버 실패 사유를 그대로 표면화,
change-password 오변수(response→error) 교정
- 코어 플러그인 설정 검증 안내의 항목 표시명이 스키마 라벨(ko/en) 폴백에 덮여 요청 로케일
(ja) 라벨을 잃던 회귀 정정 — 번역 등록이 있으면 그것을 우선 (7.0.7 미출시 기능 자체 결함)
- 사전 결함 정리(Icon 등가표 27·darkmode 2·validated 통일), API 문서·CHANGELOG·ja 팩 동기
- develop(60652fdc0) 리베이스: getTable 정비와 병합 — 양측 의도 보존 (충돌 18파일)
3.0 KiB
3.0 KiB
Orders(주문 보조 조회) API 레퍼런스
소유: plugin
sirsoft-pay_nicepayments· 사람이 서술한 레퍼런스. 관리자 주문 화면과 사용자 영수증 화면이 쓰는 보조 조회 경로를 다룬다. 에스크로 결제 목록은 escrow.md, 거래 조회는 transaction.md 참조.
TL;DR (5초 요약)
1. 관리자 주문 목록 배지용 맵 2종(테스트모드 / 간편결제 표시)과 입금통보 이력, 사용자 영수증 조회
2. 관리자 경로는 auth:sanctum + permission:sirsoft-ecommerce.orders.read
3. 맵 2종은 최근 6개월의 나이스페이 결제 건만 집계한다 (주문 목록 배지 표시용)
4. 영수증 조회는 회원이면 본인 주문만, 비회원이면 X-Guest-Order-Token 검증으로 접근 제어
5. 응답 data 는 화면 표시용 경량 구조 — 주문 상세 데이터는 이커머스 API 가 담당
GET /api/plugins/sirsoft-pay_nicepayments/admin/orders/{orderNumber}/vbank-notifications
- 라우트명:
api.plugins.sirsoft-pay_nicepayments.orders.vbank-notifications - 컨트롤러:
AdminVbankNotificationController@show - 인증/권한:
auth:sanctum+permission:admin,sirsoft-ecommerce.orders.read
주문의 가상계좌 입금통보 수신 이력을 반환한다. 통보 수신 경로 자체는 vbank.md 참조. 주문이 없으면 실패 응답(success: false).
GET /api/plugins/sirsoft-pay_nicepayments/admin/orders/test-mode-map
- 라우트명:
api.plugins.sirsoft-pay_nicepayments.orders.test-mode-map - 컨트롤러:
AdminOrderListController@testModeMap - 인증/권한:
auth:sanctum+permission:admin,sirsoft-ecommerce.orders.read
최근 6개월 나이스페이 결제 건 중 테스트 모드 자격증명으로 결제된 주문의 맵을 반환한다. 주문 목록의 "테스트" 배지 표시용.
{ "success": true, "data": { "ORD-20260817-000001": true } }
GET /api/plugins/sirsoft-pay_nicepayments/admin/orders/easy-pay-display-map
- 라우트명:
api.plugins.sirsoft-pay_nicepayments.orders.easy-pay-display-map - 컨트롤러:
AdminOrderListController@easyPayDisplayMap - 인증/권한:
auth:sanctum+permission:admin,sirsoft-ecommerce.orders.read
최근 6개월 나이스페이 결제 건 중 간편결제(내장 PG) 표시 라벨이 있는 주문의 맵을 반환한다. 주문 목록이 결제수단 열에 간편결제 명칭(네이버페이 등)을 표시하는 데 쓴다.
GET /api/plugins/sirsoft-pay_nicepayments/user/orders/{orderNumber}/receipt
- 라우트명:
api.plugins.sirsoft-pay_nicepayments.user.orders.receipt - 컨트롤러:
UserReceiptController@show - 인증/권한:
optional.sanctum— 회원이면 본인 주문만, 비회원이면X-Guest-Order-Token헤더 검증
주문의 나이스페이 매출전표(영수증) URL 을 반환한다. 소유권 검증에 실패하면 대상 없음으로 처리된다(다른 사용자의 주문번호로는 조회 불가).