bootpay 1.2.0 → 3.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9857f52bec71aa5dd18ebc6348be24579e75dcb786adad6179f9abe628363cc5
-  data.tar.gz: c45ef8873b722b9ff22a5edfec482be0ccd5b5c953733d48d5e9b31a6bd4f62d
+  metadata.gz: c451a531a23a1a127987e92afb1980687ebd31a484326da574520dc41e78da87
+  data.tar.gz: 0d0e6b71cd59143809355360bedd0f9f43da13a6a02cf9c9d8952edbecb6c7d0
 SHA512:
-  metadata.gz: aff54ec2aa4f15e611171cc5741a5f7c3d1d9d67c3dc846db396d11c13339b93ec4c1be02fc90bf0d6340ab8620ec5c61c8207b4cbfd3518f4511dcf6dcf368c
-  data.tar.gz: 6bbb59991a54f12a2b260dac55c71c043ad5da7e3d65e6f67e10f7cf22bc30072be912678afb31da4bb940482657bac530ba2bb5b0e7d8778319643e716fffbd
+  metadata.gz: 0ff9f2a74b66f0644633b605edff8e440ea29546cffba5cf7432597ea5b6ebbf8172cdc1598989b64d48c3bfd5091cbe9cec4f048965ccd032e93328faf5a4f6
+  data.tar.gz: 9ef546f66306f41e58e8fcaffc5ac1595eab60140056a1552d8a0f7b78ecd27c6c7843803fb1015149d4b86ac98a22d3350be6e1146eccd42514cedf4a146c41

data/.gitignore

@@ -7,18 +7,17 @@
 /spec/reports/
 /tmp/
 
-
 # rspec failure tracking
 .rspec_status
 *.idea
 *.iml
-Gemfile.lock
 *.gem
-
-# Environment files
+Gemfile.lock
+/spec/bootpay/card_billing/request_rest_billing_key_spec.rb
+/spec/bootpay/__stage_test_unit_spec.rb
+/spec/bootpay/__development_test_unit_spec.rb
+/spec/bootpay/
+.DS_Store
+# 실 API 키가 들어가는 로컬 설정 — 커밋 금지 (26-08-24 추가)
 .env
-.env.*
-!.env.example
-
-# Tool runtime dirs
-.omj/
+.env.local

data/.rspec

@@ -1 +1,3 @@
+--format documentation
+--color
 --require spec_helper

data/CHANGELOG.md

@@ -1,31 +1,117 @@
-### 1.2.0
-- NodeJS @bootpay/backend-js@2.6.0 기준 PG API parity 보완. 신규 11개 메서드 추가 (기존 메서드 시그니처/URL 불변, 백워드 호환 유지).
-  - 본인인증: `request_authentication`, `confirm_authentication`, `realarm_authentication`
-  - 현금영수증: `cash_receipt_publish_on_receipt`, `cash_receipt_cancel_on_receipt`, `request_cash_receipt`, `cancel_cash_receipt`
-  - 자동이체 빌링키: `request_subscribe_automatic_transfer_billing_key`, `publish_automatic_transfer_billing_key`
-  - 단일 조회: `lookup_billing_key`, `subscribe_payment_reserve_lookup`
-- `Bootpay::Rest#request` 에 `params:` 옵션 추가 — DELETE 의 query-string (현금영수증 취소의 `cancel_username` / `cancel_message`) 등에 사용. 기존 호출은 영향 없음.
+### 3.1.0
 
