LC-2789 admin 배너 관리 by yeeun426 · Pull Request #2138 · Let-s-intern/lets-intern-client

yeeun426 · 2026-02-22T15:29:53Z

연관 작업

LC-2789

gemini-code-assist · 2026-02-22T15:30:17Z

Summary of Changes

Hello @yeeun426, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

이 PR은 관리자가 여러 위치의 배너를 효율적으로 관리할 수 있도록 통합 배너 관리 시스템을 도입합니다. 관리자 페이지에서 배너를 생성, 편집, 삭제할 수 있는 완전한 기능을 제공하며, 사용자에게 노출되는 기존 배너 섹션들은 이 새로운 통합 시스템을 통해 데이터를 가져오도록 업데이트되었습니다. 이를 통해 배너 관리 프로세스가 간소화되고 일관성이 강화됩니다.

Highlights

통합 배너 관리 시스템 도입: 관리자가 홈 상단, 홈 하단, 프로그램, 마이페이지 등 다양한 위치의 배너를 한 곳에서 통합적으로 관리할 수 있는 새로운 시스템이 추가되었습니다.
관리자 페이지 CRUD 기능 구현: 통합 배너의 생성, 조회, 수정, 삭제 기능을 제공하는 관리자 페이지가 구현되었습니다. 노출 중인 배너와 전체 배너를 탭으로 구분하여 볼 수 있습니다.
기존 배너 컴포넌트 통합 API 연동: 홈 상단, 홈 하단, 프로그램, 마이페이지 등 사용자 화면에 노출되는 기존 배너 컴포넌트들이 새로운 통합 배너 API를 사용하도록 변경되었습니다.
파일 업로드 기능 개선: 파일 업로드 시 파일 ID를 반환하는 새로운 유틸리티 함수가 추가되어 배너 이미지 관리의 유연성이 향상되었습니다.

🧠 New Feature in Public Preview: You can now enable Memory to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

Changelog

src/api/banner.ts
- 파일 ID 업로드 유틸리티 함수 uploadFileForId를 임포트했습니다.
- 새로운 CommonBannerType 및 관련 Zod 스키마(commonBannerAdminListItemSchema, commonBannerAdminAllItemSchema, commonBannerAdminListSchema, commonBannerAdminArrayListSchema)를 정의했습니다.
- 통합 배너를 위한 새로운 쿼리 키(getCommonBannerForAdminQueryKey, getActiveBannersForAdminQueryKey)를 추가했습니다.
- bannerType에 'COMMON'을 추가하여 확장했습니다.
- 통합 배너를 위한 새로운 React Query 훅(useGetCommonBannerForAdmin, useGetActiveBannersForAdmin, usePostCommonBannerForAdmin, useGetCommonBannerDetailForAdmin, useEditCommonBannerForAdmin, useToggleCommonBannerVisibility, useDeleteCommonBannerForAdmin)을 구현했습니다.
- useDeleteBannerForAdmin에서 타입이 'COMMON'일 경우 통합 배너 쿼리를 무효화하도록 업데이트했습니다.
- 사용자 화면용 통합 배너 API(commonBannerUserItemRawSchema, commonBannerUserListRawSchema, useGetCommonBannerListForUser)를 추가했습니다.
src/api/file.ts
- fileType enum에 COMMON_BANNER를 추가했습니다.
- 파일을 업로드하고 파일 ID를 반환하는 uploadFileForId 함수를 추가했습니다.
src/app/admin/AdminSidebar.tsx
- 기존 홈 배너 관리 링크('홈 상단 배너 관리', '홈 하단 배너 관리')를 제거했습니다.
- '프로그램 배너 관리'를 '통합 배너 관리'로 변경하고 URL을 /admin/banner/common-banners로 업데이트했습니다.
src/app/admin/banner/common-banners/[id]/edit/page.tsx
- 통합 배너 수정 페이지를 새로 추가했습니다. 배너 상세 정보를 가져와 폼 값으로 매핑하고 업데이트를 처리하는 로직을 포함합니다.
src/app/admin/banner/common-banners/new/components/CommonBannerInputContent.tsx
- 통합 배너 입력 필드(제목, 랜딩 URL, 노출 여부, 기간, 노출 위치, 이미지 업로드)를 위한 재사용 가능한 컴포넌트를 새로 생성했습니다.
src/app/admin/banner/common-banners/new/page.tsx
- 통합 배너 생성 페이지를 새로 추가했습니다. 폼 값 초기화 및 새 배너 생성을 위한 폼 제출 로직을 구현합니다.
src/app/admin/banner/common-banners/page.tsx
- 메인 통합 배너 관리 페이지를 새로 추가했습니다. '노출 중' 및 '전체' 탭, 활성 배너를 위한 커스텀 테이블, 전체 배너를 위한 DataGrid, 배너 수정, 노출 여부 토글, 삭제 기능을 포함합니다.
src/domain/admin/program/ui/editor/EditorTemplate.tsx
- 에디터 템플릿의 너비를 w-[36rem]에서 w-[45rem]으로 확장했습니다.
- 폼의 상단 마진을 mt-4에서 mt-10으로 조정했습니다.
src/domain/admin/ui/table/TableLayout.tsx
- 탭 내비게이션을 지원하기 위해 TableLayout에 선택적 tabs prop을 추가했습니다.
- 제공된 경우 헤더 아래에 탭을 렌더링하도록 변경했습니다.
src/domain/home/banner/BottomBannerSection.tsx
- useGetBannerListForUser를 useGetCommonBannerListForUser로 교체하여 HOME_BOTTOM 타입의 배너를 가져오도록 변경했습니다.
- 새로운 통합 배너 구조에 맞춰 배너 데이터 접근 및 링크/이미지 속성을 업데이트했습니다.
src/domain/home/banner/MainBannerSection.tsx
- useGetBannerListForUser를 useGetCommonBannerListForUser로 교체하여 HOME_TOP 타입의 배너를 가져오도록 변경했습니다.
- 새로운 통합 배너 구조에 맞춰 배너 데이터 접근 및 링크/이미지 속성을 업데이트했습니다.
src/domain/mypage/MyPageBanner.tsx
- useGetBannerListForUser를 useGetCommonBannerListForUser로 교체하여 MY_PAGE 타입의 배너를 가져오도록 변경했습니다.
- 새로운 API가 관련 데이터를 직접 제공하므로 배너 필터링을 위한 useMemo를 제거했습니다.
- 새로운 통합 배너 구조에 맞춰 배너 데이터 접근 및 링크/이미지 속성을 업데이트했습니다.
src/domain/program/Banner.tsx
- useGetUserProgramBannerListQuery를 useGetCommonBannerListForUser로 교체하여 PROGRAM 타입의 배너를 가져오도록 변경했습니다.
- 새로운 통합 배너 구조에 맞춰 배너 데이터 접근 및 링크/이미지 속성을 업데이트했습니다.

