[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CBMHS205DX1XG3PKJ59VBA":3,"skill-same:01M6CBMHS205DX1XG3PKJ59VBA":65},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":22,"publishedAt":26,"linkOnly":27,"markdownContent":28,"markdownBody":28,"frontMatter":29,"refName":30,"commitSha":31,"skillDirectory":32,"forksCount":13,"repositoryHtmlUrl":33,"repositoryHomepageUrl":6,"ownerHtmlUrl":34,"ownerBlogUrl":6,"ownerDescription":35,"updatedAt":36,"install":37,"resources":50},"01M6CBMHS205DX1XG3PKJ59VBA","43-purchase-client-server-integration",null,"devwinsoft\u002Fdevian","devwinsoft","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F22570160?v=4","01M6C6RR8W05NH8NPKQNCE3Q72","maoshy","01M6C6RRDJ5TJJCZXRTY801YDH",0,"MIT","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian-unity\u002F50-mobile-package\u002F30-purchase-system\u002F43-purchase-client-server-integration\u002FSKILL.md",[17],{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000010","后端与接口","SCENARIO","使用场景",[23,24,25],"integration","server","43 purchase client server integration","2026-11-10 10:12:30",false,"# 43-purchase-client-server-integration — Client ↔ Server Calls (Verify\u002FSync)\n\nStatus: ACTIVE\nAppliesTo: v10\n\n> Purchase SSOT: `skills\u002Fdevian-unity\u002F50-mobile-package\u002F30-purchase-system\u002F03-ssot\u002FSKILL.md` (C 섹션 \"Callable 권장\", 필드 매핑)\n\n## 목적\n\n`PurchaseManager`의 스텁:\n- `VerifyPurchaseAsync`\n- `AckPurchaseClientGrantAsync`\n- `SyncEntitlementsAsync` (server entitlements restore)\n를 어떤 호출 방식으로 서버(Functions)에 연결할지 \"정본\"으로 고정한다.\n\n또한 `ConfirmPurchase` 호출 타이밍을 SSOT 기준으로 하드룰로 고정한다.\n\n\n---\n\n\n## A. 호출 방식 (정본) — ✅ 확정: Firebase Functions Callable\n\n- **Firebase Functions Callable**을 사용한다.\n- SDK: `Firebase.Functions` (Firebase Unity SDK 13.7.0, `Firebase.Functions.dll`)\n- 호출 패턴:\n  - `FirebaseFunctions.DefaultInstance.GetHttpsCallable(functionName)`\n  - `.CallAsync(data)` → `HttpsCallableResult` → `.Data` (Dictionary)\n- `uid`는 Firebase Auth context에서 자동 전달된다 (클라가 명시적으로 보내지 않음).\n\n\n---\n\n\n## B. 요청\u002F응답 매핑 (정본)\n\nSSOT의 \"C# ↔ Callable 필드 매핑\"을 그대로 따른다.\n\n- 요청 키:\n  - `storeKey`, `internal_product_id`, `kind` (`\"Consumable\" | \"Rental\" | \"Subscription\" | \"SeasonPass\"`), `payload`\n- 응답 키:\n  - `resultStatus`, `purchaseId`, `verifyStatus`, `clientGrantStatus`, `storeConfirmStatus`, `grants`, `entitlementsSnapshot`\n\n- ACK(로컬 지급 결과 보고) 요청 키:\n  - `purchaseId`, `clientGrantStatus`\n- ACK 응답 키:\n  - `purchaseId`, `verifyStatus`, `clientGrantStatus`, `storeConfirmStatus`\n- Confirm ACK 요청\u002F응답 키:\n  - 요청: `purchaseId`\n  - 응답: `purchaseId`, `verifyStatus`, `clientGrantStatus`, `storeConfirmStatus`\n\n\n---\n\n\n## C. ConfirmPurchase 타이밍 (하드룰)\n\n클라이언트는 서버 응답의 `resultStatus`와 `clientGrantStatus`에 따라\nConfirm\u002FACK\u002F로컬 지급 순서를 결정한다.\n\n계정\u002FSKU 잠김(`already owned`) 방지를 위해 **`ConfirmPurchase` + `ackPurchaseStoreConfirm`을 로컬 지급\u002F`ackPurchaseClientGrant`보다 앞에 둔다.**\n\n- `GRANTED`\n  - `ConfirmPurchase(pendingOrder)` → `ackPurchaseStoreConfirm` **먼저 실행** (스토어 잠김 방지 우선)\n  - 이후 로컬 지급 → `ackPurchaseClientGrant(APPLIED_ACKED)` 수행\n  - `PurchaseStorage.current`는 `Confirm + storeConfirm ACK + clientGrant report` 종결 후 clear\n  - 로컬 지급 실패 → `ackPurchaseClientGrant(FAILED_REPORTED)` 보고 가능, 단 `storeConfirmStatus != CONFIRMED`이면 clear 금지\n- `ALREADY_GRANTED`\n  - `storeConfirmStatus == PENDING`이고 로컬에서 이미 Confirm 완료(`storeConfirmedLocal`) 상태면 `ackPurchaseStoreConfirm` 복구 먼저 수행\n  - `clientGrantStatus == APPLIED_ACKED` → 중복 지급 없이 Confirm\u002FACK 복구만 진행\n  - `clientGrantStatus == PENDING` 또는 `FAILED_REPORTED` → 로컬 지급 복구 재시도 허용 → APPLIED_ACKED 보고\n  - `PurchaseStorage.current`는 복구 단계가 모두 종결될 때만 clear\n- `REJECTED` (영구 거부) → `ConfirmPurchase(pendingOrder)`로 pending order 소비 후 종료 (Consumable\u002FRental 재구매 잠김 방지)\n- `PENDING` → Confirm **하지 않음** (스토어 확정 대기)\n- `REVOKED` \u002F `REFUNDED` → Confirm 하지 않음\n\n(SSOT의 resultStatus 규칙과 불일치하면 이 문서\u002F코드가 아니라 SSOT를 기준으로 수정한다.)\n\n또한 로컬 지급은 `GRANTED` 또는 `ALREADY_GRANTED + clientGrantStatus == PENDING\u002FFAILED_REPORTED` 복구 경로에서만 수행한다.\nReward는 지급 실행만 담당하며, 멱등\u002F복구 판단은 PurchaseManager(+서버 상태) 기준으로 한다.\n\n\n---\n\n\n## C2. purchaseAndVerifyAsync 반환값 규칙 (하드룰)\n\n`purchaseAndVerifyAsync`는 서버 `resultStatus`에 따라 반환 타입을 구분해야 한다.\n\n- `GRANTED` \u002F `ALREADY_GRANTED` → `GameResult.Success(PurchaseFinalResult)` 반환\n- `REJECTED` \u002F `PENDING` \u002F `REVOKED` \u002F `REFUNDED` → `GameResult.Failure(...)` 반환\n\n호출자가 `IsSuccess`만으로 지급 여부를 판단할 수 있어야 한다.\n\n> ~~**현재 코드 위반**~~ → ✅ **수정됨**: `GRANTED`\u002F`ALREADY_GRANTED`만 `Success`, 나머지는 `Failure` 반환.\n\n\n---\n\n\n## C3. 최근 구매 조회 (kind 파라미터)\n\n- Client: `PurchaseManager.GetLatestConsumablePurchase30dAsync()`\n- Server: `getRecentPurchases30d` (`kind=\"Consumable\"`, `pageSize=1`)\n- 서버가 \"최근 30일\"을 계산한다. 클라\u002F기기 시간 사용 금지.\n- 최근 30일 내 해당 kind 내역이 없으면 `GameResult.Failure(GAME_ERROR_TYPE.PURCHASE_*, ...)` 반환.\n\n\n---\n\n\n## D. Entitlements 스냅샷 (정본)\n\n- `mRentals\u002FmPasses`는 로그인\u002F복원 시 서버 `getEntitlements` 결과로 복원한다. (클라이언트 인벤토리 덮어쓰기)\n- `SyncEntitlementsAsync()`는 서버 `getEntitlements`를 호출해 `InventoryStorage`를 갱신한 뒤 `EntitlementsSnapshot`을 반환한다.\n- `SeasonPass`는 현재 시즌 유효 구간(`TB_SEASON`)일 때만 반영한다.\n- `Rental`은 `expiresAtServerUtcMs > serverNowUtcMs`인 항목만 반영한다.\n- Rental 만료 상한을 두지 않으며, 누적 연장을 허용한다.\n- `GetRentalRemainingMsAsync(internal_product_id)`는 서버 조회 없이 `InventoryStorage.GetRentalRemainingMs(id)`를 반환한다.\n- `verifyPurchaseAsync` 응답의 `entitlementsSnapshot`은 클라이언트 인벤토리를 갱신하는 용도로 사용하지 않는다.\n\n\n---\n\n\n## DoD\n\nHard (must be 0)\n- [x] Verify\u002FSync 호출 방식이 단일 옵션으로 확정됐다. → Firebase Functions Callable\n- [x] SSOT 필드 매핑과 동일하다. → 코드에서 verify\u002Fack 요청·응답 키 사용 확인\n- [x] ConfirmPurchase 하드룰이 문서에 명시돼 있다.\n\nSoft\n- [ ] 호출 실패 시 에러 매핑 규칙(GAME_ERROR_TYPE.PURCHASE_*) 링크 추가\n",{},"main","8cb5bd877a3a7004867d2f55697cb9e4ff2f1734","skills\u002Fdevian-unity\u002F50-mobile-package\u002F30-purchase-system\u002F43-purchase-client-server-integration","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft","Kim Hyong Joon","2026-04-12 18:44:10",{"source":7,"skillName":5,"commands":38,"prompt":48,"zipAvailable":49},[39,42,45],{"tool":40,"command":41},"npx","npx skills add devwinsoft\u002Fdevian --skill 43-purchase-client-server-integration",{"tool":43,"command":44},"bunx","bunx skills add devwinsoft\u002Fdevian --skill 43-purchase-client-server-integration",{"tool":46,"command":47},"pnpm","pnpm dlx skills add devwinsoft\u002Fdevian --skill 43-purchase-client-server-integration","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian-unity\u002F50-mobile-package\u002F30-purchase-system\u002F43-purchase-client-server-integration\u002FSKILL.md",true,[51,57,61],{"path":52,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":55,"sourceHtmlUrl":56},"references\u002Fbest-practices.md","REFERENCE","参考文档",9355,"https:\u002F\u002Fgithub.com\u002Fwelflau\u002Fai-dev-system\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fmarketplace\u002Fcb_teams_marketplace\u002Fplugins\u002Fequity-research\u002Fskills\u002Fearnings-analysis\u002Freferences\u002Fbest-practices.md",{"path":58,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":59,"sourceHtmlUrl":60},"references\u002Freport-structure.md",11141,"https:\u002F\u002Fgithub.com\u002Fwelflau\u002Fai-dev-system\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fmarketplace\u002Fcb_teams_marketplace\u002Fplugins\u002Fequity-research\u002Fskills\u002Fearnings-analysis\u002Freferences\u002Freport-structure.md",{"path":62,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":63,"sourceHtmlUrl":64},"references\u002Fworkflow.md",21406,"https:\u002F\u002Fgithub.com\u002Fwelflau\u002Fai-dev-system\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fmarketplace\u002Fcb_teams_marketplace\u002Fplugins\u002Fequity-research\u002Fskills\u002Fearnings-analysis\u002Freferences\u002Fworkflow.md",[66,72,80,88,97,104],{"skillNo":67,"name":68,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":26},"01M6CBX3K2JJV38ANHVGCAT8A0","devian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002FSKILL.md",[],[68],{"skillNo":73,"name":74,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":26},"01M6CBX210BFMM8AMN770J9WY8","90-project-archive","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F90-project-archive\u002FSKILL.md",[],[78,79],"archive","90 project archive",{"skillNo":81,"name":82,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":26},"01M6CBWZSGRR9R3YJZB3177667","30-env-management","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F30-env-management\u002FSKILL.md",[],[86,87],"management","30 env management",{"skillNo":89,"name":90,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":91,"categories":92,"keywords":93,"publishedAt":26},"01M6CBWYD3TGWBQV7V35551THF","19-page-push-send","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F19-page-push-send\u002FSKILL.md",[],[94,95,96],"push","page","19 page push send",{"skillNo":98,"name":99,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":100,"categories":101,"keywords":102,"publishedAt":26},"01M6CBWWRQ05A7604GHJKTPJTF","18-page-savedata","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F18-page-savedata\u002FSKILL.md",[],[95,103],"18 page savedata",{"skillNo":105,"name":106,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":107,"categories":108,"keywords":109,"publishedAt":26},"01M6CBWVH4S2VF1V7B2GBTESCT","17-page-deobfuscate","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F17-page-deobfuscate\u002FSKILL.md",[],[95,110],"17 page deobfuscate"]