-### 1.0.6 
-- request_link api 에 주석 추가 
+- 커머스 게시판 API 28종 SDK 메서드 추가 — FAQ · 공지사항 · 1:1 문의 · 상품문의(Q&A) · 상품평.
+  `BootpayStore::RestClient` 에 아래 메서드가 생긴다.
+  - FAQ(5): `faqs` `faq_detail` `faq_create` `faq_update` `faq_delete`
+  - 공지사항(5): `notices` `notice_detail` `notice_create` `notice_update` `notice_delete`
+  - 1:1 문의(6): `inquiries` `inquiry_detail` `inquiry_create` `inquiry_update` `inquiry_delete` `inquiry_answer`
+  - 상품문의(6): `product_qnas` `product_qna_detail` `product_qna_create` `product_qna_update` `product_qna_delete` `product_qna_answer`
+  - 상품평(6): `reviews` `review_detail` `review_create` `review_update` `review_delete` `review_reply`
+  공통 규칙: 목록·단건·삭제 조회 계열은 `supervisor: true` 를 주면 운영자 모드(`Bootpay-Role: supervisor`)로
+  비공개·숨김 글까지 다루고, 기본값은 고객 모드다. 등록·수정 계열 중 `faq_*` · `notice_*` 와
+  `*_answer` / `review_reply` 는 운영자 전용이다. 회원 대상 메서드는 `user_id` · `login_id` · `user_jwt`
+  중 하나로 회원을 지정하며, `product_qna_create` 는 몰이 허용할 때 `guest_name` + `guest_password` 로
+  비회원 작성도 된다. 모든 메서드가 `idempotency_key` 를 받고 안 주면 UUID 를 자동 생성한다.
+  기존 상품 상세의 공개 상품평 목록(`GET /v1/products/:id/reviews`)은 그대로 쓴다.
+- `alimtalk_send` / `alimtalk_send_bulk` 에 `webhook_url` 인자 추가(선택). 주면 그 건(bulk 는 요청 전체)의
+  발송 성공·실패·문자 대체발송·예약취소 웹훅이 **이 주소로만** 가고 프로젝트 웹훅 설정은 쓰이지 않는다.
+  `https` 만 허용하며 2,000자를 넘으면 `3028` 로 거부된다(bulk 는 요청 전체가 거부). 서명은 프로젝트
+  시크릿으로 하며, 시크릿만 필요하면 `alimtalk_webhook_rotate_secret` 으로 설정 없이 발급받을 수 있다.
+  ⚠️ 같은 `ref_id` 로 이미 접수·성공한 건을 다시 요청하면 기존 접수가 그대로 돌아와 새 주소는 무시된다.
+  기본값이 `nil` 이라 기존 호출은 그대로 동작한다.
+- 알림톡 API(`alimtalk_*` 메서드 35종) 요청 호스트 변경 — `/alimtalk/*` 경로는 커머스 API(`api.bootapi.com/v1`)가
+  아니라 메시지 API(`message.bootapi.com`, 경로에 `/v1` 없음)로 보낸다. development 는 `dev-m.bootapi.com`,
+  stage 는 `stage-m.bootapi.com`. 경로·파라미터·응답은 그대로이며 메서드 시그니처 변경 없음.
+  옛 주소(`api.bootapi.com/v1/alimtalk/*`)는 410 으로 응답한다.
+- `BootpayStore::RestClient::MESSAGE_API` 상수와 `set_message_api_url(url)` 추가 — 알림톡 호스트만 따로 바꿀 수 있다.
+  그 외 API 는 기존처럼 `API` / `set_api_url` 을 쓴다.
 
-### 1.0.5
-- model별 주석 추가, extra에 불필요한 파라미터 제거
+### 3.0.1
 
-### 1.0.4
+`bootpay` 이름으로 낸 3.0.0 을 실제 배포본으로 점검하다 나온 수정 2건. **API 변경 없음.**
 
-- cancel에 refund 형식 수정 
+- `basic_or_request_access_token` 이 항상 `Bootpay::Response` 를 돌려준다.
+  client_key/secret_key 를 쓰면 Basic Auth 라 토큰 요청이 필요 없는데, 그 분기에서
+  `success?` 만 정의된 **맨 `Object`** 를 돌려주고 있었다. 다른 메서드처럼 `.data` 를 부르면
+  `NoMethodError` 로 죽는다. `success?` 동작은 그대로다(둘 다 true).
+- gemspec 의 `required_ruby_version` 제거. 3.0.0 에서 `>= 2.6.0` 으로 선언했는데 **근거 없는
+  추정값**이었다 — 실제 의존성 체인은 그보다 높은 Ruby 를 요구한다. 정확한 하한을 확인하기 전까지
+  잘못된 값을 박아 두는 대신 선언하지 않는다(3.0.0 이전과 같은 상태).
+- Gemfile 주석의 옛 gemspec 파일명 정정.
 
-### 1.0.3 
+검증(development, 읽기 전용): PG 토큰·Commerce 토큰·상품 조회·알림톡 수신거부/발신프로필 조회가
+모두 도메인 응답으로 성공. 알림톡 메서드 35개 로드 확인.
 
-- BankCode 추가
+### 3.0.0
 
-### 1.0.2
-- certificate data type application/json 으로 수정
+2025-03 부터 alpha.1~alpha.4 로 쌓아 온 3.0 라인을 **정식 릴리스**한다.
 
-### 1.0.1
-- namespace 변경  
+#### ⚠️ gem 이름이 `bootpay` 로 바뀐다
 
-### 1.0.0
+이 버전부터 **정본 gem 은 `bootpay`** 다. 같은 코드가 `bootpay-backend-ruby` 3.0.0 으로도
+배포돼 있지만, **앞으로 신규 릴리스는 `bootpay` 로만 나간다.**
 
