docs: add public community templates - #1
Conversation
There was a problem hiding this comment.
APPROVE
Summary
이 PR은 Billtap의 public community intake 시스템을 구축하는 문서 추가 변경입니다. GitHub issue 템플릿, PR 템플릿, Code of Conduct, Support 가이드를 추가하고 기존 문서의 routing을 개선했습니다.
Safety & Boundary Review
✅ Production Boundary 명확성
모든 새 문서가 Billtap의 "billing sandbox not payment processor" 경계를 명확히 합니다:
- bug_report.yml: required checkbox로 "Billtap is a billing sandbox and not a real payment processor" 확인
- feature_request.yml: "out of scope" 섹션에서 real payment processing, production payment dependency를 명시적 거부
- CODE_OF_CONDUCT.md: "Product Safety Boundary" 섹션에서 no real card processing, no live payment credentials, no production payment dependency 강조
✅ Security Routing 분리
SECURITY.md와 security_boundary.yml가 적절히 분리되었습니다:
- Private: secret exposure, real card data, webhook-signature bypass, relay-mode bypass →
SECURITY.mdprivate advisory - Public: documentation questions, boundary clarifications, no-vulnerability disclosure → public issue template
✅ Support Channel 명확화
SUPPORT.md가 올바른 routing을 제공합니다:
- Issues: bugs, feature requests (sandbox scope 내)
- PRs: focused fixes, fixture-backed improvements
- Security: vulnerabilities, secret exposure, bypasses
- Out of Scope: live payment operations, real card processing, Stripe production replacement
Documentation Quality
✅ Issue Template 구조
모든 템플릿이 요구사항에 부합합니다:
- Area dropdown: spec.md와 일치하는 카테고리 (API compatibility, Billing state, Checkout UI, Portal UI, Dashboard, Webhooks, Scenario runner, Fixtures, SaaS profile, Production boundary)
- Safety boundary checkboxes: required 체크박스로 실제 결제 데이터/credential 제거 강제
- Environment dropdown: "Controlled staging-adjacent relay mode"가 relay mode의 bounded nature 반영
✅ PR Template 구조
PULL_REQUEST_TEMPLATE.md가 요구사항을 포함합니다:
- Scope checkboxes (sandbox boundary, no live credentials)
- Verification checklist (go test, npm typecheck/build, scenario run)
- Compatibility/boundary notes field for behavior changes
✅ CONTRIBUTING.md 개선
CONTRIBUTING.md 개선사항:
- Issue/PR flow 섹션 추가 (template 사용, security routing 명시)
- Documentation-only changes에 대한 review criteria 추가 (clear routing, no-real-payment language, working links)
- "Out of scope" 섹션으로 명확한 경계 설정
Gate Alignment
- G9 Release Candidate support: community intake docs가 pre-release 상태에 적합한 "best effort" support expectation을 설정합니다
Minor Notes
-
config.yml의
contact_links가PRODUCTION_BOUNDARIES.md를 참조하는데, 이 파일이 아직 존재하지 않을 수 있습니다. 나중에 해당 문서를 추가하거나 링크를 조정해야 할 수 있습니다. -
YAML validation은 PR author가 이미 수행했다고 명시했으므로 별도 검증 없이 진행합니다.
Conclusion
이 PR은 Billtap의 production boundary와 no-real-payment 원칙을 모든 community touchpoint에서 일관되게 강화합니다. 문서만 변경되었으며, billing state, webhook reliability, safety에 영향을 주는 코드 변경은 없습니다.
Blocking issue 없습니다.
Reviewed by Z.ai GLM via Claude Code Action
Summary
Verification
Open risks
Gate status