크레딧 판매

조직에 크레딧을 파는 절차 — 단가·VAT 자동 계산, 입금 확인 체크, 정산 이력과 원장 반영.

언제 쓰나

고객사가 크레딧을 추가로 구매했고 입금이 확인됐을 때 반영한다. 반영하면 그 크레딧이 조직 미할당 풀로 들어가고, Org Admin이 팀 예산으로 나눠 쓸 수 있게 된다. 조직 생성 시 넣는 초기 크레딧도 내부적으로는 같은 판매 처리다.

화면

조직 관리에서 조직 행의 크레딧 판매 를 누르면 판매 모달이 뜬다.

크레딧 판매

모달 상단에 <조직명> · 크레딧 판매와 함께 미할당 잔여 … C · 누적 판매 … C · <플랜> 플랜이 표시된다.

입력	규칙	설명
판매 크레딧	0보다 큼	반영할 크레딧 수량
금액 (₩, VAT 별도 · 단가 ₩500/C 자동 계산)	0 이상	판매 정책 단가로 자동 계산된다. 수정 가능
VAT 10% 포함 시 ₩…	표시 전용	금액에 VAT를 더한 값. 참고용
입금 확인됨 · 반영 즉시 사용 가능	체크박스	체크해야 반영 버튼이 동작한다
<수량> C 반영	버튼	반영 실행. 미체크 시 거부

하단에 반영 시 조직 어드민에게 알림 발송 · 정산 이력과 감사 로그에 기록이라고 안내된다.

절차

1. 조직 행의 크레딧 판매 를 누른다.
2. 판매 크레딧에 수량을 넣는다. 금액이 정책 단가(₩500/C)로 자동 계산되고, VAT 10% 포함 시 금액도 함께 갱신된다.
3. 필요하면 금액을 수정한다(할인 판매 등).
4. 입금을 확인했으면 입금 확인됨 · 반영 즉시 사용 가능을 체크한다. 체크하지 않으면 payment_unconfirmed로 거부된다.
5. <수량> C 반영 을 누른다. 크레딧이 조직 원장에 purchase로 적립되고, 정산 이력(credit_sales)이 남으며, Org Admin에게 알림이 간다.

이렇게 되면 정상

• 조직의 미할당 잔여가 판매 수량만큼 늘고, 크레딧 판매 누적도 그만큼 증가한다.
• 원장에 purchase 엔트리가 남는다(ref = sale:<판매ID>).
• credit_sales 테이블에 판매 이력 행이 생긴다(수량·금액·확인자).
• Org Admin에게 크레딧 … C가 반영되었습니다 알림이 발송된다(미할당 풀에서 팀 예산으로 할당할 수 있습니다).
• 감사 로그에 org.sell_credits가 남는다(수량·금액 포함).

막히는 경우

증상	원인	조치
payment_unconfirmed	입금 확인됨 체크를 하지 않음	입금 확인 후 체크하고 재시도
반영 버튼을 눌러도 아무 일 없음	입금 확인 미체크	체크박스를 켜야 버튼이 동작한다
조직을 찾을 수 없음	제거된 조직	제거된 조직에는 판매 불가

알아둘 것

• 단가와 VAT는 판매 정책에서 온다(D-015). 기본값은 ₩500/C, VAT 10%다. 조직 관리 화면 상단의 판매 정책 · ₩500/C에서 확인·변경한다. 이 값은 코드에 하드코딩하지 않고 Super Admin이 운영 중 바꾼다.
• 금액은 자동 계산되지만 수정할 수 있다. 원장에 남는 건 크레딧 수량이고, 금액은 정산 이력용이다.
• 크레딧은 센티크레딧 정수로 저장된다(D-004). 화면의 30,000 C는 내부적으로 3,000,000 센티크레딧이다. Float를 쓰지 않아 누적 오차가 없다.
• 입금 확인 체크는 회계 게이트다. 실제 돈이 들어온 뒤에만 반영하라는 의도다. 반영은 원장 적립·정산 이력·감사 기록을 한 번에 남긴다.
• 판매는 미할당 풀을 늘릴 뿐 팀 예산을 직접 늘리지 않는다. 팀 배분은 Org Admin이 팀 관리에서 한다.