API 표면보다 계약 먼저

문서

Samchil 문서는 API 세부사항보다 검증 근거, 모듈 계약, 알려진 제한사항, 구매 및 접근 경계를 먼저 이해하도록 구성합니다.

01 / Planned

시작하기

Samchil을 평가하고, badge를 읽고, limitation을 확인하고, module이 project에 맞는지 판단하는 방법을 설명합니다.

  • Samchil promise와 exclusions
  • Module page를 읽는 방법
  • Verification Report 위치
  • Contact 및 support path
상태
Planned
대상
기술 구매자와 첫 모듈 사용자
경계
Badge가 buyer의 production validation을 대체한다고 주장하지 않습니다.

02 / Draft source exists

Samchil Verification Standard

Verified, Trusted, Proven 단계와 각 단계에 필요한 evidence를 문서화합니다.

  • Evidence philosophy
  • Badge level requirements
  • Downgrade 및 review expectations
  • 명시적 non-guarantees
상태
Draft source exists
대상
구매자, maintainer, reviewer
경계
SVS는 legal, regulatory, compliance, security certification이 아닙니다.

03 / Planned

모듈 계약

Package contents, version expectations, supported runtime scope, access 후 제공 항목을 설명합니다.

  • Package contents
  • Runtime 및 compatibility notes
  • Known limitations
  • Update policy references
상태
Planned
대상
유료 모듈을 통합하는 개발자
경계
Module contract는 custom integration, universal compatibility, production fitness를 약속하지 않습니다.

04 / Partially implemented

Verification Reports

Report field, evidence status, compatibility row, limitation, badge approval 기록 방식을 설명합니다.

  • Quality, security, documentation, compatibility section
  • Evidence references
  • Known critical issue handling
  • Badge approval caveats
상태
Partially implemented
대상
구매 전 evidence를 비교하는 technical evaluator
경계
Report는 검토된 scope만 설명하며 모든 environment나 future version을 증명하지 않습니다.

05 / Env 및 API Error Handler checkout wired

구매 및 접근

Purchase path, GitHub Private Repository access model, manual recovery expectations, open implementation gap을 문서화합니다.

  • Polar hosted checkout
  • Polar-connected GitHub benefit을 통한 repository access
  • Env Config Validator 및 API Error Handler checkout path
  • Manual support path
  • Website-owned order/webhook gaps
상태
Env 및 API Error Handler checkout wired
대상
Polar checkout과 GitHub repository access를 사용하는 구매자
경계
Website-owned license records, webhooks, refund automation이 구현되기 전에는 존재한다고 암시하지 않습니다.

06 / Draft policy source exists

라이선스, 환불, 지원

Allowed use, prohibited redistribution, refund eligibility, support scope를 구매 전에 보이게 합니다.

  • Commercial license summary
  • Refund window and eligibility
  • Support email and scope
  • Warranty and certification exclusions
상태
Draft policy source exists
대상
상업적 사용 및 지원 경계를 검토하는 구매자
경계
Refund 및 legal policy wording은 final publication 전에 owner/legal review가 필요합니다.

07 / Planned per module

통합 가이드

검토된 package evidence를 바탕으로 module-specific installation, configuration, examples, framework notes를 제공합니다.

  • Install and import steps
  • Minimal examples
  • 구현된 경우에만 framework-specific notes
  • Documented behavior 기반 troubleshooting
상태
Planned per module
대상
Application에 module을 추가하는 개발자
경계
Module에 존재하지 않는 framework example에 대한 guide를 게시하지 않습니다.

08 / Planned

변경 및 마이그레이션

Module release의 changelog, update policy, compatibility changes, migration notes를 추적합니다.

  • Release tags
  • Compatibility changes
  • Breaking change notes
  • Verification report updates
상태
Planned
대상
Update를 검토하는 기존 구매자
경계
승인된 package policy를 넘어서는 long-term maintenance나 SLA commitment를 약속하지 않습니다.

게시 규칙

공개 문서는 구현된 기능, 검증된 근거, owner가 검토한 launch boundary와 일치해야 합니다.

  • 새로운 badge claim, pricing claim, support promise, refund language, product availability statement를 게시하기 전에는 owner review가 필요합니다.