Activity

관리자 배너 관리를 위한 새로운 기능이 도입되었습니다.
기존 배너 관련 API 호출 및 UI 컴포넌트에 대한 상당한 리팩토링이 포함되었습니다.
관리자 패널에서 통합 배너 생성, 편집 및 목록 기능을 지원하기 위해 새로운 파일들이 추가되었습니다.
사용자 화면에 노출되는 기존 배너 컴포넌트들이 새로운 통합 배너 API를 사용하도록 업데이트되었습니다.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature	Command	Description
Code Review	`/gemini review`	Performs a code review for the current pull request in its current state.
Pull Request Summary	`/gemini summary`	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help	`/gemini help`	Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

gemini-code-assist

Code Review

This PR reorganizes the existing distributed banner management system into a 'unified banner' system, introducing new API hooks, components, and pages for administrators and user-facing sections. A critical Stored Cross-Site Scripting (XSS) vulnerability was identified, as the landingUrl input lacks validation on the admin side and is directly rendered into href attributes on the user side, potentially allowing malicious scripts via javascript: URIs. It is recommended to implement strict URL protocol validation (allowing only http: and https:) and sanitize these URLs before rendering. Additionally, several code-related improvements are needed, primarily concerning API design, efficiency, and potential UI logic bugs. These include ensuring unique IDs in API responses for list rendering, optimizing mutation hooks to prevent unnecessary requests, and fixing bugs related to image processing and data display.

src/api/banner.ts

gemini-code-assist · 2026-02-22T15:34:27Z

src/api/banner.ts

+      // PC/MOBILE 아이템을 같은 title+landingUrl 기준으로 그룹핑
+      const groupMap = new Map<string, CommonBannerUserItem>();
+      for (const item of parsed.commonBannerList) {
+        const key = `${item.title ?? ''}::${item.landingUrl ?? ''}`;
+        if (!groupMap.has(key)) {
+          groupMap.set(key, {
+            title: item.title,
+            landingUrl: item.landingUrl,
+            imgUrl: null,
+            mobileImgUrl: null,
+          });
+        }
+        const group = groupMap.get(key)!;
+        if (item.agentType === 'PC') {
+          group.imgUrl = item.fileUrl;
+        } else {
+          group.mobileImgUrl = item.fileUrl;
+        }
+      }
+
+      return Array.from(groupMap.values());


