[ { "path": ".claude/settings.local.json", "content": "{\n \"permissions\": {\n \"allow\": [\n \"mcp__mysql__mysql_query\"\n ]\n }\n}\n" }, { "path": ".github/CODEOWNERS", "content": "* @ImNM @sanbonai06 @cofls6581 @gengminy @kim-wonjin" }, { "path": ".github/PULL_REQUEST_TEMPLATE.md", "content": "## 개요\n- close #issueNumber\n\n## 작업사항\n- 내용을 적어주세요.\n\n## 변경로직\n- 내용을 적어주세요." }, { "path": ".github/workflows/BuildApiServer.yml", "content": "name: Build Api Server\non:\n push:\n tags:\n - Api-v*.*.*\n\njobs:\n build:\n runs-on: ubuntu-latest\n strategy:\n matrix:\n java-version: [ 21 ]\n outputs:\n version: ${{ steps.get_version.outputs.BRANCH_NAME }}\n\n steps:\n - name: Check Out The Repository\n uses: actions/checkout@v4\n\n - name: Set up Java\n uses: actions/setup-java@v4\n with:\n java-version: ${{ matrix.java-version }}\n distribution: 'temurin'\n\n - name: Get the version\n id: get_version\n run: |\n RELEASE_VERSION_WITHOUT_V=\"$(cut -d'v' -f2 <<< ${GITHUB_REF#refs/*/})\"\n echo \"VERSION=$RELEASE_VERSION_WITHOUT_V\" >> $GITHUB_OUTPUT\n\n #테스트 수행용 도커 컴포즈\n - name: Start containers\n run: docker compose up -d\n\n - name: Gradle Build\n uses: gradle/gradle-build-action@v3\n\n - name: Execute Gradle build\n run: ./gradlew :DuDoong-Api:build --no-daemon\n\n - name: Set up Docker Buildx\n uses: docker/setup-buildx-action@v3\n\n - name: Login to Docker Hub\n uses: docker/login-action@v3\n with:\n username: ${{ secrets.DOCKERHUB_USERNAME }}\n password: ${{ secrets.DOCKERHUB_TOKEN }}\n - name: Build and push\n uses: docker/build-push-action@v5\n with:\n context: ./DuDoong-Api\n push: true\n tags: water0641/dudoong-api:${{ steps.get_version.outputs.VERSION }}\n" }, { "path": ".github/workflows/BuildBatchServer.yml", "content": "name: Build Batch Server\non:\n push:\n tags:\n - Batch-v*.*.*\n\njobs:\n build:\n runs-on: ubuntu-latest\n strategy:\n matrix:\n java-version: [ 21 ]\n outputs:\n version: ${{ steps.get_version.outputs.BRANCH_NAME }}\n\n steps:\n - name: Check Out The Repository\n uses: actions/checkout@v4\n\n - name: Set up Java\n uses: actions/setup-java@v4\n with:\n java-version: ${{ matrix.java-version }}\n distribution: 'temurin'\n\n - name: Get the version\n id: get_version\n run: |\n RELEASE_VERSION_WITHOUT_V=\"$(cut -d'v' -f2 <<< ${GITHUB_REF#refs/*/})\"\n echo \"VERSION=$RELEASE_VERSION_WITHOUT_V\" >> $GITHUB_OUTPUT\n\n #테스트 수행용 도커 컴포즈\n - name: Start containers\n run: docker compose up -d\n\n - name: Gradle Build\n uses: gradle/gradle-build-action@v3\n\n - name: Execute Gradle build\n run: ./gradlew :DuDoong-Batch:build --no-daemon\n\n - name: Set up Docker Buildx\n uses: docker/setup-buildx-action@v3\n\n - name: Login to Docker Hub\n uses: docker/login-action@v3\n with:\n username: ${{ secrets.DOCKERHUB_USERNAME }}\n password: ${{ secrets.DOCKERHUB_TOKEN }}\n - name: Build and push\n uses: docker/build-push-action@v5\n with:\n context: ./DuDoong-Batch\n push: true\n tags: |\n water0641/dudoong-batch:${{ steps.get_version.outputs.VERSION }}\n water0641/dudoong-batch:latest\n" }, { "path": ".github/workflows/BuildSocketServer.yml", "content": "name: Build Socket Server\non:\n push:\n tags:\n - Socket-v*.*.*\n\njobs:\n build:\n runs-on: ubuntu-latest\n strategy:\n matrix:\n java-version: [ 17 ]\n outputs:\n version: ${{ steps.get_version.outputs.BRANCH_NAME }}\n\n steps:\n - name: Check Out The Repository\n uses: actions/checkout@v3\n\n - name: Set up Java\n uses: actions/setup-java@v3\n with:\n java-version: ${{ matrix.java-version }}\n distribution: 'corretto'\n\n - name: Get the version\n id: get_version\n run: |\n RELEASE_VERSION_WITHOUT_V=\"$(cut -d'v' -f2 <<< ${GITHUB_REF#refs/*/})\"\n echo ::set-output name=VERSION::$RELEASE_VERSION_WITHOUT_V \n\n #테스트 수행용 도커 컴포즈\n - name: Start containers\n run: docker compose up -d\n\n - name: Gradle Build\n uses: gradle/gradle-build-action@v2\n\n - name: Execute Gradle build\n run: ./gradlew :DuDoong-Socket:build --no-daemon\n\n - name: Set up Docker Buildx\n uses: docker/setup-buildx-action@v2\n\n - name: Login to Docker Hub\n uses: docker/login-action@v2\n with:\n username: ${{ secrets.DOCKERHUB_USERNAME }}\n password: ${{ secrets.DOCKERHUB_TOKEN }}\n - name: Build and push\n uses: docker/build-push-action@v3\n with:\n context: ./DuDoong-Socket\n push: true\n tags: water0641/dudoong-socket:${{ steps.get_version.outputs.VERSION }}\n\n" }, { "path": ".github/workflows/ci.yml", "content": "name: ci\non:\n pull_request:\n branch: 'dev'\n\njobs:\n ktlintCheck:\n runs-on: ubuntu-latest\n\n steps:\n - uses: actions/checkout@v4\n\n - name: SetUp JDK 21\n uses: actions/setup-java@v4\n with:\n java-version: \"21\"\n distribution: 'temurin'\n\n - name: Gradle Caching\n uses: actions/cache@v4\n with:\n path: |\n ~/.gradle/caches\n ~/.gradle/wrapper\n key: ${{ runner.os }}-gradle-${{ hashFiles('**/*.gradle.kts', '**/gradle-wrapper.properties') }}\n restore-keys: |\n ${{ runner.os }}-gradle-\n\n - name: Grant execute permission for gradlew\n run: chmod +x ./gradlew\n\n - name: ktlint check\n run: ./gradlew ktlintCheck\n" }, { "path": ".gitignore", "content": "DuDoong-Domain/HELP.md\n.gradle\nbuild/\n!gradle/wrapper/gradle-wrapper.jar\n!**/src/main/**/build/\n!**/src/test/**/build/\n\n### STS ###\n.apt_generated\n.classpath\n.factorypath\n.project\n.settings\n.springBeans\n.sts4-cache\nbin/\n!**/src/main/**/bin/\n!**/src/test/**/bin/\n\n### IntelliJ IDEA ###\n.idea\n*.iws\n*.iml\n*.ipr\nout/\n!**/src/main/**/out/\n!**/src/test/**/out/\n\n### NetBeans ###\n/nbproject/private/\n/nbbuild/\n/dist/\n/nbdist/\n/.nb-gradle/\n\n### VS Code ###\n.vscode/\n.env\n.env.*\n\n*.xlsx\n\n**/src/main/generated/\n.omc/\n" }, { "path": "CLAUDE.md", "content": "# DuDoong Backend - Claude 컨텍스트\n\n## 🎯 현재 진행 중인 작업\n\n**Java → Kotlin 전체 마이그레이션**\n\n마스터 트래킹 이슈: https://github.com/Gosrock/DuDoong-Backend/issues/582\n\n---\n\n## 🏗️ 프로젝트 아키텍처\n\n### 기술 스택\n- **언어**: Kotlin 1.9.22 (Java → Kotlin 마이그레이션 완료)\n- **프레임워크**: Spring Boot 3.2.0\n- **런타임**: Java 21\n- **빌드**: Gradle 8.5 Kotlin DSL\n- **DB**: MySQL + Spring Data JPA + QueryDSL\n- **캐시/락**: Redis + Redisson (분산락)\n- **외부 API**: Toss Payments (OpenFeign), AWS S3/SES, NCP AlimTalk, Slack API\n- **인증**: Spring Security + JWT + Kakao OAuth\n- **문서화**: SpringDoc OpenAPI (Swagger)\n- **배치**: Spring Batch\n- **실시간**: Spring WebSocket (STOMP)\n- **코드 품질**: SonarQube, Spotless (google-java-format), Jacoco\n\n### 멀티모듈 구조 (의존성 순서)\n\n```\nDuDoong-Backend/\n├── DuDoong-Common/ # 최하위: JWT, 어노테이션, 예외처리, DTO, 유틸\n├── DuDoong-Infrastructure/ # Common 의존: Redis, S3, SES, Feign, Slack, NCP\n├── DuDoong-Domain/ # Common+Infra 의존: JPA 엔티티, 도메인 서비스, AOP\n├── DuDoong-Api/ # 모든 모듈 의존: REST API, Security, Swagger\n├── DuDoong-Socket/ # 모든 모듈 의존: WebSocket STOMP 서버\n└── DuDoong-Batch/ # 모든 모듈 의존: Spring Batch 정산/알림/엑셀\n```\n\n### 도메인 영역 (DuDoong-Domain/domains/)\n\n| 도메인 | 설명 |\n|--------|------|\n| `user` | 사용자 (Kakao OAuth 로그인) |\n| `host` | 이벤트 주최자 |\n| `event` | 이벤트 |\n| `ticket_item` | 티켓 종류 |\n| `order` | 주문/결제 (Toss Payments) |\n| `cart` | 장바구니 |\n| `coupon` | 쿠폰 |\n| `issuedTicket` | 발급 티켓 (QR 입장 검증) |\n| `settlement` | 정산 |\n| `comment` | 댓글 |\n\n### API 컨트롤러 목록\n\n- `AuthController` - 카카오 OAuth 인증\n- `UserController` - 유저 관리\n- `HostController` - 호스트 관리\n- `EventController` - 이벤트 CRUD\n- `TicketItemController` / `TicketOptionController` - 티켓 종류\n- `OrderController` / `OrderAdminController` - 주문/결제\n- `CartController` - 장바구니\n- `CouponController` - 쿠폰\n- `IssuedTicketController` / `AdminIssuedTicketController` - 발급 티켓\n- `ImageController` - S3 Pre-signed URL 이미지 업로드\n- `AdminStatisticController` - 통계\n- `CommentController` - 댓글\n\n### GitHub 저장소\n\n- **Remote**: https://github.com/Gosrock/DuDoong-Backend.git\n- **기본 브랜치**: `dev`\n\n---\n\n## 🚀 Kotlin 마이그레이션 진행 상황\n\n### 마이그레이션 전략: Bottom-up 방식\n\n```\nPhase 0 → Phase 1 → Phase 2 → Phase 3 → Phase 4\n(Gradle) (Common) (Infra) (Domain) (Api)\n ↘ Phase 5 (Socket)\n ↘ Phase 6 (Batch)\n```\n\n### 이슈 목록\n\n| Phase | 이슈 | 내용 | 상태 |\n|-------|------|------|------|\n| Master | [#582](https://github.com/Gosrock/DuDoong-Backend/issues/582) | 전체 트래킹 | 🔵 진행예정 |\n| Phase 0 | [#583](https://github.com/Gosrock/DuDoong-Backend/issues/583) | Gradle Kotlin DSL 전환 | ⬜ 대기 |\n| Phase 1-1 | [#584](https://github.com/Gosrock/DuDoong-Backend/issues/584) | Common: 어노테이션 & 유틸 | ⬜ 대기 |\n| Phase 1-2 | [#585](https://github.com/Gosrock/DuDoong-Backend/issues/585) | Common: 예외처리 & DTO | ⬜ 대기 |\n| Phase 1-3 | [#586](https://github.com/Gosrock/DuDoong-Backend/issues/586) | Common: JWT & Properties | ⬜ 대기 |\n| Phase 2-1 | [#587](https://github.com/Gosrock/DuDoong-Backend/issues/587) | Infra: Redis & Redisson | ⬜ 대기 |\n| Phase 2-2 | [#588](https://github.com/Gosrock/DuDoong-Backend/issues/588) | Infra: AWS S3 & SES | ⬜ 대기 |\n| Phase 2-3 | [#589](https://github.com/Gosrock/DuDoong-Backend/issues/589) | Infra: Toss Payments Feign | ⬜ 대기 |\n| Phase 2-4 | [#590](https://github.com/Gosrock/DuDoong-Backend/issues/590) | Infra: Slack & AlimTalk | ⬜ 대기 |\n| Phase 3-1 | [#591](https://github.com/Gosrock/DuDoong-Backend/issues/591) | Domain: AOP & 도메인 이벤트 | ⬜ 대기 |\n| Phase 3-2 | [#592](https://github.com/Gosrock/DuDoong-Backend/issues/592) | Domain: User & Host | ⬜ 대기 |\n| Phase 3-3 | [#593](https://github.com/Gosrock/DuDoong-Backend/issues/593) | Domain: Event & TicketItem | ⬜ 대기 |\n| Phase 3-4 | [#594](https://github.com/Gosrock/DuDoong-Backend/issues/594) | Domain: Order & Cart | ⬜ 대기 |\n| Phase 3-5 | [#595](https://github.com/Gosrock/DuDoong-Backend/issues/595) | Domain: IssuedTicket & Coupon | ⬜ 대기 |\n| Phase 3-6 | [#596](https://github.com/Gosrock/DuDoong-Backend/issues/596) | Domain: Settlement & Comment | ⬜ 대기 |\n| Phase 4-1 | [#597](https://github.com/Gosrock/DuDoong-Backend/issues/597) | Api: Spring Security & Auth | ⬜ 대기 |\n| Phase 4-2 | [#598](https://github.com/Gosrock/DuDoong-Backend/issues/598) | Api: User, Host, Event | ⬜ 대기 |\n| Phase 4-3 | [#599](https://github.com/Gosrock/DuDoong-Backend/issues/599) | Api: Order, Cart, Coupon | ⬜ 대기 |\n| Phase 4-4 | [#600](https://github.com/Gosrock/DuDoong-Backend/issues/600) | Api: IssuedTicket, TicketItem | ⬜ 대기 |\n| Phase 4-5 | [#601](https://github.com/Gosrock/DuDoong-Backend/issues/601) | Api: Image, Statistic, 공통 | ⬜ 대기 |\n| Phase 5 | [#602](https://github.com/Gosrock/DuDoong-Backend/issues/602) | Socket: WebSocket 서버 | ⬜ 대기 |\n| Phase 6-1 | [#603](https://github.com/Gosrock/DuDoong-Backend/issues/603) | Batch: 정산 Job | ⬜ 대기 |\n| Phase 6-2 | [#604](https://github.com/Gosrock/DuDoong-Backend/issues/604) | Batch: 만료/엑셀/Slack 통계 | ⬜ 대기 |\n\n---\n\n## 🔐 인증 및 권한 체계\n\n### 인증 방식\n- **로그인**: 카카오 OAuth (`/api/v1/auth/oauth/kakao`) 또는 로컬 개발용 (`/api/v1/auth/oauth/local/login`, dev 전용)\n- **토큰 전달**: `accessToken` 쿠키 (기본) 또는 `Authorization: Bearer` 헤더\n- **토큰 갱신**: `POST /api/v1/auth/token/refresh`\n\n### 역할 (AccountRole)\n| 역할 | 설명 |\n|------|------|\n| `USER` | 일반 유저 |\n| `ADMIN` | 어드민 (내부 관리자) |\n| `SUPER_ADMIN` | 최고 관리자 |\n\n- **MANAGER 역할은 삭제됨** (호스트 멤버십의 HostRole과 혼동 방지)\n- Role hierarchy: `SUPER_ADMIN > ADMIN > USER`\n\n### API 접근 제어 (SecurityConfig)\n| 경로 | 접근 권한 |\n|------|----------|\n| `/api/v1/auth/oauth/**` | permitAll |\n| `/api/v1/events/{id}` (GET) | permitAll |\n| `/api/v1/events/search` (GET) | permitAll |\n| `/internal-api/**` | **ADMIN, SUPER_ADMIN만** |\n| 나머지 `/api/**` | USER 이상 (인증 필수) |\n\n### 호스트 권한 (HostRole AOP)\n- `@HostRolesAllowed` AOP로 호스트 멤버십 기반 권한 체크\n- **userId를 메서드 파라미터로 명시적 전달** (SecurityContext 미사용)\n- `SUPER_ADMIN`은 호스트 멤버가 아니어도 모든 이벤트/호스트 접근 가능 (바이패스)\n- HostQualification: `MASTER` > `MANAGER` > `GUEST`\n\n### Admin API (internal-api)\n- SecurityConfig 레벨: ADMIN/SUPER_ADMIN role 체크\n- UseCase 레벨: `AdminAuthValidator`로 이중 권한 체크\n - 읽기: `validateAdminOrAbove` (ADMIN+)\n - 쓰기: `validateAdminOrAbove` (ADMIN+)\n - 역할 변경: `validateSuperAdmin` (SUPER_ADMIN만)\n- 어드민 전용 로그인 엔드포인트 없음 — 일반 로그인 쿠키 사용\n\n### 어드민 토큰 관련 (레거시)\n- `X-Admin-Token` 헤더, `aud:admin` JWT claim — **사용하지 않음**\n- `AdminLoginUseCase`, `AdminLocalDevLoginUseCase` — **삭제됨**\n- 어드민 접근은 쿠키 기반 + DB role 체크로 통일\n\n---\n\n## 🧪 로컬 개발 & E2E 테스트\n\n### 서버 기동 (로컬 MySQL 사용)\n```bash\n# docker-compose 먼저 (MySQL + Redis)\ndocker compose up -d\n\n# local 프로필로 기동 — 반드시 이 방식으로!\n./gradlew :DuDoong-Api:bootRun --args='--spring.profiles.active=local,infrastructure,domain,domain-local,common,common-local'\n```\n\n**주의**: `local` 프로필 없이 기동하면 **H2 인메모리 DB**를 사용하게 되어 MySQL과 불일치 발생.\n- `spring.profiles.group.local` = `infrastructure, domain-local, common-local`\n- `domain-local` 프로필이 `jdbc:mysql://127.0.0.1:13306/dudoong` 설정\n\n### E2E 테스트 (Python pytest)\n```bash\ncd e2e-tests\npytest -v # 전체 실행\npytest test_33* test_34* -v # 권한 테스트만\n```\n\n### 디버깅 팁\n- API 안 되면 **프로필 먼저 확인** (`profiles are active` 로그)\n- DB 연결 확인: 로그에서 `jdbc:mysql` vs `jdbc:h2:mem` 확인\n- 403 나오면: DB에서 `account_role` 확인 + `hasAnyRole` 매칭 확인\n- 한번에 안 되면 **curl로 한 단계씩 확인** (로그인 → DB 확인 → role 변경 → API 호출)\n\n---\n\n## 🔑 Kotlin 마이그레이션 핵심 원칙\n\n1. **Lombok 제거**: `@Data` → `data class`, `@Builder` → named params + `copy()`, `@RequiredArgsConstructor` → 주생성자\n2. **Null Safety**: `@Nullable`/`@NonNull` → Kotlin `?` / non-null 타입\n3. **KAPT**: QueryDSL Q클래스 생성을 APT → KAPT로 전환\n4. **JPA 엔티티**: `open class` 필수 (`allOpen` plugin), 기본 생성자 자동생성 (`noArg` plugin)\n5. **Jackson**: `jackson-module-kotlin` 등록 필수\n6. **Bean Validation**: `@field:NotBlank` 접두사 필수 (Kotlin data class)\n7. **Spring Security**: Kotlin lambda DSL 활용\n\n## 📋 PR 규칙\n\n- 브랜치명: `feature/kotlin-migration-phase-{N}` 또는 `feature/kotlin-migration-phase-{N}-{name}`\n- PR 본문: `close #이슈번호` 포함\n- 각 Phase 완료 후 빌드(`./gradlew :{Module}:build`) 확인 필수\n\n## ⚠️ 주요 주의사항\n\n- Java ↔ Kotlin 혼재 허용 (마이그레이션 기간 중)\n- CI (GitHub Actions) 빌드 항상 유지\n- `lombok.config` 파일 → 최종 완료 시 삭제\n- SonarQube 설정 → 마지막에 Kotlin 소스로 업데이트\n" }, { "path": "DuDoong-Admin/build.gradle.kts", "content": "tasks.bootJar { enabled = false }\ntasks.jar { enabled = true }\n\ndependencies {\n implementation(\"org.springframework.boot:spring-boot-starter-web\")\n implementation(\"org.springframework.boot:spring-boot-starter-validation\")\n implementation(\"org.springframework.boot:spring-boot-starter-security\")\n implementation(\"org.springdoc:springdoc-openapi-starter-webmvc-ui:2.3.0\")\n implementation(project(\":DuDoong-Domain\"))\n implementation(project(\":DuDoong-Common\"))\n implementation(\"org.apache.poi:poi:5.2.0\")\n implementation(\"org.apache.poi:poi-ooxml:5.2.0\")\n}\n" }, { "path": "DuDoong-Admin/src/main/kotlin/band/gosrock/admin/controller/AdminCommentController.kt", "content": "package band.gosrock.admin.controller\n\nimport band.gosrock.admin.model.dto.response.AdminCommentResponse\nimport band.gosrock.admin.service.AdminDeleteCommentUseCase\nimport band.gosrock.admin.service.AdminGetCommentsUseCase\nimport band.gosrock.common.annotation.CurrentUserId\nimport io.swagger.v3.oas.annotations.Operation\nimport io.swagger.v3.oas.annotations.security.SecurityRequirement\nimport io.swagger.v3.oas.annotations.tags.Tag\nimport org.springframework.data.domain.Page\nimport org.springframework.data.domain.Pageable\nimport org.springframework.data.web.PageableDefault\nimport org.springframework.http.HttpStatus\nimport org.springframework.web.bind.annotation.DeleteMapping\nimport org.springframework.web.bind.annotation.GetMapping\nimport org.springframework.web.bind.annotation.PathVariable\nimport org.springframework.web.bind.annotation.RequestMapping\nimport org.springframework.web.bind.annotation.RequestParam\nimport org.springframework.web.bind.annotation.ResponseStatus\nimport org.springframework.web.bind.annotation.RestController\n\n@RestController\n@RequestMapping(\"/internal-api/v1/comments\")\n@SecurityRequirement(name = \"admin-token\")\n@Tag(name = \"Admin\")\nclass AdminCommentController(\n private val adminGetCommentsUseCase: AdminGetCommentsUseCase,\n private val adminDeleteCommentUseCase: AdminDeleteCommentUseCase,\n) {\n\n @Operation(summary = \"댓글 목록을 조회합니다.\")\n @GetMapping\n fun getComments(\n @CurrentUserId userId: Long,\n @RequestParam(required = false) keyword: String?,\n @RequestParam(required = false) eventId: Long?,\n @PageableDefault(size = 20) pageable: Pageable,\n ): Page {\n return adminGetCommentsUseCase.execute(userId, keyword, eventId, pageable)\n }\n\n @Operation(summary = \"댓글을 삭제합니다. (소프트 삭제)\")\n @DeleteMapping(\"/{commentId}\")\n @ResponseStatus(HttpStatus.NO_CONTENT)\n fun deleteComment(@CurrentUserId userId: Long, @PathVariable commentId: Long) {\n adminDeleteCommentUseCase.execute(userId, commentId)\n }\n}\n" }, { "path": "DuDoong-Admin/src/main/kotlin/band/gosrock/admin/controller/AdminDashboardController.kt", "content": "package band.gosrock.admin.controller\n\nimport band.gosrock.admin.model.dto.response.DashboardResponse\nimport band.gosrock.admin.service.GetDashboardUseCase\nimport band.gosrock.common.annotation.CurrentUserId\nimport io.swagger.v3.oas.annotations.Operation\nimport io.swagger.v3.oas.annotations.security.SecurityRequirement\nimport io.swagger.v3.oas.annotations.tags.Tag\nimport java.time.LocalDate\nimport org.springframework.format.annotation.DateTimeFormat\nimport org.springframework.web.bind.annotation.GetMapping\nimport org.springframework.web.bind.annotation.RequestMapping\nimport org.springframework.web.bind.annotation.RequestParam\nimport org.springframework.web.bind.annotation.RestController\n\n@RestController\n@RequestMapping(\"/internal-api/v1\")\n@SecurityRequirement(name = \"admin-token\")\n@Tag(name = \"Admin\")\nclass AdminDashboardController(\n private val getDashboardUseCase: GetDashboardUseCase,\n) {\n\n @Operation(summary = \"어드민 대시보드 통계를 조회합니다.\")\n @GetMapping(\"/dashboard\")\n fun getDashboard(\n @CurrentUserId userId: Long,\n @RequestParam(required = false) @DateTimeFormat(iso = DateTimeFormat.ISO.DATE) startDate: LocalDate?,\n @RequestParam(required = false) @DateTimeFormat(iso = DateTimeFormat.ISO.DATE) endDate: LocalDate?,\n ): DashboardResponse {\n return getDashboardUseCase.execute(userId, startDate, endDate)\n }\n}\n" }, { "path": "DuDoong-Admin/src/main/kotlin/band/gosrock/admin/controller/AdminEventController.kt", "content": "package band.gosrock.admin.controller\n\nimport band.gosrock.admin.model.dto.request.AdminAdjustTicketStockRequest\nimport band.gosrock.admin.model.dto.request.AdminUpdateEventRequest\nimport band.gosrock.admin.model.dto.request.AdminUpdateEventStatusRequest\nimport band.gosrock.admin.model.dto.request.AdminUpdateTicketItemRequest\nimport band.gosrock.admin.model.dto.response.AdminEventResponse\nimport band.gosrock.admin.model.dto.response.AdminIssuedTicketResponse\nimport band.gosrock.admin.model.dto.response.AdminTicketItemResponse\nimport band.gosrock.admin.service.AdminAdjustTicketStockUseCase\nimport band.gosrock.admin.service.AdminDeleteEventUseCase\nimport band.gosrock.admin.service.AdminExcelService\nimport band.gosrock.admin.service.AdminExportIssuedTicketsUseCase\nimport band.gosrock.admin.service.AdminGetEventDetailUseCase\nimport band.gosrock.admin.service.AdminGetEventsUseCase\nimport band.gosrock.admin.service.AdminGetIssuedTicketsUseCase\nimport band.gosrock.admin.service.AdminGetTicketItemsUseCase\nimport band.gosrock.admin.service.AdminUpdateEventStatusUseCase\nimport band.gosrock.admin.service.AdminUpdateEventUseCase\nimport band.gosrock.admin.service.AdminUpdateTicketItemUseCase\nimport band.gosrock.common.annotation.CurrentUserId\nimport io.swagger.v3.oas.annotations.Operation\nimport io.swagger.v3.oas.annotations.security.SecurityRequirement\nimport io.swagger.v3.oas.annotations.tags.Tag\nimport org.springframework.data.domain.Page\nimport org.springframework.data.domain.Pageable\nimport org.springframework.data.web.PageableDefault\nimport org.springframework.http.HttpHeaders\nimport org.springframework.http.HttpStatus\nimport org.springframework.http.MediaType\nimport org.springframework.http.ResponseEntity\nimport org.springframework.web.bind.annotation.DeleteMapping\nimport org.springframework.web.bind.annotation.GetMapping\nimport org.springframework.web.bind.annotation.PatchMapping\nimport org.springframework.web.bind.annotation.PathVariable\nimport org.springframework.web.bind.annotation.PostMapping\nimport org.springframework.web.bind.annotation.RequestBody\nimport org.springframework.web.bind.annotation.RequestMapping\nimport org.springframework.web.bind.annotation.RequestParam\nimport org.springframework.web.bind.annotation.ResponseStatus\nimport org.springframework.web.bind.annotation.RestController\n\n@RestController\n@RequestMapping(\"/internal-api/v1/events\")\n@SecurityRequirement(name = \"admin-token\")\n@Tag(name = \"Admin\")\nclass AdminEventController(\n private val adminGetEventsUseCase: AdminGetEventsUseCase,\n private val adminGetEventDetailUseCase: AdminGetEventDetailUseCase,\n private val adminDeleteEventUseCase: AdminDeleteEventUseCase,\n private val adminUpdateEventStatusUseCase: AdminUpdateEventStatusUseCase,\n private val adminUpdateEventUseCase: AdminUpdateEventUseCase,\n private val adminGetIssuedTicketsUseCase: AdminGetIssuedTicketsUseCase,\n private val adminExcelService: AdminExcelService,\n private val adminExportIssuedTicketsUseCase: AdminExportIssuedTicketsUseCase,\n private val adminGetTicketItemsUseCase: AdminGetTicketItemsUseCase,\n private val adminUpdateTicketItemUseCase: AdminUpdateTicketItemUseCase,\n private val adminAdjustTicketStockUseCase: AdminAdjustTicketStockUseCase,\n) {\n\n @Operation(summary = \"이벤트 목록을 엑셀로 다운로드합니다.\")\n @GetMapping(\"/export\")\n fun exportEvents(\n @CurrentUserId userId: Long,\n @RequestParam(required = false) keyword: String?,\n @RequestParam(required = false) status: String?,\n ): ResponseEntity {\n val events = adminGetEventsUseCase.executeAll(userId, keyword, status)\n val bytes = adminExcelService.generateEventsExcel(events)\n return ResponseEntity.ok()\n .header(HttpHeaders.CONTENT_DISPOSITION, \"attachment; filename=events.xlsx\")\n .contentType(MediaType.APPLICATION_OCTET_STREAM)\n .body(bytes)\n }\n\n @Operation(summary = \"이벤트 목록을 조회합니다.\")\n @GetMapping\n fun getEvents(\n @CurrentUserId userId: Long,\n @RequestParam(required = false) keyword: String?,\n @RequestParam(required = false) status: String?,\n @PageableDefault(size = 20) pageable: Pageable,\n ): Page {\n return adminGetEventsUseCase.execute(userId, keyword, status, pageable)\n }\n\n @Operation(summary = \"이벤트 상세 정보를 조회합니다.\")\n @GetMapping(\"/{eventId}\")\n fun getEventDetail(@CurrentUserId userId: Long, @PathVariable eventId: Long): AdminEventResponse {\n return adminGetEventDetailUseCase.execute(userId, eventId)\n }\n\n @Operation(summary = \"이벤트를 소프트 삭제합니다.\")\n @DeleteMapping(\"/{eventId}\")\n @ResponseStatus(HttpStatus.NO_CONTENT)\n fun deleteEvent(@CurrentUserId userId: Long, @PathVariable eventId: Long) {\n adminDeleteEventUseCase.execute(userId, eventId)\n }\n\n @Operation(summary = \"이벤트 상태를 변경합니다. (어드민 전용, 밸리데이션 우회)\")\n @PatchMapping(\"/{eventId}/status\")\n @ResponseStatus(HttpStatus.NO_CONTENT)\n fun updateEventStatus(\n @CurrentUserId userId: Long,\n @PathVariable eventId: Long,\n @RequestBody request: AdminUpdateEventStatusRequest,\n ) {\n adminUpdateEventStatusUseCase.execute(userId, eventId, request)\n }\n\n @Operation(summary = \"이벤트 정보를 수정합니다. (어드민 전용, OPEN 상태에서도 수정 가능)\")\n @PatchMapping(\"/{eventId}\")\n fun updateEvent(\n @CurrentUserId userId: Long,\n @PathVariable eventId: Long,\n @RequestBody request: AdminUpdateEventRequest,\n ): AdminEventResponse {\n return adminUpdateEventUseCase.execute(userId, eventId, request)\n }\n\n @Operation(summary = \"이벤트별 발급 티켓 목록을 조회합니다.\")\n @GetMapping(\"/{eventId}/issued-tickets\")\n fun getIssuedTickets(\n @CurrentUserId userId: Long,\n @PathVariable eventId: Long,\n @PageableDefault(size = 20) pageable: Pageable,\n ): Page {\n return adminGetIssuedTicketsUseCase.execute(userId, eventId, pageable)\n }\n\n @Operation(summary = \"이벤트별 티켓 종류 목록을 조회합니다.\")\n @GetMapping(\"/{eventId}/ticket-items\")\n fun getTicketItems(@CurrentUserId userId: Long, @PathVariable eventId: Long): List {\n return adminGetTicketItemsUseCase.execute(userId, eventId)\n }\n\n @Operation(summary = \"이벤트별 티켓 종류 목록을 엑셀로 다운로드합니다.\")\n @GetMapping(\"/{eventId}/ticket-items/export\")\n fun exportTicketItems(@CurrentUserId userId: Long, @PathVariable eventId: Long): ResponseEntity {\n val items = adminGetTicketItemsUseCase.execute(userId, eventId)\n val bytes = adminExcelService.generateTicketItemsExcel(items)\n return ResponseEntity.ok()\n .header(HttpHeaders.CONTENT_DISPOSITION, \"attachment; filename=ticket-items-${eventId}.xlsx\")\n .contentType(MediaType.APPLICATION_OCTET_STREAM)\n .body(bytes)\n }\n\n @Operation(summary = \"이벤트별 발급 티켓 목록을 엑셀로 다운로드합니다. (옵션 응답 동적 컬럼 포함)\")\n @GetMapping(\"/{eventId}/issued-tickets/export\")\n fun exportIssuedTickets(@CurrentUserId userId: Long, @PathVariable eventId: Long): ResponseEntity {\n val bytes = adminExportIssuedTicketsUseCase.execute(userId, eventId)\n return ResponseEntity.ok()\n .header(HttpHeaders.CONTENT_DISPOSITION, \"attachment; filename=issued-tickets-${eventId}.xlsx\")\n .contentType(MediaType.APPLICATION_OCTET_STREAM)\n .body(bytes)\n }\n\n @Operation(summary = \"티켓 종류를 수정합니다. (어드민 전용, 이벤트 상태 체크 없이 수정 가능)\")\n @PatchMapping(\"/{eventId}/ticket-items/{ticketItemId}\")\n fun updateTicketItem(\n @CurrentUserId userId: Long,\n @PathVariable eventId: Long,\n @PathVariable ticketItemId: Long,\n @RequestBody request: AdminUpdateTicketItemRequest,\n ): AdminTicketItemResponse {\n return adminUpdateTicketItemUseCase.execute(userId, eventId, ticketItemId, request)\n }\n\n @Operation(summary = \"티켓 재고를 조정합니다. (어드민 전용, delta 양수=증가 음수=감소)\")\n @PostMapping(\"/{eventId}/ticket-items/{ticketItemId}/adjust-stock\")\n fun adjustTicketStock(\n @CurrentUserId userId: Long,\n @PathVariable eventId: Long,\n @PathVariable ticketItemId: Long,\n @RequestBody request: AdminAdjustTicketStockRequest,\n ): AdminTicketItemResponse {\n return adminAdjustTicketStockUseCase.execute(userId, ticketItemId, request.delta)\n }\n}\n" }, { "path": "DuDoong-Admin/src/main/kotlin/band/gosrock/admin/controller/AdminHostController.kt", "content": "package band.gosrock.admin.controller\n\nimport band.gosrock.admin.model.dto.request.AdminAddHostMemberRequest\nimport band.gosrock.admin.model.dto.request.AdminTransferMasterRequest\nimport band.gosrock.admin.model.dto.request.AdminUpdateHostMemberRoleRequest\nimport band.gosrock.admin.model.dto.request.AdminUpdateHostPartnerRequest\nimport band.gosrock.admin.model.dto.request.AdminUpdateHostProfileRequest\nimport band.gosrock.admin.model.dto.response.AdminEventResponse\nimport band.gosrock.admin.model.dto.response.AdminHostDetailResponse\nimport band.gosrock.admin.model.dto.response.AdminHostMemberResponse\nimport band.gosrock.admin.model.dto.response.AdminHostResponse\nimport band.gosrock.admin.service.AdminAddHostMemberUseCase\nimport band.gosrock.admin.service.AdminTransferMasterUseCase\nimport band.gosrock.admin.service.AdminGetHostDetailUseCase\nimport band.gosrock.admin.service.AdminGetHostEventsUseCase\nimport band.gosrock.admin.service.AdminGetHostMembersUseCase\nimport band.gosrock.admin.service.AdminGetHostsUseCase\nimport band.gosrock.admin.service.AdminRemoveHostMemberUseCase\nimport band.gosrock.admin.service.AdminUpdateHostMemberRoleUseCase\nimport band.gosrock.admin.service.AdminUpdateHostPartnerUseCase\nimport band.gosrock.admin.service.AdminUpdateHostProfileUseCase\nimport band.gosrock.common.annotation.CurrentUserId\nimport io.swagger.v3.oas.annotations.Operation\nimport io.swagger.v3.oas.annotations.security.SecurityRequirement\nimport io.swagger.v3.oas.annotations.tags.Tag\nimport org.springframework.data.domain.Page\nimport org.springframework.data.domain.Pageable\nimport org.springframework.data.web.PageableDefault\nimport org.springframework.http.HttpStatus\nimport org.springframework.web.bind.annotation.DeleteMapping\nimport org.springframework.web.bind.annotation.GetMapping\nimport org.springframework.web.bind.annotation.PatchMapping\nimport org.springframework.web.bind.annotation.PathVariable\nimport org.springframework.web.bind.annotation.PostMapping\nimport org.springframework.web.bind.annotation.RequestBody\nimport org.springframework.web.bind.annotation.RequestMapping\nimport org.springframework.web.bind.annotation.RequestParam\nimport org.springframework.web.bind.annotation.ResponseStatus\nimport org.springframework.web.bind.annotation.RestController\n\n@RestController\n@RequestMapping(\"/internal-api/v1/hosts\")\n@SecurityRequirement(name = \"admin-token\")\n@Tag(name = \"Admin\")\nclass AdminHostController(\n private val adminGetHostsUseCase: AdminGetHostsUseCase,\n private val adminGetHostDetailUseCase: AdminGetHostDetailUseCase,\n private val adminGetHostMembersUseCase: AdminGetHostMembersUseCase,\n private val adminUpdateHostMemberRoleUseCase: AdminUpdateHostMemberRoleUseCase,\n private val adminAddHostMemberUseCase: AdminAddHostMemberUseCase,\n private val adminRemoveHostMemberUseCase: AdminRemoveHostMemberUseCase,\n private val adminGetHostEventsUseCase: AdminGetHostEventsUseCase,\n private val adminUpdateHostPartnerUseCase: AdminUpdateHostPartnerUseCase,\n private val adminUpdateHostProfileUseCase: AdminUpdateHostProfileUseCase,\n private val adminTransferMasterUseCase: AdminTransferMasterUseCase,\n) {\n\n @Operation(summary = \"호스트 목록을 조회합니다.\")\n @GetMapping\n fun getHosts(\n @CurrentUserId userId: Long,\n @RequestParam(required = false) keyword: String?,\n @PageableDefault(size = 20) pageable: Pageable,\n ): Page {\n return adminGetHostsUseCase.execute(userId, keyword, pageable)\n }\n\n @Operation(summary = \"호스트 상세 정보를 조회합니다.\")\n @GetMapping(\"/{hostId}\")\n fun getHostDetail(@CurrentUserId userId: Long, @PathVariable hostId: Long): AdminHostDetailResponse {\n return adminGetHostDetailUseCase.execute(userId, hostId)\n }\n\n @Operation(summary = \"호스트 소속 멤버 목록을 조회합니다.\")\n @GetMapping(\"/{hostId}/members\")\n fun getHostMembers(@CurrentUserId userId: Long, @PathVariable hostId: Long): List {\n return adminGetHostMembersUseCase.execute(userId, hostId)\n }\n\n @Operation(summary = \"호스트 멤버 역할을 변경합니다.\")\n @PatchMapping(\"/{hostId}/members/{targetUserId}/role\")\n fun updateHostMemberRole(\n @CurrentUserId userId: Long,\n @PathVariable hostId: Long,\n @PathVariable targetUserId: Long,\n @RequestBody request: AdminUpdateHostMemberRoleRequest,\n ): AdminHostMemberResponse {\n return adminUpdateHostMemberRoleUseCase.execute(userId, hostId, targetUserId, request)\n }\n\n @Operation(summary = \"호스트에 멤버를 추가합니다.\")\n @PostMapping(\"/{hostId}/members\")\n @ResponseStatus(HttpStatus.CREATED)\n fun addHostMember(\n @CurrentUserId userId: Long,\n @PathVariable hostId: Long,\n @RequestBody request: AdminAddHostMemberRequest,\n ): AdminHostMemberResponse {\n return adminAddHostMemberUseCase.execute(userId, hostId, request)\n }\n\n @Operation(summary = \"호스트에서 멤버를 제거합니다.\")\n @DeleteMapping(\"/{hostId}/members/{targetUserId}\")\n @ResponseStatus(HttpStatus.NO_CONTENT)\n fun removeHostMember(\n @CurrentUserId userId: Long,\n @PathVariable hostId: Long,\n @PathVariable targetUserId: Long,\n ) {\n adminRemoveHostMemberUseCase.execute(userId, hostId, targetUserId)\n }\n\n @Operation(summary = \"호스트별 이벤트 목록을 조회합니다.\")\n @GetMapping(\"/{hostId}/events\")\n fun getHostEvents(\n @CurrentUserId userId: Long,\n @PathVariable hostId: Long,\n @PageableDefault(size = 20) pageable: Pageable,\n ): Page {\n return adminGetHostEventsUseCase.execute(userId, hostId, pageable)\n }\n\n @Operation(summary = \"호스트의 파트너 여부를 변경합니다.\")\n @PatchMapping(\"/{hostId}/partner\")\n fun updateHostPartner(\n @CurrentUserId userId: Long,\n @PathVariable hostId: Long,\n @RequestBody request: AdminUpdateHostPartnerRequest,\n ): AdminHostDetailResponse {\n return adminUpdateHostPartnerUseCase.execute(userId, hostId, request)\n }\n\n @Operation(summary = \"호스트 프로필을 수정합니다.\")\n @PatchMapping(\"/{hostId}/profile\")\n fun updateHostProfile(\n @CurrentUserId userId: Long,\n @PathVariable hostId: Long,\n @RequestBody request: AdminUpdateHostProfileRequest,\n ): AdminHostDetailResponse {\n return adminUpdateHostProfileUseCase.execute(userId, hostId, request)\n }\n\n @Operation(summary = \"호스트 마스터 권한을 강제 양도합니다. (어드민)\")\n @PostMapping(\"/{hostId}/transfer-master\")\n fun transferMaster(\n @CurrentUserId userId: Long,\n @PathVariable hostId: Long,\n @RequestBody request: AdminTransferMasterRequest,\n ): AdminHostDetailResponse {\n return adminTransferMasterUseCase.execute(userId, hostId, request)\n }\n}\n" }, { "path": "DuDoong-Admin/src/main/kotlin/band/gosrock/admin/controller/AdminOrderController.kt", "content": "package band.gosrock.admin.controller\n\nimport band.gosrock.admin.model.dto.request.AdminCancelOrderRequest\nimport band.gosrock.admin.model.dto.request.AdminRefundStatusRequest\nimport band.gosrock.admin.model.dto.response.AdminOrderResponse\nimport band.gosrock.admin.service.AdminCancelOrderUseCase\nimport band.gosrock.admin.service.AdminExcelService\nimport band.gosrock.admin.service.AdminGetOrderDetailUseCase\nimport band.gosrock.admin.service.AdminGetOrdersUseCase\nimport band.gosrock.admin.service.AdminUpdateRefundStatusUseCase\nimport band.gosrock.common.annotation.CurrentUserId\nimport band.gosrock.domain.domains.order.domain.OrderStatus\nimport io.swagger.v3.oas.annotations.Operation\nimport io.swagger.v3.oas.annotations.security.SecurityRequirement\nimport io.swagger.v3.oas.annotations.tags.Tag\nimport jakarta.validation.Valid\nimport org.springframework.data.domain.Page\nimport org.springframework.data.domain.Pageable\nimport org.springframework.data.web.PageableDefault\nimport org.springframework.http.HttpHeaders\nimport org.springframework.http.MediaType\nimport org.springframework.http.ResponseEntity\nimport org.springframework.web.bind.annotation.GetMapping\nimport org.springframework.web.bind.annotation.PatchMapping\nimport org.springframework.web.bind.annotation.PathVariable\nimport org.springframework.web.bind.annotation.PostMapping\nimport org.springframework.web.bind.annotation.RequestBody\nimport org.springframework.web.bind.annotation.RequestMapping\nimport org.springframework.web.bind.annotation.RequestParam\nimport org.springframework.web.bind.annotation.RestController\n\n@RestController\n@RequestMapping(\"/internal-api/v1/orders\")\n@SecurityRequirement(name = \"admin-token\")\n@Tag(name = \"Admin\")\nclass AdminOrderController(\n private val adminGetOrdersUseCase: AdminGetOrdersUseCase,\n private val adminGetOrderDetailUseCase: AdminGetOrderDetailUseCase,\n private val adminCancelOrderUseCase: AdminCancelOrderUseCase,\n private val adminUpdateRefundStatusUseCase: AdminUpdateRefundStatusUseCase,\n private val adminExcelService: AdminExcelService,\n) {\n\n @Operation(summary = \"주문 목록을 엑셀로 다운로드합니다.\")\n @GetMapping(\"/export\")\n fun exportOrders(\n @CurrentUserId userId: Long,\n @RequestParam(required = false) keyword: String?,\n @RequestParam(required = false) status: OrderStatus?,\n @RequestParam(required = false) eventId: Long?,\n ): ResponseEntity {\n val orders = adminGetOrdersUseCase.executeAll(userId, keyword, status, eventId)\n val bytes = adminExcelService.generateOrdersExcel(orders)\n return ResponseEntity.ok()\n .header(HttpHeaders.CONTENT_DISPOSITION, \"attachment; filename=orders.xlsx\")\n .contentType(MediaType.APPLICATION_OCTET_STREAM)\n .body(bytes)\n }\n\n @Operation(summary = \"주문 목록을 조회합니다.\")\n @GetMapping\n fun getOrders(\n @CurrentUserId userId: Long,\n @RequestParam(required = false) keyword: String?,\n @RequestParam(required = false) status: OrderStatus?,\n @RequestParam(required = false) eventId: Long?,\n @PageableDefault(size = 20) pageable: Pageable,\n ): Page {\n return adminGetOrdersUseCase.execute(userId, keyword, status, eventId, pageable)\n }\n\n @Operation(summary = \"주문 상세 정보를 조회합니다.\")\n @GetMapping(\"/{orderUuid}\")\n fun getOrderDetail(@CurrentUserId userId: Long, @PathVariable orderUuid: String): AdminOrderResponse {\n return adminGetOrderDetailUseCase.execute(userId, orderUuid)\n }\n\n @Operation(summary = \"주문을 취소합니다.\")\n @PostMapping(\"/{orderUuid}/cancel\")\n fun cancelOrder(\n @CurrentUserId userId: Long,\n @PathVariable orderUuid: String,\n @RequestBody(required = false) request: AdminCancelOrderRequest?,\n ): AdminOrderResponse {\n return adminCancelOrderUseCase.execute(userId, orderUuid, request?.reason)\n }\n\n @Operation(summary = \"주문의 환불 상태를 변경합니다. (REFUND_COMPLETED)\")\n @PatchMapping(\"/{orderUuid}/refund-status\")\n fun updateRefundStatus(\n @CurrentUserId userId: Long,\n @PathVariable orderUuid: String,\n @RequestBody @Valid request: AdminRefundStatusRequest,\n ): AdminOrderResponse {\n return adminUpdateRefundStatusUseCase.execute(userId, orderUuid, request)\n }\n}\n" }, { "path": "DuDoong-Admin/src/main/kotlin/band/gosrock/admin/controller/AdminRefundController.kt", "content": "package band.gosrock.admin.controller\n\nimport band.gosrock.admin.model.dto.response.AdminRefundResponse\nimport band.gosrock.admin.service.AdminCompleteRefundUseCase\nimport band.gosrock.admin.service.AdminGetRefundDetailUseCase\nimport band.gosrock.admin.service.AdminGetRefundsUseCase\nimport band.gosrock.common.annotation.CurrentUserId\nimport band.gosrock.domain.domains.order.domain.RefundStatus\nimport io.swagger.v3.oas.annotations.Operation\nimport io.swagger.v3.oas.annotations.security.SecurityRequirement\nimport io.swagger.v3.oas.annotations.tags.Tag\nimport org.springframework.data.domain.Page\nimport org.springframework.data.domain.Pageable\nimport org.springframework.data.web.PageableDefault\nimport org.springframework.web.bind.annotation.GetMapping\nimport org.springframework.web.bind.annotation.PatchMapping\nimport org.springframework.web.bind.annotation.PathVariable\nimport org.springframework.web.bind.annotation.RequestMapping\nimport org.springframework.web.bind.annotation.RequestParam\nimport org.springframework.web.bind.annotation.RestController\n\n@RestController\n@RequestMapping(\"/internal-api/v1/refunds\")\n@SecurityRequirement(name = \"admin-token\")\n@Tag(name = \"Admin\")\nclass AdminRefundController(\n private val adminGetRefundsUseCase: AdminGetRefundsUseCase,\n private val adminGetRefundDetailUseCase: AdminGetRefundDetailUseCase,\n private val adminCompleteRefundUseCase: AdminCompleteRefundUseCase,\n) {\n\n @Operation(summary = \"전체 환불 목록을 조회합니다.\")\n @GetMapping\n fun getRefunds(\n @CurrentUserId userId: Long,\n @RequestParam(required = false) refundStatus: RefundStatus?,\n @RequestParam(required = false) eventId: Long?,\n @RequestParam(required = false) keyword: String?,\n @PageableDefault(size = 20) pageable: Pageable,\n ): Page =\n adminGetRefundsUseCase.execute(userId, refundStatus, eventId, keyword, pageable)\n\n @Operation(summary = \"환불 상세 정보를 조회합니다.\")\n @GetMapping(\"/{orderUuid}\")\n fun getRefundDetail(\n @CurrentUserId userId: Long,\n @PathVariable orderUuid: String,\n ): AdminRefundResponse =\n adminGetRefundDetailUseCase.execute(userId, orderUuid)\n\n @Operation(summary = \"환불을 확인 처리합니다. (REFUND_COMPLETED)\")\n @PatchMapping(\"/{orderUuid}/complete\")\n fun completeRefund(\n @CurrentUserId userId: Long,\n @PathVariable orderUuid: String,\n ): AdminRefundResponse =\n adminCompleteRefundUseCase.execute(userId, orderUuid)\n}\n" }, { "path": "DuDoong-Admin/src/main/kotlin/band/gosrock/admin/controller/AdminUserController.kt", "content": "package band.gosrock.admin.controller\n\nimport band.gosrock.admin.model.dto.request.AdminChangeNameRequest\nimport band.gosrock.admin.model.dto.request.AdminUpdateUserRoleRequest\nimport band.gosrock.admin.model.dto.request.AdminUpdateUserStatusRequest\nimport band.gosrock.admin.model.dto.response.AdminUserDetailResponse\nimport band.gosrock.admin.model.dto.response.AdminUserResponse\nimport band.gosrock.admin.service.AdminChangeNameUseCase\nimport band.gosrock.admin.service.AdminExcelService\nimport band.gosrock.admin.service.AdminGetUserDetailUseCase\nimport band.gosrock.admin.service.AdminGetUsersUseCase\nimport band.gosrock.admin.service.AdminUpdateUserRoleUseCase\nimport band.gosrock.admin.service.AdminUpdateUserStatusUseCase\nimport band.gosrock.common.annotation.CurrentUserId\nimport io.swagger.v3.oas.annotations.Operation\nimport io.swagger.v3.oas.annotations.security.SecurityRequirement\nimport io.swagger.v3.oas.annotations.tags.Tag\nimport jakarta.validation.Valid\nimport org.springframework.data.domain.Page\nimport org.springframework.data.domain.Pageable\nimport org.springframework.data.web.PageableDefault\nimport org.springframework.http.HttpHeaders\nimport org.springframework.http.MediaType\nimport org.springframework.http.ResponseEntity\nimport org.springframework.web.bind.annotation.GetMapping\nimport org.springframework.web.bind.annotation.PatchMapping\nimport org.springframework.web.bind.annotation.PathVariable\nimport org.springframework.web.bind.annotation.RequestBody\nimport org.springframework.web.bind.annotation.RequestMapping\nimport org.springframework.web.bind.annotation.RequestParam\nimport org.springframework.web.bind.annotation.RestController\n\n@RestController\n@RequestMapping(\"/internal-api/v1/users\")\n@SecurityRequirement(name = \"admin-token\")\n@Tag(name = \"Admin\")\nclass AdminUserController(\n private val adminGetUsersUseCase: AdminGetUsersUseCase,\n private val adminGetUserDetailUseCase: AdminGetUserDetailUseCase,\n private val adminUpdateUserRoleUseCase: AdminUpdateUserRoleUseCase,\n private val adminUpdateUserStatusUseCase: AdminUpdateUserStatusUseCase,\n private val adminChangeNameUseCase: AdminChangeNameUseCase,\n private val adminExcelService: AdminExcelService,\n) {\n\n @Operation(summary = \"유저 목록을 엑셀로 다운로드합니다.\")\n @GetMapping(\"/export\")\n fun exportUsers(\n @CurrentUserId currentUserId: Long,\n @RequestParam(required = false) keyword: String?,\n ): ResponseEntity {\n val users = adminGetUsersUseCase.executeAll(currentUserId, keyword)\n val bytes = adminExcelService.generateUsersExcel(users)\n return ResponseEntity.ok()\n .header(HttpHeaders.CONTENT_DISPOSITION, \"attachment; filename=users.xlsx\")\n .contentType(MediaType.APPLICATION_OCTET_STREAM)\n .body(bytes)\n }\n\n @Operation(summary = \"유저 목록을 조회합니다.\")\n @GetMapping\n fun getUsers(\n @CurrentUserId currentUserId: Long,\n @RequestParam(required = false) keyword: String?,\n @PageableDefault(size = 20) pageable: Pageable,\n ): Page {\n return adminGetUsersUseCase.execute(currentUserId, keyword, pageable)\n }\n\n @Operation(summary = \"유저 상세 정보를 조회합니다.\")\n @GetMapping(\"/{userId}\")\n fun getUserDetail(\n @CurrentUserId currentUserId: Long,\n @PathVariable userId: Long,\n ): AdminUserDetailResponse {\n return adminGetUserDetailUseCase.execute(currentUserId, userId)\n }\n\n @Operation(summary = \"유저 역할을 변경합니다. (SUPER_ADMIN 전용)\")\n @PatchMapping(\"/{userId}/role\")\n fun updateUserRole(\n @CurrentUserId currentUserId: Long,\n @PathVariable userId: Long,\n @RequestBody request: AdminUpdateUserRoleRequest,\n ): AdminUserResponse {\n return adminUpdateUserRoleUseCase.execute(currentUserId, userId, request)\n }\n\n @Operation(summary = \"유저 상태를 변경합니다.\")\n @PatchMapping(\"/{userId}/status\")\n fun updateUserStatus(\n @CurrentUserId currentUserId: Long,\n @PathVariable userId: Long,\n @RequestBody request: AdminUpdateUserStatusRequest,\n ): AdminUserResponse {\n return adminUpdateUserStatusUseCase.execute(currentUserId, userId, request)\n }\n\n @Operation(summary = \"유저 이름 변경\")\n @PatchMapping(\"/{userId}/name\")\n fun changeUserName(\n @CurrentUserId adminUserId: Long,\n @PathVariable userId: Long,\n @Valid @RequestBody request: AdminChangeNameRequest,\n ) {\n adminChangeNameUseCase.execute(adminUserId, userId, request)\n }\n}\n" }, { "path": "DuDoong-Admin/src/main/kotlin/band/gosrock/admin/exception/AdminErrorCode.kt", "content": "package band.gosrock.admin.exception\n\nimport band.gosrock.common.annotation.ExplainError\nimport band.gosrock.common.consts.DuDoongStatic.FORBIDDEN\nimport band.gosrock.common.dto.ErrorReason\nimport band.gosrock.common.exception.BaseErrorCode\nimport java.lang.reflect.Field\n\nenum class AdminErrorCode(\n private val status: Int,\n private val code: String,\n private val reason: String,\n) : BaseErrorCode {\n @ExplainError(\"어드민 권한이 없는 유저가 어드민 기능에 접근하려는 경우\")\n ADMIN_FORBIDDEN(FORBIDDEN, \"ADMIN_403_1\", \"어드민 권한이 필요합니다. MANAGER 이상의 역할이 필요합니다.\"),\n\n @ExplainError(\"SUPER_ADMIN 전용 기능에 일반 관리자가 접근하려는 경우\")\n ADMIN_SUPER_ADMIN_REQUIRED(FORBIDDEN, \"ADMIN_403_2\", \"SUPER_ADMIN 권한이 필요합니다.\");\n\n override fun getErrorReason(): ErrorReason =\n ErrorReason(status = status, code = code, reason = reason)\n\n override fun getExplainError(): String {\n val field: Field = this.javaClass.getField(this.name)\n val annotation = field.getAnnotation(ExplainError::class.java)\n return annotation?.value ?: reason\n }\n}\n" }, { "path": "DuDoong-Admin/src/main/kotlin/band/gosrock/admin/exception/AdminForbiddenException.kt", "content": "package band.gosrock.admin.exception\n\nimport band.gosrock.common.exception.DuDoongCodeException\n\nclass AdminForbiddenException private constructor() : DuDoongCodeException(AdminErrorCode.ADMIN_FORBIDDEN) {\n companion object {\n @JvmField\n val EXCEPTION: DuDoongCodeException = AdminForbiddenException()\n }\n}\n" }, { "path": "DuDoong-Admin/src/main/kotlin/band/gosrock/admin/model/dto/request/AdminAddHostMemberRequest.kt", "content": "package band.gosrock.admin.model.dto.request\n\nimport band.gosrock.domain.domains.host.domain.HostRole\n\ndata class AdminAddHostMemberRequest(\n val userId: Long,\n val role: HostRole,\n)\n" }, { "path": "DuDoong-Admin/src/main/kotlin/band/gosrock/admin/model/dto/request/AdminAdjustTicketStockRequest.kt", "content": "package band.gosrock.admin.model.dto.request\n\ndata class AdminAdjustTicketStockRequest(\n val delta: Long, // 양수 = 증가, 음수 = 감소\n)\n" }, { "path": "DuDoong-Admin/src/main/kotlin/band/gosrock/admin/model/dto/request/AdminCancelOrderRequest.kt", "content": "package band.gosrock.admin.model.dto.request\n\ndata class AdminCancelOrderRequest(\n val reason: String? = null,\n)\n" }, { "path": "DuDoong-Admin/src/main/kotlin/band/gosrock/admin/model/dto/request/AdminChangeNameRequest.kt", "content": "package band.gosrock.admin.model.dto.request\n\nimport jakarta.validation.constraints.NotBlank\nimport jakarta.validation.constraints.Size\n\ndata class AdminChangeNameRequest(\n @field:NotBlank(message = \"이름을 입력해주세요.\")\n @field:Size(min = 2, max = 7, message = \"이름은 2~7자여야 합니다.\")\n val name: String,\n)\n" }, { "path": "DuDoong-Admin/src/main/kotlin/band/gosrock/admin/model/dto/request/AdminRefundStatusRequest.kt", "content": "package band.gosrock.admin.model.dto.request\n\nimport jakarta.validation.constraints.NotNull\n\ndata class AdminRefundStatusRequest(\n @field:NotNull\n val refundStatus: String,\n val reason: String? = null,\n)\n" }, { "path": "DuDoong-Admin/src/main/kotlin/band/gosrock/admin/model/dto/request/AdminTransferMasterRequest.kt", "content": "package band.gosrock.admin.model.dto.request\n\nimport jakarta.validation.constraints.NotNull\n\n/** 어드민 호스트 마스터 강제 양도 요청 DTO */\ndata class AdminTransferMasterRequest(\n @field:NotNull(message = \"양도 대상 유저 아이디를 입력해주세요\")\n val newMasterUserId: Long,\n)\n" }, { "path": "DuDoong-Admin/src/main/kotlin/band/gosrock/admin/model/dto/request/AdminUpdateEventRequest.kt", "content": "package band.gosrock.admin.model.dto.request\n\nimport java.time.LocalDateTime\n\ndata class AdminUpdateEventRequest(\n val name: String? = null,\n val startAt: LocalDateTime? = null,\n val runTime: Int? = null,\n val content: String? = null,\n val placeName: String? = null,\n val placeAddress: String? = null,\n)\n" }, { "path": "DuDoong-Admin/src/main/kotlin/band/gosrock/admin/model/dto/request/AdminUpdateEventStatusRequest.kt", "content": "package band.gosrock.admin.model.dto.request\n\nimport band.gosrock.domain.domains.event.domain.EventStatus\n\ndata class AdminUpdateEventStatusRequest(\n val status: EventStatus,\n)\n" }, { "path": "DuDoong-Admin/src/main/kotlin/band/gosrock/admin/model/dto/request/AdminUpdateHostMemberRoleRequest.kt", "content": "package band.gosrock.admin.model.dto.request\n\nimport band.gosrock.domain.domains.host.domain.HostRole\n\ndata class AdminUpdateHostMemberRoleRequest(\n val role: HostRole,\n)\n" }, { "path": "DuDoong-Admin/src/main/kotlin/band/gosrock/admin/model/dto/request/AdminUpdateHostPartnerRequest.kt", "content": "package band.gosrock.admin.model.dto.request\n\ndata class AdminUpdateHostPartnerRequest(\n val partner: Boolean,\n)\n" }, { "path": "DuDoong-Admin/src/main/kotlin/band/gosrock/admin/model/dto/request/AdminUpdateHostProfileRequest.kt", "content": "package band.gosrock.admin.model.dto.request\n\ndata class AdminUpdateHostProfileRequest(\n val name: String?,\n val introduce: String?,\n val contactEmail: String?,\n val contactNumber: String?,\n)\n" }, { "path": "DuDoong-Admin/src/main/kotlin/band/gosrock/admin/model/dto/request/AdminUpdateTicketItemRequest.kt", "content": "package band.gosrock.admin.model.dto.request\n\nimport java.math.BigDecimal\n\ndata class AdminUpdateTicketItemRequest(\n val name: String? = null,\n val description: String? = null,\n val price: BigDecimal? = null,\n val quantity: Long? = null,\n val purchaseLimit: Long? = null,\n)\n" }, { "path": "DuDoong-Admin/src/main/kotlin/band/gosrock/admin/model/dto/request/AdminUpdateUserRoleRequest.kt", "content": "package band.gosrock.admin.model.dto.request\n\nimport band.gosrock.domain.domains.user.domain.AccountRole\n\ndata class AdminUpdateUserRoleRequest(\n val role: AccountRole,\n)\n" }, { "path": "DuDoong-Admin/src/main/kotlin/band/gosrock/admin/model/dto/request/AdminUpdateUserStatusRequest.kt", "content": "package band.gosrock.admin.model.dto.request\n\nimport band.gosrock.domain.domains.user.domain.AccountState\n\ndata class AdminUpdateUserStatusRequest(\n val status: AccountState,\n)\n" }, { "path": "DuDoong-Admin/src/main/kotlin/band/gosrock/admin/model/dto/response/AdminCommentResponse.kt", "content": "package band.gosrock.admin.model.dto.response\n\nimport band.gosrock.domain.domains.comment.domain.Comment\nimport band.gosrock.domain.domains.comment.domain.CommentStatus\nimport java.time.LocalDateTime\n\ndata class AdminCommentResponse(\n val id: Long,\n val userName: String?,\n val eventName: String?,\n val content: String?,\n val commentStatus: CommentStatus?,\n val createdAt: LocalDateTime?,\n val userId: Long?,\n val eventId: Long?,\n) {\n companion object {\n fun of(comment: Comment, eventName: String?): AdminCommentResponse =\n AdminCommentResponse(\n id = comment.id!!,\n userName = comment.nickName,\n eventName = eventName,\n content = comment.content,\n commentStatus = comment.commentStatus,\n createdAt = comment.createdAt,\n userId = comment.user?.id,\n eventId = comment.eventId,\n )\n }\n}\n" }, { "path": "DuDoong-Admin/src/main/kotlin/band/gosrock/admin/model/dto/response/AdminEventResponse.kt", "content": "package band.gosrock.admin.model.dto.response\n\nimport band.gosrock.domain.domains.event.domain.Event\nimport band.gosrock.domain.domains.event.domain.EventStatus\nimport java.time.LocalDateTime\n\ndata class AdminEventResponse(\n val id: Long,\n val name: String?,\n val hostName: String?,\n val status: EventStatus,\n val startAt: LocalDateTime?,\n val runTime: Long?,\n val createdAt: LocalDateTime?,\n val ticketItemCount: Int = 0,\n val issuedTicketCount: Int = 0,\n val totalOrderCount: Int = 0,\n val content: String? = null,\n val placeName: String? = null,\n val placeAddress: String? = null,\n val hostId: Long? = null,\n val posterImageKey: String? = null,\n val latitude: Double? = null,\n val longitude: Double? = null,\n) {\n companion object {\n fun of(event: Event, hostName: String?): AdminEventResponse =\n AdminEventResponse(\n id = event.id!!,\n name = event.eventBasic?.name,\n hostName = hostName,\n status = event.status,\n startAt = event.eventBasic?.startAt,\n runTime = event.eventBasic?.runTime,\n createdAt = event.createdAt,\n hostId = event.hostId,\n posterImageKey = event.eventDetail?.posterImage?.imageKey,\n latitude = event.eventPlace?.latitude,\n longitude = event.eventPlace?.longitude,\n )\n\n fun ofDetail(\n event: Event,\n hostName: String?,\n ticketItemCount: Int,\n issuedTicketCount: Int,\n totalOrderCount: Int,\n ): AdminEventResponse =\n AdminEventResponse(\n id = event.id!!,\n name = event.eventBasic?.name,\n hostName = hostName,\n status = event.status,\n startAt = event.eventBasic?.startAt,\n runTime = event.eventBasic?.runTime,\n createdAt = event.createdAt,\n ticketItemCount = ticketItemCount,\n issuedTicketCount = issuedTicketCount,\n totalOrderCount = totalOrderCount,\n content = event.eventDetail?.content,\n placeName = event.eventPlace?.placeName,\n placeAddress = event.eventPlace?.placeAddress,\n hostId = event.hostId,\n posterImageKey = event.eventDetail?.posterImage?.imageKey,\n latitude = event.eventPlace?.latitude,\n longitude = event.eventPlace?.longitude,\n )\n }\n}\n" }, { "path": "DuDoong-Admin/src/main/kotlin/band/gosrock/admin/model/dto/response/AdminHostDetailResponse.kt", "content": "package band.gosrock.admin.model.dto.response\n\nimport band.gosrock.domain.domains.host.domain.Host\nimport java.time.LocalDateTime\n\ndata class AdminHostDetailResponse(\n val id: Long,\n val name: String?,\n val introduce: String?,\n val contactEmail: String?,\n val contactNumber: String?,\n val profileImage: String?,\n val partner: Boolean,\n val masterUserId: Long?,\n val createdAt: LocalDateTime?,\n val memberCount: Int,\n val slackUrl: String?,\n) {\n companion object {\n fun from(host: Host): AdminHostDetailResponse =\n AdminHostDetailResponse(\n id = host.id!!,\n name = host.profile?.name,\n introduce = host.profile?.introduce,\n contactEmail = host.profile?.contactEmail,\n contactNumber = host.profile?.contactNumber,\n profileImage = host.profile?.profileImage?.imageKey,\n partner = host.partner,\n masterUserId = host.masterUserId,\n createdAt = host.createdAt,\n memberCount = host.hostUsers.size,\n slackUrl = host.slackUrl,\n )\n }\n}\n" }, { "path": "DuDoong-Admin/src/main/kotlin/band/gosrock/admin/model/dto/response/AdminHostMemberResponse.kt", "content": "package band.gosrock.admin.model.dto.response\n\nimport band.gosrock.domain.domains.host.domain.HostRole\nimport band.gosrock.domain.domains.host.domain.HostUser\nimport java.time.LocalDateTime\n\ndata class AdminHostMemberResponse(\n val userId: Long?,\n val userName: String?,\n val role: HostRole,\n val active: Boolean,\n val createdAt: LocalDateTime?,\n) {\n companion object {\n fun of(hostUser: HostUser, userName: String?): AdminHostMemberResponse =\n AdminHostMemberResponse(\n userId = hostUser.userId,\n userName = userName,\n role = hostUser.role,\n active = hostUser.active,\n createdAt = hostUser.createdAt,\n )\n }\n}\n" }, { "path": "DuDoong-Admin/src/main/kotlin/band/gosrock/admin/model/dto/response/AdminHostResponse.kt", "content": "package band.gosrock.admin.model.dto.response\n\nimport band.gosrock.domain.domains.host.domain.Host\nimport java.time.LocalDateTime\n\ndata class AdminHostResponse(\n val id: Long,\n val name: String?,\n val introduce: String?,\n val contactEmail: String?,\n val contactNumber: String?,\n val profileImage: String?,\n val partner: Boolean,\n val masterUserId: Long?,\n val createdAt: LocalDateTime?,\n) {\n companion object {\n fun from(host: Host): AdminHostResponse =\n AdminHostResponse(\n id = host.id!!,\n name = host.profile?.name,\n introduce = host.profile?.introduce,\n contactEmail = host.profile?.contactEmail,\n contactNumber = host.profile?.contactNumber,\n profileImage = host.profile?.profileImage?.imageKey,\n partner = host.partner,\n masterUserId = host.masterUserId,\n createdAt = host.createdAt,\n )\n }\n}\n" }, { "path": "DuDoong-Admin/src/main/kotlin/band/gosrock/admin/model/dto/response/AdminIssuedTicketResponse.kt", "content": "package band.gosrock.admin.model.dto.response\n\nimport band.gosrock.domain.domains.issuedTicket.domain.IssuedTicket\nimport band.gosrock.domain.domains.issuedTicket.domain.IssuedTicketStatus\nimport java.time.LocalDateTime\n\ndata class AdminIssuedTicketResponse(\n val id: Long,\n val issuedTicketNo: String?,\n val userName: String?,\n val ticketName: String?,\n val orderUuid: String?,\n val enteredAt: LocalDateTime?,\n val status: IssuedTicketStatus,\n val createdAt: LocalDateTime?,\n) {\n companion object {\n fun from(issuedTicket: IssuedTicket): AdminIssuedTicketResponse =\n AdminIssuedTicketResponse(\n id = issuedTicket.id!!,\n issuedTicketNo = issuedTicket.issuedTicketNo,\n userName = issuedTicket.userInfo?.userName,\n ticketName = issuedTicket.itemInfo?.ticketName,\n orderUuid = issuedTicket.orderUuid,\n enteredAt = issuedTicket.enteredAt,\n status = issuedTicket.issuedTicketStatus,\n createdAt = issuedTicket.createdAt,\n )\n }\n}\n" }, { "path": "DuDoong-Admin/src/main/kotlin/band/gosrock/admin/model/dto/response/AdminOrderResponse.kt", "content": "package band.gosrock.admin.model.dto.response\n\nimport band.gosrock.domain.domains.order.domain.Order\nimport band.gosrock.domain.domains.order.domain.OrderStatus\nimport java.time.LocalDateTime\n\ndata class AdminOrderResponse(\n val orderId: String?,\n val userName: String?,\n val eventName: String?,\n val ticketName: String?,\n val totalAmount: Long,\n val orderStatus: OrderStatus,\n val createdAt: LocalDateTime?,\n val orderNo: String?,\n val orderMethod: String?,\n val userId: Long?,\n val eventId: Long?,\n val approvedAt: LocalDateTime?,\n val withDrawAt: LocalDateTime?,\n val paymentMethod: String?,\n val receiptUrl: String?,\n val supplyAmount: String?,\n val discountAmount: String?,\n val couponName: String?,\n val failReason: String? = null,\n val cancelReason: String? = null,\n val refundStatus: String? = null,\n val refundStatusChangedAt: String? = null,\n) {\n companion object {\n fun of(order: Order, userName: String?, eventName: String?): AdminOrderResponse =\n AdminOrderResponse(\n orderId = order.uuid,\n userName = userName,\n eventName = eventName,\n ticketName = order.orderName,\n totalAmount = order.getTotalPaymentPrice().longValue(),\n orderStatus = order.orderStatus,\n createdAt = order.createdAt,\n orderNo = order.orderNo,\n orderMethod = order.orderMethod?.name,\n userId = order.userId,\n eventId = order.eventId,\n approvedAt = order.approvedAt,\n withDrawAt = order.withDrawAt,\n paymentMethod = order.pgPaymentInfo.paymentMethod.name,\n receiptUrl = order.pgPaymentInfo.receiptUrl,\n supplyAmount = order.totalPaymentInfo?.supplyAmount?.toString(),\n discountAmount = order.totalPaymentInfo?.discountAmount?.toString(),\n couponName = order.orderCouponVo.name,\n failReason = order.failReason,\n cancelReason = order.cancelReason,\n refundStatus = order.refundStatus.name,\n refundStatusChangedAt = order.refundStatusChangedAt?.toString(),\n )\n }\n}\n" }, { "path": "DuDoong-Admin/src/main/kotlin/band/gosrock/admin/model/dto/response/AdminRefundResponse.kt", "content": "package band.gosrock.admin.model.dto.response\n\nimport band.gosrock.domain.domains.order.domain.Order\nimport band.gosrock.domain.domains.order.domain.RefundStatus\nimport java.time.LocalDateTime\n\ndata class AdminRefundResponse(\n val orderId: String?,\n val orderNo: String?,\n val userName: String?,\n val eventName: String?,\n val eventId: Long?,\n val ticketName: String?,\n val totalAmount: Long,\n val cancelReason: String?,\n val refundStatus: RefundStatus,\n val refundStatusChangedAt: LocalDateTime?,\n val withDrawAt: LocalDateTime?,\n val createdAt: LocalDateTime?,\n val userId: Long?,\n) {\n companion object {\n fun of(order: Order, userName: String?, eventName: String?): AdminRefundResponse =\n AdminRefundResponse(\n orderId = order.uuid,\n orderNo = order.orderNo,\n userName = userName,\n eventName = eventName,\n eventId = order.eventId,\n ticketName = order.orderName,\n totalAmount = order.getTotalPaymentPrice().longValue(),\n cancelReason = order.cancelReason,\n refundStatus = order.refundStatus,\n refundStatusChangedAt = order.refundStatusChangedAt,\n withDrawAt = order.withDrawAt,\n createdAt = order.createdAt,\n userId = order.userId,\n )\n }\n}\n" }, { "path": "DuDoong-Admin/src/main/kotlin/band/gosrock/admin/model/dto/response/AdminTicketItemResponse.kt", "content": "package band.gosrock.admin.model.dto.response\n\nimport band.gosrock.domain.domains.ticket_item.domain.TicketItem\nimport band.gosrock.domain.domains.ticket_item.domain.TicketItemStatus\nimport band.gosrock.domain.domains.ticket_item.domain.TicketPayType\nimport band.gosrock.domain.domains.ticket_item.domain.TicketType\nimport java.math.BigDecimal\nimport java.time.LocalDateTime\n\ndata class AdminTicketItemResponse(\n val id: Long,\n val name: String?,\n val description: String?,\n val price: BigDecimal?,\n val quantity: Long?,\n val supplyCount: Long?,\n val purchaseLimit: Long?,\n val payType: TicketPayType?,\n val type: TicketType?,\n val isQuantityPublic: Boolean?,\n val isSellable: Boolean?,\n val saleStartAt: LocalDateTime?,\n val saleEndAt: LocalDateTime?,\n val ticketItemStatus: TicketItemStatus,\n val eventId: Long?,\n) {\n companion object {\n fun from(ticketItem: TicketItem): AdminTicketItemResponse =\n AdminTicketItemResponse(\n id = ticketItem.id!!,\n name = ticketItem.name,\n description = ticketItem.description,\n price = ticketItem.price?.amount,\n quantity = ticketItem.quantity,\n supplyCount = ticketItem.supplyCount,\n purchaseLimit = ticketItem.purchaseLimit,\n payType = ticketItem.payType,\n type = ticketItem.type,\n isQuantityPublic = ticketItem.isQuantityPublic,\n isSellable = ticketItem.isSellable,\n saleStartAt = ticketItem.saleStartAt,\n saleEndAt = ticketItem.saleEndAt,\n ticketItemStatus = ticketItem.ticketItemStatus,\n eventId = ticketItem.eventId,\n )\n }\n}\n" }, { "path": "DuDoong-Admin/src/main/kotlin/band/gosrock/admin/model/dto/response/AdminUserDetailResponse.kt", "content": "package band.gosrock.admin.model.dto.response\n\nimport band.gosrock.domain.domains.user.domain.AccountRole\nimport band.gosrock.domain.domains.user.domain.AccountState\nimport band.gosrock.domain.domains.user.domain.OauthProvider\nimport band.gosrock.domain.domains.user.domain.User\nimport java.time.LocalDateTime\n\ndata class AdminUserDetailResponse(\n val id: Long,\n val name: String?,\n val email: String?,\n val profileImage: String?,\n val accountRole: AccountRole,\n val accountState: AccountState,\n val createdAt: LocalDateTime?,\n val phoneNumber: String?,\n val marketingAgree: Boolean,\n val oauthProvider: OauthProvider?,\n val lastLoginAt: LocalDateTime?,\n val receiveMail: Boolean,\n) {\n companion object {\n fun from(user: User): AdminUserDetailResponse =\n AdminUserDetailResponse(\n id = user.id!!,\n name = user.profile?.name,\n email = user.profile?.email,\n profileImage = user.profile?.profileImage?.imageKey,\n accountRole = user.accountRole,\n accountState = user.accountState,\n createdAt = user.createdAt,\n phoneNumber = user.profile?.phoneNumberVo?.phoneNumber,\n marketingAgree = user.marketingAgree,\n oauthProvider = user.oauthInfo?.provider,\n lastLoginAt = user.lastLoginAt,\n receiveMail = user.receiveMail,\n )\n }\n}\n" }, { "path": "DuDoong-Admin/src/main/kotlin/band/gosrock/admin/model/dto/response/AdminUserResponse.kt", "content": "package band.gosrock.admin.model.dto.response\n\nimport band.gosrock.domain.domains.user.domain.AccountRole\nimport band.gosrock.domain.domains.user.domain.AccountState\nimport band.gosrock.domain.domains.user.domain.User\nimport java.time.LocalDateTime\n\ndata class AdminUserResponse(\n val id: Long,\n val name: String?,\n val email: String?,\n val profileImage: String?,\n val accountRole: AccountRole,\n val accountState: AccountState,\n val createdAt: LocalDateTime?,\n) {\n companion object {\n fun from(user: User): AdminUserResponse =\n AdminUserResponse(\n id = user.id!!,\n name = user.profile?.name,\n email = user.profile?.email,\n profileImage = user.profile?.profileImage?.imageKey,\n accountRole = user.accountRole,\n accountState = user.accountState,\n createdAt = user.createdAt,\n )\n }\n}\n" }, { "path": "DuDoong-Admin/src/main/kotlin/band/gosrock/admin/model/dto/response/DashboardResponse.kt", "content": "package band.gosrock.admin.model.dto.response\n\ndata class DashboardResponse(\n val totalUsers: Long,\n val todayNewUsers: Long,\n val todayOrders: Long,\n val todayRevenue: Long,\n val activeEvents: Long,\n val todayRefunds: Long,\n val recentOrders: List = emptyList(),\n val recentEvents: List = emptyList(),\n)\n" }, { "path": "DuDoong-Admin/src/main/kotlin/band/gosrock/admin/service/AdminAddHostMemberUseCase.kt", "content": "package band.gosrock.admin.service\n\nimport band.gosrock.admin.model.dto.request.AdminAddHostMemberRequest\nimport band.gosrock.admin.model.dto.response.AdminHostMemberResponse\nimport band.gosrock.common.annotation.UseCase\nimport band.gosrock.domain.domains.host.adaptor.HostAdaptor\nimport band.gosrock.domain.domains.host.domain.HostUser\nimport band.gosrock.domain.domains.host.repository.HostRepository\nimport band.gosrock.domain.domains.user.adaptor.UserAdaptor\nimport org.springframework.transaction.annotation.Transactional\n\n@UseCase\nclass AdminAddHostMemberUseCase(\n private val hostAdaptor: HostAdaptor,\n private val hostRepository: HostRepository,\n private val userAdaptor: UserAdaptor,\n private val adminAuthValidator: AdminAuthValidator,\n) {\n\n @Transactional\n fun execute(userId: Long, hostId: Long, request: AdminAddHostMemberRequest): AdminHostMemberResponse {\n adminAuthValidator.validateAdminOrAbove(userId)\n val host = hostAdaptor.findById(hostId)\n val hostUser = HostUser(host, request.userId, request.role)\n host.addHostUsers(setOf(hostUser))\n hostRepository.save(host)\n\n val userName = runCatching { userAdaptor.queryUser(request.userId).profile?.name }.getOrNull()\n val savedHostUser = host.getHostUserByUserId(request.userId)\n return AdminHostMemberResponse.of(savedHostUser, userName)\n }\n}\n" }, { "path": "DuDoong-Admin/src/main/kotlin/band/gosrock/admin/service/AdminAdjustTicketStockUseCase.kt", "content": "package band.gosrock.admin.service\n\nimport band.gosrock.admin.model.dto.response.AdminTicketItemResponse\nimport band.gosrock.common.annotation.UseCase\nimport band.gosrock.domain.common.aop.redissonLock.RedissonLock\nimport band.gosrock.domain.domains.ticket_item.adaptor.TicketItemAdaptor\n\n@UseCase\nclass AdminAdjustTicketStockUseCase(\n private val ticketItemAdaptor: TicketItemAdaptor,\n private val adminAuthValidator: AdminAuthValidator,\n) {\n @RedissonLock(LockName = \"티켓관리\", identifier = \"ticketItemId\")\n fun execute(userId: Long, ticketItemId: Long, delta: Long): AdminTicketItemResponse {\n adminAuthValidator.validateAdminOrAbove(userId)\n val ticketItem = ticketItemAdaptor.queryTicketItem(ticketItemId)\n ticketItem.adminAdjustStock(delta)\n ticketItemAdaptor.save(ticketItem)\n return AdminTicketItemResponse.from(ticketItem)\n }\n}\n" }, { "path": "DuDoong-Admin/src/main/kotlin/band/gosrock/admin/service/AdminAuthValidator.kt", "content": "package band.gosrock.admin.service\n\nimport band.gosrock.admin.exception.AdminForbiddenException\nimport band.gosrock.domain.domains.user.adaptor.UserAdaptor\nimport band.gosrock.domain.domains.user.domain.AccountRole\nimport band.gosrock.domain.domains.user.domain.User\nimport org.slf4j.LoggerFactory\nimport org.springframework.stereotype.Component\n\n@Component\nclass AdminAuthValidator(\n private val userAdaptor: UserAdaptor,\n) {\n private val log = LoggerFactory.getLogger(javaClass)\n\n fun validateAdminOrAbove(userId: Long): User {\n val user = userAdaptor.queryUser(userId)\n if (user.accountRole != AccountRole.ADMIN && user.accountRole != AccountRole.SUPER_ADMIN) {\n log.info(\"[ADMIN-AUTH] DENIED - userId={}, role={}, required=ADMIN+\", userId, user.accountRole)\n throw AdminForbiddenException.EXCEPTION\n }\n log.info(\"[ADMIN-AUTH] GRANTED - userId={}, role={}\", userId, user.accountRole)\n return user\n }\n\n fun validateSuperAdmin(userId: Long): User {\n val user = userAdaptor.queryUser(userId)\n if (user.accountRole != AccountRole.SUPER_ADMIN) {\n log.info(\"[ADMIN-AUTH] DENIED - userId={}, role={}, required=SUPER_ADMIN\", userId, user.accountRole)\n throw AdminForbiddenException.EXCEPTION\n }\n log.info(\"[ADMIN-AUTH] GRANTED - userId={}, role=SUPER_ADMIN\", userId)\n return user\n }\n}\n" }, { "path": "DuDoong-Admin/src/main/kotlin/band/gosrock/admin/service/AdminCancelOrderUseCase.kt", "content": "package band.gosrock.admin.service\n\nimport band.gosrock.admin.model.dto.response.AdminOrderResponse\nimport band.gosrock.common.annotation.UseCase\nimport band.gosrock.domain.domains.event.adaptor.EventAdaptor\nimport band.gosrock.domain.domains.order.adaptor.OrderAdaptor\nimport band.gosrock.domain.domains.order.domain.validator.OrderValidator\nimport band.gosrock.domain.domains.user.adaptor.UserAdaptor\nimport org.springframework.transaction.annotation.Transactional\n\n@UseCase\nclass AdminCancelOrderUseCase(\n private val orderAdaptor: OrderAdaptor,\n private val orderValidator: OrderValidator,\n private val userAdaptor: UserAdaptor,\n private val eventAdaptor: EventAdaptor,\n private val adminAuthValidator: AdminAuthValidator,\n) {\n\n @Transactional\n fun execute(userId: Long, orderUuid: String, reason: String? = null): AdminOrderResponse {\n adminAuthValidator.validateAdminOrAbove(userId)\n val order = orderAdaptor.findByOrderUuid(orderUuid)\n order.cancel(orderValidator, reason)\n\n val userName = order.userId?.let {\n runCatching { userAdaptor.queryUser(it).profile?.name }.getOrNull()\n }\n val eventName = order.eventId?.let {\n runCatching { eventAdaptor.findById(it).eventBasic?.name }.getOrNull()\n }\n return AdminOrderResponse.of(order, userName, eventName)\n }\n}\n" }, { "path": "DuDoong-Admin/src/main/kotlin/band/gosrock/admin/service/AdminChangeNameUseCase.kt", "content": "package band.gosrock.admin.service\n\nimport band.gosrock.admin.model.dto.request.AdminChangeNameRequest\nimport band.gosrock.common.annotation.UseCase\nimport band.gosrock.domain.domains.user.adaptor.UserAdaptor\nimport org.springframework.transaction.annotation.Transactional\n\n@UseCase\nclass AdminChangeNameUseCase(\n private val adminAuthValidator: AdminAuthValidator,\n private val userAdaptor: UserAdaptor,\n) {\n\n @Transactional\n fun execute(adminUserId: Long, targetUserId: Long, request: AdminChangeNameRequest) {\n adminAuthValidator.validateAdminOrAbove(adminUserId)\n val user = userAdaptor.queryUser(targetUserId)\n user.changeName(request.name)\n }\n}\n" }, { "path": "DuDoong-Admin/src/main/kotlin/band/gosrock/admin/service/AdminCompleteRefundUseCase.kt", "content": "package band.gosrock.admin.service\n\nimport band.gosrock.admin.model.dto.response.AdminRefundResponse\nimport band.gosrock.common.annotation.UseCase\nimport band.gosrock.domain.domains.event.adaptor.EventAdaptor\nimport band.gosrock.domain.domains.order.adaptor.OrderAdaptor\nimport band.gosrock.domain.domains.user.adaptor.UserAdaptor\nimport org.springframework.transaction.annotation.Transactional\n\n@UseCase\nclass AdminCompleteRefundUseCase(\n private val orderAdaptor: OrderAdaptor,\n private val userAdaptor: UserAdaptor,\n private val eventAdaptor: EventAdaptor,\n private val adminAuthValidator: AdminAuthValidator,\n) {\n\n @Transactional\n fun execute(userId: Long, orderUuid: String): AdminRefundResponse {\n adminAuthValidator.validateAdminOrAbove(userId)\n val order = orderAdaptor.findByOrderUuid(orderUuid)\n order.completeRefund()\n\n val userName = order.userId?.let {\n runCatching { userAdaptor.queryUser(it).profile?.name }.getOrNull()\n }\n val eventName = order.eventId?.let {\n runCatching { eventAdaptor.findById(it).eventBasic?.name }.getOrNull()\n }\n return AdminRefundResponse.of(order, userName, eventName)\n }\n}\n" }, { "path": "DuDoong-Admin/src/main/kotlin/band/gosrock/admin/service/AdminDeleteCommentUseCase.kt", "content": "package band.gosrock.admin.service\n\nimport band.gosrock.common.annotation.UseCase\nimport band.gosrock.domain.domains.comment.adaptor.CommentAdaptor\nimport org.springframework.transaction.annotation.Transactional\n\n@UseCase\nclass AdminDeleteCommentUseCase(\n private val commentAdaptor: CommentAdaptor,\n private val adminAuthValidator: AdminAuthValidator,\n) {\n\n @Transactional\n fun execute(userId: Long, commentId: Long) {\n adminAuthValidator.validateAdminOrAbove(userId)\n val comment = commentAdaptor.queryComment(commentId)\n comment.delete()\n }\n}\n" }, { "path": "DuDoong-Admin/src/main/kotlin/band/gosrock/admin/service/AdminDeleteEventUseCase.kt", "content": "package band.gosrock.admin.service\n\nimport band.gosrock.common.annotation.UseCase\nimport band.gosrock.domain.domains.event.adaptor.EventAdaptor\nimport band.gosrock.domain.domains.event.domain.EventStatus\nimport band.gosrock.domain.domains.event.repository.EventRepository\nimport org.springframework.transaction.annotation.Transactional\n\n@UseCase\nclass AdminDeleteEventUseCase(\n private val eventAdaptor: EventAdaptor,\n private val eventRepository: EventRepository,\n private val adminAuthValidator: AdminAuthValidator,\n) {\n\n @Transactional\n fun execute(userId: Long, eventId: Long) {\n adminAuthValidator.validateAdminOrAbove(userId)\n val event = eventAdaptor.findById(eventId)\n // 어드민은 밸리데이션 없이 직접 DELETED 상태로 변경\n event.adminUpdateStatus(EventStatus.DELETED)\n eventRepository.save(event)\n }\n}\n" }, { "path": "DuDoong-Admin/src/main/kotlin/band/gosrock/admin/service/AdminExcelService.kt", "content": "package band.gosrock.admin.service\n\nimport band.gosrock.admin.model.dto.response.AdminEventResponse\nimport band.gosrock.admin.model.dto.response.AdminIssuedTicketResponse\nimport band.gosrock.admin.model.dto.response.AdminOrderResponse\nimport band.gosrock.admin.model.dto.response.AdminTicketItemResponse\nimport band.gosrock.admin.model.dto.response.AdminUserResponse\nimport band.gosrock.domain.domains.issuedTicket.domain.IssuedTicket\nimport band.gosrock.domain.domains.ticket_item.domain.Option\nimport org.apache.poi.xssf.usermodel.XSSFWorkbook\nimport org.springframework.stereotype.Service\nimport java.io.ByteArrayOutputStream\n\n@Service\nclass AdminExcelService {\n\n fun generateOrdersExcel(orders: List): ByteArray {\n val workbook = XSSFWorkbook()\n val sheet = workbook.createSheet(\"주문 목록\")\n val headerRow = sheet.createRow(0)\n val headers = listOf(\n \"주문번호\", \"주문번호(읽기용)\", \"사용자\", \"이벤트\", \"티켓\", \"금액\", \"상태\",\n \"주문방식\", \"결제수단\", \"승인일시\", \"취소일시\", \"할인금액\", \"쿠폰명\", \"주문일\",\n )\n headers.forEachIndexed { i, h -> headerRow.createCell(i).setCellValue(h) }\n orders.forEachIndexed { idx, order ->\n val row = sheet.createRow(idx + 1)\n var col = 0\n row.createCell(col++).setCellValue(order.orderId ?: \"\")\n row.createCell(col++).setCellValue(order.orderNo ?: \"\")\n row.createCell(col++).setCellValue(order.userName ?: \"\")\n row.createCell(col++).setCellValue(order.eventName ?: \"\")\n row.createCell(col++).setCellValue(order.ticketName ?: \"\")\n row.createCell(col++).setCellValue(order.totalAmount.toDouble())\n row.createCell(col++).setCellValue(order.orderStatus.toString())\n row.createCell(col++).setCellValue(order.orderMethod ?: \"\")\n row.createCell(col++).setCellValue(order.paymentMethod ?: \"\")\n row.createCell(col++).setCellValue(order.approvedAt?.toString() ?: \"\")\n row.createCell(col++).setCellValue(order.withDrawAt?.toString() ?: \"\")\n row.createCell(col++).setCellValue(order.discountAmount ?: \"\")\n row.createCell(col++).setCellValue(order.couponName ?: \"\")\n row.createCell(col++).setCellValue(order.createdAt?.toString() ?: \"\")\n }\n return toByteArray(workbook)\n }\n\n fun generateEventsExcel(events: List): ByteArray {\n val workbook = XSSFWorkbook()\n val sheet = workbook.createSheet(\"이벤트 목록\")\n val headerRow = sheet.createRow(0)\n listOf(\"ID\", \"이벤트명\", \"호스트\", \"상태\", \"시작일\", \"런타임(분)\", \"생성일\").forEachIndexed { i, h ->\n headerRow.createCell(i).setCellValue(h)\n }\n events.forEachIndexed { idx, event ->\n val row = sheet.createRow(idx + 1)\n row.createCell(0).setCellValue(event.id.toDouble())\n row.createCell(1).setCellValue(event.name ?: \"\")\n row.createCell(2).setCellValue(event.hostName ?: \"\")\n row.createCell(3).setCellValue(event.status.toString())\n row.createCell(4).setCellValue(event.startAt?.toString() ?: \"\")\n row.createCell(5).setCellValue(event.runTime?.toDouble() ?: 0.0)\n row.createCell(6).setCellValue(event.createdAt?.toString() ?: \"\")\n }\n return toByteArray(workbook)\n }\n\n fun generateUsersExcel(users: List): ByteArray {\n val workbook = XSSFWorkbook()\n val sheet = workbook.createSheet(\"유저 목록\")\n val headerRow = sheet.createRow(0)\n listOf(\"ID\", \"이름\", \"이메일\", \"역할\", \"상태\", \"가입일\").forEachIndexed { i, h ->\n headerRow.createCell(i).setCellValue(h)\n }\n users.forEachIndexed { idx, user ->\n val row = sheet.createRow(idx + 1)\n row.createCell(0).setCellValue(user.id.toDouble())\n row.createCell(1).setCellValue(user.name ?: \"\")\n row.createCell(2).setCellValue(user.email ?: \"\")\n row.createCell(3).setCellValue(user.accountRole.toString())\n row.createCell(4).setCellValue(user.accountState.toString())\n row.createCell(5).setCellValue(user.createdAt?.toString() ?: \"\")\n }\n return toByteArray(workbook)\n }\n\n fun generateTicketItemsExcel(items: List): ByteArray {\n val workbook = XSSFWorkbook()\n val sheet = workbook.createSheet(\"티켓 종류 목록\")\n val headerRow = sheet.createRow(0)\n listOf(\"이름\", \"설명\", \"가격\", \"수량\", \"판매수\", \"구매제한\", \"타입\", \"상태\").forEachIndexed { i, h ->\n headerRow.createCell(i).setCellValue(h)\n }\n items.forEachIndexed { idx, item ->\n val row = sheet.createRow(idx + 1)\n row.createCell(0).setCellValue(item.name ?: \"\")\n row.createCell(1).setCellValue(item.description ?: \"\")\n row.createCell(2).setCellValue(item.price?.toDouble() ?: 0.0)\n row.createCell(3).setCellValue(item.quantity?.toDouble() ?: 0.0)\n row.createCell(4).setCellValue(item.supplyCount?.toDouble() ?: 0.0)\n row.createCell(5).setCellValue(item.purchaseLimit?.toDouble() ?: 0.0)\n row.createCell(6).setCellValue(item.type?.toString() ?: \"\")\n row.createCell(7).setCellValue(item.ticketItemStatus.toString())\n }\n return toByteArray(workbook)\n }\n\n fun generateIssuedTicketsExcel(tickets: List): ByteArray {\n return generateIssuedTicketsExcelWithOptions(tickets, emptyList(), emptyList())\n }\n\n /**\n * 발급 티켓 엑셀에 옵션 응답을 동적 컬럼으로 포함하여 생성합니다.\n *\n * @param tickets 발급 티켓 응답 목록\n * @param options 이벤트에 등록된 옵션 목록 (동적 컬럼 헤더용)\n * @param issuedTickets 발급 티켓 엔티티 목록 (옵션 응답 데이터 접근용)\n */\n fun generateIssuedTicketsExcelWithOptions(\n tickets: List,\n options: List