[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CBME3AZJV66ETWK9Y71PC7":3,"skill-same:01M6CBME3AZJV66ETWK9Y71PC7":51},{"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":17,"publishedAt":20,"linkOnly":21,"markdownContent":22,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":13,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":6,"ownerDescription":29,"updatedAt":30,"install":31,"resources":44},"01M6CBME3AZJV66ETWK9Y71PC7","41-purchase-store-verification",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\u002F41-purchase-store-verification\u002FSKILL.md",[],[18,19],"verification","41 purchase store verification","2026-11-10 10:12:30",false,"# 41-purchase-store-verification — Store Verification (Apple + Google)\n\nStatus: ACTIVE\nAppliesTo: v10\n\n> Purchase SSOT: `skills\u002Fdevian-unity\u002F50-mobile-package\u002F30-purchase-system\u002F03-ssot\u002FSKILL.md` (C 섹션)\n\n## 목적\n\n서버(Cloud Functions)에서 Apple\u002FGoogle 구매를 검증하기 위해 필요한:\n- 어떤 검증 API를 쓸지\n- 어떤 식별자를 `storePurchaseId`로 고정할지\n- 원장\u002F멱등 키(purchaseId)에 어떤 값을 사용할지\n를 **정본으로 고정**한다.\n\n이 스킬이 확정되지 않으면 40 스킬의 `purchaseId`가 결정될 수 없다.\n\n\n---\n\n\n## A. 공통 규칙 (정본)\n\n- 검증은 반드시 서버에서 수행한다.\n- 클라 payload는 \"서버 검증에 필요한 최소 데이터\"만 전달한다.\n- 서버는 검증 결과로부터 `storePurchaseId`를 추출하고, 이를 기반으로 `purchaseId`를 만든다:\n  - `purchaseId = \"{storeKey}_{storePurchaseId}\"`\n\n\n---\n\n\n## B. Google Play 검증 (정본)\n\nNEEDS CHECK:\n- 어떤 Google API(경로\u002F버전)를 사용할지 레포 정책으로 확정해야 한다.\n\n고정해야 할 항목(결정 후 문서에 값 채우기):\n- 인증 방식: 서비스 계정 사용 여부 \u002F 키 관리 방식(Secret Manager 등)\n- `storePurchaseId`로 삼을 필드:\n  - 예: orderId \u002F purchaseToken 기반 등 (정확한 선택 필요)\n\n검증 엔드포인트 분기 (kind 기준):\n- `kind == Subscription` → `purchases.subscriptions.get`\n- `kind == Consumable` \u002F `SeasonPass` → `purchases.products.get` (one-time 검증 경로)\n\n서버가 최소로 저장해야 할 필드(원장):\n- `internal_product_id`\n- `storePurchaseId`\n- `purchaseTime`\n- `acknowledged` 또는 동등 상태(가능한 경우)\n- `raw`(필요 시 일부만)\n\n\n---\n\n\n## C. Apple 검증 (정본)\n\nNEEDS CHECK:\n- Apple 검증 방식(App Store Server API \u002F receipt 검증)의 선택을 확정해야 한다.\n\n고정해야 할 항목(결정 후 문서에 값 채우기):\n- `storePurchaseId`로 삼을 필드:\n  - 예: originalTransactionId \u002F transactionId 등 (정확한 선택 필요)\n\n검증 엔드포인트:\n- Apple `verifyReceipt`는 kind에 관계없이 동일 엔드포인트를 사용한다.\n\n서버가 최소로 저장해야 할 필드(원장):\n- `internal_product_id`\n- `storePurchaseId`\n- `purchaseTime`\n- `revocation\u002Frefund` 관련 상태(가능한 경우)\n- `raw`(필요 시 일부만)\n\n\n---\n\n\n## D. 상태 매핑 (정본)\n\n서버는 최종적으로 SSOT의 `resultStatus` enum으로 반환한다:\n- `GRANTED`, `ALREADY_GRANTED`, `REJECTED`, `PENDING`, `REVOKED`, `REFUNDED`\n\nFirestore에는 소문자 상태로 저장한다:\n- `granted`, `already_granted`, `rejected`, `pending`, `revoked`, `refunded`\n\n\n---\n\n\n## DoD\n\nHard (must be 0)\n- [ ] Google 검증에서 `storePurchaseId`가 단일 규칙으로 확정됐다.\n- [ ] Apple 검증에서 `storePurchaseId`가 단일 규칙으로 확정됐다.\n- [ ] `purchaseId = \"{storeKey}_{storePurchaseId}\"` 규칙이 흔들리지 않는다.\n- [ ] SSOT resultStatus ↔ Firestore status 소문자 규칙이 명시돼 있다.\n\nSoft\n- [ ] 저장 필드 최소화 원칙(PII\u002F과다 저장 방지) 문구 추가\n",{},"main","8cb5bd877a3a7004867d2f55697cb9e4ff2f1734","skills\u002Fdevian-unity\u002F50-mobile-package\u002F30-purchase-system\u002F41-purchase-store-verification","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":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add devwinsoft\u002Fdevian --skill 41-purchase-store-verification",{"tool":37,"command":38},"bunx","bunx skills add devwinsoft\u002Fdevian --skill 41-purchase-store-verification",{"tool":40,"command":41},"pnpm","pnpm dlx skills add devwinsoft\u002Fdevian --skill 41-purchase-store-verification","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian-unity\u002F50-mobile-package\u002F30-purchase-system\u002F41-purchase-store-verification\u002FSKILL.md",true,[45],{"path":46,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":49,"sourceHtmlUrl":50},"agents\u002Fopenai.yaml","REFERENCE","参考文档",127,"https:\u002F\u002Fgithub.com\u002Fmalinskibeniamin\u002Fskills\u002Fblob\u002Fmain\u002Fcodex-skills\u002Fcontribution-triage\u002Fagents\u002Fopenai.yaml",[52,58,66,74,83,90],{"skillNo":53,"name":54,"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":55,"categories":56,"keywords":57,"publishedAt":20},"01M6CBX3K2JJV38ANHVGCAT8A0","devian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002FSKILL.md",[],[54],{"skillNo":59,"name":60,"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":61,"categories":62,"keywords":63,"publishedAt":20},"01M6CBX210BFMM8AMN770J9WY8","90-project-archive","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F90-project-archive\u002FSKILL.md",[],[64,65],"archive","90 project archive",{"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":20},"01M6CBWZSGRR9R3YJZB3177667","30-env-management","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F30-env-management\u002FSKILL.md",[],[72,73],"management","30 env management",{"skillNo":75,"name":76,"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":77,"categories":78,"keywords":79,"publishedAt":20},"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",[],[80,81,82],"push","page","19 page push send",{"skillNo":84,"name":85,"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":86,"categories":87,"keywords":88,"publishedAt":20},"01M6CBWWRQ05A7604GHJKTPJTF","18-page-savedata","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F18-page-savedata\u002FSKILL.md",[],[81,89],"18 page savedata",{"skillNo":91,"name":92,"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":93,"categories":94,"keywords":95,"publishedAt":20},"01M6CBWVH4S2VF1V7B2GBTESCT","17-page-deobfuscate","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F17-page-deobfuscate\u002FSKILL.md",[],[81,96],"17 page deobfuscate"]