사용자단 배너를 가져오는 useGetCommonBannerListForUser 훅에서 사용하는 /common-banner API의 응답에 각 배너를 식별할 수 있는 고유 ID(commonBannerId)가 누락되어 있습니다. 이로 인해 여러 컴포넌트에서 React key로 index를 사용하는 문제가 발생하고 있습니다.

백엔드 API 응답에 commonBannerId를 포함하도록 수정하고, 이를 그룹핑과 React key 값으로 사용하는 것이 안정성과 성능 면에서 중요합니다. index를 key로 사용하면 리스트가 변경될 때 예기치 않은 동작이 발생할 수 있습니다.

CommonBannerUserItem 타입에 id를 추가하고, 그룹핑 로직에서 이 ID를 전달하도록 수정하는 것을 제안합니다.

gemini-code-assist · 2026-02-22T15:34:27Z

src/domain/admin/banner/common-banner/CommonBannerInputContent.tsx

+              type="button"
+              className="absolute right-2 top-2 rounded-full bg-black/50 px-2 py-0.5 text-xs text-white"
+              onClick={(e) => {
+                e.stopPropagation();
+                onChange(null);
+              }}
+            >
+              ✕
+            </button>


이미지 미리보기의 '✕' 버튼이 수정 모드에서 제대로 동작하지 않습니다. 이 버튼은 새로 업로드할 File 객체만 null로 만들고, 기존 이미지의 fileId는 그대로 유지합니다. 이로 인해 사용자가 기존 이미지를 삭제할 수 없습니다.

이미지를 삭제하려면, '✕' 버튼 클릭 시 해당 이미지의 fileId (예: homePcFileId)와 fileUrl도 null로 설정하도록 onChange 핸들러 로직을 수정해야 합니다.

src/app/admin/banner/common-banners/page.tsx

src/domain/home/banner/BottomBannerSection.tsx

src/domain/mypage/MyPageBanner.tsx

src/domain/program/Banner.tsx

src/api/banner.ts

src/app/admin/banner/common-banners/[id]/edit/page.tsx

src/domain/admin/banner/common-banner/CommonBannerInputContent.tsx

yeeun426 added 9 commits February 16, 2026 18:29

feat : admin 통합 배너 관리 수정

a4dbd2b

Merge branch 'main' into LC-2789-admin-배너-관리

89251b2

feat : 노출 중 ui 변경

d325a3f

feat : 통합 배너 생성 API 스펙 적용 및 폴더 구조 정리

72551b2

feat: 통합 배너 수정 추가

edd2823

feat : 배너 삭제 기능 추가

bef565c

feat: 통합 배너 노출 여부 토글 api 변경

10c3b20

feat : 어드민 사이드바 사용하지 않는 메뉴 정리

e514250

feat : USER 통합 배너 api 수정

84a7901

github-actions bot changed the title ~~Lc 2789 admin 배너 관리~~ LC-2789 admin 배너 관리 Feb 22, 2026

gemini-code-assist bot reviewed Feb 22, 2026

View reviewed changes

yeeun426 added 3 commits February 23, 2026 00:35

feat : 등록/수정 페이지 검증 추가

91a4253

feat : 만료된 배너 업데이트 버튼 추가

bcd0574

feat : 업데이트 아이콘 추가

a23a005

yeeun426 self-assigned this Feb 28, 2026

yeeun426 added 3 commits February 28, 2026 18:47

feat: 배너 등록 API 호출 방식 변경

dc3e1fe

feat : 마이페이지 모바일의 경우, 홈 배너로 수정

2134741

feat : 폴더 구조 기반 리팩토링

72a7ae9

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

LC-2789 admin 배너 관리#2138

Hidden character warning

LC-2789 admin 배너 관리#2138
yeeun426 wants to merge 15 commits intomainfrom
LC-2789-admin-배너-관리

yeeun426 commented Feb 22, 2026 •

edited by atlassian bot

Loading

Uh oh!

gemini-code-assist bot commented Feb 22, 2026

Uh oh!

gemini-code-assist bot left a comment

Uh oh!

Uh oh!

gemini-code-assist bot Feb 22, 2026

Uh oh!

gemini-code-assist bot Feb 22, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Conversation

yeeun426 commented Feb 22, 2026 • edited by atlassian bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

연관 작업

Uh oh!

gemini-code-assist bot commented Feb 22, 2026

Summary of Changes

Highlights

Footnotes

Uh oh!

gemini-code-assist bot left a comment

Choose a reason for hiding this comment

Code Review

Uh oh!

Uh oh!

gemini-code-assist bot Feb 22, 2026

Choose a reason for hiding this comment

Uh oh!

gemini-code-assist bot Feb 22, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

yeeun426 commented Feb 22, 2026 •

edited by atlassian bot

Loading