[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CBKKC14VCFQ3Z3NCYEN1A1":3,"skill-same:01M6CBKKC14VCFQ3Z3NCYEN1A1":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},"01M6CBKKC14VCFQ3Z3NCYEN1A1","01-policy",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\u002F01-policy\u002FSKILL.md",[],[18,19],"policy","01 policy","2026-11-10 10:12:30",false,"# 30-purchase-system — Policy\n\n\nStatus: ACTIVE\nAppliesTo: v10\nType: Policy \u002F Entry Point\n\n\n## Purpose\n\n\nDevian의 인앱 결제 모듈(클라이언트) 설계\u002F코딩 규약을 정의한다.\n\n\n- 결제 SDK는 Unity IAP를 사용한다.\n- 결제 검증\u002F지급 결정은 **클라이언트가 아닌 서버(Cloud Functions)**가 담당한다.\n- 상위 로직은 Store SKU \u002F 스토어별 영수증 구조를 직접 알지 않는다(내부 ID만 사용).\n\n\n---\n\n\n## Hard Rules\n\n\n### 1) 클라이언트는 \"지급 결정\"을 하지 않는다\n\n\n- Unity IAP 콜백에서 \"성공\"이 와도 **즉시 지급 금지**\n- 반드시 서버(Cloud Functions)의 `verifyPurchase` 결과를 기준으로 Entitlement를 반영한다.\n\n\n정본 규칙: [03-ssot](..\u002F03-ssot\u002FSKILL.md)\n\n\n### 2) 내부 표준 ID만 상위 로직에 노출한다\n\n\n- 상위 로직은 `internal_product_id`만 사용한다.\n- Store SKU(googlePlayProductId \u002F appStoreProductId)는 카탈로그\u002F매핑 레이어로만 취급한다.\n\n\n정본 규칙: [03-ssot](..\u002F03-ssot\u002FSKILL.md)\n\n\n### 3) iOS Restore 지원\n\n\n- iOS는 Restore(복원) 플로우를 제공해야 한다.\n- Android는 UX상 \"자동 복원\u002F동기화\" 패턴을 주로 사용해도 된다.\n- 단, 최종 상태는 서버의 Entitlement 기준.\n\n\n정본 규칙: [03-ssot](..\u002F03-ssot\u002FSKILL.md)\n\n\n### 4) Purchase의 실제 지급 실행은 RewardManager에 위임한다\n\n- 서버 `verifyPurchase` 결과가 `GRANTED`일 때만 `reward_group_id`를 RewardManager에 전달해 적용한다.\n- `reward_group_id`는 `internal_product_id -> reward_group_id` 매핑으로 얻는다(PurchaseManager가 `TB_PURCHASE` 테이블을 직접 조회하여 변환).\n- `ALREADY_GRANTED`는 서버 멱등 결과이며, 클라에서 중복 적용을 시도하지 않는다.\n- 멱등\u002F기록\u002F복구 정본은 Purchase 시스템이다. Reward는 지급 실행만 담당한다.\n\n연관: [49-reward-system](..\u002F..\u002F49-reward-system\u002F00-overview\u002FSKILL.md)\n\n### 5) 구매 전 인증 게이트는 LoginManager API를 사용한다\n\n- PurchaseManager는 \"로그인 여부\"를 `FirebaseAuth.CurrentUser`로 직접 판정하지 않는다.\n- 구매 가능 여부는 `LoginManager.IsPurchaseLoginReady()` \u002F `LoginManager.EnsurePurchaseLoginReadyAsync()`로 판단한다.\n- 인증 상태의 최종 소유자는 AccountManager이며, LoginManager는 인증 게이트 오케스트레이션만 담당한다.\n- Android 정책: GPGS silent 인증이 이미 성립한 경우, 구매 진입 시 LoginManager가 Google 로그인(Firebase 연동) 자동 보정을 시도할 수 있다(사용자 명시 로그인 버튼 없이 가능).\n- Firebase Auth context(`context.auth.uid`)는 서버 `verifyPurchase`에서 최종 검증한다.\n\n### 6) 상품 종류별 구매 제한 정책 (현재)\n\n- `Consumable`: 반복 구매 허용 (제한 없음)\n- `Rental`: 반복 구매 허용 (30일 재구매 제한 없음)\n- `Subscription`: 스토어\u002F서버 상태 기준으로 검증 (클라에서 임의 제한 금지)\n- `SeasonPass`: 동일 `internal_product_id` 중복 구매 금지 (서버에서 거부)\n\n### 7) 구매 로컬 상태 저장은 PurchaseManager 소유 PurchaseStorage에 한정한다\n\n- `PurchaseStorage`는 `PurchaseManager`가 소유하며 SaveData(local\u002Fcloud) 경로로 저장될 수 있다.\n- 저장 범위는 **진행 중 구매 1건(current)** 의 최소 복구 상태로 제한한다.\n- 구매 실패 내역\u002F최근 실패 요약은 저장하지 않는다.\n- 전체 구매 이력\u002F영수증\u002F토큰 저장 금지. 서버 원장(Firestore) 대체 금지.\n- 정본: [33-purchase-storage](..\u002F33-purchase-storage\u002FSKILL.md)\n\n\n---\n\n\n## Client API (권장 형태)\n\n\n> 이 섹션은 \"Devian 클라 레이어가 따라야 하는 규약\"이며, 실제 코드 시그니처\u002F클래스명은 구현 프로젝트에 맞춰 적용한다.\n\n\n### 최소 기능\n\n\n- Initialize: Unity IAP 초기화\n- GetCatalog: 가격\u002F통화\u002F로컬라이즈 정보 조회(가능한 범위)\n- Purchase: 구매 시작\n- Restore: iOS 복원 트리거\n- GetEntitlements: 서버에서 Entitlement 상태 조회(앱 시작\u002F포그라운드 등)\n\n\n### 이벤트\u002F상태\n\n\n- 구매 결과는 \"스토어 결제 성공\u002F실패\"와 \"서버 검증 결과\"를 구분한다.\n- UI\u002F상위 로직에 반영 가능한 최종 결과는 서버 검증 결과(`GRANTED\u002FALREADY_GRANTED\u002FREJECTED\u002FPENDING`)를 따른다.\n\n\n정본 규칙: [03-ssot](..\u002F03-ssot\u002FSKILL.md)\n\n\n---\n\n\n## PurchaseManager (Client Entry Point)\n\n\n- 샘플 구현: `com.devian.foundation` — `Samples~\u002FMobilePackage\u002FRuntime\u002FPurchase\u002FPurchaseManager.cs`\n- 구현: `PurchaseManager : CompoSingleton\u003CPurchaseManager>`\n- 구매 상태 스냅샷 저장: `PurchaseManager.Instance.Storage` (`PurchaseStorage`)\n\n\n### 공개 메소드 규약(Policy)\n\n\n- `InitializeAsync(ct)` → `Task\u003CGameResult>`\n  - IAP 초기화 (Connect + FetchProducts). Idempotent.\n- `PurchaseAsync(internal_product_id, ct)` → `Task\u003CGameResult\u003CPurchaseFinalResult>>`\n  - 단일 구매 진입점. `TB_PURCHASE`에서 `Kind`를 조회하여 구매 유형(Consumable\u002FRental\u002FSubscription\u002FSeasonPass)을 자동 결정\n  - 최종 지급은 서버 `verifyPurchase` 결과만 신뢰\n  - **Caller-managed client grant**: `NeedsClientGrantDelivery=true`이면 호출자가 보상을 적용한 뒤 `AckPurchaseClientGrantAppliedAsync`로 ACK\n- `RetryInterruptedPurchaseAsync(ct)` → `Task\u003CGameResult\u003CRetryInterruptedPurchaseResult>>`\n  - `PurchaseStorage.current`에 중단된 결제가 있으면 상태 전이를 재개\u002F마무리\n- `AckPurchaseClientGrantAppliedAsync(purchaseId, ct)` — 로컬 지급 성공 보고\n- `ReportPurchaseClientGrantFailureAsync(purchaseId, ct)` — 로컬 지급 실패 보고\n- `RestoreAsync(ct)` (iOS 스토어 복원, manual\u002Ffallback)\n- `GetLatestConsumablePurchase30dAsync(ct)` — 최근 30일 Consumable 최신 1건 조회\n- `SyncEntitlementsAsync(ct)` → `Task\u003CGameResult>` — 서버 `getEntitlements`로 `mPasses\u002FmRentals`를 복원(덮어쓰기)한 뒤 snapshot 반환\n  - `pass`: 시즌 유효 구간 체크\n  - `rental`: 만료시각 미래값만 반영, 누적 연장 허용\n- `RefundAsync(ct)` — 환불 상태 동기화\u002F처리\n\n\n### Hard\n- Unity IAP \"스토어 구매 성공 콜백\"만으로 지급\u002FNoAds 적용 금지\n- 지급량\u002F보상 계산을 클라이언트에서 임의로 하지 않음\n",{},"main","8cb5bd877a3a7004867d2f55697cb9e4ff2f1734","skills\u002Fdevian-unity\u002F50-mobile-package\u002F30-purchase-system\u002F01-policy","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 01-policy",{"tool":37,"command":38},"bunx","bunx skills add devwinsoft\u002Fdevian --skill 01-policy",{"tool":40,"command":41},"pnpm","pnpm dlx skills add devwinsoft\u002Fdevian --skill 01-policy","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian-unity\u002F50-mobile-package\u002F30-purchase-system\u002F01-policy\u002FSKILL.md",true,[45],{"path":46,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":49,"sourceHtmlUrl":50},"agents\u002Fopenai.yaml","REFERENCE","参考文档",116,"https:\u002F\u002Fgithub.com\u002Fmalinskibeniamin\u002Fskills\u002Fblob\u002Fmain\u002Fcodex-skills\u002Fchangesets\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"]