74 lines
4.3 KiB
Markdown
74 lines
4.3 KiB
Markdown
# 관리자 정산 크리에이터 번호 적용 PRD
|
|
|
|
## 문서 정보
|
|
|
|
| 항목 | 내용 |
|
|
|---|---|
|
|
| 문서 상태 | 구현 완료 |
|
|
| 작성일 | 2026-08-04 |
|
|
| 최종 수정일 | 2026-08-04 |
|
|
| 대상 제품 | 관리자 크리에이터별 정산 조회 및 엑셀 |
|
|
| 작성자·결정권자 | 사용자 |
|
|
| 관련 구현 계획 | `docs/20260804_관리자정산크리에이터번호적용/plan-task.md` |
|
|
|
|
## 1. Overview
|
|
|
|
관리자 크리에이터별 정산에서 nullable인 `Member.email`을 필수 QueryDSL projection 값으로 사용해 발생하는 조회 오류를 제거한다. 정산 대상 식별값은 이메일 대신 non-null PK인 `creatorId`를 사용한다.
|
|
|
|
## 2. Problem Statement
|
|
|
|
- `Member.email`은 nullable이지만 `GetCalculateByCreatorQueryData.email`은 non-null `String`이다.
|
|
- 이메일이 없는 크리에이터가 정산 결과에 포함되면 QueryDSL이 DTO 생성 중 `ExpressionException`을 발생시킨다.
|
|
- 이메일은 정산 계산식에 사용되지 않으므로 필수 projection 값으로 유지할 이유가 없다.
|
|
|
|
문제 해결 여부는 이메일이 null인 크리에이터의 정산 조회가 성공하고 `creatorId`를 반환하는지로 판단한다.
|
|
|
|
## 3. Goals
|
|
|
|
- 라이브·콘텐츠·커뮤니티 크리에이터별 정산 projection에서 `email`을 제거한다.
|
|
- 정산 응답에 `creatorId`를 추가한다.
|
|
- 크리에이터별 정산 엑셀에서 이메일을 제거하고 크리에이터 번호를 제공한다.
|
|
- 기존 정산 금액 계산, 집계, 필터, 정렬과 페이지네이션을 유지한다.
|
|
|
|
## 4. Non-Goals
|
|
|
|
- `Member.email`의 nullable 정책을 변경하지 않는다.
|
|
- 이메일이 없는 회원의 다른 기능을 수정하지 않는다.
|
|
- 에이전트 정산과 채널후원 정산 API를 변경하지 않는다.
|
|
- 정산 공식 또는 정산 비율을 변경하지 않는다.
|
|
|
|
## 5. 기능 요구사항
|
|
|
|
| ID | 상태 | 요구사항 | 수용 기준 | Goal 연결 |
|
|
|---|---|---|---|---|
|
|
| `CALC-001` | 확정 | 크리에이터별 정산 조회는 이메일 대신 크리에이터 번호를 반환한다. | 응답 item에 `creatorId: Long`이 있고 `email`이 없다. | `P1-T1` |
|
|
| `CALC-002` | 확정 | 이메일이 없는 크리에이터도 정산 조회 대상에 포함된다. | null 이메일 크리에이터의 라이브·콘텐츠·커뮤니티 정산 QueryDSL 조회가 예외 없이 성공한다. | `P1-T1` |
|
|
| `CALC-003` | 확정 | 크리에이터별 정산 엑셀은 이메일 대신 크리에이터 번호를 제공한다. | 첫 헤더가 `크리에이터 번호`이고 데이터 셀에 `creatorId`가 기록된다. | `P1-T2` |
|
|
| `CALC-004` | 확정 | 기존 정산 계산 결과를 유지한다. | `totalCan`, 원화, 결제수수료, 정산금액, 원천세와 입금액 계산 회귀 테스트가 통과한다. | `P1-T1`, `P1-GATE` |
|
|
|
|
## 6. API 계약
|
|
|
|
대상 endpoint는 다음과 같다.
|
|
|
|
- `GET /admin/calculate/live-by-creator`
|
|
- `GET /admin/calculate/content-by-creator`
|
|
- `GET /admin/calculate/community-by-creator`
|
|
- 위 세 endpoint의 `/excel` 다운로드
|
|
|
|
조회 응답 item의 `email: String`을 제거하고 `creatorId: Long`을 추가한다. 요청 파라미터와 응답의 나머지 필드는 변경하지 않는다.
|
|
|
|
## 7. 성공 기준
|
|
|
|
- [x] null 이메일 크리에이터에 대한 세 종류의 크리에이터별 정산 조회가 성공한다.
|
|
- [x] 조회 응답은 `creatorId`를 포함하고 `email`을 포함하지 않는다.
|
|
- [x] 엑셀은 `크리에이터 번호` 컬럼을 포함하고 이메일 컬럼을 포함하지 않는다.
|
|
- [x] 기존 정산 계산 및 관련 회귀 테스트가 통과한다.
|
|
|
|
## 8. Decision Log
|
|
|
|
| 날짜 | ID | 상태 | 결정 | 근거 | 영향 요구사항·Goal |
|
|
|---|---|---|---|---|---|
|
|
| 2026-08-04 | `DEC-001` | 확정 | 정산에서 email을 제거하고 creatorId를 사용한다. | email은 계산에 사용되지 않고 nullable이라 projection 오류를 발생시킨다. | `CALC-001`, `CALC-002`, `P1-T1` |
|
|
| 2026-08-04 | `DEC-002` | 확정 | 엑셀의 이메일 컬럼을 크리에이터 번호 컬럼으로 교체한다. | 사용자가 이메일 제거와 creatorId 기반 구분을 확정했다. | `CALC-003`, `P1-T2` |
|
|
| 2026-08-04 | `DEC-003` | 확정 | 이메일 제거에 따른 추가 식별력 보완은 하지 않는다. | 사용자가 식별력 저하는 문제가 되지 않는다고 확정했다. | Non-Goals |
|