-- 첫 배포 
+```ruby
+# Gemfile
+gem 'bootpay', '~> 3.0'
+```
+```bash
+$ gem install bootpay
+```
+
+- **`bootpay-backend-ruby` 사용자**: `require 'bootpay-backend-ruby'` 는 계속 동작한다
+  (호환 진입점을 남겨 두었다). Gemfile 만 `gem 'bootpay'` 로 바꾸면 코드 변경은 없다.
+  기존 `bootpay-backend-ruby` 버전들은 RubyGems 에 그대로 남지만 갱신되지 않는다.
+- **`bootpay` 1.x 사용자**: ⚠️ 1.x 와 3.0.0 은 **계보가 다르다.** 진입 클래스부터 바뀐다
+  (`Bootpay::Api` → `Bootpay::RestClient`). 1.x 를 계속 쓰려면 `gem 'bootpay', '~> 1.2'`
+  로 버전을 고정하면 된다. 두 계보는 파일 경로가 겹치지 않는다.
+- `Bootpay::VERSION` 이 정본 상수다. `Bootpay::V2_VERSION` 은 같은 값을 가리키는 별칭으로 남는다.
+
+#### 추가
+- **알림톡 v1 API 35종** — 발송·발송내역·공식 카탈로그·자체 템플릿·발신프로필·수신거부·알림톡 웹훅 7개 모듈
+  - 알림톡 요청은 `Idempotency-Key` 를 싣지 않는다 (멱등은 발송의 `ref_id` 로만 성립)
+  - `Bootpay-Role` 은 항상 `user` (스코프 키가 전부 `user:alimtalk_*`)
+  - ⚠️ **샌드박스가 없다** — 발송·OTP·발신프로필 등록·템플릿 등록/검수는 실제로 나가고 과금된다
+  - ⚠️ 템플릿 버튼은 **등록 API 와 발송 API 의 키 이름이 다르다**.
+    등록은 `linkType`·`linkMo`·`linkPc`·`linkIos`·`linkAnd` 를 쓴다
+    (발송 포맷 `type`·`url_mobile` 로 보내면 서버가 거부한다)
+- Commerce store 모듈 — mall_setting · order · order_subscription · supervisor · user ·
+  user_group · product · invoice · payment · webhook
+- 내부용 storage 모듈
+
+#### 변경
+- 별건 현금영수증의 `pg` 를 **선택 파라미터**로 (미지정 시 가맹점에 설정된 기본 PG 로 발행).
+  종전에는 필수라 기본 PG 를 쓰려는 가맹점도 PG명을 적어 넣어야 했다.
+
+#### 배포 산출물
+- gemspec 이 루트의 `tests_*.rb` · `*.gem` · `.env*` 도 제외한다.
+  종전 규칙은 `test/`·`spec/`·`features/` **디렉터리**만 걸러서, 루트의
+  `tests_basic_auth_product_info.rb` 가 dev Commerce 키를 하드코딩한 채 gem 에 실려 나갔다.
+- 해당 스크립트는 `BP_CLIENT_KEY`/`BP_SECRET_KEY` 환경변수 전용으로 바뀌었다.
+
+#### 알려진 사항
+- spec 스위트는 dev 서버 라이브 호출 기반이라 오프라인 회귀 게이트가 아니다.
+
+### 3.0.0-alpha.4
+- 알림톡 v1 API 35종 추가 — 발송·발송내역·공식 카탈로그·자체 템플릿·발신프로필·수신거부·알림톡 웹훅 7개 모듈
+  - 알림톡 요청은 `Idempotency-Key` 를 싣지 않는다 (멱등은 발송의 `ref_id` 로만 성립)
+  - `Bootpay-Role` 은 항상 `user` (스코프 키가 전부 `user:alimtalk_*`)
+  - ⚠️ 샌드박스가 없다 — 발송·OTP·발신프로필 등록·템플릿 등록/검수는 실제로 나가고 과금된다
+- 별건 현금영수증의 `pg` 를 선택 파라미터로 (미지정 시 가맹점 기본 PG 로 발행)
+- mall_setting · order_subscription · supervisor · user · user_group · product · invoice ·
+  payment · order · store · webhook · storage 모듈 확충
+- alpha.3(2025-03-27) 이후 63커밋 누적분을 릴리스한다
+
+### 3.0.0-alpha.1
+- store api 추가
+- 내부용 storage api 추가
+
+### 2.0.5
+- 빌링결제 api 추가 
+- 계좌 빌링 결제 api 추가 
+
+### 2.0.1
+- readme update and republish
+
+### 2.0.0 
+- v1 -> v2 update 

data/CODE_OF_CONDUCT.md

@@ -39,7 +39,7 @@ This Code of Conduct applies within all community spaces, and also applies when
 
 ## Enforcement
 
-Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the community leaders responsible for enforcement at rupy1014@gmail.com. All complaints will be reviewed and investigated promptly and fairly.
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the community leaders responsible for enforcement at gosomi@udid.co.kr. All complaints will be reviewed and investigated promptly and fairly.
 
 All community leaders are obligated to respect the privacy and security of the reporter of any incident.
 

data/Gemfile

@@ -7,6 +7,4 @@ gemspec
 
 gem "rake", "~> 13.0"
 
-# gem "rubocop", "~> 1.7"
-gem "rspec", "~> 3.0"
-
+gem "rspec", "~> 3.0"

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2021 bootpay
+Copyright (c) 2021 gosomi
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal