파트너 수수료 계층 구조와 외부 API 레퍼런스 문서 정비

docs: 파트너 매뉴얼 및 gitignore 업데이트

문서화 작업은 귀찮지만 나중을 위해 꼭 필요함. 특히 외부 API 연동 부분은 레퍼런스 없으면 매번 명세서 다시 뒤져야 함.

문서 구조

.claude/docs/
├── api-reference.md     # 외부 API 엔드포인트 정리
├── architecture.md      # 시스템 구조도
├── java.md              # 코딩 컨벤션
├── sql.md               # SQL 패턴/규칙
└── rbac.md              # 권한 체계

좋은 API 레퍼런스 문서 요소

문서 관리 원칙

코드 변경 시 관련 문서도 같이 업데이트해야 함. 코드와 문서가 따로 노는 순간부터 문서는 신뢰할 수 없게 됨.

파트너 계층 구조

유통 단계가 깊어질수록 수수료 계산이 복잡해짐. 각 단계의 요율 차이가 해당 단계의 수익임.

최상위 운영사 (0%)
  └── 총판 A (0.5%) → 수익 0.5%
        └── 판매점 B (0.8%) → 수익 0.3%
              └── 최하위 C (1.0%) → 수익 0.2%

파트너 등록 시 상위 파트너의 요율을 초과할 수 없는 검증 로직이 필요함. 초과 설정을 허용하면 마진 역전이 발생함.

끝